Migrer des données vers une nouvelle instance de notebooks gérés par l'utilisateur

Cette page explique comment migrer des données et des fichiers depuis une instance de notebooks gérés existante vers une nouvelle instance.

Quand migrer ?

Vous pouvez migrer vers une nouvelle instance de notebooks gérés pour l'une des raisons suivantes :

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

• 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.

• Si vous ne parvenez pas à mettre à niveau l'environnement d'une instance existante. Consultez les exigences relatives à la mise à niveau de l'environnement d'une instance de notebooks gérés.

Options de migration

Pour migrer des données et des fichiers d'une instance de notebooks gérés à une autre, envisagez les méthodes suivantes :

• Utiliser GitHub : copiez vos données et vos fichiers dans un dépôt GitHub à l'aide de l'extension Git pour JupyterLab.

• Utiliser Cloud Storage et le terminal : copiez vos données et vos fichiers sur Cloud Storage, puis sur une autre instance à l'aide du terminal.

• Utiliser Cloud Storage dans les notebooks JupyterLab : copiez vos données et vos fichiers dans Cloud Storage, puis sur une autre instance en exécutant des commandes dans les cellules de notebook de vos instances respectives.

Ce guide explique comment migrer des données et des fichiers à l'aide de Cloud Storage et du terminal.

Conditions requises

Vous devez disposer d'un accès terminal à votre instance de notebooks gérés. L'accès au terminal est défini manuellement lorsque vous créez une instance. Le paramètre d'accès au terminal ne peut pas être modifié une fois l'instance créée.

Avant de commencer

Créez un bucket Cloud Storage dans le projet où se trouve votre instance de notebooks gérés.

Migrer vos données vers une nouvelle instance de notebooks gérés

Pour migrer des données et des fichiers vers une nouvelle instance de notebooks gérés à l'aide de Cloud Storage et du terminal, procédez comme suit :

1. Dans l'interface JupyterLab de votre instance de notebooks gérés, sélectionnez Fichier > Nouveau > Terminal pour ouvrir une fenêtre de terminal.

2. Utilisez gsutil tool pour copier vos données utilisateur dans un bucket Cloud Storage. L'exemple de commande suivant copie tous les fichiers du répertoire /home/jupyter/ de votre instance dans un répertoire situé dans un bucket Cloud Storage.

   gsutil cp -R /home/jupyter/* gs://BUCKET_NAMEPATH
   

   Remplacez les éléments suivants :

   • BUCKET_NAME : nom du bucket Cloud Storage.
   • PATH : chemin d'accès au répertoire dans lequel vous souhaitez copier vos fichiers, par exemple : /copy/jupyter/

3. créer une instance de notebooks gérés

4. Dans l'interface JupyterLab de votre nouvelle instance de notebooks gérés, sélectionnez Fichier > Nouveau > Terminal pour ouvrir une fenêtre de terminal.

5. Utilisez gsutil tool pour restaurer vos données sur la nouvelle instance. L'exemple de commande suivant copie tous les fichiers d'un répertoire Cloud Storage vers le répertoire /home/jupyter/ de votre nouvelle instance.

   gsutil cp gs://BUCKET_NAMEPATH* /home/jupyter/
   

Étapes suivantes

• Apprenez à mettre à niveau manuellement l'environnement des instances de notebooks gérés.