サンドボックスを長時間実行する

サーバーレスのサンドボックスは、最大 30 日間 (2,592,000 秒) 実行できます。エージェント、開発環境、バッチワークロードが完了するまでの十分な時間を確保できるよう、サンドボックスの作成時に有効期間を設定してください。このガイドでは、有効期間の延長をリクエストする方法を説明します。

Before you begin

あらかじめサンドボックスのセットアップを完了しておいてください。Python のサンプルを実行するには、wandb エクストラ付きの cwsandbox パッケージと、環境変数 WANDB_API_KEY に設定した W&B APIキーが必要です。[WANDB-API-KEY] をご自身の W&B APIキーに置き換えてください：

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.

設定	サーバーレス
サンドボックスごとの有効期間	ソフトウェア開発キット (SDK) またはサンドボックス作成リクエストで設定します。
ランナーポリシーのデフォルト	CoreWeave が管理します。
最大ライフタイム	30 日。

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. 30 日を超えるリクエストはプラットフォームで拒否されます。値に 0 を指定しても、実行時間が無制限になるわけではありません。 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

Python では max_lifetime_seconds を使用します。次の例では、上限である 30 日間をリクエストし、後で再接続できるようにサンドボックス ID を出力します：

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:

インターフェース	有効期間の設定
Python SDK	`Sandbox.run(max_lifetime_seconds=2592000, ...)`。クライアント全体で共有するデフォルトを設定するには、`SandboxDefaults(max_lifetime_seconds=2592000)` を使用します。引数を明示的に指定すると、クライアントのデフォルトが上書きされます。
TypeScript SDK	`client.run()` に渡すオプションで `maxLifetimeSeconds: 2592000` を指定します。
Compose ファイルのインポート	`POST /v1/sandboxes:createFromFile` のトップレベルのリクエストフィールド `maxLifetimeSeconds` を `2592000` に設定します。有効期間はリクエスト側の設定であり、Compose のサービスのプロパティではありません。

リクエストの形式については、Compose ファイルからサンドボックスを作成するを参照してください。Python クライアントのデフォルト値については、サンドボックスの設定を参照してください。

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

サンドボックスの有効期間が切れる前に、結果やチェックポイントをサンドボックスの外部に保存してください。ワークフローに 30 日以上かかる場合は、新しいサンドボックスを作成し、保存した状態から再開してください。サポートされるストレージおよびスナップショットのオプションについては、サンドボックスボリュームとファイルシステムスナップショットを参照してください。 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