Skip to main content
배치는 샌드박스를 어떤 컴퓨팅에서 실행할지 결정합니다. 서버리스는 CoreWeave에서 관리하는 컴퓨팅을 사용합니다. 클러스터 배치는 조직의 CoreWeave Kubernetes Service(CKS) 클러스터에 있는 컴퓨팅을 사용합니다. 대체 배치로 재시도는 초기 배치에 실패하면 다른 모드에서 샌드박스 생성을 다시 시도합니다.

배치 모드 비교

용량과 정책을 누가 관리하는지에 따라 모드를 선택하세요. 첫 번째 샌드박스를 만들려면 서버리스 퀵스타트 또는 자체 컴퓨팅 사용 가이드를 따르세요.

사용자 인증 정보 선택 및 발급

사용하는 사용자 인증 정보에 따라 샌드박스를 소유하고 사용 요금을 청구받는 계정이 결정됩니다. Forge API 키는 서버리스 샌드박스를 지원합니다. CoreWeave API 액세스 토큰은 서버리스 샌드박스와 클러스터 샌드박스를 모두 지원합니다.

Forge API 키

CoreWeave 콘솔 계정이 없거나 Forge 결제를 사용하려는 경우 Forge API 키를 선택하세요.
  1. Forge API 키 설정을 여세요. 로그인하거나, 같은 링크에서 계정을 생성하세요.
  2. API 키를 복사한 다음, 클라이언트를 실행할 터미널에서 설정하세요.
키는 Python에서는 AuthHeaders로, TypeScript에서는 @coreweave/cwsandbox/wandb의 createSandboxClient({apiKey: process.env.FORGE_API_KEY})로 명시적으로 전달하세요. 전체 예시는 서버리스 퀵스타트에서 확인할 수 있습니다. FORGE_API_KEY는 예시로 든 변수일 뿐이며, SDK가 자동으로 감지하는 설정이 아닙니다.

CoreWeave API 액세스 토큰

CoreWeave 조직의 결제를 사용하거나 조직의 클러스터에서 샌드박스를 실행하려면 CoreWeave를 선택하세요.
  1. 샌드박스를 실행하려면 Sandbox User 역할을 부여하는 액세스 정책을 생성하거나 업데이트해 달라고 관리자에게 요청하세요. 러너를 활성화하고 러너의 정책을 설정하는 관리자에게는 샌드박스 실행 권한이 포함된 Sandbox Admin 역할이 필요합니다. 자세한 내용은 액세스 정책 생성 및 샌드박스 역할을 참조하세요.
  2. Tokens 페이지에서 Create Token을 클릭하고 토큰 세부 정보를 입력한 다음 Create를 클릭하세요.
  3. Token Secret을 복사한 후 클라이언트를 실행할 터미널에서 환경 변수로 설정하세요.
토큰을 생성할 수 없다면 관리자에게 Access Token User 역할을 요청하세요. 토큰 시크릿은 한 번만 표시됩니다. 자세한 내용은 API 액세스 토큰 관리를 참조하세요. Python에서는 AuthStrategy.COREWEAVE_API_KEY를 선택하세요. TypeScript에서는 @coreweave/cwsandbox/node에서 클라이언트를 임포트하세요.

배치 모드 선택

Python과 TypeScript 모두 서버리스 배치와 클러스터 배치를 지원합니다. 기본값은 서버리스입니다. 지원되는 모드 값은 PlacementMode 레퍼런스에서 확인할 수 있습니다. 두 클러스터 예시 모두 CWSANDBOX_API_KEY를 읽습니다. 먼저 사용자 인증 정보 설정을 완료하세요. 그런 다음 자체 컴퓨팅 사용을 참고하여 러너를 활성화하거나, 서버리스 퀵스타트를 참고하여 TypeScript 클라이언트를 설치하세요. 클러스터 배치를 명시적으로 선택하는 방법은 다음과 같습니다.
placement_mode="cks"를 사용하세요. 특정 러너에만 배치하려면 runner_ids를 추가하세요.
runner_ids를 지정하지 않으면 CKS 배치 시 조직 내에서 사용 가능한 모든 러너가 대상이 됩니다. 서버리스로 배치하려면 두 필드를 모두 생략하거나, runner_ids 없이 placement_mode="serverless"를 설정하세요.

모드 간 대체 배치로 재시도

자동 대체 배치로 재시도는 Python 클라이언트에서 사용할 수 있습니다. TypeScript 클라이언트는 두 배치 모드 중 하나를 선택할 수는 있지만, 자동 대체 배치로 재시도는 제공하지 않습니다. 대체 배치로 재시도는 용량 부족이나 적합한 러너 부재처럼 재시도 대상에 해당하는 배치 실패가 발생하면, 다른 모드에서 샌드박스 생성을 한 번 더 시도합니다. 이미 실행 중인 샌드박스를 다른 모드로 옮기지는 않습니다. 서버리스 액세스 권한이 있고 CKS 러너가 설정된 조직의 CoreWeave API 액세스 토큰을 사용하세요. Forge API 키만으로는 CKS에 액세스할 수 없습니다. CKS를 우선 사용하고 실패 시 서버리스로 전환하려면 placement_spillover="cks_then_serverless"를 설정하세요.
이 예시에서는 두 시도 모두에 CPU와 메모리를 지정합니다. 모드마다 자체 정책이 적용되므로, 요청은 실제로 실행되는 모드의 정책을 충족해야 합니다. 폴백 동작을 제어하려면 placement_spillover를 다음 옵션 중 하나로 설정하세요. 지원되는 폴백 값은 PlacementSpillover 레퍼런스를 참조하세요. 리소스 및 timeout 설정은 샌드박스 구성을 참조하세요.
마지막 수정일 2026년 10월 15일