> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

> インストール方法ごとに W&B のバージョンとライセンスを更新する方法を説明するガイドです。

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

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

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

| リリースタイプ | 説明 |
| - | - |
| [Terraform](#update-with-terraform) | W\&B は、クラウドデプロイメント向けに [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) の 3 つの公開 Terraform モジュールをサポートしています。 |
| [Helm](#update-with-helm) | [Helm チャート](https://github.com/wandb/helm-charts) を使用して、既存の Kubernetes クラスターに W\&B をインストールします。 |

<h2 id="update-with-terraform">
  Terraform で更新する
</h2>

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

| クラウドプロバイダー | Terraform モジュール |
| - | - |
| AWS | [AWS Terraform モジュール](https://registry.terraform.io/modules/wandb/wandb/aws/latest) |
| Google Cloud | [Google Cloud Terraform モジュール](https://registry.terraform.io/modules/wandb/wandb/google/latest) |
| Azure | [Azure Terraform モジュール](https://registry.terraform.io/modules/wandb/wandb/azurerm/latest) |

1. ご利用のクラウドプロバイダー向けの、W\&B が管理する Terraform モジュールにアクセスします。ご利用のクラウドプロバイダーに対応する Terraform モジュールは、前の表で確認してください。

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

   ```hcl theme={"system"}
   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={"system"}
   terraform init
   terraform apply
   ```

4. オプション: `terraform.tfvars` などの `.tfvars` ファイルを使用している場合は、新しい W\&B のバージョンとライセンスキーでファイルを更新するか、新たに作成します。
   ```bash theme={"system"}
   terraform plan -var-file="terraform.tfvars"
   ```
   Terraform のワークスペースディレクトリで、設定を適用します。
   ```bash theme={"system"}
   terraform apply -var-file="terraform.tfvars"
   ```

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

<h2 id="update-with-helm">
  Helm で更新する
</h2>

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

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

<h3 id="update-wb-with-spec">
  spec を使用して W\&B を更新する
</h3>

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

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

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

2. Helm リポジトリを更新し、values ファイルを使用して W\&B のリリースをアップグレードします。

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

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

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

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

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

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

   ```bash theme={"system"}
   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)を参照してください。

<h2 id="update-with-admin-ui">
  管理 UI で更新する
</h2>

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

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