配置モードを比較する
キャパシティとポリシーを誰が管理するかに基づいて、モードを選択します。
最初のサンドボックスを作成するには、サーバーレスのクイックスタートまたは独自のコンピュートを使用するの手順に従ってください。
認証情報を選択して取得する
使用する認証情報によって、サンドボックスを所有し、その使用料金を請求されるアカウントが決まります。Forge の APIキーはサーバーレスのサンドボックスに対応しています。CoreWeave API アクセストークンは、サーバーレスとクラスターの両方のサンドボックスに対応しています。Forge APIキー
CoreWeave コンソールのアカウントを持っていない場合や、Forge での請求を希望する場合は、Forge APIキーを選択します。- Forge APIキーの設定を開きます。サインインするか、同じリンクからアカウントを作成します。
-
APIキーをコピーし、クライアントを実行するターミナルで設定します。
AuthHeaders を使用し、TypeScript では @coreweave/cwsandbox/wandb の createSandboxClient({apiKey: process.env.FORGE_API_KEY}) を使用します。完全な例については、サーバーレスのクイックスタートを参照してください。FORGE_API_KEY は説明用の変数名であり、SDK が自動的に検出する設定ではありません。
CoreWeave API アクセストークン
CoreWeave 組織の請求を利用する場合、またはその組織のクラスターでサンドボックスを実行する場合は、CoreWeave を選択します。- サンドボックスを実行するには、Sandbox User ロールを付与する アクセスポリシー を作成または更新するよう管理者に依頼します。ランナーを有効化してそのポリシーを設定する管理者には、Sandbox Admin ロールが必要です。このロールにはサンドボックスの実行権限も含まれます。アクセスポリシーを作成する および サンドボックスのロール を参照してください。
- Tokens ページで Create Token をクリックし、トークンの詳細を入力して Create をクリックします。
-
Token Secret をコピーし、クライアントを実行するターミナルで環境変数として設定します。
AuthStrategy.COREWEAVE_API_KEY を選択します。TypeScript では @coreweave/cwsandbox/node からクライアントをインポートします。
配置モードを選択する
Python と TypeScript のどちらも、サーバーレス配置とクラスター配置をサポートしています。デフォルトはサーバーレスです。サポートされるモードの値については、PlacementMode リファレンスを参照してください。
クラスターの例はどちらも CWSANDBOX_API_KEY を読み取ります。まず認証情報のセットアップを完了してください。次に、独自のコンピュートを使用するの手順に従ってランナーを有効にするか、サーバーレスのクイックスタートの手順に従って TypeScript クライアントをインストールします。
クラスター配置を明示的に選択するには、次のようにします。
- Python
- 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" を設定します。
placement_spillover に次のいずれかのオプションを設定します。
サポートされるフォールバック値については、
PlacementSpillover リファレンスを参照してください。リソースとタイムアウトの設定については、サンドボックスの設定を参照してください。