Cloudflare Containers, 에이전트 샌드박스 확장을 위한 재설계

주요 변경 사항

Cloudflare는 에이전트 워크로드에 최적화된 Cloudflare Containers의 재설계를 발표했다. 이번 업데이트를 통해 개발자는 런타임에 각 샌드박스의 이미지와 인스턴스 유형을 선택할 수 있게 되었다. 컨테이너 시작 속도는 기존 대비 6배 이상 빨라졌으며, 파일 시스템 스냅샷 기능이 공개 베타로 도입되어 워크스페이스의 영속성을 강화한다. 이러한 변화는 에이전트가 필요에 따라 즉시 샌드박스를 생성하고, 작업을 일시 중지 및 재개할 수 있도록 지원하는 데 중점을 둔다.

이를 위해 Cloudflare는 Containers 인프라를 근본적으로 재설계했다. 새로운 durable_object 스케줄링 정책은 각 샌드박스에 대한 제어권을 애플리케이션 코드로 이전한다. 또한, 재설계된 런타임은 컨테이너가 실행 상태에 도달하는 경로를 단축하여 전반적인 성능을 향상시켰다. 모든 컨테이너는 고유한 Durable Object와 연결되어 라이프사이클, 아웃바운드 트래픽 등을 관리하며, ctx.container API를 통해 Durable Object가 컨테이너를 직접 제어할 수 있는 기능이 추가되었다.

재설계 배경

기존 Cloudflare Containers는 애플리케이션 배포를 중심으로 설계되어, 이미지와 컴퓨팅 리소스가 배포 시점에 고정되고 중앙에서 관리되는 방식이었다. 그러나 에이전트 워크스페이스는 작업 중 온디맨드로 생성되며, 각 작업의 요구사항에 따라 이미지, 리소스, 도구, 시작 파일 시스템이 동적으로 결정되어야 한다. 에이전트 샌드박스는 몇 분 동안 존재하거나, 요청 사이에 절전 모드로 전환되거나, 며칠 후에 복원될 수 있는 유연성이 필요하다.

이러한 에이전트 워크로드의 특성은 샌드박스가 빠르게 시작되어야 한다는 요구사항으로 이어진다. Cloudflare는 Base44, Kilo Code, Cursor Cloud Agents, Devin Outposts, OpenAI Agents API, Claude Managed Agents 등 다양한 에이전트 시스템에서 이러한 패턴을 확인했다. 코딩 에이전트, 평가(Evals) 시스템, 강화 학습 시스템 등은 각기 다른 환경 설정과 상태 보존 능력을 필요로 하며, 이는 컨테이너의 구성, 스케줄링, 저장 방식에 대한 근본적인 재고를 촉발했다.

런타임 제어 및 성능

새로운 durable_object 스케줄링 정책은 런타임에 컨테이너의 이미지와 인스턴스 유형을 선택할 수 있도록 한다. 개발자는 wrangler.jsonc 파일에서 scheduling_policy를 durable_object로 설정하고, Durable Object가 사용할 수 있는 이미지를 선언한다. 이후 Durable Object 코드 내에서 this.ctx.container.images를 통해 선언된 이미지를 참조하여, 작업의 필요에 따라 this.ctx.container.run() 메서드로 컨테이너를 시작할 때 이미지와 인스턴스 유형을 동적으로 지정할 수 있다. 이전에는 이미지와 인스턴스 유형 조합마다 별도의 애플리케이션 배포가 필요했지만, 이제는 코드 내 조건문으로 유연하게 처리할 수 있다.

컨테이너 시작 속도도 크게 개선되었다. ComputeSDK의 독립 벤치마크 결과, 컨테이너의 중앙값 시작 시간은 기존 4.049초에서 648밀리초로 약 6.2배 빨라졌다. 95번째 백분위수는 5.839초에서 910밀리초로 6.4배, 99번째 백분위수는 6.717초에서 1129밀리초로 5.9배 빨라졌다. Cloudflare의 예비 버스트 테스트에서는 단일 계정으로 6개 위치에서 10만 개의 컨테이너를 5.387초 만에 시작하는 데 성공했다.

이러한 성능 향상은 Durable Object가 컨테이너를 시작할 때 동일한 머신에서 용량을 먼저 찾고, 이미지나 스냅샷이 로컬 스토리지에 있는 호스트를 선호하는 새로운 스케줄링 방식 덕분이다. 또한, 새로운 런타임은 처음부터 새 가상 머신을 부팅하는 대신, 할당되지 않은 준비된 가상 머신을 복원하여 재사용한다. 네트워킹 및 파일 시스템 설정을 재사용하고, 반복 작업을 일괄 처리하며, 첫 명령에 필요 없는 서비스 대기를 제거하여 시작 시간을 단축한다.

롤아웃 및 이미지 관리

durable_object 스케줄링 정책은 컨테이너 롤아웃 방식을 간소화한다. 기존에는 이미지 업데이트 시 전체 애플리케이션을 업데이트하고, 유예 기간 설정, 트래픽 분할 정의 등 복잡한 롤아웃 구성이 필요했다. 그러나 새로운 정책에서는 롤아웃 구성이 전혀 필요하지 않다. 컨테이너는 시작된 이미지를 계속 실행하며, Durable Object가 다음에 컨테이너를 시작할 때 코드에서 선택한 이미지를 사용한다.

