원격 함수

이 튜토리얼에서는 원격 함수를 사용하여 샌드박스 내에서 Python 함수를 실행하는 방법을 안내합니다. 셸 명령어 문자열을 구성하는 대신 샌드박스에서 실행되는 코드를 로컬 함수처럼 호출할 수 있습니다. Python 코드에서 직접 샌드박스의 컴퓨팅 작업을 호출하고 유형 지정된 결과를 수집하려는 개발자를 위한 튜토리얼입니다.

인증 선택

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

원격 함수 정의 및 호출

함수에 @session.function() 데코레이터를 적용하면 .remote()로 샌드박스 내부에서 호출할 수 있습니다. 호출은 .result()로 확인할 수 있는 참조를 반환합니다:

from sandbox_auth import AUTH
from cwsandbox import Sandbox, SandboxDefaults

with Sandbox.session(SandboxDefaults(
    resources={"cpu": "1", "memory": "1Gi"},
), auth=AUTH) as session:
    @session.function()
    def add(x: int, y: int) -> int:
        return x + y

    result = add.remote(2, 3).result()  # 5

`.map()`으로 함수를 병렬 실행하기

.map()을 사용하면 여러 호출을 한 번에 디스패치하고 그 결과를 수집할 수 있습니다. 서로 독립적인 호출은 하나씩 순차적으로 실행되지 않고 동시에 실행됩니다.

@session.function()
def square(x: int) -> int:
    return x * x

refs = square.map([(1,), (2,), (3,)])
results = [r.result() for r in refs]  # [1, 4, 9]

다음 단계

이제 샌드박스 내의 Python 함수를 로컬 호출처럼 호출하고, .map()으로 작업을 병렬로 분산할 수 있습니다. 직렬화 모드, .local() 테스트 등에 대한 자세한 내용은 원격 함수 가이드를 참조하세요.

샌드박스

샌드박스 사용하기

샌드박스 관리

레퍼런스

인증 선택

원격 함수 정의 및 호출

`.map()`으로 함수를 병렬 실행하기

다음 단계

​인증 선택

​원격 함수 정의 및 호출

​.map()으로 함수를 병렬 실행하기

​다음 단계

인증 선택

원격 함수 정의 및 호출

`.map()`으로 함수를 병렬 실행하기

다음 단계