Docker Sandboxes
Docker Sandboxes
Docker Sandboxes가 뭔지, 어떤 곳에서 실행되는지부터 차근히 알아볼게요.
출처: 문서
본문
Docker Sandboxes는 AI 코딩 에이전트를 격리된 환경에서 실행해 주는 기능이에요. 이 환경은 여러분의 머신 위에 있거나 Docker가 관리하는 클라우드 인프라 위에 있죠. sbx CLI를 쓰면 두 종류의 샌드박스를 모두 만들고 관리할 수 있어요.
sbx CLI와 로컬 샌드박스 컴퓨팅은 상업적인 용도를 포함해서 무료로 쓸 수 있어요. 클라우드 컴퓨팅은 종량제(pay-as-you-go) 구독으로 이용하고요. 모델 제공 업체(Model provider) 요금은 별도로 부과돼요.
조직 관리자(Organization admins)는 개발자 머신 전반의 로컬 샌드박스에 대해 샌드박스 네트워크, 파일시스템, MCP 정책을 중앙에서 관리할 수 있어요. 이 기능은 별도의 유료 구독으로 이용할 수 있어요.
시작하기
sbx CLI를 설치하고 로그인한 다음, 에이전트를 어디서 실행할지 선택해요:
| 환경 | 어디에 쓸까요 | 시작하기 |
|---|---|---|
| 로컬 샌드박스 (Local sandboxes) | 머신의 파일과 지원되는 하드웨어를 다룰 때 | 로컬에서 시작하기 (Get started locally) |
| 클라우드 샌드박스 (Cloud sandboxes) | 로컬 가상화 없이 Docker 관리 컴퓨팅에서 실행할 때 | 클라우드에서 시작하기 (Get started in the cloud) |
두 환경은 각각 별도의 자격 증명(credentials), 네트워크 정책, 수명 주기(lifecycle) 제어를 가져요. 워크플로를 적용하기 전에 로컬과 클라우드 샌드박스 비교 를 먼저 확인해 보는 게 좋아요.
여러분의 애플리케이션에서 클라우드 샌드박스를 만들고 관리하고 싶다면 Sandboxes API and SDK 문서를 보세요.
더 알아보기 (Learn more)
아래 가이드들은 로컬 샌드박스 워크플로를 설명해요. 클라우드 워크플로가 필요하면 클라우드 샌드박스 문서를 보면 돼요.
- Agents — 지원되는 에이전트와 에이전트별 설정
- Workflows — Git, 로컬 개발, 인증, 에이전트 스킬, 자동화 패턴
- Configuration — 자격 증명 관리, 프로젝트 환경 선언, GPU 패스스루 켜기, 업스트림 프록시 설정
- Integrations — VS Code나 Cursor 같은 에디터와 앱을 SSH로 샌드박스에 연결하기
- MCP gateway — MCP 서버를 등록하고 샌드박스 에이전트에 연결하기
- Kits — 도구와 설정을 재사용 가능한 샌드박스 환경으로 패키징하기
- Architecture — microVM 격리, 워크스페이스 마운팅, 네트워킹
- Security — 격리 모델, 자격 증명 처리, 네트워크 정책
- CLI reference —
sbx명령과 옵션 전체 목록 - Troubleshooting — 흔한 문제와 해결 방법
- FAQ — 로그인 요구사항, 텔레메트리 등
피드백 (Feedback)
여러분의 피드백이 다음에 무엇을 만들지 결정해요. 버그를 발견하거나 빠진 기능, 혹은 제안이 있다면 github.com/docker/sbx-releases/issues 에 이슈를 열어 주세요.
더 알아보기 (Learn more)
관련 문서와 심화 내용은 원문을 참고해 주세요.