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

Devin Outposts では、Devin の計画立案とモデル推論は Devin Cloud で行われます。一方、コマンドの実行、ファイルの編集、リポジトリへのアクセスは、お客様が運用するマシン上で Devin が行います。このガイドでは、そのマシンとして CoreWeave のサンドボックスを使用します。サンドボックスは、イメージ、CPU、メモリ、GPU、有効期間を任意に指定できる分離環境です。アウトポストとは、Devin Cloud 上の名前付きキューです。ワーカーとは devin worker プロセスのことで、アウトバウンド HTTPS で Devin Cloud に接続し、キューからセッションを取得してローカルで実行します。インバウンドのポート、パブリック IP アドレス、仮想プライベートネットワーク (VPN) は必要ありません。このガイドでは、1 つのサンドボックスで 1 つのワーカーを実行します。そのワーカーは、サンドボックスが存続している間、セッションを順番に処理します。各ワーカーが同時に処理できる実行中のセッションは 1 つだけです。それ以外のセッションは、ワーカーが空くまで待機します。このガイドでは、起動するワーカーの数は固定です。セッションがキューに溜まっても、サンドボックスが自動で追加されることはありません。ワーカーを手動で追加起動するか、オーケストレーターを使用して自動的にプロビジョニングしてください。

前提条件

始める前に、次のものが揃っていることを確認してください。

Outposts が有効になっている Devin 組織。Devin Cloud の Settings > Environment に Outposts が表示されない場合は、Devin の管理者に問い合わせてください。
SANDBOX_USER action が付与された CoreWeave API アクセストークン。
SDK (ソフトウェア開発キット) を直接使用する場合は、Python 3.11 以降と uv、または Node.js 22 以降。

このガイドの手順を実行するターミナルで、CoreWeave API アクセストークンをエクスポートします。

export CWSANDBOX_API_KEY="[API-ACCESS-TOKEN]"

Devin Cloud でアウトポストを作成する

アウトポストを作成してトークンを取得するには、次の手順に従います。

Devin Cloud で、Settings > Environment > Outposts に移動します。
Create Outpost をクリックし、名前を入力して Linux を選択します。
アウトポストのトークンをコピーします。トークンは Devin Cloud で一度しか表示されません。

アウトポストの準備が完了したら、cws-agent または Sandboxes SDK のいずれかでワーカーを起動し、検証セッションを実行します。

cws-agent によるクイックスタート

cws-agent のインストール手順に従ってください。このツールは、ファイルシステムスナップショットでワークスペースを保存およびリストアするためのスナップショットボリュームを設定します。 [OUTPOST-TOKEN] はコピーしたトークンに、[OUTPOST-NAME] はアウトポスト名に、[SANDBOX-NAME] はこのサンドボックス用の cws-agent セッション名に置き換えてください。セッション名は英小文字、数字、ハイフンを使用した 1～40 文字で指定し、先頭は英字または数字にしてください。

export DEVIN_OUTPOSTS_TOKEN="[OUTPOST-TOKEN]"
cws-agent launch [SANDBOX-NAME] --outpost [OUTPOST-NAME]

このツールはトークンをサンドボックスに渡し、ワーカーを 1 つ起動します。ワーカーのターミナルを表示するには、次のコマンドを実行します。

cws-agent connect [SANDBOX-NAME] --cmd 'tmux attach -t outpost-0'

Ctrl-b を押してから d を押してデタッチし、Devin セッションを実行して検証するに進みます。このワーカーは Devin Cloud に接続します。--agent devin で起動する対話型の Devin コマンドラインインターフェース (CLI) とは別のものです。

Sandboxes SDK を使用して設定する

cws-agent を使用せずにワーカーを直接起動する場合は、この代替手段を使用します。この方法では永続ストレージは構成されません。 Python のスニペットは、認証情報を設定してクライアントをインストールするで作成した仮想環境で実行してください。TypeScript のスニペットは、クライアントをインストールしたプロジェクトに .mts ファイルとして保存し、npx tsx [FILENAME].mts で実行してください。

