設定 - CoreWeave Docs

このチュートリアルでは、Sandbox.run() にオプションを渡すことで起動時にサンドボックスを設定する方法を説明します。基本的なサンドボックスはすでに作成済みで、コンテナーイメージ、リソース割り当て、およびワークロード用の事前配置ファイルの制御を希望する開発者を対象としています。

認証を選択する

これらの例は、セクション内で CKS が指定されている場合を除き、サーバーレスキャパシティ上で実行されます。サンドボックスを所有するアカウントの認証情報を選択してください。キーまたはトークンの取得方法については、認証情報の選択と取得を参照してください。インストールコマンドは、有効化した Python 仮想環境で実行してください。使用する認証情報のタブにある Python コードを、このページで実行する Python スクリプトと同じディレクトリに sandbox_auth.py として保存します。このファイルに保存されるのは認証方式の選択であり、認証情報そのものではありません。各例ではこのファイルから 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 が所有するサンドボックスも認証されます。サンドボックスへの再接続、一覧表示、クリーンアップの際も、同じ認証情報を使用してください。

`Sandbox.run()` に設定を渡す

サンドボックスをプロビジョニングする方法を制御する設定オプションを、キーワード引数として直接 Sandbox.run() に渡します:

from sandbox_auth import AUTH
from cwsandbox import Sandbox

with Sandbox.run(
    container_image="python:3.11",
    max_lifetime_seconds=300,
    tags=["my-app"],
    resources={"cpu": "1", "memory": "1Gi"},
    auth=AUTH,
) as sandbox:
    sandbox.exec(["python", "--version"]).result()

リソース

ワークロードのニーズに合わせて CPU とメモリを設定し、オーバープロビジョニングやアンダープロビジョニングを避けましょう。ResourceOptions を使用してリクエストと制限を設定します：

from sandbox_auth import AUTH
from cwsandbox import ResourceOptions, Sandbox

with Sandbox.run(
    resources=ResourceOptions(
        requests={"cpu": "2", "memory": "2Gi"},
        limits={"cpu": "2", "memory": "2Gi"},
    ),
    auth=AUTH,
) as sandbox:
    sandbox.exec(["python", "compute.py"]).result()

ResourceOptions は Kubernetes resource syntax を使用します:

リソース	形式	サンプル
CPU	コアまたはミリコア	`"1"`, `"2"`, `"500m"` (0.5 CPU)
メモリ	単位接尾辞付きのバイト	`"512Mi"`, `"1Gi"`, `"2Gi"`

マウントされたファイル

マウントされたファイルを使用すると、サンドボックスが起動する前に設定、スクリプト、またはその他の静的コンテンツをサンドボックスに配置できます。これにより、ワークロードは実行開始時に必要なものをすべて揃えられます。サンドボックスの起動時にファイルを事前投入します：

from sandbox_auth import AUTH
with Sandbox.run(
    mounted_files=[
        {"mount_path": "/app/config.json", "file_content": b'{"debug": true}'},
        {"mount_path": "/app/script.py", "file_content": b"print('hello')"},
    ],
    resources={"cpu": "1", "memory": "1Gi"},
    auth=AUTH,
) as sandbox:
    sandbox.exec(["python", "/app/script.py"]).result()

各エントリには、サンドボックス内の絶対パスである mount_path と、ファイルの内容をバイト列で表す file_content を指定します。str を渡した場合は、自動的に UTF-8 でエンコードされます。マウントされたファイルは読み取り専用です。変更が必要な file には write_file() を使用してください。

次のステップ

コンテナーイメージ、リソース割り当て、およびワークロードに必要な事前マウント済みファイルで開始するサンドボックスが用意できました。複数のサンドボックス間で再利用可能な設定にするには、SandboxDefaults を使用します。すべての ResourceOptions フィールド、GPU リソース、QoS クラス、および config-library 相互運用については、サンドボックスの設定ガイドを参照してください。

サンドボックス

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

サンドボックスの管理

リファレンス

設定

認証を選択する

`Sandbox.run()` に設定を渡す

リソース

マウントされたファイル

次のステップ

​認証を選択する

​Sandbox.run() に設定を渡す

​リソース

​マウントされたファイル

​次のステップ

認証を選択する

`Sandbox.run()` に設定を渡す

リソース

マウントされたファイル

次のステップ