Exécuter des sandboxes de longue durée

Les sandboxes serverless peuvent s’exécuter pendant 30 jours maximum (2 592 000 secondes). Définissez la durée de vie lors de la création de la sandbox afin de laisser à un agent, à un environnement de développement ou à une charge de travail par lots suffisamment de temps pour se terminer. Ce guide explique comment demander une durée de vie plus longue.

Before you begin

Effectuez la configuration du sandbox. Les exemples Python nécessitent le package cwsandbox avec l’option supplémentaire wandb, ainsi qu’une clé API W&B définie dans la variable d’environnement WANDB_API_KEY. Remplacez [WANDB-API-KEY] par votre clé API W&B :

pip install --upgrade 'cwsandbox[wandb]'
export WANDB_API_KEY="[WANDB-API-KEY]"

Choose a lifetime

The lifetime is an upper bound on how long the sandbox can run. The platform terminates it when the lifetime expires, even if work is still in progress. A workload that finishes or a sandbox that you stop can end sooner.

Paramètre	Sans serveur
Durée de vie par sandbox	Définissez-la à l’aide du kit de développement logiciel (SDK) ou dans la requête de création du sandbox.
Valeur par défaut de la politique de l’exécuteur	Gérée par CoreWeave.
Durée de vie maximale	30 jours.

An explicit lifetime takes precedence over a runner-policy default. If you omit the lifetime, the platform uses the applicable policy default. If no positive default supplies a lifetime, the platform uses 10 minutes (600 seconds). Set the lifetime explicitly for long-running work instead of relying on a default. La plateforme rejette les requêtes dépassant 30 jours. La valeur 0 ne correspond pas à une durée d’exécution illimitée. You can’t extend the lifetime after a sandbox starts. Choose enough time at creation, and plan to save your work before the deadline.

Set the lifetime when creating a sandbox

En Python, utilisez max_lifetime_seconds. L’exemple suivant demande la durée complète de 30 jours et affiche l’ID du sandbox pour que vous puissiez vous y reconnecter plus tard :

Create a Serverless sandbox

from cwsandbox import AuthStrategy, Sandbox

sandbox = Sandbox.run(
    "sleep", "infinity",
    auth=AuthStrategy.WANDB,
    placement_mode="serverless",
    container_image="python:3.11",
    resources={"cpu": "2", "memory": "4Gi"},
    max_lifetime_seconds=30 * 24 * 60 * 60,
)
sandbox.wait()
print(sandbox.sandbox_id)

The script prints the sandbox ID. These examples keep the primary process alive with sleep infinity and leave the sandbox running after the script exits. When you finish using the sandbox, stop it. The same lifetime is available through the other client interfaces:

Interface	Configuration de la durée de vie
SDK Python	`Sandbox.run(max_lifetime_seconds=2592000, ...)`. Pour définir des valeurs par défaut partagées au niveau du client, utilisez `SandboxDefaults(max_lifetime_seconds=2592000)`. Un argument explicite prévaut sur la valeur par défaut du client.
SDK TypeScript	Transmettez `maxLifetimeSeconds: 2592000` dans les options de `client.run()`.
Importation d’un fichier Compose	Définissez le champ de premier niveau `maxLifetimeSeconds` de la requête sur `2592000` dans `POST /v1/sandboxes:createFromFile`. La durée de vie est un paramètre de la requête, et non une propriété d’un service Compose.

Pour connaître le format de la requête, consultez Créer une sandbox à partir d’un fichier Compose. Pour connaître les valeurs par défaut du client Python, consultez Configuration de la sandbox.

Keep working across client sessions

When a sandbox should outlive the Python script that launches it, create a standalone sandbox, as in the preceding examples. A with Sandbox.run(...) context stops the sandbox when the block exits, even if its configured lifetime is 30 days. A Session also manages cleanup of the sandboxes it owns. See Cleanup patterns. To reconnect from another script, replace [SANDBOX-ID] with the ID printed at creation:

Reconnect to a running sandbox

from cwsandbox import AuthStrategy, Sandbox

sandbox = Sandbox.from_id(
    "[SANDBOX-ID]",
    auth=AuthStrategy.WANDB,
).result()
result = sandbox.exec(["echo", "Connected"]).result()
print(result.stdout)

The command prints Connected. Reconnecting doesn’t reset the lifetime. When you finish, stop the sandbox explicitly:

Stop a sandbox

from cwsandbox import AuthStrategy, Sandbox

sandbox = Sandbox.from_id(
    "[SANDBOX-ID]",
    auth=AuthStrategy.WANDB,
).result()
sandbox.stop().result()

Plan for expiry

Enregistrez les résultats ou les points de contrôle en dehors de la sandbox avant l’expiration de sa durée de vie. Si un flux de travail dure plus de 30 jours, créez une sandbox de remplacement et reprenez à partir de l’état enregistré. Pour connaître les options de stockage et d’instantanés prises en charge, consultez Volumes de sandbox et Instantanés du système de fichiers. The sandbox lifetime is separate from the timeout for a command or API request. Increasing timeout_seconds or request_timeout_seconds doesn’t extend the sandbox lifetime. For the differences, see Timeouts.

​Before you begin

​Choose a lifetime

​Set the lifetime when creating a sandbox

​Keep working across client sessions

​Plan for expiry

Before you begin

Choose a lifetime

Set the lifetime when creating a sandbox

Keep working across client sessions

Plan for expiry