認証情報を設定してクライアントをインストールする

スクリプトを実行するターミナルで、アウトポストの作成時にコピーしたトークンをエクスポートします。

export DEVIN_OUTPOSTS_TOKEN="[OUTPOST-TOKEN]"

クライアントを選択し、ローカルにインストールします。

Python
TypeScript

Python 3.11 以降と uv を使用します。

uv venv --python 3.11
source .venv/bin/activate
uv pip install 'cwsandbox>=1.14.2'

Node.js 22 以降を使用します。お使いのプロジェクトにクライアントと TypeScript ランナーをインストールしてください。

npm install @coreweave/cwsandbox@0.5.0-beta.0 tsx

ワーカーを起動する

ワーカーの起動時間を短縮するには、Devin CLI、Git、言語ランタイム、プロジェクトの依存関係をプリインストールした独自のイメージを使用してください。Python では container_image、TypeScript では containerImage にそのイメージを指定します。イメージに Git と認証局 (CA) 証明書がすでに含まれている場合は、例から apt-get コマンドを削除してください。

次のスクリプトは、Cognition の公式ワーカーイメージからサンドボックスを作成し、サンドボックスのメインコマンドとして devin worker を実行します。クライアントはローカル環境から DEVIN_OUTPOSTS_TOKEN を読み取り、その値をサンドボックスリクエストに含めて渡すことで、ワーカーの環境変数を設定します。ワーカーの出力はサンドボックスのログとして記録されます。ワーカーがエラーで終了した場合、プラットフォームは再起動の上限に達するまでコンテナーを再起動します。

Python
TypeScript

start_outpost_worker.py

import os
import sys

from cwsandbox import ResourceOptions, Sandbox

outpost = sys.argv[1]

# ワーカーイメージには Devin CLI が含まれていますが、Devin がリポジトリを
# クローンするために必要な git は含まれていません。git をインストールしてから、プロセスをワーカーに引き渡します。
command = """
apt-get update -qq
DEBIAN_FRONTEND=noninteractive apt-get install -y -qq git ca-certificates >/dev/null
mkdir -p /workspace
cd /workspace
exec devin worker start --outpost="$DEVIN_OUTPOST"
"""

sandbox = Sandbox.run(
    "bash", "-ec", command,
    container_image="public.ecr.aws/e0h8a4b6/devin-cli:stable",
    environment_variables={
        "DEVIN_OUTPOSTS_TOKEN": os.environ["DEVIN_OUTPOSTS_TOKEN"],
        "DEVIN_OUTPOST": outpost,
    },
    max_lifetime_seconds=8 * 3600,
    resources=ResourceOptions(
        requests={"cpu": "2", "memory": "4Gi"},
        limits={"cpu": "2", "memory": "4Gi"},
    ),
    tags=["devin-outpost-worker"],
)
try:
    sandbox.wait()
except BaseException:
    sandbox.stop().result()
    raise

print(f"Worker sandbox ID: {sandbox.sandbox_id}")

start_outpost_worker.mts

import { createSandboxClientFromEnv } from "@coreweave/cwsandbox/node";

const token = process.env.DEVIN_OUTPOSTS_TOKEN;
if (!token) throw new Error("Set DEVIN_OUTPOSTS_TOKEN.");
const outpost = process.argv[2];
if (!outpost) throw new Error("Pass an outpost name.");

const command = `
apt-get update -qq
DEBIAN_FRONTEND=noninteractive apt-get install -y -qq git ca-certificates >/dev/null
mkdir -p /workspace
cd /workspace
exec devin worker start --outpost="$DEVIN_OUTPOST"
`;

