설정 - CoreWeave Docs

이 튜토리얼에서는 Sandbox.run()에 옵션을 전달하여 시작 시 샌드박스를 설정하는 방법을 보여줍니다. 기본 샌드박스를 이미 생성한 개발자를 대상으로 하며, 워크로드에 대한 컨테이너 이미지, 리소스 할당 및 사전 채워진 파일을 제어하려는 경우에 유용합니다.

인증 선택

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로 세션을 생성하면 해당 세션이 소유한 샌드박스도 함께 인증됩니다. 샌드박스에 다시 연결하거나 목록을 조회하거나 정리할 때도 동일한 사용자 인증 정보를 사용하세요.

`Sandbox.run()`에 설정 전달

설정 옵션은 샌드박스가 프로비저닝되는 방식을 제어합니다. 이를 Sandbox.run()에 키워드 인수로 직접 전달하세요:

from sandbox_auth import AUTH
from cwsandbox import Sandbox

with Sandbox.run(
    container_image="python:3.11",
    max_lifetime_seconds=300,
    tags=["my-app"],
    resources={"cpu": "1", "memory": "1Gi"},
    auth=AUTH,
) as sandbox:
    sandbox.exec(["python", "--version"]).result()

리소스

워크로드의 요구 사항에 맞게 CPU와 메모리를 설정하여 과도한 프로비저닝이나 부족한 프로비저닝을 피하세요. ResourceOptions를 사용하여 requests와 limits를 설정하세요:

from sandbox_auth import AUTH
from cwsandbox import ResourceOptions, Sandbox

with Sandbox.run(
    resources=ResourceOptions(
        requests={"cpu": "2", "memory": "2Gi"},
        limits={"cpu": "2", "memory": "2Gi"},
    ),
    auth=AUTH,
) as sandbox:
    sandbox.exec(["python", "compute.py"]).result()

ResourceOptions는 Kubernetes 리소스 구문을 사용합니다:

리소스	형식	예시
CPU	코어 또는 밀리코어	`"1"`, `"2"`, `"500m"` (0.5 CPU)
메모리	단위 접미사가 있는 바이트	`"512Mi"`, `"1Gi"`, `"2Gi"`

마운트된 파일

마운트된 파일을 사용하면 샌드박스가 시작되기 전에 설정, 스크립트 또는 기타 정적 콘텐츠를 샌드박스에 제공할 수 있으므로, 워크로드가 실행되는 순간 필요한 것을 갖출 수 있습니다. 샌드박스 시작 시 파일을 미리 채우세요:

from sandbox_auth import AUTH
with Sandbox.run(
    mounted_files=[
        {"mount_path": "/app/config.json", "file_content": b'{"debug": true}'},
        {"mount_path": "/app/script.py", "file_content": b"print('hello')"},
    ],
    resources={"cpu": "1", "memory": "1Gi"},
    auth=AUTH,
) as sandbox:
    sandbox.exec(["python", "/app/script.py"]).result()

각 항목은 샌드박스 내부의 절대 경로인 mount_path와 파일 내용을 바이트로 나타낸 file_content를 받습니다. str을 전달하면 UTF-8로 자동 인코딩됩니다. 마운트된 파일은 읽기 전용입니다. 수정이 필요한 파일에는 write_file()을 사용하세요.

다음 단계

이제 워크로드에 필요한 컨테이너 이미지, 리소스 할당 및 사전 마운트된 파일로 시작하는 샌드박스가 있습니다. 여러 샌드박스에서 재사용 가능한 설정을 위해 SandboxDefaults를 사용하세요. 모든 ResourceOptions 필드, GPU 리소스, QoS 클래스 및 설정 라이브러리 상호 운용성에 대한 자세한 내용은 샌드박스 설정 가이드를 참조하세요.

샌드박스

샌드박스 사용하기

샌드박스 관리

레퍼런스

설정

인증 선택

`Sandbox.run()`에 설정 전달

리소스

마운트된 파일

다음 단계

​인증 선택

​Sandbox.run()에 설정 전달

​리소스

​마운트된 파일

​다음 단계

인증 선택

`Sandbox.run()`에 설정 전달

리소스

마운트된 파일

다음 단계