Mettre à niveau l'environnement d'une instance

Les instances Vertex AI Workbench sont des instances Deep Learning VM Image dans lesquelles les environnements de notebook JupyterLab sont activés et prêts à l'emploi. Cette page explique comment mettre à niveau l'environnement d'une instance Vertex AI Workbench.

Motifs de la mise à niveau

Vous pouvez être amené à mettre à niveau l'environnement de votre instance Vertex AI Workbench pour l'une des raisons suivantes :

  • Pour utiliser les nouvelles fonctionnalités qui ne sont disponibles que dans une version plus récente de votre environnement.

  • Pour bénéficier des mises à jour de framework, des mises à jour de packages et des corrections de bugs intégrées dans une version plus récente de votre environnement.

Méthodes de mise à niveau

Il existe deux façons de mettre à niveau une instance Vertex AI Workbench :

  • Mise à niveau automatique : activez la mise à niveau automatique lorsque vous créez une instance Vertex AI Workbench. Pendant une période récurrente que vous spécifiez, Vertex AI Workbench vérifie si votre instance peut être mise à niveau et, le cas échéant, met à niveau votre instance.

  • Mise à niveau manuelle : si une instance Vertex AI Workbench existante respecte les conditions de la mise à niveau, vous pouvez mettre à niveau l'instance manuellement.

Conditions requises et limites

La rétrocompatibilité avec Vertex AI Workbench n'est pas garantie. Effectuez une copie de vos données avant de mettre à niveau une instance Vertex AI Workbench.

Pour déterminer si vous pouvez mettre à niveau une instance Vertex AI Workbench spécifique, consultez les exigences et limitations suivantes :

  • L'API Notebooks doit être activée dans le projet Google Cloud de l'instance. Pour en savoir plus, consultez les sections Répertorier les services activés et Activer une API.

  • Si votre instance Vertex AI Workbench est basée sur des conteneurs, Vertex AI Workbench met à niveau le système d'exploitation. La version d'image dépend de l'image spécifique extraite par votre fichier Dockerfile.

    Pour vous assurer que la mise à niveau utilise la version la plus récente de l'image, envisagez d'utiliser le tag latest dans votre fichier Dockerfile.

Si la mise à niveau de votre instance n'est pas possible dans votre cas, envisagez de migrer vos données vers une nouvelle instance Vertex AI Workbench.

Fonctionnement de la mise à niveau

Les instances Vertex AI Workbench pouvant être mises à niveau sont des instances à deux disques, avec un disque de démarrage et un disque de données. Le processus met à niveau le disque de démarrage vers une nouvelle image tout en conservant les données sur le disque de données.

Quels composants sont mis à niveau ou conservés ?

Le tableau suivant indique les composants de votre instance Vertex AI Workbench qui sont mis à niveau et ceux qui sont conservés.

Composant Résultat de la mise à niveau
Frameworks de machine learning Mise à niveau
Données de machine learning Conservés
Dépendances préinstallées Mise à niveau
Bibliothèques installées par l'utilisateur Par défaut, doit être réinstallé (voir Bibliothèques installées par l'utilisateur).
Fichiers locaux dans le répertoire /home/jupyter Conservés
Fichiers locaux dans tout autre répertoire /home/ Aucune conservation
Packages de système d'exploitation préinstallés Mise à niveau
Packages de système d'exploitation installés par l'utilisateur Aucune conservation
Pilotes de GPU Mise à niveau
Notebooks Conservés
Configurations utilisateur Conservés

Bibliothèques installées par l'utilisateur

Par défaut, les instances Vertex AI Workbench stockent les bibliothèques pip et Conda dans le disque de démarrage, qui est remplacé lors d'une mise à niveau. Lorsque vous installez des bibliothèques pip, vous pouvez inclure l'option --user pour les installer dans le répertoire /home/jupyter/, où elles sont conservées lors d'une mise à niveau.

Par défaut, si vous installez des bibliothèques pip ou Conda dans un noyau créé à partir d'un conteneur personnalisé, les bibliothèques ne persistent que pendant l'exécution du noyau. Chaque fois que le noyau est redémarré, ces bibliothèques doivent être réinstallées. Pour installer des bibliothèques persistantes dans un conteneur personnalisé, incluez les installations de bibliothèques dans votre fichier Dockerfile. Lorsque vous installez des bibliothèques pip dans un noyau créé à partir d'un conteneur personnalisé, vous pouvez inclure l'option --user afin que les bibliothèques persistent jusqu'au redémarrage de l'instance.

Versions d'environnement

Votre instance Vertex AI Workbench possède un numéro de version d'environnement que vous pouvez vérifier :

  1. Dans la console Google Cloud, accédez à la page Instances.

    Accéder à la page "Instances"

  2. Dans la liste des instances, recherchez le numéro de version de l'environnement de votre instance dans la colonne Version.

Vertex AI Workbench met régulièrement à jour les environnements (consultez les notes de version de Deep Learning VM), mais les environnements ne sont pas tous mis à jour à chaque nouvelle version. Vertex AI Workbench ne met à niveau une instance que s'il existe une version plus récente de l'environnement pour l'image de VM sur laquelle votre instance est basée.

Pour en savoir plus sur l'utilisation d'une version spécifique pour créer une instance Vertex AI Workbench, consultez la page Créer une version spécifique d'une instance Vertex AI Workbench.

