Skip to main content
配置によって、サンドボックスを実行するコンピュートが決まります。サーバーレスでは、CoreWeave が管理するマネージドコンピュートを使用します。クラスター配置では、組織内の CoreWeave Kubernetes Service (CKS) クラスターのコンピュートを使用します。スピルオーバーを使用すると、最初の配置が失敗した場合に、もう一方のモードでサンドボックスの作成が再試行されます。

配置モードを比較する

キャパシティとポリシーを誰が管理するかに基づいて、モードを選択します。 最初のサンドボックスを作成するには、サーバーレスのクイックスタートまたは独自のコンピュートを使用するの手順に従ってください。

認証情報を選択して取得する

使用する認証情報によって、サンドボックスを所有し、その使用料金を請求されるアカウントが決まります。Forge の APIキーはサーバーレスのサンドボックスに対応しています。CoreWeave API アクセストークンは、サーバーレスとクラスターの両方のサンドボックスに対応しています。

Forge APIキー

CoreWeave コンソールのアカウントを持っていない場合や、Forge での請求を希望する場合は、Forge APIキーを選択します。
  1. Forge APIキーの設定を開きます。サインインするか、同じリンクからアカウントを作成します。
  2. APIキーをコピーし、クライアントを実行するターミナルで設定します。
キーは明示的に渡す必要があります。Python では AuthHeaders を使用し、TypeScript では @coreweave/cwsandbox/wandb の createSandboxClient({apiKey: process.env.FORGE_API_KEY}) を使用します。完全な例については、サーバーレスのクイックスタートを参照してください。FORGE_API_KEY は説明用の変数名であり、SDK が自動的に検出する設定ではありません。

CoreWeave API アクセストークン

CoreWeave 組織の請求を利用する場合、またはその組織のクラスターでサンドボックスを実行する場合は、CoreWeave を選択します。
  1. サンドボックスを実行するには、Sandbox User ロールを付与する アクセスポリシー を作成または更新するよう管理者に依頼します。ランナーを有効化してそのポリシーを設定する管理者には、Sandbox Admin ロールが必要です。このロールにはサンドボックスの実行権限も含まれます。アクセスポリシーを作成する および サンドボックスのロール を参照してください。
  2. Tokens ページで Create Token をクリックし、トークンの詳細を入力して Create をクリックします。
  3. Token Secret をコピーし、クライアントを実行するターミナルで環境変数として設定します。
トークンを作成できない場合は、Access Token User ロールの付与を管理者に依頼してください。トークンシークレットは一度しか表示されません。詳細については、次を参照してください: API アクセストークンを管理する。 Python では AuthStrategy.COREWEAVE_API_KEY を選択します。TypeScript では @coreweave/cwsandbox/node からクライアントをインポートします。

配置モードを選択する

Python と TypeScript のどちらも、サーバーレス配置とクラスター配置をサポートしています。デフォルトはサーバーレスです。サポートされるモードの値については、PlacementMode リファレンスを参照してください。 クラスターの例はどちらも CWSANDBOX_API_KEY を読み取ります。まず認証情報のセットアップを完了してください。次に、独自のコンピュートを使用するの手順に従ってランナーを有効にするか、サーバーレスのクイックスタートの手順に従って TypeScript クライアントをインストールします。 クラスター配置を明示的に選択するには、次のようにします。
placement_mode="cks" を使用します。配置先を特定のランナーに限定するには、runner_ids を追加します。
runner_ids を指定しない場合、CKS 配置では組織内の条件を満たす任意のランナーが使用される可能性があります。サーバーレスの場合は、両方のフィールドを省略するか、runner_ids を指定せずに placement_mode="serverless" を設定します。

モード間のスピルオーバー

自動スピルオーバーは Python クライアントで利用できます。TypeScript クライアントはどちらの配置モードも選択できますが、自動スピルオーバーには対応していません。 スピルオーバーは、キャパシティ不足や適切なランナーがないなど、対象となる配置エラーが発生した場合に、もう一方のモードでサンドボックスの作成を 1 回だけ再試行します。実行中のサンドボックスをモード間で移動することはありません。 サーバーレスへのアクセス権と設定済みの CKS ランナーの両方を備えた組織の CoreWeave API アクセストークンを使用してください。Forge の APIキーだけでは CKS にアクセスできません。 CKS を優先し、利用できない場合にサーバーレスへフォールバックするには、placement_spillover="cks_then_serverless" を設定します。
この例では、両方の試行で CPU とメモリを指定しています。モードごとに独自のポリシーが適用されるため、リクエストは実行先のモードのポリシーを満たす必要があります。 フォールバックを制御するには、placement_spillover に次のいずれかのオプションを設定します。 サポートされるフォールバック値については、PlacementSpillover リファレンスを参照してください。リソースとタイムアウトの設定については、サンドボックスの設定を参照してください。
最終更新日 2026年10月15日