이러한 변화를 통해 개발자는 롤아웃 전략을 Durable Object 코드 내에서 직접 구현할 수 있다. 예를 들어, Durable Object ID를 해싱하여 새로운 샌드박스의 5%에 새로운 툴체인을 카나리 테스트하거나, 활성 프로젝트를 현재 이미지에 고정하여 작업 중 환경이 변경되지 않도록 할 수 있다. 또한, 다음 세션이나 스냅샷 생성 후와 같은 자연스러운 체크포인트에서 워크스페이스를 마이그레이션하거나, 미래 시작 시 선택할 이미지를 변경하여 쉽게 롤백하는 것도 가능하다. 롤아웃 정책이 코드에 통합됨으로써, 개발자는 더 유연하고 정교한 제어를 할 수 있다.

Cloudflare는 에이전트 환경 구성을 더욱 간소화하기 위해 cloudflare/debian-trixie라는 준비된 시스템 이미지를 제공한다. 이 이미지에는 Debian Trixie Slim과 Node.js 24.20.0 LTS가 포함되어 있어, 개발자는 Dockerfile을 생성하거나 이미지를 빌드하고 푸시하는 과정 없이 즉시 Linux 샌드박스를 시작할 수 있다. 샌드박스가 실행된 후에는 exec() 명령을 사용하여 리포지토리를 클론하고, 패키지를 설치하며, 작업에 필요한 환경을 구성할 수 있다. Cloudflare가 이 이미지를 관리하므로, 요청이 도착하기 전에 적격 컨테이너 호스트에 미리 배포 및 준비되어 사용자의 대기 시간을 줄인다.

파일 시스템 스냅샷

새로운 파일 시스템 스냅샷 기능은 에이전트 워크스페이스의 영속성을 강화한다. 이 기능은 공개 베타로 제공되며, 에이전트가 준비된 환경에서 작업을 시작하고, 작업이 일시 중지될 때 워크스페이스를 저장하며, 세션이 재개될 때 해당 파일을 복원할 수 있도록 한다. 개발자는 this.ctx.container.snapshotContainer() 메서드를 사용하여 컨테이너의 스냅샷을 생성하고, Durable Object 스토리지에 저장한 후, containerSnapshot 옵션을 통해 해당 스냅샷에서 컨테이너를 시작할 수 있다.

스냅샷은 두 가지 주요 활용 패턴을 가능하게 한다. 첫째, 하나의 워크스페이스가 여러 세션에 걸쳐 지속될 수 있다. 예를 들어, 코딩 에이전트가 작업 완료 후 워크스페이스를 저장하고 다음 날 복원할 때, 리포지토리, 설치된 종속성, 빌드 캐시, 구성 및 편집 내용이 환경을 재구축할 필요 없이 즉시 사용 가능하다. 둘째, 스냅샷은 여러 샌드박스에 대한 공유 체크포인트를 제공할 수 있다. 스냅샷은 불변하며 재사용 가능하므로, 여러 컨테이너가 동일하게 준비된 환경에서 독립적으로 시작하여 각자의 변경 사항을 적용할 수 있다. 이는 에이전트 평가와 같은 시나리오에서 설정 시간을 줄이고 환경 드리프트가 결과에 미치는 영향을 방지하는 데 유용하다.

개발자 영향 및 마이그레이션

이번 업데이트는 Durable Object를 컨테이너의 컨트롤러로 더욱 활용하는 방향으로 설계되었다. 에이전트 시스템은 컨테이너 외부에서 상태를 유지하고, 자격 증명을 보관하며, 샌드박스의 라이프사이클을 제어할 수 있는 프로그래밍 가능하고 상태 저장 환경을 필요로 한다. Durable Object는 이러한 요구사항에 적합하며, 에이전트가 Linux 워크스페이스가 절전 모드일 때도 계속 사용 가능하게 하거나, 컨테이너의 보안 경계를 프로그래밍 방식으로 제어하는 등의 고급 패턴을 구현할 수 있도록 한다.

새로운 durable_object 스케줄링 정책을 통해 Durable Object는 이제 래퍼 클래스 없이 컨테이너를 직접 제어할 수 있다. exec() 명령 실행, 아웃바운드 요청 가로채기, 런타임 이미지 및 인스턴스 선택, 파일 시스템 스냅샷 기능은 모두 ctx.container를 통해 직접 사용할 수 있다. 이는 컨테이너를 Durable Object의 컴퓨팅 확장으로 만들어, 컨테이너가 Linux 환경을 제공하고 Durable Object가 샌드박스의 ID, 상태, 정책 및 라이프사이클을 유지하도록 한다.

Cloudflare는 기존 Container 클래스와 레거시 Sandbox 클래스를 2026년 12월 31일까지 유지할 예정이다. 이 날짜 이후에도 기존 배포는 계속 실행되지만, 해당 클래스에는 더 이상 업데이트가 제공되지 않는다. 따라서 개발자는 ctx.container로 마이그레이션하는 것이 권장된다. Sandbox SDK 1.0은 이제 기본 클래스가 아닌 유틸리티 세트로 제공되어, 개발자의 Durable Object 클래스 내에서 ctx.container와 함께 작동한다. 마이그레이션은 일반적으로 extends Container를 extends DurableObject로 변경하고 this.ctx.container를 직접 호출하는 방식으로 이루어진다.