Enregistrer une ancienne instance avec l'API Notebooks

Cette page explique comment migrer et enregistrer une ancienne instance de notebooks gérés par l'utilisateur avec l'API Notebooks. Les instances créées à l'aide de l'API Compute Engine sont appelées anciennes instances. Les anciennes instances ne disposent pas des dernières mises à jour des fonctionnalités et caractéristiques.

Pour utiliser les nouvelles fonctionnalités et caractéristiques disponibles avec l'API Notebooks, vous devez enregistrer vos anciennes instances avec l'API Notebooks. Avant d'enregistrer vos anciennes instances, vérifiez si elles répondent aux exigences. Vous pouvez migrer des instances qui ne répondent pas aux exigences.

Si vous activez l'API Notebooks avant d'enregistrer vos anciennes instances, le processus d'activation de l'API Notebooks tente d'enregistrer automatiquement vos anciennes instances existantes.

Conditions requises et limites

Avant d'enregistrer vos anciennes instances avec l'API Notebooks, tenez compte des exigences et des limites suivantes.

  • Les zones source et de destination doivent correspondre et être une zone valide pour l'API Notebooks.

    Par exemple, une ancienne instance de notebooks gérés par l'utilisateur dans us-west1-a reste dans us-west1-a lorsqu'elle est enregistrée auprès de l'API Notebooks. En revanche, une ancienne instance de notebooks gérés par l'utilisateur dans us-central1-f ne s'enregistrera pas auprès de l'API Notebooks, car us-central1-f n'est pas une zone valide pour l'API Notebooks.

    Pour obtenir la liste des zones valides pour les instances de notebooks de l'API Notebooks, exécutez la commande suivante à l'aide de Google Cloud CLI dans le terminal de votre choix ou dans Cloud Shell :

    gcloud notebooks locations list

    Si la zone de votre ancienne instance n'est pas une zone valide pour l'API Notebooks, vous pouvez contacter l'assistance ou votre responsable de compte, ou migrer l'ancienne instance vers une nouvelle instance de notebooks gérés par l'utilisateur.

  • Seules les instances à deux disques peuvent utiliser toutes les fonctionnalités des notebooks gérés par l'utilisateur.

    Les anciennes instances à disque unique ne peuvent pas utiliser certaines fonctionnalités de notebooks gérés par l'utilisateur, telles que la mise à niveau automatique, même après leur enregistrement avec l'API Notebooks. Pour permettre à votre ancienne instance à disque unique d'utiliser toutes les fonctionnalités disponibles, vous devez migrer votre instance à disque unique vers une instance à deux disques.

    Vous pouvez migrer votre instance à disque unique vers une instance à deux disques dans le cadre de votre migration d'une ancienne instance vers une instance enregistrée auprès de l'API Notebooks. Si vous avez déjà enregistré l'ancienne instance auprès de l'API Notebooks, vous pouvez toujours migrer l'instance vers une nouvelle instance à deux disques pour résoudre le problème.

    Pour vérifier le nombre de disques, procédez comme suit :

    Console

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

      Accéder à la page "Instances de VM"

    2. Recherchez l'ancienne instance de notebooks gérés par l'utilisateur actuelle.

    3. Cliquez sur le nom de l'instance pour ouvrir la page Informations sur l'instance de VM.

    4. Dans les sections Disque de démarrage et Disques supplémentaires, vérifiez le nombre de disques associés à la VM.

    gcloud

    1. Dans Cloud Shell ou dans tout environnement dans lequel Google Cloud CLI est installé, saisissez la commande suivante de Google Cloud CLI :

      gcloud compute instances describe MY_INSTANCE_NAME
    --zone=MY_ZONE

      Remplacez les éléments suivants :

      • MY_INSTANCE_NAME : nom de l'instance
      • MY_ZONE : zone de l'instance

    2. Examinez les informations qui suivent l'élément disks: et vérifiez le nombre de disques associés à la VM.

Migrer une ancienne instance vers une nouvelle instance de notebooks gérés par l'utilisateur

Si l'ancienne instance de notebooks gérés par l'utilisateur se situe dans une zone qui n'est pas valide pour l'API Notebooks ou si vous souhaitez migrer d'une instance à disque unique vers une instance à deux disques, vous devez créer une instance de notebooks gérés par l'utilisateur et copier vos données utilisateur de votre ancienne instance vers la nouvelle instance.

Pour créer une instance de notebooks gérés par l'utilisateur et copier vos données utilisateur de votre ancienne instance vers la nouvelle instance, procédez comme suit :

  1. Pour utiliser ssh pour vous connecter à votre ancienne instance, dans Cloud Shell ou dans tout environnement dans lequel Google Cloud CLI est installé, saisissez la commande suivante de Google Cloud CLI :

    export PROJECT_ID="MY_PROJECT_ID"
