Mettre à jour la licence et la version de Weights & Biases

Ce guide explique aux administrateurs du serveur W&B comment mettre à jour la version du serveur W&B et la clé de licence d’un déploiement autogéré existant. En maintenant votre serveur et votre licence à jour, vous bénéficiez des dernières fonctionnalités et des derniers correctifs, et vous conservez votre droit d’utilisation du serveur W&B. Mettez à jour la version et la licence de votre serveur W&B en utilisant la même méthode que celle employée pour l’installer. Le tableau suivant indique comment mettre à jour votre licence et votre version selon la méthode de déploiement utilisée.

Type de version	Description
Terraform	Weights & Biases 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 Weights & Biases dans un cluster Kubernetes existant.

Mettre à jour avec Terraform

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

Fournisseur de cloud	Module Terraform
AWS	Module Terraform pour AWS
Google Cloud	Module Terraform pour Google Cloud
Azure	Module Terraform pour Azure

Accédez au module Terraform maintenu par Weights & Biases pour votre fournisseur de cloud. Consultez le tableau ci-dessus pour trouver le module Terraform correspondant à votre fournisseur de cloud.

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 de W&B souhaitée
    ...
}

Appliquez la configuration Terraform avec terraform plan et terraform apply.
terraform init terraform apply
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 Weights & Biases et la nouvelle clé de licence.
terraform plan -var-file="terraform.tfvars"
Depuis le répertoire de votre workspace Terraform, appliquez la configuration :
terraform apply -var-file="terraform.tfvars"

Une fois la modification appliquée par Terraform, votre déploiement exécute la version de Weights & Biases spécifiée et utilise la clé de licence mise à jour.

Mettre à 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 basées sur Helm sont disponibles : partir de votre fichier de valeurs Helm existant, ou définir la nouvelle licence et le nouveau tag d’image directement dans la commande de mise à niveau. Les sections suivantes décrivent chacune de ces méthodes.

Mettre à jour Weights & Biases avec une spec

Utilisez cette méthode si vous gérez votre configuration Helm dans un fichier de valeurs *.yaml suivi.

Indiquez une nouvelle version en modifiant la valeur image.tag, la valeur license, ou les deux, dans le fichier de configuration *.yaml de votre chart Helm :
license: 'new_license' image: repository: wandb/local tag: 'new_version'

Mettez à jour le dépôt Helm, puis mettez à niveau la version Weights & Biases à 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 méthode pour mettre à jour la licence et le tag d’image sans modifier de fichier de valeurs, tout en réutilisant la configuration existante de votre version Helm.

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'

Mettez à niveau votre version 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 avec l’interface d’administration

Utilisez l’interface d’administration pour faire pivoter votre clé de licence directement depuis la W&B App, sans modifier la configuration de votre déploiement. Cette méthode ne s’applique qu’aux licences qui ne sont pas définies par une variable d’environnement dans le conteneur du serveur Weights & Biases, ce qui est généralement le cas des installations Docker autogérées. Elle met uniquement à jour la licence et ne modifie pas la version du serveur W&B en cours d’exécution.

Obtenez une nouvelle licence depuis la page Weights & Biases Deployment, en vérifiant qu’elle correspond à la bonne organisation et à l’ID du déploiement que vous souhaitez mettre à niveau.
Ouvrez la page License dans la W&B App. Cliquez sur Settings > License ou rendez-vous sur HOST_URL/console/settings/license, où HOST_URL correspond à l’URL de l’hôte de votre serveur W&B.
Accédez à la section de gestion des licences.
Saisissez la nouvelle clé de licence et enregistrez vos modifications.

​Mettre à jour avec Terraform

​Mettre à jour avec Helm

​Mettre à jour Weights & Biases avec une spec

​Mettre à jour directement la licence et la version

​Mettre à jour avec l’interface d’administration

Mettre à jour avec Terraform

Mettre à jour avec Helm

Mettre à jour Weights & Biases avec une spec

Mettre à jour directement la licence et la version

Mettre à jour avec l’interface d’administration