Mettre à jour la licence et la version de W&B

Guide de mise à jour de la version et de la licence de W&B selon différentes méthodes d’installation.

Ce guide explique aux administrateurs du serveur W&B comment mettre à jour la version du serveur W&B et la clé de licence pour un déploiement autogéré existant. Maintenir votre serveur et votre licence à jour garantit l’accès aux dernières fonctionnalités, aux derniers correctifs, ainsi que le maintien de votre droit d’utiliser le serveur W&B.

Mettez à jour la version et la licence de votre serveur W&B en utilisant la même méthode que celle utilisée pour installer le serveur W&B. Le tableau suivant répertorie les procédures de mise à jour de votre licence et de votre version selon différentes méthodes de déploiement.

Type de déploiement	Description
Terraform	W&B prend en charge trois modules Terraform publics pour le déploiement dans le cloud : AWS, Google Cloud et Azure.
Helm	Utilisez le chart Helm pour installer W&B dans un cluster Kubernetes existant.

​

Mettre à jour avec Terraform

Si vous avez déployé le serveur W&B avec l’un des modules Terraform maintenus par W&B, utilisez Terraform pour mettre à jour directement votre clé de licence et la version de W&B. Le tableau suivant répertorie les modules Terraform gérés par W&B par plateforme cloud.

fournisseur de cloud	Terraform module
AWS	Module Terraform AWS
Google Cloud	Module Terraform Google Cloud
Azure	Module Terraform Azure

1. Accédez au module Terraform maintenu par W&B pour votre fournisseur de cloud. Reportez-vous au tableau ci-dessus pour trouver le module Terraform correspondant à votre fournisseur de cloud.

2. Dans votre configuration Terraform, mettez à jour wandb_version et license dans la configuration de votre module Terraform wandb_app :

   module "wandb_app" {
       source  = "wandb/wandb/[CLOUD-SPECIFIC-MODULE]"
       version = "new_version"
       license       = "new_license_key" # Votre nouvelle clé de licence
       wandb_version = "new_wandb_version" # Version W&B souhaitée
       ...
   }
   

3. Appliquez la configuration Terraform avec terraform plan et terraform apply.

   terraform init
   terraform apply
   

4. Facultatif : si vous utilisez un fichier terraform.tfvars ou un autre fichier .tfvars, mettez-le à jour ou créez-en un avec la nouvelle version de W&B et la nouvelle clé de licence.

   terraform plan -var-file="terraform.tfvars"
   

   Depuis le répertoire de votre espace de travail Terraform, appliquez la configuration :

   terraform apply -var-file="terraform.tfvars"
   

Après application de la modification par Terraform, votre déploiement exécute la version spécifiée de W&B et utilise la clé de licence mise à jour.

​

Mise à jour avec Helm

Le chart Helm wandb est obsolète et n’est plus pris en charge. Il déployait un seul pod et a été remplacé par l’opérateur Kubernetes W&B. Si vous utilisez encore ce chart, suivez le guide de migration pour passer à l’opérateur.

Deux méthodes de mise à jour avec Helm sont disponibles : mettez à jour à partir de votre fichier de valeurs Helm existant, ou définissez directement la nouvelle licence et la balise d’image dans la commande de mise à niveau. Les sections suivantes décrivent chaque approche.

​

Mettre à jour W&B avec le fichier de spécification

Utilisez cette approche lorsque vous gérez votre configuration Helm dans un fichier de valeurs *.yaml suivi.

1. Spécifiez une nouvelle version en modifiant la valeur image.tag ou license, ou les deux, dans le fichier de configuration *.yaml de votre chart Helm :

   license: 'new_license'
   image:
     repository: wandb/local
     tag: 'new_version'
   

2. Mettez à jour le dépôt Helm et mettez à niveau la version W&B à l’aide de votre fichier de valeurs :

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

​

Mettre à jour directement la licence et la version

Utilisez cette approche pour mettre à jour la licence et le tag d’image sans modifier de fichier de valeurs, et réutiliser votre configuration de version Helm existante.

1. Définissez la nouvelle clé de licence et le nouveau tag d’image comme variables d’environnement :

   export LICENSE='new_license'
   export TAG='new_version'
   

2. Mettez à jour votre release Helm, en fusionnant les nouvelles valeurs avec la configuration existante :

   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
   

Pour plus d’informations, voir le guide de mise à niveau dans le dépôt public.

​

Mettre à jour via l’interface d’administration

Utilisez l’interface d’administration pour remplacer votre clé de licence depuis la W&B App, sans modifier la configuration de votre déploiement. Cette méthode fonctionne uniquement pour mettre à jour des licences qui ne sont pas définies à l’aide d’une variable d’environnement dans le conteneur du serveur W&B, généralement dans des installations Docker autogérées. Cette méthode met à jour uniquement la licence. Elle ne modifie pas la version du serveur W&B en cours d’exécution.

1. Obtenez une nouvelle licence depuis la W&B Deployment Page, en vous assurant qu’elle correspond à la bonne organisation et au bon ID de déploiement pour le déploiement que vous souhaitez mettre à niveau.
2. Accédez à la page License dans la W&B App. Cliquez sur Settings > License ou accédez à HOST_URL/console/settings/license, où HOST_URL correspond à l’URL hôte de votre serveur W&B.
3. Accédez à la section de gestion des licences.
4. Saisissez la nouvelle clé de licence et enregistrez les modifications.