export ZONE="MY_ZONE"
export INSTANCE_NAME="MY_INSTANCE"
gcloud compute ssh
    --project $PROJECT_ID
    --zone $ZONE $INSTANCE_NAME
    -- -L 8080:localhost:8080

    Remplacez les éléments suivants :

    • MY_PROJECT_ID : ID de votre projet Google Cloud
    • MY_ZONE : zone de l'instance
    • MY_INSTANCE : nom de l'instance avec les informations pertinentes

  2. Pour copier le contenu de l'ancienne instance dans un bucket Cloud Storage, utilisez gsutil. L'exemple de commande suivant copie tous les fichiers de notebook (.ipynb) du répertoire par défaut /home/jupyter/ dans un répertoire Cloud Storage nommé my-bucket/legacy-notebooks.

    gsutil cp -R /home/jupyter/*.ipynb gs://my-bucket/legacy-notebooks/

  3. Créez une instance de notebook gérés par l'utilisateur avec les mêmes spécifications matérielles que l'ancienne instance. Vous pouvez créer l'instance à l'aide de la console Googl Cloud ou de Google Cloud CLI.

    Dans cet exemple, Vertex AI Workbench crée une instance de notebooks gérés par l'utilisateur nommée new-notebook dans le projet example à l'aide de la dernière image TensorFlow 2, avec un type de machine n1-standard-1, dans la zone us-west1-a.

    Dans Cloud Shell ou dans tout environnement dans lequel Google Cloud CLI est installé, saisissez la commande suivante de Google Cloud CLI :

    gcloud notebooks instances create new-notebook \
    --vm-image-project=example \
    --vm-image-family=tf-latest-cpu \
    --machine-type=n1-standard-1 \
    --location=us-west1-a

    La nouvelle instance de notebooks gérés par l'utilisateur est une instance à deux disques. Elle dispose d'un disque de démarrage et d'un disque de données.

  4. Utilisez ssh pour vous connecter à l'instance de notebooks gérés par l'utilisateur que vous venez de créer.

  5. Pour copier le contenu de l'ancienne instance du bucket Cloud Storage vers la nouvelle instance, utilisez gsutil. L'exemple de commande suivant copie tous les fichiers de notebook (.ipynb) du répertoire Cloud Storage dans le répertoire /home/jupyter/ de la nouvelle instance.

    gsutil cp -R gs://my-bucket/legacy-notebooks/*.ipynb  /home/jupyter/

  6. Dans la nouvelle instance de notebooks gérés par l'utilisateur, ouvrez JupyterLab et vérifiez que les éléments et les données utilisateur ont bien été copiés.

  7. Facultatif : supprimez l'ancienne instance.

Enregistrer une ancienne instance avec l'API Notebooks

Pour utiliser l'API Notebooks afin de gérer vos anciennes instances, vous devez enregistrer vos anciennes instances avec l'API Notebooks.

Si vous activez l'API Notebooks avant d'enregistrer vos anciennes instances, le processus d'activation de l'API Notebooks tente d'enregistrer automatiquement vos anciennes instances existantes. Si vous créez d'anciennes instances après l'activation de l'API Notebooks, vous devez les enregistrer manuellement à l'aide de l'une des méthodes suivantes.

Pour enregistrer votre ancienne instance avec l'API Notebooks, vous pouvez utiliser Google Cloud Console ou l'API Notebooks.

Console

Pour utiliser l'option Tout enregistrer dans la console Google Cloud, procédez comme suit :

  1. Dans Google Cloud Console, accédez à la page Notebooks gérés par l'utilisateur.

    Accéder à la page Notebooks gérés par l'utilisateur

  2. Si vous disposez d'une ou de plusieurs instances de notebooks gérés par l'utilisateur anciennes, un message vous indique que vous devez les enregistrer avec l'API Notebooks. À côté de ce message, cliquez sur Tout enregistrer.

  3. Si vous n'avez pas d'anciennes instances de notebooks gérés par l'utilisateur, mais que vous n'avez pas encore activé l'API Notebooks, cliquez sur Activer l'API Notebooks pour vous assurer que les nouvelles instances de notebooks gérés par l'utilisateur sont créées à l'aide de l'API Notebooks.

API Notebooks

Pour utiliser la méthode register fournie par l'API Notebooks, dans Cloud Shell ou dans tout environnement dans lequel Google Cloud CLI est installé, saisissez la commande suivante de Google Cloud CLI :

gcloud notebooks instances register MY_INSTANCE_NAME
    --location=MY_ZONE

Remplacez les éléments suivants :

  • MY_INSTANCE_NAME : nom de l'instance
  • MY_ZONE : zone de l'instance

Étape suivante