배치 모드 비교
용량과 정책을 누가 관리하는지에 따라 모드를 선택하세요.
첫 번째 샌드박스를 만들려면 서버리스 퀵스타트 또는 자체 컴퓨팅 사용 가이드를 따르세요.
사용자 인증 정보 선택 및 발급
사용하는 사용자 인증 정보에 따라 샌드박스를 소유하고 사용 요금을 청구받는 계정이 결정됩니다. Forge API 키는 서버리스 샌드박스를 지원합니다. CoreWeave API 액세스 토큰은 서버리스 샌드박스와 클러스터 샌드박스를 모두 지원합니다.Forge API 키
CoreWeave 콘솔 계정이 없거나 Forge 결제를 사용하려는 경우 Forge API 키를 선택하세요.- Forge API 키 설정을 여세요. 로그인하거나, 같은 링크에서 계정을 생성하세요.
-
API 키를 복사한 다음, 클라이언트를 실행할 터미널에서 설정하세요.
AuthHeaders로, TypeScript에서는 @coreweave/cwsandbox/wandb의 createSandboxClient({apiKey: process.env.FORGE_API_KEY})로 명시적으로 전달하세요. 전체 예시는 서버리스 퀵스타트에서 확인할 수 있습니다. FORGE_API_KEY는 예시로 든 변수일 뿐이며, SDK가 자동으로 감지하는 설정이 아닙니다.
CoreWeave API 액세스 토큰
CoreWeave 조직의 결제를 사용하거나 조직의 클러스터에서 샌드박스를 실행하려면 CoreWeave를 선택하세요.- 샌드박스를 실행하려면 Sandbox User 역할을 부여하는 액세스 정책을 생성하거나 업데이트해 달라고 관리자에게 요청하세요. 러너를 활성화하고 러너의 정책을 설정하는 관리자에게는 샌드박스 실행 권한이 포함된 Sandbox Admin 역할이 필요합니다. 자세한 내용은 액세스 정책 생성 및 샌드박스 역할을 참조하세요.
- Tokens 페이지에서 Create Token을 클릭하고 토큰 세부 정보를 입력한 다음 Create를 클릭하세요.
-
Token Secret을 복사한 후 클라이언트를 실행할 터미널에서 환경 변수로 설정하세요.
AuthStrategy.COREWEAVE_API_KEY를 선택하세요. TypeScript에서는 @coreweave/cwsandbox/node에서 클라이언트를 임포트하세요.
배치 모드 선택
Python과 TypeScript 모두 서버리스 배치와 클러스터 배치를 지원합니다. 기본값은 서버리스입니다. 지원되는 모드 값은PlacementMode 레퍼런스에서 확인할 수 있습니다.
두 클러스터 예시 모두 CWSANDBOX_API_KEY를 읽습니다. 먼저 사용자 인증 정보 설정을 완료하세요. 그런 다음 자체 컴퓨팅 사용을 참고하여 러너를 활성화하거나, 서버리스 퀵스타트를 참고하여 TypeScript 클라이언트를 설치하세요.
클러스터 배치를 명시적으로 선택하는 방법은 다음과 같습니다.
- Python
- 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"를 설정하세요.
placement_spillover를 다음 옵션 중 하나로 설정하세요.
지원되는 폴백 값은
PlacementSpillover 레퍼런스를 참조하세요. 리소스 및 timeout 설정은 샌드박스 구성을 참조하세요.