Skip to main content
이 가이드에서는 CWSandbox 인스턴스에서 환경 변수를 설정하고 관리하는 방법을 설명합니다. 환경 변수를 사용하면 로그 수준이나 프로젝트 식별자 같은 민감하지 않은 설정 값을 샌드박스에 전달할 수 있습니다. 환경 변수는 개별 샌드박스에 설정하거나, 세션 내 여러 샌드박스에서 공유하거나, 원격 함수 범위로 한정할 수 있습니다.
API 키, 비밀번호 또는 기타 사용자 인증 정보를 environment_variables에 하드코딩하거나 로그에 출력하지 마세요. 원시 사용자 인증 정보를 직접 전달하기보다는 시크릿 참조를 사용하는 것이 좋습니다. Forge 시크릿 주입을 사용할 수 없는 경우에도 민감한 값은 시크릿 관리자에 보관하세요. 이 지침은 서버리스 샌드박스와 CKS 샌드박스 모두에 적용됩니다.
Forge로 인증된 서버리스 샌드박스에서는 Forge 시크릿을 사용하세요. 서버가 이 참조를 확인한 뒤 해당 값을 환경 변수로 주입합니다. CKS 배치를 사용하거나 CoreWeave API 액세스 토큰으로 인증된 샌드박스에서는 Forge 시크릿 주입을 사용할 수 없습니다. CKS에서는 조직에서 승인한 방법으로 워크로드에 시크릿을 전달하세요.

인증 선택

이 예시는 섹션에서 CKS를 별도로 지정하지 않는 한 서버리스 용량에서 실행됩니다. 샌드박스를 소유한 계정의 사용자 인증 정보를 선택하세요. 키 또는 토큰을 획득하는 방법은 사용자 인증 정보 선택 및 조회를 참조하세요. 설치 명령어는 활성화된 Python 가상 환경에서 실행하세요. 사용 중인 사용자 인증 정보 탭의 Python 코드를 sandbox_auth.py로 저장하되, 이 페이지에서 실행할 Python script와 같은 위치에 저장하세요. 이 파일에는 사용자 인증 정보 자체가 아니라 어떤 인증 방식을 사용할지만 저장됩니다. 예시에서는 이 파일에서 AUTH를 임포트한 뒤 새 샌드박스나 세션을 만들 때마다 명시적으로 전달합니다.
SDK의 W&B 인증 전략으로 Forge API 키를 사용하세요.
sandbox_auth.py
CKS 배치를 사용하려면 CoreWeave 토큰을 선택하고 러너를 활성화한 다음, 샌드박스를 생성할 때 또는 SandboxDefaults에서 placement_mode="cks"를 설정하세요. auth=AUTH로 세션을 생성하면 해당 세션이 소유한 샌드박스도 함께 인증됩니다. 샌드박스에 다시 연결하거나 목록을 조회하거나 정리할 때도 같은 사용자 인증 정보를 사용하세요.

기본 사용법

샌드박스 내부에서 실행되는 process에 값을 사용 가능하게 하려면 environment_variables 딕셔너리를 Sandbox.run에 전달하세요:

세션 수준 기본값

여러 샌드박스에서 동일한 변수를 필요로 할 때, 각 샌드박스마다 반복해서 정의하는 대신 세션에 한 번 정의하세요. 개별 샌드박스는 세션 기본값을 재정의하거나 자체 변수를 추가할 수 있습니다:

원격 함수

원격 함수는 세션에서 환경 변수를 상속받으며 @session.function 데코레이터를 통해 자체 환경 변수를 선언할 수 있습니다. SDK는 호출 시점에 함수 수준의 환경 변수와 세션 기본값을 병합합니다:
환경 변수는 참조로 전달됩니다. 데코레이션 이후 딕셔너리의 변경 사항은 후속 함수 호출에 반영됩니다. 다음 예시에서 볼 수 있듯이.
마지막 수정일 2026년 10월 23일