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

CoreWeave のサンドボックスは、サーバーレスと CoreWeave Kubernetes Service (CKS) のどちらの配置でも、最大 30 日 (2,592,000 秒) 実行できます。エージェント、開発環境、バッチワークロードが処理を完了するのに十分な時間を確保できるよう、サンドボックスの作成時にライフタイムを設定してください。このガイドでは、開発者向けに、より長いライフタイムをリクエストする方法を説明します。また、管理者向けに、CKS ランナー上のサンドボックスのデフォルトのライフタイムを設定する方法を説明します。

始める前に

サンドボックスのセットアップを完了し、Python クライアントをインストールしたうえで、CoreWeave API アクセストークンを設定します：

pip install --upgrade cwsandbox
export CWSANDBOX_API_KEY="[API-ACCESS-TOKEN]"

CKS 配置を使用する場合は、独自のコンピュートを使用するの手順も完了してください。CKS の例にある [RUNNER-ID] は、設定済みのランナーの ID に置き換えてください。Forge のAPIキーでサーバーレス配置を使用する場合は、はじめにに記載されている、認証を明示的に行うセットアップ手順に従ってください。

有効期間を選択する

有効期間は、サンドボックスを実行できる時間の上限です。有効期間が切れると、作業が進行中であってもプラットフォームはサンドボックスを終了します。ワークロードが完了した場合や、ユーザーがサンドボックスを停止した場合は、それより早く終了することがあります。

設定	サーバーレス	CKS
サンドボックスごとの有効期間	ソフトウェア開発キット (SDK) またはサンドボックス作成リクエストで設定します。	SDK またはサンドボックス作成リクエストで設定します。
ランナーのポリシーのデフォルト	CoreWeave が管理します。	管理者がランナーのポリシーで `constraints.lifecycle.default_lifetime_seconds` を設定できます。
最大ライフタイム	30 日。	30 日 (独自のクラスターを使用する場合も同様)。

明示的に指定した有効期間は、ランナーのポリシーのデフォルトよりも優先されます。有効期間を省略すると、プラットフォームは該当するポリシーのデフォルトを使用します。正の値のデフォルトが設定されていない場合、プラットフォームは 10 分 (600 秒) を使用します。長時間実行する作業では、デフォルトに頼らず有効期間を明示的に設定してください。 30 日を超えるリクエストはプラットフォームによって拒否されます。値 0 は実行時間が無制限であることを意味しません。CKS のポリシーでプラットフォームの最大値を引き上げることはできません。サンドボックスの開始後に有効期間を延長することはできません。作成時に十分な時間を指定し、期限までに作業を保存できるよう計画してください。

サンドボックス作成時に有効期間を設定する

Python では max_lifetime_seconds を使用します。以下の例では、上限である 30 日間をリクエストし、後で再接続できるようにサンドボックス ID を出力します。使用する配置モードのタブを選択してください。

Serverless
CKS

Serverless サンドボックスを作成する

from cwsandbox import AuthStrategy, Sandbox

sandbox = Sandbox.run(
    "sleep", "infinity",
    auth=AuthStrategy.COREWEAVE_API_KEY,
    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)

CKS ランナー上にサンドボックスを作成する

from cwsandbox import AuthStrategy, Sandbox

sandbox = Sandbox.run(
    "sleep", "infinity",
    auth=AuthStrategy.COREWEAVE_API_KEY,
    placement_mode="cks",
    runner_ids=["[RUNNER-ID]"],
    container_image="python:3.11",
    resources={"cpu": "2", "memory": "4Gi"},
    max_lifetime_seconds=30 * 24 * 60 * 60,
)
sandbox.wait()
print(sandbox.sandbox_id)

スクリプトを実行すると、サンドボックス ID が出力されます。これらの例では、sleep infinity でプライマリプロセスを動かし続けるため、スクリプトの終了後もサンドボックスは実行されたままになります。サンドボックスを使い終わったら、停止してください。有効期間は、他のクライアントインターフェースからも同様に設定できます。

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

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

CKS ランナーのデフォルトを設定する

