Docker Sandboxes API 및 SDK
Docker Sandboxes API 및 SDK
Docker Sandboxes API를 사용하면 애플리케이션과 자동화 워크플로에서 클라우드 샌드박스를 만들고, 명령을 실행하고, 파일을 전송할 수 있어요. 이미지, 스냅샷, 볼륨, 시크릿을 포함한 관련 리소스도 관리할 수 있죠.
출처: 문서
본문
참고: Docker Sandboxes API와 SDK는 실험적이에요. 기능, 인터페이스, 동작이 바뀔 수 있어요.
시도해 보려면 TypeScript SDK로 첫 번째 클라우드 샌드박스를 실행해 보세요. 이 튜토리얼은 명령 실행용 셸 환경을 제공하는 번들 키트(bundled kit)를 사용해요.
클라우드 접근 활성화
API나 SDK를 사용하려면 Docker Agentic Platform 구독을 활성화하세요. 애플리케이션 인증에는 같은 Docker 계정을 사용해요.
클라우드 컴퓨팅은 Docker 구독과 별도로 청구돼요. 자세한 내용은 Billing 문서를 참고해 주세요.
인터페이스 선택
JavaScript나 TypeScript 애플리케이션에서 TypeScript SDK를 사용하세요. SDK는 타입이 있는 요청과 응답을 제공하고, 샌드박스가 시작되거나 중지될 때까지 기다리며, 파일 전송과 인터랙티브 프로세스를 처리해요. 설치 안내는 SDK 설치 문서를 참고해 주세요.
또한 어떤 언어나 HTTP 도구에서도 REST API를 직접 호출할 수 있어요. 연산, 요청 필드, 응답, 다운로드 가능한 OpenAPI 스펙은 API 레퍼런스를 참고해 주세요.
터미널에서 에이전트를 실행하려면 Docker Sandboxes 문서를 참고해 주세요.
애플리케이션 개발
- SDK 쿡북: 프로세스, 파일, 스토리지, 네트워킹 및 기타 샌드박스 연산의 예시를 따라 해 보세요.
- API 개념: 키트나 이미지를 선택하고, 리소스를 식별하고, 작업이 끝날 때까지 기다려요.
- 인증과 권한 부여: Docker 계정으로 인증하고 애플리케이션에 필요한 권한을 이해해요.
- 오류와 재시도: 실패를 처리하고 작업을 중복하지 않고 요청을 재시도해요.
- 컴퓨트 크기와 제한: 리소스를 선택하고 계정 할당량과 요청 속도 제한을 처리해요.