Enregistrer un notebook sur GitHub

Enregistrer un notebook sur GitHub

Les notebooks gérés Vertex AI Workbench sont obsolètes. À compter du 30 janvier 2025, les notebooks gérés ne seront plus pris en charge et il ne sera plus possible de créer des instances de notebooks gérés. Les instances existantes continueront de fonctionner, mais les correctifs, mises à jour et mises à niveau ne seront plus disponibles. Pour continuer à utiliser Vertex AI Workbench, nous vous recommandons de migrer vos instances de notebooks gérés vers des instances Vertex AI Workbench.

Pour sauvegarder votre instance de notebooks gérés et la mettre à disposition d'autres utilisateurs, enregistrez le contenu de votre instance de notebooks gérés dans GitHub.

Créer un dépôt GitHub

Si vous n'avez pas encore de dépôt GitHub, vous devez en créer un.

Lorsque vous créez votre dépôt GitHub, assurez-vous qu'il peut être cloné en cochant la case Initialize this repository with a README (Initialiser ce dépôt avec un fichier README).

Cloner votre dépôt GitHub dans votre instance de notebooks gérés

Pour cloner votre dépôt GitHub dans votre instance de notebooks gérés, procédez comme suit :

1. Dans votre dépôt GitHub, cliquez sur le bouton Code, puis sur l'onglet Local.

2. Copiez l'URL HTTPS.

3. Dans Google Cloud Console, accédez à la page Notebooks gérés.

   Accéder à la page "Notebooks gérés"

4. Cliquez sur Ouvrir JupyterLab pour ouvrir votre instance de notebooks gérés.

5. Dans le Navigateur de fichiers  de JupyterLab, sélectionnez le dossier dans lequel vous souhaitez cloner le dépôt GitHub. Par exemple, le dossier de base.

   

6. Dans JupyterLab, sélectionnez Git > Cloner un dépôt.

7. Si vous y êtes invité, saisissez vos identifiants.

   • Si vous utilisez un nom d'utilisateur et un mot de passe GitHub, saisissez-les.

   • Si vous utilisez une authentification à deux facteurs avec GitHub, créez un jeton d'accès personnel et utilisez-le.

8. Dans la boîte de dialogue Cloner un dépôt, collez l'URL HTTPS de votre dépôt GitHub.

   

9. Cliquez sur Clone (Cloner).

Configurer votre instance de notebooks gérés avec vos informations utilisateur GitHub

1. Dans JupyterLab, sélectionnez Git > Ouvrir le dépôt Git dans le terminal pour ouvrir une fenêtre de terminal Git.

2. Dans la fenêtre du terminal Git, entrez les commandes suivantes pour configurer votre nom d'utilisateur et votre adresse e-mail Git :

   git config --global user.name "YOUR_NAME"
   git config --global user.email "YOUR_EMAIL"

3. Si votre compte GitHub nécessite une authentification SSH, procédez comme suit pour l'associer :

   1. Depuis le terminal Git dans votre instance de notebooks gérés, suivez les instructions de GitHub pour générer une nouvelle clé SSH.

   2. Suivez les instructions pour ajouter cette clé SSH à votre compte GitHub.

4. Fermez la fenêtre du terminal Git.

Ajouter vos fichiers validés à votre dépôt GitHub

1. Votre instance de notebooks gérés affiche votre dépôt dans un nouveau dossier. Si vous ne voyez pas votre dépôt GitHub cloné sous forme de dossier, cliquez sur le bouton Actualiser la liste des fichiers.

   

2. Double-cliquez sur le dossier de votre dépôt pour l'ouvrir.

3. Ajoutez un nouveau notebook à votre instance de notebooks gérés.

   Pour ajouter un fichier notebook, vous pouvez utiliser le menu ou le lanceur d'applications.

   Menu

   1. Pour ajouter un fichier notebook depuis le menu, sélectionnez File > New > Notebook (Fichier > Nouveau > Notebook).

      

   2. Dans la boîte de dialogue Sélectionner le noyau, sélectionnez le noyau du nouveau notebook, par exemple Python 3, puis cliquez sur Sélectionner.

      Le nouveau fichier notebook s'ouvre.

   Lanceur d'applications

   1. Pour ajouter un fichier notebook à partir du lanceur d'applications, sélectionnez Fichier > Nouveau > Lanceur d'applications.

   2. Cliquez sur la tuile du noyau que vous souhaitez utiliser.

      

      Le nouveau fichier notebook s'ouvre.

4. Renommez le nouveau fichier notebook.

   Menu

   1. Sélectionnez Fichier > Renommer le notebook. La boîte de dialogue Renommer le fichier s'ouvre.

   2. Dans le champ Nouveau nom, remplacez Untitled.ipynb par un nom significatif, tel que install.ipynb.

   3. Cliquez sur Renommer.

   Lanceur d'applications

   1. Cliquez avec le bouton droit sur l'onglet Untitled.ipynb, puis cliquez sur Renommer le notebook. La boîte de dialogue Renommer le fichier s'ouvre.

   2. Dans le champ Nouveau nom, remplacez Untitled.ipynb par un nom significatif, tel que install.ipynb.

   3. Cliquez sur Renommer.

5. Sélectionnez l'onglet Git. Votre nouveau notebook est répertorié dans le groupe Non suivi.

6. Pour ajouter le nouveau notebook en tant que fichier dans votre dépôt GitHub, faites un clic droit sur le nouveau notebook et sélectionnez Suivre. Dans l'onglet Git, votre notebook est maintenant ajouté au regroupement par étapes.

7. Pour valider votre nouveau notebook dans votre dépôt GitHub, dans l'onglet Git, ajoutez un commentaire de validation et cliquez sur Valider.

8. Pour ouvrir une fenêtre de terminal Git, sélectionnez Git > Ouvrir le dépôt Git dans le terminal.

9. Dans la fenêtre du terminal Git, saisissez la commande git push.

   • Si vous utilisez un nom d'utilisateur et un mot de passe GitHub, saisissez-les lorsque vous y êtes invité.

   • Si vous utilisez une authentification à deux facteurs avec GitHub, créez un jeton d'accès personnel.

   Lorsque la commande git push se termine, vos fichiers validés se trouvent dans votre dépôt GitHub.