複数のサンドボックス

この例では、Sessionを使用して複数の CoreWeave サンドボックスを並列に実行する方法を示します。Sessionは、共有デフォルトを各サンドボックスに適用し、ブロックを抜けるとサンドボックスを自動的にクリーンアップします。各サンドボックスのライフサイクルを個別に管理せずに複数のサンドボックスで作業を連携させたい場合は、このパターンを使用してください。

認証を選択する

このページの例は、CKS を指定しているセクションを除き、サーバーレスキャパシティ上で実行されます。サンドボックスを所有するアカウントの認証情報を選択してください。キーまたはトークンの取得方法については、認証情報の選択と取得を参照してください。インストールコマンドは、有効化した Python 仮想環境で実行してください。使用する認証情報のタブにある Python コードを sandbox_auth.py として、このページで実行する Python スクリプトと同じディレクトリに保存してください。このファイルに保存されるのはどの認証を使うかという選択だけで、認証情報そのものは含まれません。各例ではこのファイルから AUTH をインポートし、新しいサンドボックスやSessionを作成するたびに明示的に渡します。

Forge API キー
CoreWeave API アクセストークン

SDK の W&B 認証方式で Forge APIキーを使用します。

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

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

CKS に配置する場合は、CoreWeave トークンを選択してランナーを有効化し、サンドボックスの作成時または SandboxDefaults で placement_mode="cks" を設定してください。auth=AUTH を指定してSessionを作成すると、そのSessionが所有するサンドボックスも認証されます。サンドボックスへの再接続、一覧表示、クリーンアップの際も、同じ認証情報を使用してください。

Sessionでサンドボックスを実行する

Sessions manage multiple サンドボックス with shared デフォルト and automatic クリーンアップ:

from sandbox_auth import AUTH
from cwsandbox import Sandbox, SandboxDefaults

defaults = SandboxDefaults(
    container_image="python:3.11",
    tags=("my-app",),
    resources={"cpu": "1", "memory": "1Gi"},
)

with Sandbox.session(defaults, auth=AUTH) as session:
    sb1 = session.sandbox()
    sb2 = session.sandbox()

    p1 = sb1.exec(["echo", "one"])
    p2 = sb2.exec(["echo", "two"])

    print(p1.result().stdout, p2.result().stdout)
# すべてのサンドボックスがクリーンアップされました

サンドボックスプール、取り込みパターン、およびライフサイクル管理については、Sessions ガイドを参照してください。

サンドボックス

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

サンドボックスの管理

リファレンス

複数のサンドボックス

認証を選択する

Sessionでサンドボックスを実行する

​認証を選択する

​Sessionでサンドボックスを実行する

認証を選択する

Sessionでサンドボックスを実行する