W&B のライセンスとバージョンを更新する

このガイドでは、W&B サーバー の管理者向けに、既存のセルフマネージドデプロイメントで W&B サーバー のバージョンとライセンスキーを更新する方法を説明します。サーバーとライセンスを最新の状態に保つことで、最新の機能や修正を利用できるほか、W&B サーバー を引き続き使用する権利も維持されます。 W&B サーバー のバージョンとライセンスは、W&B サーバー をインストールしたときと同じ方法で更新してください。次の表は、デプロイメント方法ごとのライセンスとバージョンの更新方法を示しています。

​

Terraform で更新する

W&B が管理する Terraform モジュールのいずれかを使用して W&B サーバー をデプロイした場合は、Terraform を使用して、ライセンスキーと W&B のバージョンの両方をインプレースで更新します。次の表は、W&B が管理する Terraform モジュールをクラウドプラットフォーム別に示したものです。

1. ご利用のクラウドプロバイダー向けの、W&B が管理する Terraform モジュールにアクセスします。ご利用のクラウドプロバイダーに対応する Terraform モジュールは、前の表で確認してください。
2. Terraform の設定で、wandb_app モジュール設定内の wandb_version と license を更新します。
   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 plan と terraform apply を使用して Terraform の設定を適用します。
   terraform init
   terraform apply
   
4. オプション: terraform.tfvars などの .tfvars ファイルを使用している場合は、新しい W&B のバージョンとライセンスキーでファイルを更新するか、新たに作成します。
   terraform plan -var-file="terraform.tfvars"
   
   Terraform のワークスペースディレクトリで、設定を適用します。
   terraform apply -var-file="terraform.tfvars"
   

Terraform による変更が適用されると、デプロイメントは指定した W&B のバージョンで実行され、更新後のライセンスキーが使用されます。

​

Helm で更新する

Helm を使用した更新方法は 2 つあります。既存の Helm values ファイルを使用して更新する方法と、アップグレードコマンドで新しいライセンスとイメージタグを直接指定する方法です。以下のセクションでは、それぞれの方法について説明します。

​

spec を使用して W&B を更新する

Helm の設定を、追跡対象の *.yaml values ファイルで管理している場合は、この方法を使用します。

1. Helm チャートの *.yaml 設定ファイルで image.tag と license のいずれか、または両方の値を変更して、新しいバージョンを指定します。
   license: 'new_license'
   image:
     repository: wandb/local
     tag: 'new_version'
   
2. Helm リポジトリを更新し、values ファイルを使用して 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
   

詳細については、公開リポジトリのアップグレードガイドを参照してください。

​

管理 UI で更新する

管理 UI を使用すると、デプロイメントの設定を変更することなく、W&B アプリ内からライセンスキーをローテーションできます。この方法は、W&B サーバーのコンテナーで環境変数としてライセンスが設定されていない場合 (通常はセルフマネージドの Docker インストール) のライセンス更新にのみ使用できます。この方法で更新されるのはライセンスのみで、実行中の W&B サーバー のバージョンは変更されません。

1. W&B Deployment Page から新しいライセンスを取得します。その際、アップグレード対象のデプロイメントの組織とデプロイメント ID に一致していることを確認してください。
2. W&B アプリで License ページにアクセスします。Settings > License をクリックするか、HOST_URL/console/settings/license にアクセスします (HOST_URL は W&B サーバー のホスト URL です) 。
3. ライセンス管理セクションに移動します。
4. 新しいライセンスキーを入力し、変更を保存します。