Avant de commencer

Avant de mettre à niveau, procédez comme suit :

  1. Consultez les notes de version pour en savoir plus sur les mises à jour vers des versions plus récentes.

  2. Créer une copie de vos données en tant que sauvegarde.

Mise à niveau automatique

Vertex AI Workbench peut automatiquement mettre à niveau les instances en cours d'exécution. Si votre instance est arrêtée, elle n'est pas automatiquement mise à niveau, même si vous avez activé la mise à niveau automatique lors de sa création.

Lorsque vous activez les mises à niveau automatiques de l'environnement, vous spécifiez une période récurrente pendant laquelle Vertex AI Workbench vérifie si l'instance peut être mise à niveau et, le cas échéant, met à niveau l'instance.

La période que vous spécifiez est stockée sous la forme d'une entrée de métadonnées notebook-upgrade-schedule, au format unix-cron, à l'heure du méridien de Greenwich (GMT).

Pour vérifier si une instance peut être mise à niveau, Vertex AI Workbench utilise la méthode API checkUpgradability. Cette méthode recherche une version plus récente de l'image sur le disque de démarrage de l'instance.

Si l'instance peut être mise à niveau, Vertex AI Workbench utilise une méthode de mise à niveau interne pour mettre à niveau l'instance.

Créer une instance Vertex AI Workbench avec la mise à niveau automatique activée

Pour créer une instance Vertex AI Workbench avec la mise à niveau automatique activée, cochez la case Activer la mise à niveau automatique de l'environnement et définissez le calendrier de mise à niveau au moment de créer l'instance.

Vous pouvez spécifier une mise à niveau automatique à l'aide de la console Google Cloud.

  1. Dans la console Google Cloud, accédez à la page Instances.

    Accéder à la page "Instances"

  2. Cliquez sur  Créer.

  3. Dans la boîte de dialogue Nouvelle instance, cliquez sur Options avancées.

  4. Dans la boîte de dialogue Créer une instance, dans la section Détails, fournissez les informations suivantes pour la nouvelle instance :

    • Nom : donnez un nom à la nouvelle instance.
    • Région et Zone : sélectionnez une région et une zone pour la nouvelle instance. Pour obtenir les meilleures performances réseau, sélectionnez la région la plus proche de vous géographiquement. Consultez les emplacements disponibles pour Vertex AI Workbench.

  5. Dans la section État du système, sélectionnez Mise à niveau automatique de l'environnement.

  6. Vous pouvez choisir de mettre à niveau votre notebook toutes les semaines ou tous les mois.

  7. Dans le champ Jour de la semaine, sélectionnez l'option de votre choix.

  8. Dans le champ Heure, sélectionnez une heure de la journée.

  9. Renseignez le reste de la boîte de dialogue de création d'instance, puis cliquez sur Créer.

Modifier le calendrier de mise à niveau automatique

Pour modifier le calendrier de mise à niveau automatique après avoir créé votre instance Vertex AI Workbench, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Instances.

    Accéder à la page "Instances"

  2. Cliquez sur le nom de l'instance qui nécessite une modification de la programmation.

  3. Dans la section Mise à niveau automatique des environnements de la page Détails de l'instance, modifiez la programmation.

  4. Cliquez sur Soumettre pour enregistrer les modifications.

Mise à niveau manuelle

Vous pouvez mettre à niveau manuellement les instances Vertex AI Workbench qui répondent à ces conditions.

Rechercher une version plus récente de l'environnement de votre instance

Pour vérifier si une version plus récente de l'environnement de votre instance est disponible, accédez à votre instance à partir de la console Google Cloud.

  1. Dans la console Google Cloud, accédez à la page Instances.

    Accéder à la page "Instances"

  2. Cliquez sur le nom de l'instance pour laquelle vous souhaitez vérifier la disponibilité d'une version plus récente de l'environnement.

  3. Sur la page Détails de l'instance, à côté de Détails de la VM, cliquez sur Afficher dans Compute Engine.

    Si une version plus récente de l'environnement est disponible, le message "Cette instance doit être mise à niveau" s'affiche.

Mettre à niveau l'environnement de votre instance vers une version plus récente

Vous pouvez mettre à niveau manuellement une instance Vertex AI Workbench dans la console Google Cloud.

  1. Dans la console Google Cloud, accédez à la page Instances.

    Accéder à la page "Instances"

  2. Si votre instance n'est pas en cours d'exécution, démarrez-la. Vertex AI Workbench ne peut mettre à niveau des instances que lorsqu'elles sont en cours d'exécution.

  3. Cliquez sur le nom de l'instance que vous souhaitez mettre à niveau.

  4. Sur la page Détails de l'instance, cliquez sur  Mettre à niveau.

  5. Assurez-vous d'avoir effectué une copie des données sur votre instance avant de continuer.

  6. Une fois vos données sauvegardées, cliquez sur Mettre à niveau. Vertex AI Workbench met à niveau et démarre votre instance.

Effectuer le rollback d'une mise à niveau

Pour effectuer le rollback d'une mise à niveau, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Instances.

    Accéder à la page "Instances"

  2. Cliquez sur le nom de l'instance à restaurer.

  3. Sur la page Détails de l'instance, sous Historique de mise à niveau, cliquez sur Rollback.

  4. Vertex AI Workbench restaure la version précédente de votre instance.