設定 - CoreWeave Docs

これらの例では、CWSANDBOX_API_KEY に設定した CoreWeave API アクセストークンを使用します。Forge APIキーによる認証については、はじめにを参照してください。CKS の要件については、配置モードを参照してください。このチュートリアルでは、Sandbox.run() にオプションを渡すことで起動時にサンドボックスを設定する方法を説明します。基本的なサンドボックスはすでに作成済みで、コンテナーイメージ、リソース割り当て、およびワークロード用の事前配置ファイルの制御を希望する開発者を対象としています。

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

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

from cwsandbox import Sandbox

with Sandbox.run(
    container_image="python:3.11",
    max_lifetime_seconds=300,
    tags=["my-app"],
) as sandbox:
    sandbox.exec(["python", "--version"]).result()

リソース

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

from cwsandbox import ResourceOptions, Sandbox

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

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

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

マウントされたファイル

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

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')"},
    ]
) 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()` に設定を渡す

リソース

マウントされたファイル

次のステップ