← Sandbox SDK / sandbox / tutorials

Spuštění Devin Outposts na Cloudflare

Spustit Agenti Devin ↗ na Cloudflare. Každá relace Devin běží ve vlastním izolovaném sandboxu založeném na Cloudflare Containers.

Předpoklady

Budete potřebovat:

Organizace Devin Enterprise s oprávněním spravovat outposty a servisní uživatele
Účet Cloudflare s přístupem k Workers, Containers a R2
Pro ruční nasazení, Node.js 24 ↗ a běžící Docker ↗ daemon

Získejte přihlašovací údaje pro Devin

Otevřete nastavení outpostu organizace Devin. Nahraďte oba výskyty my-org v této URL slugem vaší organizace:
```
https://my-org.devinenterprise.com/org/my-org/settings/enterprise-environment?tab=outposts
```
Vytvořte nebo vyberte outpost. Zkopírujte jeho ID outpostu pro DEVIN_OUTPOST_ID a jeho token pro DEVIN_API_TOKEN.

Další informace o outpostech najdete v Přehled Devin Outposts ↗.

Nasaďte jedním kliknutím

Nejrychlejší nastavení používá Deploy to Cloudflare tlačítko. Proces nasazení vás vyzve k zadání Devin Outpost ID a API tokenu. Zároveň vytvoří a nakonfiguruje potřebné kontejnery.

Po zobrazení výzvy zadejte tyto přístupové údaje:

Proměnná	Hodnota
`DEVIN_OUTPOST_ID`	Vaše Devin Outpost ID
`DEVIN_API_TOKEN`	Token servisního uživatele Devin s Spouštění outpost workerů oprávnění

Po dokončení nasazení je váš outpost připraven spouštět relace Devin na Cloudflare, stačí ho vybrat v nabídce Virtual environment.

Přizpůsobit a nasadit ručně

Následující postup použijte, pokud potřebujete do šablony přidat závislosti, nástroje nebo proměnné prostředí.

Vytvořte projekt ze šablony Devin Outpost:
npm create cloudflare@latest -- cloudflare-devin-outpost --template=cloudflare/sandbox-sdk/devin
Přejděte do adresáře projektu a přihlaste se ke svému účtu Cloudflare:
```
cd cloudflare-devin-outpost
npx wrangler login
```
Vytvořte bucket R2 pro kontrolní body relací:
```
npx wrangler r2 bucket create devin-outpost-state
```
Chcete-li použít jiný název bucketu, aktualizujte bucket_name v wrangler.jsonc.
V wrangler.jsonc, nahraďte prázdné DEVIN_OUTPOST_ID hodnotu ID vašeho outpostu.

Výchozí DEVIN_API_URL je https://api.devin.ai/opbeta. Tuto hodnotu měňte pouze v případě, že vaše prostředí Devin používá jinou adresu URL API.
Uložte token Devin API jako tajný klíč Workeru:
```
npx wrangler secret put DEVIN_API_TOKEN
```
Zadejte token service-user, když k tomu Wrangler vyzve. Token nepřidávejte do wrangler.jsonc.
Nasaďte worker a kontejner:
```
npm run deploy
```
Wrangler sestaví kontejner a nasadí worker, kontejnerovou aplikaci a cron trigger.

Ověřte nasazení pomocí URL adresy workeru z výstupu Wrangler:

curl https://<YOUR_WORKER>.workers.dev/

Worker vrací:

{
  "service": "devin-outpost",
  "status": "ok"
}

Spuštění relace Devin

V Devin vytvořte relaci a vyberte svůj outpost z Virtuální prostředí menu. Worker dotazuje Devin jednou za minutu, takže na spuštění kontejneru relace možná budete muset počkat až minutu.

Jak šablona funguje

Šablona řídí životní cyklus každé relace Devin:

Dotazování: Cron Trigger se spouští jednou za minutu. Worker při tom kontroluje aktuální stavy session pro váš Devin Outpost.
Start: Každá čekající nebo běžící session dostane vlastní kontejner. Kontejner spouští oficiální příkaz Devin worker.
Pozastavení: Když se relace pozastaví, kontejner zaarchivuje /root, /workspace, a /opt/devin-persistent do R2. Kontejner checkpoint obnoví při obnovení relace.
Ukončení: Když relace skončí, Worker odstraní svůj kontejner i kontrolní bod v R2.

Worker koordinuje kontejnery. Přiřazování relací a běh relace nadále řídí Devin.