샌드박스 만들기 - Weights & Biases Documentation

wandb.sandbox는 사용이 중단되었으며 W&B Python SDK의 향후 릴리스에서 제거됩니다. 대신 cwsandbox 패키지를 사용하세요. 자세한 내용은 CoreWeave 샌드박스 문서를 참조하세요.마이그레이션하면 다음 두 가지가 달라집니다.

임포트 방식. W&B extra와 함께 cwsandbox를 설치하고(pip install "cwsandbox[wandb]"), wandb.sandbox 대신 cwsandbox에서 임포트하세요.
credential. cwsandbox는 기본적으로 CWSANDBOX_API_KEY에 지정된 CoreWeave API access token으로 인증하므로, 기존 W&B API 키를 계속 사용하려면 auth=AuthStrategy.WANDB를 전달하세요. Choose a credential을 참조하세요.

이 페이지의 예시는 아직 wandb.sandbox를 사용합니다. 이에 해당하는 cwsandbox 코드는 Migrate to cwsandbox를 참조하세요.

Serverless Sandboxes는 공개 프리뷰로 제공됩니다. 조직별로 액세스가 활성화됩니다. 조직에 대한 액세스를 요청하려면 지원팀에 문의하세요.

격리된 환경에서 코드를 실행할 수 있도록 W&B Serverless Sandboxes를 만드세요. 단일 샌드박스를 시작하고, 그 안에서 명령을 실행하고, Session으로 여러 샌드박스를 관리할 수 있습니다. 각 샌드박스는 자체 파일 시스템, 네트워크, 프로세스 공간을 갖춘 별도의 컨테이너에서 실행됩니다.

기본적으로 샌드박스는 python:3.11을 기본 이미지로 사용합니다. 다른 이미지를 사용하려면 Sandbox.run() 또는 SandboxDefaults에 container_image를 전달하세요. W&B는 공개 컨테이너 이미지만 지원합니다.사용하기 전에 이미지와 태그가 공개 레지스트리에 있는지 확인하세요. 샌드박스가 이미지를 가져올 수 없으면 시작되지 않으며 클라이언트에서 SandboxFailedError 예외가 발생합니다.

SandboxFailedError는 여러 이유로 발생할 수 있으며, 사용 불가능한 이미지를 구체적으로 식별하지는 않습니다. 이 오류가 발생하면 이미지와 태그를 사용할 수 있는지 확인하세요.

다음 코드 스니펫은 python:3.14 이미지를 사용해 샌드박스를 만들고, 그 안에서 python --version을 실행합니다.

from wandb.sandbox import Sandbox

with Sandbox.run(container_image="python:3.14") as sandbox:
    sandbox.exec(["python", "--version"]).result()

샌드박스 생성

Sandbox.run()을 사용하여 샌드박스를 생성하고 시작하세요. 이 방법은 환경과 상호작용하는 데 사용할 수 있는 Sandbox 객체를 반환합니다.

W&B는 오류가 발생하더라도 블록이 종료될 때 샌드박스가 자동으로 중지되도록 컨텍스트 관리자(with 문)를 사용할 것을 권장합니다.

다음 예제에서는 기본 컨테이너 이미지(python:3.11)를 사용해 샌드박스를 생성합니다:

from wandb.sandbox import Sandbox

with Sandbox.run() as sandbox:
    print(sandbox)

샌드박스에서 명령을 실행하는 방법은 명령 실행을 참조하세요. 샌드박스의 라이프사이클과 상태에 대해서는 샌드박스 라이프사이클을 참조하세요.

메인 명령 없이 샌드박스 시작하기

먼저 샌드박스를 만들고 나중에 그 안에서 작업을 실행하려면, 명령을 지정하지 않고 Sandbox.run()을 호출하세요.

from wandb.sandbox import Sandbox

with Sandbox.run() as sandbox:
    print(sandbox)

이 패턴은 대화형 및 다단계 워크플로에 유용합니다. 샌드박스 내에서 명령을 실행하는 방법은 명령 실행를 참조하세요.

메인 명령으로 샌드박스 시작하기

Sandbox.run()에 명령을 전달할 수도 있습니다. 샌드박스가 처음부터 끝까지 단일 작업만 실행하는 경우에는 이 패턴을 사용하세요. 메인 프로세스가 종료되면 샌드박스는 COMPLETED or FAILED와 같은 최종 상태로 전환됩니다. Sandbox.run()에 전달한 명령은 샌드박스의 메인 프로세스로 실행됩니다.

from wandb.sandbox import Sandbox

sandbox = Sandbox.run("python", "train.py")

Sandbox.run()은 명령의 상태를 모니터링하고 완료될 때까지 기다리는 데 사용할 수 있는 Sandbox 객체를 반환합니다. 예를 들어, 명령이 완료될 때까지 기다린 다음 결과를 가져오려면 다음과 같이 하세요:

from wandb.sandbox import Sandbox

sandbox = Sandbox.run("python", "train.py")

# 선택적으로 명령이 완료될 때까지 기다립니다
sandbox.wait_until_complete().result()

Session을 사용해 여러 샌드박스 만들기

한 번에 둘 이상의 샌드박스가 필요하거나 여러 샌드박스에서 설정을 공유하려면 Session을 사용하세요. Session을 사용해 여러 샌드박스를 생성하고 관리하세요. Session이 닫히면(예: with 블록을 종료할 때) 해당 Session에서 생성한 모든 샌드박스가 자동으로 중지됩니다. 선택적으로 SandboxDefaults 객체를 Session에 전달해, 해당 Session에서 생성하는 모든 샌드박스에 재사용 가능한 기본 설정을 정의할 수 있습니다. 예를 들어, Session의 모든 샌드박스에 적용할 기본 컨테이너 이미지, 네트워크 설정 또는 최대 수명을 지정할 수 있습니다. session.sandbox()는 아직 시작되지 않은 샌드박스를 반환합니다. Sandbox.exec(), Sandbox.read_file() 또는 다른 오퍼레이션을 호출하면 자동으로 시작됩니다. 다음 코드 스니펫은 기본 설정(SandboxDefaults)을 공유하는 두 개의 샌드박스가 포함된 Session을 만듭니다.

from wandb.sandbox import Session, SandboxDefaults

defaults = SandboxDefaults(
    container_image="python:3.11",
    max_lifetime_seconds=300,
    tags=("batch-job",),
)

with Session(defaults) as session:
    sandbox1 = session.sandbox()
    sandbox2 = session.sandbox()

    print(sandbox1)
    print(sandbox2)

​샌드박스 생성

​메인 명령 없이 샌드박스 시작하기

​메인 명령으로 샌드박스 시작하기

​Session을 사용해 여러 샌드박스 만들기

샌드박스 생성

메인 명령 없이 샌드박스 시작하기

메인 명령으로 샌드박스 시작하기

Session을 사용해 여러 샌드박스 만들기