정리 작업

이 페이지에서는 코드 실행이 끝나거나 예기치 않게 종료될 때 리소스가 해제되도록 샌드박스를 안정적으로 종료하는 방법을 설명합니다. 스크립트가 완료된 후에도 고아 샌드박스가 계속 실행되는 것을 방지하려면 다음 패턴을 사용하세요.

인증 선택

이 예시는 섹션에서 CKS를 따로 지정하지 않는 한 서버리스 용량에서 실행됩니다. 샌드박스를 소유한 계정의 사용자 인증 정보를 선택하세요. 키 또는 토큰을 획득하는 방법은 사용자 인증 정보 선택 및 조회를 참조하세요. 설치 명령어는 활성화된 Python 가상 환경에서 실행하세요. 사용 중인 사용자 인증 정보 탭의 Python 코드를 sandbox_auth.py라는 이름으로, 이 페이지에서 실행할 Python script와 같은 디렉터리에 저장하세요. 이 파일에는 사용자 인증 정보 자체가 아니라 어떤 인증 방식을 사용할지만 저장됩니다. 예시에서는 이 파일에서 AUTH를 임포트한 뒤, 새 샌드박스나 세션을 만들 때마다 명시적으로 전달합니다.

Forge API 키
CoreWeave API 액세스 토큰

SDK의 W&B 인증 전략으로 Forge API 키를 사용하세요.

uv pip install 'cwsandbox[wandb]>=1.14.2'
export WANDB_API_KEY="[WANDB-API-KEY]"

sandbox_auth.py

from cwsandbox import AuthStrategy

AUTH = AuthStrategy.WANDB

CoreWeave 조직의 토큰을 사용하세요.

uv pip install 'cwsandbox>=1.14.2'
export CWSANDBOX_API_KEY="[API-ACCESS-TOKEN]"

sandbox_auth.py

from cwsandbox import AuthStrategy

AUTH = AuthStrategy.COREWEAVE_API_KEY

CKS 배치를 사용하려면 CoreWeave 토큰을 선택하고 러너를 활성화한 다음, 샌드박스를 생성할 때 또는 SandboxDefaults에서 placement_mode="cks"를 설정하세요. auth=AUTH로 세션을 생성하면 해당 세션이 소유한 샌드박스도 함께 인증됩니다. 샌드박스에 다시 연결하거나 샌드박스 목록을 조회하거나 정리할 때도 동일한 사용자 인증 정보를 사용하세요.

샌드박스 정리

컨텍스트 관리자를 사용하여 정리 작업을 자동으로 처리하세요:

from cwsandbox import Sandbox
from sandbox_auth import AUTH

with Sandbox.run(resources={"cpu": "1", "memory": "1Gi"}, auth=AUTH) as sandbox:
    sandbox.exec(["echo", "hello"]).result()
# 자동으로 중단

컨텍스트 관리자 없이 생성한 샌드박스는 .stop()을 명시적으로 호출하세요:

from cwsandbox import Sandbox
from sandbox_auth import AUTH

sandbox = Sandbox.run(resources={"cpu": "1", "memory": "1Gi"}, auth=AUTH)
sandbox.exec(["echo", "hello"]).result()
sandbox.stop().result()

안전 장치로, SDK는 atexit과 signal(Ctrl+C, SIGTERM)에 대한 전역 정리 작업 handler를 등록합니다. 이 handler는 Session에 속한 샌드박스를 중지하므로, 세션 관리 샌드박스는 예기치 않은 종료 시에도 중지됩니다. Sandbox.run()으로 직접 생성한 샌드박스는 세션의 일부가 아니므로, process가 종료된 후에도 사용자가 중지하거나 lifetime이 만료될 때까지 계속 실행됩니다. 이 워크플로에 의존하는 예시는 Sandboxes SDK로 Claude Code 설정하기를 참조하세요. batch 정리 작업, tagging 전략, orphan recovery에 대해서는 정리 작업 patterns guide를 참조하세요.

샌드박스

샌드박스 사용하기

샌드박스 관리

레퍼런스

인증 선택

샌드박스 정리

​인증 선택

​샌드박스 정리

인증 선택

샌드박스 정리