const client = createSandboxClientFromEnv();
const sandbox = await client.run(["bash", "-ec", command], {
  containerImage: "public.ecr.aws/e0h8a4b6/devin-cli:stable",
  environmentVariables: {
    DEVIN_OUTPOSTS_TOKEN: token,
    DEVIN_OUTPOST: outpost,
  },
  resources: { cpu: "2", memory: "4Gi" },
  maxLifetimeSeconds: 8 * 3600,
  waitUntilRunning: false,
  tags: ["devin-outpost-worker"],
});
try {
  await sandbox.wait();
} catch (error) {
  await sandbox.stop();
  throw error;
}
console.log(`Worker sandbox ID: ${sandbox.sandboxId}`);

Devin Cloud でアウトポストを作成するで作成したアウトポスト名を指定して、スクリプトを実行します。

Python
TypeScript

python start_outpost_worker.py [OUTPOST-NAME]

npx tsx start_outpost_worker.mts [OUTPOST-NAME]

Python の sandbox.wait() は、サンドボックスが実行中になった時点、またはすでに完了している場合に制御を返します。その時点ではインストールやワーカーの認証がまだ完了していない可能性があるため、タスクを送信する前にワーカーの状態を確認してください。ワーカーは /workspace を作業ディレクトリとして起動します。your-org/app のセッションでは、リポジトリが /workspace/repos/app 配下にチェックアウトされます。このスクリプトは with ブロックを使用していないため、スクリプトの終了後も実行中のサンドボックスは動作し続けます。

max_lifetime_seconds は厳格な上限であり、後から延長することはできません。期限に達するとプラットフォームがサンドボックスを終了するため、そのワーカーを使用しているすべてのセッションで実行が中断されます。このスクリプトでは、スナップショットや Persistent Volume は設定していません。コンテナーが再起動すると、/workspace 配下のファイルを含め、書き込み可能なファイルシステムはリセットされます。結果は、Devin がプッシュ先とするリポジトリなど、サンドボックスの外部に保存してください。

オプション: シークレットストアを使用する

アウトポストトークンの値の代わりに Forge シークレット参照を渡すことができます。このオプションには、Forge 認証とサーバーレス配置が必要です。アウトポストトークンを Forge チームの Secret Manager に保存してから、そのチームの認証情報をエクスポートします。

export FORGE_API_KEY="[FORGE-API-KEY]"
export FORGE_TEAM="[FORGE-TEAM]"

これらの認証情報を使用して、SDK を明示的に設定してください。FORGE_API_KEY と FORGE_TEAM は説明用の環境変数名であるため、SDK はこれらを自動的に検出しません。

Python
TypeScript

サンドボックスを作成する前に、AuthHeaders をインポートして auth を定義します。

import os

from cwsandbox import AuthHeaders

auth = AuthHeaders(
    headers={
        "x-wandb-api-key": os.environ["FORGE_API_KEY"],
        "x-entity-id": os.environ["FORGE_TEAM"],
    },
    strategy="wandb_api_key",
)

Sandbox.run() に auth=auth を渡します。以降の Python の例でもこの設定を含め、Sandbox.from_id() を呼び出す際にも必ず auth=auth を渡してください。

クライアントのインポートと初期化を次の内容に置き換えます。以降の TypeScript の例でも、このクライアント設定を使用してください。

import { createSandboxClient } from "@coreweave/cwsandbox/wandb";

const client = createSandboxClient({
  apiKey: process.env.FORGE_API_KEY,
  entity: process.env.FORGE_TEAM,
});

[SECRET-NAME] はチームシークレットの名前に置き換えてください。

Python
TypeScript

cwsandbox から Secret をインポートし、environment_variables から DEVIN_OUTPOSTS_TOKEN を削除したうえで、Sandbox.run() に secrets=[Secret(store="wandb", name="[SECRET-NAME]", env_var="DEVIN_OUTPOSTS_TOKEN")] を追加します。

const token の宣言と、それに続く if (!token) チェックを削除します。environmentVariables から DEVIN_OUTPOSTS_TOKEN を削除し、client.run() に渡すオプションに secrets: [{ store: "wandb", name: "[SECRET-NAME]", envVar: "DEVIN_OUTPOSTS_TOKEN" }] を追加します。