ランナーのポリシーのデフォルトは、有効期間を個別にリクエストしない新しいサンドボックスに適用されます。CKS ランナー上のワークロードに通常より長い有効期間を与えたい場合に使用します。ポリシーを編集するには、SANDBOX_ADMIN アイデンティティとアクセス管理 (IAM) action が必要です。ポリシーを更新すると、ポリシードキュメント全体が置き換えられます。抜粋を既存のポリシーの代わりに送信しないでください。送信すると、ポリシー内のその他の制約が削除されます。

対話型ターミナルで、認証済みの CoreWeave Intelligent CLI を使用してランナーの現在のポリシーを開きます。
cwic sandbox runner policy edit [RUNNER-ID]
constraints.lifecycle.default_lifetime_seconds に任意の秒数を設定します。次の YAML は、デフォルトを 30 日に設定する場合の抜粋です。既存のポリシーのその他の部分はそのまま残してください。
ランナーのポリシーの抜粋
constraints: lifecycle: default_lifetime_seconds: 2592000
保存してエディターを閉じ、更新を送信します。ポリシーを取得して値を検証します。
cwic sandbox runner policy get [RUNNER-ID]

マネージドランナーの REST API を使用してポリシーを更新することもできます。JSON では、フィールド名は policy.constraints.lifecycle.defaultLifetimeSeconds です。読み取り、編集、置き換えまでの完全な手順については、ポリシーを更新するを参照してください。デフォルトは、更新後に作成されたサンドボックスに適用されます。実行中のサンドボックスの有効期間は延長されません。サンドボックスは、最大 30 日までの範囲で別の有効期間を明示的にリクエストできます。ポリシーに max_lifetime_seconds を追加しないでください。このフィールドは提供終了となっており、CoreWeave Intelligent CLI はこのフィールドが残っているポリシードキュメントを拒否します。ポリシーではデフォルトを指定し、最大値はプラットフォームによって強制されます。

クライアントのセッションをまたいで作業を継続する

サンドボックスを起動した Python スクリプトの終了後もサンドボックスを存続させたい場合は、前述の例のようにスタンドアロンのサンドボックスを作成します。with Sandbox.run(...) コンテキストを使用すると、設定済みの有効期間が 30 日であっても、ブロックを抜けた時点でサンドボックスが停止します。また、Session も自身が所有するサンドボックスのクリーンアップを管理します。詳しくは Cleanup patterns を参照してください。別のスクリプトから再接続するには、[SANDBOX-ID] を作成時に出力された ID に置き換えます。認証情報には、サンドボックスの作成時と同じものを使用してください。以下の例では、セットアップ時に取得した CoreWeave API アクセストークンを使用します。

Reconnect to a running sandbox

from cwsandbox import AuthStrategy, Sandbox

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

このコマンドを実行すると、Connected と出力されます。再接続しても有効期間はリセットされません。作業が終わったら、サンドボックスを明示的に停止してください：

Stop a sandbox

from cwsandbox import AuthStrategy, Sandbox

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

有効期限切れに備える

サンドボックスのライフタイムが切れる前に、結果やチェックポイントをサンドボックスの外部に保存してください。ワークフローに 30 日を超える時間が必要な場合は、代わりのサンドボックスを作成し、保存済みの状態から再開してください。サポートされるストレージとスナップショットのオプションについては、サンドボックスのボリュームおよびファイルシステムスナップショットを参照してください。サンドボックスのライフタイムは、コマンドや API リクエストのタイムアウトとは別物です。timeout_seconds や request_timeout_seconds を増やしても、サンドボックスのライフタイムは延長されません。両者の相違点については、タイムアウトを参照してください。

サンドボックス

サンドボックスを使用する

サンドボックスの管理

リファレンス

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

始める前に

有効期間を選択する

サンドボックス作成時に有効期間を設定する

CKS ランナーのデフォルトを設定する

クライアントのセッションをまたいで作業を継続する

有効期限切れに備える

​始める前に

​有効期間を選択する

​サンドボックス作成時に有効期間を設定する

​CKS ランナーのデフォルトを設定する

​クライアントのセッションをまたいで作業を継続する

​有効期限切れに備える

始める前に

有効期間を選択する

サンドボックス作成時に有効期間を設定する

CKS ランナーのデフォルトを設定する

クライアントのセッションをまたいで作業を継続する

有効期限切れに備える