> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-sdk-testing-latest.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> さまざまなインストール方法で W&B のバージョンとライセンスを更新するためのガイド。

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

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

W\&B Server のバージョンとライセンスは、W\&B Server のインストール時と同じ方法で更新してください。次の表は、デプロイ方法ごとにライセンスとバージョンを更新する方法を示しています。

| Release type                        | Description                                                                                                                                                                                                                                                                           |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Terraform](#update-with-terraform) | W\&B は、クラウドデプロイ向けに 3 つの公開 Terraform モジュールをサポートしています。[AWS](https://registry.terraform.io/modules/wandb/wandb/aws/latest)、[Google Cloud](https://registry.terraform.io/modules/wandb/wandb/google/latest)、[Azure](https://registry.terraform.io/modules/wandb/wandb/azurerm/latest) です。 |
| [Helm](#update-with-helm)           | [Helm チャート](https://github.com/wandb/helm-charts) を使用して、既存の Kubernetes クラスターに W\&B をインストールできます。                                                                                                                                                                                       |

<div id="update-with-terraform">
  ## Terraform を使用して更新する
</div>

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

| Cloud provider | Terraform module                                                                                 |
| -------------- | ------------------------------------------------------------------------------------------------ |
| AWS            | [AWS Terraform module](https://registry.terraform.io/modules/wandb/wandb/aws/latest)             |
| Google Cloud   | [Google Cloud Terraform module](https://registry.terraform.io/modules/wandb/wandb/google/latest) |
| Azure          | [Azure Terraform module](https://registry.terraform.io/modules/wandb/wandb/azurerm/latest)       |

1. 利用しているクラウドプロバイダ向けの、W\&B が管理する Terraform モジュールにアクセスします。前の表を参照して、利用しているクラウドプロバイダに一致する Terraform モジュールを検索してください。

2. Terraform の設定で、Terraform の `wandb_app` モジュール設定にある `wandb_version` と `license` を更新します。

   ```hcl theme={null}
   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 の設定を適用します。
   ```bash theme={null}
   terraform init
   terraform apply
   ```

4. 任意: `terraform.tfvars` またはその他の `.tfvars` ファイルを使用している場合は、新しい W\&B バージョンとライセンスキーを含むファイルを更新するか、新規作成します。
   ```bash theme={null}
   terraform plan -var-file="terraform.tfvars"
   ```
   Terraform Workspace ディレクトリから、設定を適用します。
   ```bash theme={null}
   terraform apply -var-file="terraform.tfvars"
   ```

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

<div id="update-with-helm">
  ## Helm を使用して更新
</div>

<Warning>
  `wandb` Helm チャートは非推奨であり、サポートが終了しました。このチャートは単一の pod をデプロイするものでしたが、現在は [W\&B Kubernetes Operator](/ja/platform/hosting/self-managed/operator) に置き換えられています。現在もこのチャートを使用している場合は、[移行ガイド](/ja/platform/hosting/self-managed/operator#migrate-self-managed-instances-to-wb-operator) に従って Operator へ移行してください。
</Warning>

Helm ベースの更新方法は 2 つあります。既存の Helm values ファイルから更新する方法と、新しい License と image tag を upgrade コマンドで直接設定する方法です。以下のセクションでは、それぞれの方法について説明します。

<div id="update-wb-with-spec">
  ### spec を使って W\&B を更新
</div>

トラッキングしている `*.yaml` の values ファイルで Helm の設定を管理している場合は、この方法を使用します。

1. Helm チャートの `*.yaml` 設定ファイルで、`image.tag` または `license` の値、あるいはその両方を変更して、新しいバージョンを指定します。

   ```yaml theme={null}
   license: 'new_license'
   image:
     repository: wandb/local
     tag: 'new_version'
   ```

2. values ファイルを使用して Helm repository を更新し、W\&B release をアップグレードします。

   ```bash theme={null}
   helm repo update
   helm upgrade --namespace=wandb --create-namespace \
     --install wandb wandb/wandb --version ${chart_version} \
     -f ${wandb_install_spec.yaml}
   ```

<div id="update-license-and-version-directly">
  ### ライセンスとバージョンを直接更新する
</div>

この方法を使用すると、values ファイル を編集せずにライセンスとイメージタグを更新でき、既存の Helm リリース設定を再利用できます。

1. 新しいライセンスキーとイメージタグを環境変数に設定します。

   ```bash theme={null}
   export LICENSE='new_license'
   export TAG='new_version'
   ```

2. 以下のコマンドで Helm リリースをアップグレードし、新しい値を既存の設定にマージします。

   ```bash theme={null}
   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
   ```

詳細は、パブリックリポジトリの[アップグレードガイド](https://github.com/wandb/helm-charts/blob/main/upgrade)を参照してください。

<div id="update-with-admin-ui">
  ## admin UI で更新
</div>

デプロイ設定を変更せずに、W\&B App 内の admin UI を使用してライセンスキーをローテーションできます。この方法は、W\&B Server コンテナーで環境変数を使って設定していないライセンスを更新する場合にのみ利用でき、通常はセルフマネージドの Docker インストールが該当します。この方法で更新されるのはライセンスのみで、実行中の W\&B Server バージョンは変更されません。

1. [W\&B Deployment Page](https://deploy.wandb.ai/) から新しいライセンスを取得し、アップグレードする対象のデプロイに対して、正しい組織と deployment ID に一致していることを確認します。
2. W\&B App の **License** ページにアクセスします。**Settings** > **License** をクリックするか、`HOST_URL/console/settings/license` にアクセスします。ここで、`HOST_URL` は W\&B Server のホスト URL です。
3. ライセンス管理のセクションにアクセスします。
4. 新しいライセンスキーを入力し、変更を保存します。