これで、アウトポストトークンをローカルでエクスポートする必要はなくなります。参照はプラットフォームによって解決され、ワーカーの環境変数に設定されます。

Devin セッションを実行して検証する

テストには、このワーカーのみが接続され、キューに追加されたセッションや実行中のセッションが他にないアウトポストを使用してください。このテスト用に、シークレットではない一意の値を決めて、以下のタスク内の [PROOF-VALUE] をその値に置き換えます。Devin Cloud で新しいセッションを開始し、Configuration > Virtual environment でアウトポストを選択します。続いて、Write the exact text で始まる以下のタスクを送信します。Slack を使用する場合は、次のメッセージ全文を送信してください。

@Devin !outpost [OUTPOST-NAME] Write the exact text [PROOF-VALUE] to /workspace/outpost-proof.txt and read the file back. Report its contents.

Devin が完了を報告したら、ご利用の環境に対応するコマンドを使用して、ご自身のターミナルからファイルを読み取ります。[SANDBOX-NAME] を cws-agent のワークスペース名に、または [SANDBOX-ID] を SDK スクリプトが出力した ID に置き換えてください。

cws-agent
Sandboxes SDK

cws-agent exec [SANDBOX-NAME] 'cat /workspace/outpost-proof.txt'

Python
TypeScript

from cwsandbox import Sandbox

sandbox = Sandbox.from_id("[SANDBOX-ID]").result()
result = sandbox.exec(["cat", "/workspace/outpost-proof.txt"], check=True).result()
print(result.stdout, end="")

import { createSandboxClientFromEnv } from "@coreweave/cwsandbox/node";

const client = createSandboxClientFromEnv();
const sandbox = await client.fromId("[SANDBOX-ID]");
const result = await sandbox.commands.run(["cat", "/workspace/outpost-proof.txt"], { check: true });
process.stdout.write(result.stdout);

出力が指定した一意の値と一致することを確認してください。そのサンドボックスの ID を指定して読み取ることで、セッションによるファイル書き込みが、作成したサンドボックス上で行われたことを確認できます。また、絶対パスを使用しているため、セッションの作業ディレクトリに依存しません。セッションがキューに追加されたままの場合は、次のセクションの手順に従ってワーカーのログを確認してください。以前のセッションを処理中のワーカーは、そのセッションが終了または一時停止されるまで、別のセッションを取得できません。以前のセッションが不要であれば、Devin Cloud で終了してください。または、別のワーカーを起動することもできます。

ワーカーを確認して停止する

cws-agent の場合は、クイックスタートで示したとおりワーカーのターミナルにアタッチします。SDK を使用する場合は、ステータスと最近のログを確認します。[SANDBOX-ID] は出力された ID に置き換えてください。

Python
TypeScript

from cwsandbox import Sandbox

sandbox = Sandbox.from_id("[SANDBOX-ID]").result()
print("Sandbox status:", sandbox.get_status())
for container in sandbox.container_statuses:
    print(container.name, container.state, container.exit_code, container.restart_count)
for line in sandbox.stream_logs(tail_lines=100):
    print(line, end="")

import { createSandboxClientFromEnv } from "@coreweave/cwsandbox/node";

const client = createSandboxClientFromEnv();
const sandbox = await client.fromId("[SANDBOX-ID]");
console.log("Sandbox status:", sandbox.status, "Exit code:", sandbox.exitCode);
for (const line of await sandbox.logs.read({ tailLines: 100 })) {
  process.stdout.write(line);
}

