볼륨 - CoreWeave Docs

The examples on this page omit auth. To authenticate with your W&B API key, install cwsandbox[wandb] and pass auth=AuthStrategy.WANDB to Sandbox.run(), Sandbox(), or Sandbox.session(). See Get started.

볼륨은 샌드박스가 사용자가 지정한 경로에 마운트하는 저장소입니다. 스크래치 볼륨은 하나의 샌드박스에 속하며 해당 샌드박스와 함께 삭제됩니다. 이 페이지는 컨테이너 파일 시스템 용량을 초과하는 데이터를 샌드박스에서 써야 하는 개발자를 위한 문서입니다. 이 문서를 마치면 스크래치 볼륨을 연결할 수 있습니다.

Scratch volumes

A scratch volume is created with the sandbox and destroyed with it. Declare one with ScratchVolumeOptions in the volumes list.

from cwsandbox import Sandbox, ScratchVolumeOptions

with Sandbox.run(
    container_image="ubuntu:22.04",
    volumes=[ScratchVolumeOptions(name="workspace", mount_path="/workspace", size="10Gi")],
) as sandbox:
    sandbox.exec(["sh", "-c", "echo hello > /workspace/data.txt"]).result()

ScratchVolumeOptions accepts the following fields:

필드	설명
`name`	샌드박스 내 볼륨 이름입니다. 마운트와 스냅샷에서 이 이름을 참조합니다. 필수 항목입니다.
`mount_path`	기본 컨테이너에 마운트할 절대 경로입니다. 생략하면 볼륨을 마운트하지 않고 선언만 합니다.
`size`	볼륨 크기입니다(예: `"10Gi"`). 생략하면 플랫폼 기본값이 사용됩니다.
`medium`	기반 저장소입니다. `StorageMedium.DISK`(기본값) 또는 `StorageMedium.MEMORY` 중 하나입니다.
`sub_path`	볼륨 루트 대신 마운트할 볼륨 내부의 상대 경로입니다.
`read_only`	볼륨을 읽기 전용으로 마운트합니다. 기본값은 `False`입니다.
`restore_from_snapshot_id`	생성 시 파일 시스템 스냅샷을 볼륨에 복원합니다.

Choose a storage medium

StorageMedium.DISK backs the volume with local disk. StorageMedium.MEMORY backs it with tmpfs, which is faster but counts against the mounting container’s memory request and against the policy’s memory ceiling. Because an unbounded RAM-backed volume could exhaust the node, a MEMORY volume must declare a size. It may do so as an absolute quantity, or as an integer percentage of the sandbox’s resolved memory request, such as "50%". The percentage form is valid only for MEMORY. A DISK volume must use an absolute size.

from cwsandbox import Sandbox, ScratchVolumeOptions, StorageMedium

with Sandbox.run(
    container_image="ubuntu:22.04",
    volumes=[
        ScratchVolumeOptions(
            name="fast-cache",
            mount_path="/cache",
            size="50%",
            medium=StorageMedium.MEMORY,
        )
    ],
) as sandbox:
    sandbox.exec(["sh", "-c", "df -h /cache"]).result()

Mount a scratch volume on several containers

mount_path is a convenience that mounts the volume on the primary container. In a multi-container sandbox, omit mount_path and declare the mounts on each container instead, so that more than one container can reach the same volume.

from cwsandbox import Container, Sandbox, ScratchVolumeOptions, VolumeMount

with Sandbox.run(
    volumes=[ScratchVolumeOptions(name="shared", size="5Gi")],
    containers=[
        Container(
            name="app",
            image="ubuntu:22.04",
            primary=True,
            volume_mounts=[VolumeMount(volume="shared", mount_path="/data")],
        ),
        Container(
            name="sidecar",
            image="ubuntu:22.04",
            volume_mounts=[VolumeMount(volume="shared", mount_path="/data", read_only=True)],
        ),
    ],
) as sandbox:
    sandbox.exec(["sh", "-c", "echo shared > /data/note.txt"]).result()

For more on related sandbox features, see the following resources:

파일 시스템 스냅샷: 샌드박스의 파일 시스템을 저장하고 복원합니다.
샌드박스 설정: 그 밖의 샌드박스 생성 옵션

​Scratch volumes

​Choose a storage medium

​Mount a scratch volume on several containers

​Related resources

Scratch volumes

Choose a storage medium

Mount a scratch volume on several containers

Related resources