설정 - CoreWeave Docs

이 예시에서는 CWSANDBOX_API_KEY에 설정된 CoreWeave API 액세스 토큰을 사용합니다. Forge API 키 인증은 시작하기를 참조하세요. CKS 요구 사항은 배치 모드를 참조하세요. 이 튜토리얼에서는 Sandbox.run()에 옵션을 전달하여 시작 시 샌드박스를 설정하는 방법을 보여줍니다. 기본 샌드박스를 이미 생성한 개발자를 대상으로 하며, 워크로드에 대한 컨테이너 이미지, 리소스 할당 및 사전 채워진 파일을 제어하려는 경우에 유용합니다.

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

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

from cwsandbox import Sandbox

with Sandbox.run(
    container_image="python:3.11",
    max_lifetime_seconds=300,
    tags=["my-app"],
) as sandbox:
    sandbox.exec(["python", "--version"]).result()

리소스

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

from cwsandbox import ResourceOptions, Sandbox

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

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

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

마운트된 파일

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

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')"},
    ]
) 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()`에 설정 전달

리소스

마운트된 파일

다음 단계