新しいログを取得するには、この確認を再度実行します。Python クライアントでは、コンテナーごとの状態、終了コード、再起動回数も確認できます。TypeScript クライアントでは、これらの詳細は取得できません。 Outposts API がワーカーのトークンを拒否したことがログに記録されている場合は、アウトポストの作成時にコピーしたトークンを使用しているかどうか、またそのトークンがアウトポストを所有するアカウントのものであるかどうかを確認してください。代わりにサービスユーザーの v3 API トークンを使用する場合は、そのロールに Outposts write (account.outposts.write) の権限が必要です。認証情報を修正したうえで、サンドボックスを再作成してください。ワーカーが終了と再起動を繰り返していても、サンドボックスのステータスが running と表示される場合があります。ログを確認し、Python クライアントを使用している場合は、前述の例で示したコンテナーごとの詳細も確認してください。認証に失敗し続けるワーカーは、代わりのワーカーを作成する前に停止してください。起動に失敗し、原因を特定できる情報が得られない場合は、サンドボックス ID とログを保存し、CoreWeave Support にお問い合わせください。ワーカーが不要になったら、サンドボックスを停止してください。サーバーレスのセットアップについては、はじめにを参照してください。実行中の Devin セッションが完了して結果が保存されるのを待ってから、ご利用の構成に応じたコマンドでコンピュートを停止します。

cws-agent
Sandboxes SDK

cws-agent down [SANDBOX-NAME]

down は停止前にワークスペースのスナップショットを作成します。スナップショットの取得に失敗した場合は、表示されたエラーと cws-agent status [SANDBOX-NAME] の出力を確認し、問題を解決してから再試行してください。保存されていない変更を破棄してもかまわない場合は、cws-agent down [SANDBOX-NAME] --no-snapshot を使用します。

Python
TypeScript

from cwsandbox import Sandbox

sandbox = Sandbox.from_id("[SANDBOX-ID]").result()
sandbox.stop().result()

import { createSandboxClientFromEnv } from "@coreweave/cwsandbox/node";

const client = createSandboxClientFromEnv();
const sandbox = await client.fromId("[SANDBOX-ID]");
await sandbox.stop();

この例では永続マウントを使用していません。停止する前に、ファイルを外部にコピーするか、変更をリポジトリにプッシュしてください。

Devin セッションを終了しても、このワーカーのサンドボックスは停止しません。cws-agent のワークスペースをリストアする方法については、Devin Outposts ガイドを参照してください。

オプション: 環境をカスタマイズする

ワーカー環境は、次の方法でカスタマイズできます。

独自のイメージを使用する。 公式イメージには devin CLI 以外ほとんど何も含まれていません。公式イメージをベースに独自のツールチェーンを追加したイメージをビルドし、Python では container_image、TypeScript では containerImage として渡します。Devin には git が必要です。画面録画には ffmpeg が、ブラウザーツールとコンピューター操作ツールには互換性のあるブラウザーのバイナリが必要です。公式 Ubuntu イメージをベースにした amd64 イメージの場合は、Google Chrome をインストールしてください。Ubuntu の chromium パッケージは snap のスタブであり、コンテナー内では動作しません。詳しくは Devin のコンテナーセットアップを参照してください。また、コンピューター操作を行うには、Xvfb などのグラフィカルディスプレイが実行されており、ワーカーに DISPLAY が設定されている必要があります。ワーカーは標準のインストール場所を検索します。バイナリが見つからない場合は、DEVIN_CHROME_PATH にその絶対パスを設定してください。詳しくは Devin Outposts リファレンスを参照してください。
GPU を設定する。 使用可能なオプションについては、サンドボックスの GPU 設定を参照してください。このガイドのワーカーの例では CPU リソースのみを使用します。
ワーカーを増やす。 1 つのワーカーが同時に処理できるセッションは 1 つだけです。同じアウトポスト名でスクリプトを再度実行すると、そのキューに別のワーカーが追加で起動します。
セッションごとにサンドボックスを作成する。 この例のワーカーは、複数のセッションで同じサンドボックスを使い回します。セッションごとに新しいサンドボックスを用意する方法については、Devin のオーケストレーションガイドを参照してください。