샌드박스에서 Devin Outposts 실행하기

​

사전 요구 사항

• Outposts가 활성화된 Devin 조직. Devin Cloud의 설정 > 환경에 Outposts가 보이지 않으면 Devin Admin에게 문의하세요.
• SANDBOX_USER 액션이 부여된 CoreWeave API 액세스 토큰.
• SDK를 직접 사용하는 경우 Python 3.11 이상과 uv, 또는 Node.js 22 이상.

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

​

Devin Cloud에서 outpost 생성

1. Devin Cloud에서 Settings > Environment > Outposts로 이동하세요.
2. Create Outpost를 클릭하고, 이름을 입력한 후 Linux를 선택하세요.
3. outpost 토큰을 복사하세요. Devin Cloud는 이 토큰을 한 번만 표시합니다.

​

cws-agent 빠른 시작

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

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

​

Sandboxes SDK로 설정

​

사용자 인증 정보 설정 및 클라이언트 설치

export DEVIN_OUTPOSTS_TOKEN="[OUTPOST-TOKEN]"

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

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

​

워커 시작

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}")

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}`);

python start_outpost_worker.py [OUTPOST-NAME]

npx tsx start_outpost_worker.mts [OUTPOST-NAME]

​

선택: 시크릿 스토어 사용

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

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",
)

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

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

​

Devin 세션 실행 및 확인

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

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

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);

​

워커 확인 및 중지

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);
}

cws-agent down [SANDBOX-NAME]

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 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 리소스만 사용합니다.
• 워커 추가 실행. 워커 하나는 한 번에 하나의 세션만 처리합니다. 같은 outpost 이름으로 스크립트를 다시 실행하면 해당 큐에 워커를 하나 더 시작할 수 있습니다.
• 세션마다 샌드박스 생성. 이 예시의 워커는 여러 세션에서 같은 샌드박스를 재사용합니다. 세션마다 새 샌드박스를 사용하려면 Devin의 오케스트레이션 가이드를 참조하세요.