메인 콘텐츠로 건너뛰기
System Settings 관리자 UI를 통해 인스턴스 수준 설정을 구성하는 것 외에도, W&B는 환경 변수를 통해 코드에서 이러한 값을 설정하는 방법도 제공합니다. 또한 IAM 고급 구성을 참고하세요.

환경 변수 레퍼런스

Environment VariableDescription
LICENSE사용자의 wandb/local 라이선스
MYSQLMySQL 연결 문자열
BUCKET데이터를 저장할 S3 / GCS 버킷
BUCKET_QUEUE객체 생성 이벤트를 위한 SQS / Google PubSub 큐
NOTIFICATIONS_QUEUE실행 이벤트를 게시할 SQS 큐
AWS_REGION버킷이 위치한 AWS 리전
HOST인스턴스의 FQDN, 예: https://my.domain.net
OIDC_ISSUEROpen ID Connect ID 제공자에 대한 URL, 예: https://cognito-idp.us-east-1.amazonaws.com/us-east-1_uiIFNdacd
OIDC_CLIENT_IDID 제공자에 있는 애플리케이션의 Client ID
OIDC_AUTH_METHODimplicit(기본값) 또는 pkce, 자세한 내용은 아래를 참조하십시오
SLACK_CLIENT_ID알림에 사용할 Slack 애플리케이션의 Client ID
SLACK_SECRET알림에 사용할 Slack 애플리케이션의 Secret
LOCAL_RESTORE인스턴스에 접근할 수 없는 경우, 임시로 이를 true로 설정할 수 있습니다. 컨테이너의 로그에서 임시 자격 증명을 확인하십시오.
REDIS외부 REDIS 인스턴스를 W&B와 함께 설정하는 데 사용할 수 있습니다.
LOGGING_ENABLEDtrue로 설정하면 액세스 로그가 stdout으로 스트리밍됩니다. 이 변수를 설정하지 않고도 sidecar 컨테이너를 마운트한 뒤 /var/log/gorilla.log를 tail로 모니터링할 수 있습니다.
GORILLA_ALLOW_USER_TEAM_CREATIONtrue로 설정하면 관리자 권한이 없는 사용자가 새 팀을 만들 수 있습니다. 기본값은 false입니다.
GORILLA_CUSTOMER_SECRET_STORE_SOURCEW&B Weave에서 팀 시크릿을 저장할 시크릿 매니저를 설정합니다. 다음 시크릿 매니저가 지원됩니다:
  • 내부 시크릿 매니저 (기본값): k8s-secretmanager://wandb-secret
  • AWS Secret Manager: aws-secretmanager
  • Google Cloud Secret Manager: gcp-secretmanager
  • Azure: az-secretmanger
GORILLA_DATA_RETENTION_PERIOD실행에서 삭제된 데이터를 몇 시간 동안 보존할지 설정합니다. 삭제된 실행 데이터는 복구할 수 없습니다. 입력 값에 h를 추가하십시오. 예: "24h".
GORILLA_DISABLE_PERSONAL_ENTITYtrue로 설정하면 personal entities를 비활성화합니다. 개인 엔터티에서 새 개인 프로젝트를 생성하는 것을 차단하고, 기존 개인 프로젝트에 쓰는 것도 차단합니다.
ENABLE_REGISTRY_UItrue로 설정하면 새로운 W&B Registry UI를 활성화합니다.
GORILLA_ARTIFACT_GC_ENABLEDtrue로 설정하면 삭제된 아티팩트에 대한 가비지 컬렉션을 활성화합니다. 셀프 관리형 배포에 필수입니다. 자세한 내용은 Delete an artifact를 참조하십시오.
WANDB_ARTIFACT_DIR다운로드된 모든 아티팩트를 저장할 위치입니다. 설정하지 않으면 학습 스크립트 기준 상대 경로인 artifacts 디렉터리가 기본값입니다. 이 디렉터리가 존재하며 실행 중인 사용자가 여기에 쓸 권한이 있는지 확인하십시오. 생성된 메타데이터 파일의 위치는 제어하지 않으며, 이는 WANDB_DIR 환경 변수로 설정할 수 있습니다.
WANDB_DATA_DIR스테이징 아티팩트를 업로드할 위치입니다. 기본 위치는 사용하는 플랫폼에 따라 다르며, platformdirs Python 패키지의 user_data_dir 값이 사용됩니다. 이 디렉터리가 존재하며 실행 중인 사용자가 여기에 쓸 권한이 있는지 확인하십시오.
WANDB_DIR생성된 모든 파일을 저장할 위치입니다. 설정하지 않으면 학습 스크립트 기준 상대 경로인 wandb 디렉터리가 기본값입니다. 이 디렉터리가 존재하며 실행 중인 사용자가 여기에 쓸 권한이 있는지 확인하십시오. 다운로드된 아티팩트의 위치는 제어하지 않으며, 이는 WANDB_ARTIFACT_DIR 환경 변수로 설정할 수 있습니다.
WANDB_IDENTITY_TOKEN_FILEidentity federation을 위한 JSON Web Token(JWT)이 저장되는 로컬 디렉터리의 절대 경로입니다.
GORILLA_DATA_RETENTION_PERIOD 환경 변수는 주의해서 사용해야 합니다. 이 환경 변수를 설정하는 즉시 데이터가 바로 삭제됩니다. 또한 이 플래그를 활성화하기 전에 데이터베이스와 스토리지 버킷을 모두 백업해둘 것을 권장합니다.

고급 신뢰성 설정

Redis

외부 Redis 서버 구성은 선택 사항이지만, 프로덕션 시스템에서는 사용하는 것을 권장합니다. Redis는 서비스의 안정성을 향상시키고 캐싱을 통해 로드 시간을 줄이는 데 도움이 되며, 특히 대규모 프로젝트에서 유용합니다. 고가용성(HA)이 활성화된 ElastiCache와 같은 관리형 Redis 서비스를 다음과 같은 사양으로 사용하세요:
  • 최소 4GB 메모리, 권장 8GB
  • Redis 버전 6.x
  • 전송 구간 암호화
  • 인증 활성화
Redis 인스턴스를 W&B와 함께 사용하도록 구성하려면 http(s)://YOUR-W&B-SERVER-HOST/system-admin의 W&B 설정 페이지로 이동합니다. “Use an external Redis instance” 옵션을 활성화한 후 다음 형식으로 Redis 연결 문자열을 입력합니다:
W&B에서 REDIS 구성하기
컨테이너 또는 Kubernetes 배포에서 환경 변수 REDIS를 사용하여 Redis를 구성할 수도 있습니다. 또는 REDIS를 Kubernetes secret으로 설정할 수도 있습니다. 이 문서에서는 Redis 인스턴스가 기본 포트 6379에서 실행된다고 가정합니다. 다른 포트를 구성하고 인증을 설정했으며 redis 인스턴스에서 TLS도 활성화한 경우, 연결 문자열 형식은 redis://$USER:$PASSWORD@$HOST:$PORT?tls=true와 비슷한 형태가 됩니다.