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

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

​

Terraform を使用して更新する

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

1. 利用しているクラウドプロバイダ向けの、W&B が管理する Terraform モジュールにアクセスします。前の表を参照して、利用しているクラウドプロバイダに一致する Terraform モジュールを検索してください。
2. Terraform の設定で、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 Workspace ディレクトリから、設定を適用します。
   terraform apply -var-file="terraform.tfvars"
   

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

​

Helm を使用して更新

Helm ベースの更新方法は 2 つあります。既存の Helm values ファイルから更新する方法と、新しい License と image tag を 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 repository を更新し、W&B release をアップグレードします。
   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 を使用してライセンスキーをローテーションできます。この方法は、W&B Server コンテナーで環境変数を使って設定していないライセンスを更新する場合にのみ利用でき、通常はセルフマネージドの Docker インストールが該当します。この方法で更新されるのはライセンスのみで、実行中の 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. 新しいライセンスキーを入力し、変更を保存します。