메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt

Use this file to discover all available pages before exploring further.

이 가이드는 기존 self-managed 배포에서 W&B Server 버전과 라이선스 키를 업데이트하는 방법을 W&B Server 관리자에게 안내합니다. 서버와 라이선스를 최신 상태로 유지하면 최신 특성 및 수정 사항에 액세스할 수 있으며, W&B Server를 계속 사용할 자격도 유지됩니다. W&B Server를 설치할 때 사용한 것과 동일한 방법으로 W&B Server 버전 및 라이선스를 업데이트하세요. 다음 표에는 배포 방법별로 라이선스와 버전을 업데이트하는 방법이 나와 있습니다.
릴리스 유형설명
TerraformW&B는 클라우드 배포를 위한 세 가지 공개 Terraform 모듈(AWS, Google Cloud, Azure)을 지원합니다.
Helm기존 Kubernetes 클러스터에 W&B를 설치하려면 Helm 차트를 사용하세요.

Terraform으로 업데이트

W&B에서 유지 관리하는 Terraform 모듈 중 하나로 W&B Server를 배포한 경우, Terraform을 사용해 라이선스 키와 W&B 버전을 현재 배포에 그대로 업데이트할 수 있습니다. 다음 표에는 클라우드 제공업체별 W&B 관리 Terraform 모듈이 나와 있습니다.
클라우드 제공업체Terraform 모듈
AWSAWS Terraform module
Google CloudGoogle Cloud Terraform module
AzureAzure Terraform module
  1. 사용 중인 클라우드 제공업체에 맞는 W&B에서 유지 관리하는 Terraform 모듈로 이동합니다. 앞의 표를 참조하여 클라우드 제공업체에 맞는 Terraform 모듈을 찾으세요.
  2. Terraform 설정에서 Terraform wandb_app 모듈 설정의 wandb_versionlicense를 업데이트합니다:
    module "wandb_app" {
        source  = "wandb/wandb/[CLOUD-SPECIFIC-MODULE]"
        version = "new_version"
        license       = "new_license_key" # 새 라이선스 키
        wandb_version = "new_wandb_version" # 원하는 W&B 버전
        ...
    }
    
  3. terraform planterraform apply를 사용해 Terraform 설정을 적용합니다.
    terraform init
    terraform apply
    
  4. 선택: terraform.tfvars 또는 다른 .tfvars 파일을 사용하는 경우, 새 W&B 버전과 라이선스 키로 파일을 업데이트하거나 생성합니다.
    terraform plan -var-file="terraform.tfvars"
    
    Terraform Workspace 디렉터리에서 설정을 적용합니다.
    terraform apply -var-file="terraform.tfvars"
    
Terraform이 변경 사항을 적용하면 배포가 지정한 W&B 버전으로 실행되고 업데이트된 라이선스 키를 사용합니다.

Helm으로 업데이트

wandb Helm 차트는 사용 중단되었으며 더 이상 지원되지 않습니다. 이 차트는 단일 파드를 배포했으며, 현재는 W&B Kubernetes Operator로 대체되었습니다. 아직 이 차트를 사용 중이라면 마이그레이션 가이드를 따라 Operator로 마이그레이션하세요.
Helm 기반 업데이트 경로는 두 가지를 사용할 수 있습니다. 기존 Helm values 파일에서 업데이트하거나, upgrade 명령에서 새 라이선스와 이미지 태그를 직접 설정할 수 있습니다. 다음 섹션에서는 각 접근 방식을 설명합니다.

spec을 사용해 W&B 업데이트

추적되는 *.yaml values 파일에서 Helm 설정을 관리하는 경우 이 방법을 사용하세요.
  1. Helm 차트 *.yaml 설정 파일에서 image.tag 또는 license 값, 또는 둘 다를 수정해 새 버전을 지정합니다:
    license: 'new_license'
    image:
      repository: wandb/local
      tag: 'new_version'
    
  2. values 파일을 사용해 Helm 저장소를 업데이트하고 W&B 릴리스를 업그레이드합니다:
    helm repo update
    helm upgrade --namespace=wandb --create-namespace \
      --install wandb wandb/wandb --version ${chart_version} \
      -f ${wandb_install_spec.yaml}
    

라이선스 및 버전을 직접 업데이트

이 방법을 사용하면 values 파일을 편집하지 않고도 라이선스와 이미지 태그를 업데이트하고, 기존 Helm 릴리스 설정을 재사용할 수 있습니다.
  1. 새 라이선스 키와 이미지 태그를 환경 변수로 설정합니다.
    export LICENSE='new_license'
    export TAG='new_version'
    
  2. 아래 명령으로 Helm 릴리스를 업그레이드하여 새 값을 기존 설정에 병합합니다.
    helm repo update
    helm upgrade --namespace=wandb --create-namespace \
      --install wandb wandb/wandb --version ${chart_version} \
      --reuse-values --set license=$LICENSE --set image.tag=$TAG
    
자세한 내용은 공개 저장소의 업그레이드 가이드를 참조하세요.

admin UI에서 업데이트

배포 설정을 변경하지 않고 W&B App 내부의 admin UI를 사용하여 라이선스 키를 교체할 수 있습니다. 이 방법은 일반적으로 Self-Managed Docker 설치에서 W&B Server container의 환경 변수로 설정되지 않은 라이선스를 업데이트할 때만 작동합니다. 이 방법은 라이선스만 업데이트하며, 실행 중인 W&B Server 버전은 변경하지 않습니다.
  1. W&B Deployment Page에서 새 라이선스를 획득하고, 업그레이드하려는 배포의 올바른 조직 및 deployment ID와 일치하는지 확인하세요.
  2. W&B App에서 License 페이지에 액세스하세요. Settings > License를 클릭하거나 HOST_URL/console/settings/license로 이동하세요. 여기서 HOST_URL은 W&B Server 호스트 URL입니다.
  3. 라이선스 관리 섹션으로 이동하세요.
  4. 새 라이선스 키를 입력하고 변경 사항을 저장하세요.