Nettoyage

Cette page explique comment arrêter les Sandbox de manière fiable afin de libérer les ressources lorsque votre code se termine ou s’interrompt de façon inattendue. Appliquez ces approches pour éviter que des Sandbox orphelines continuent de s’exécuter une fois votre script terminé.

Choisir l’authentification

Ces exemples s’exécutent sur une capacité sans serveur, sauf si une section indique CKS. Choisissez l’identifiant d’authentification du compte propriétaire de vos Sandbox. Pour obtenir une clé ou un jeton, consultez Choisir et obtenir des identifiants d’authentification. Exécutez les commandes d’installation dans un environnement virtuel Python actif. Enregistrez le code Python de l’onglet correspondant à votre identifiant d’authentification sous le nom sandbox_auth.py, dans le même répertoire que les scripts Python que vous exécutez depuis cette page. Ce fichier stocke le mode d’authentification choisi, et non votre identifiant d’authentification lui-même. Les exemples importent AUTH depuis ce fichier et le transmettent explicitement à chaque nouvelle sandbox ou session.

Clé API Forge
Jeton d’accès à l’API CoreWeave

Utilisez votre clé API Forge avec la stratégie d’authentification W&B du SDK :

uv pip install 'cwsandbox[wandb]>=1.14.2'
export WANDB_API_KEY="[WANDB-API-KEY]"

sandbox_auth.py

from cwsandbox import AuthStrategy

AUTH = AuthStrategy.WANDB

Utilisez le jeton de votre organisation CoreWeave :

uv pip install 'cwsandbox>=1.14.2'
export CWSANDBOX_API_KEY="[API-ACCESS-TOKEN]"

sandbox_auth.py

from cwsandbox import AuthStrategy

AUTH = AuthStrategy.COREWEAVE_API_KEY

Pour un placement sur CKS, choisissez le jeton CoreWeave, activez un exécuteur et définissez placement_mode="cks" lors de la création de la sandbox ou dans SandboxDefaults. Créer une session avec auth=AUTH authentifie également les Sandbox qui lui appartiennent. Utilisez le même identifiant d’authentification pour vous reconnecter à vos Sandbox, les lister ou les nettoyer.

Nettoyer les Sandbox

Utilisez un gestionnaire de contexte pour gérer le nettoyage automatiquement :

from cwsandbox import Sandbox
from sandbox_auth import AUTH

with Sandbox.run(resources={"cpu": "1", "memory": "1Gi"}, auth=AUTH) as sandbox:
    sandbox.exec(["echo", "hello"]).result()
# Arrêtée automatiquement

Pour les Sandbox créées sans gestionnaire de contexte, appelez explicitement .stop() :

from cwsandbox import Sandbox
from sandbox_auth import AUTH

sandbox = Sandbox.run(resources={"cpu": "1", "memory": "1Gi"}, auth=AUTH)
sandbox.exec(["echo", "hello"]).result()
sandbox.stop().result()

Par mesure de sécurité, le SDK enregistre des handlers de nettoyage globaux pour atexit et pour les signaux (Ctrl+C, SIGTERM). Ces handlers arrêtent les Sandbox rattachées à une Session, de sorte que les Sandbox gérées par une session s’arrêtent même en cas de sortie inattendue. Une sandbox créée directement avec Sandbox.run() n’appartient à aucune session : elle continue donc de s’exécuter après la fin du processus, jusqu’à ce que vous l’arrêtiez ou que sa durée de vie expire. Consultez Configurer Claude Code avec le SDK Sandbox pour un exemple de flux de travail qui repose sur ce comportement. Pour le nettoyage par lots, les stratégies d’étiquetage et la récupération des Sandbox orphelines, consultez le guide des modèles de nettoyage.

Sandbox

Utiliser les Sandbox

Gérer les bacs à sable

Référence

Choisir l’authentification

Nettoyer les Sandbox

​Choisir l’authentification

​Nettoyer les Sandbox

Choisir l’authentification

Nettoyer les Sandbox