Enregistrer un notebook sur GitHub

Pour sauvegarder votre instance de notebooks gérés par l'utilisateur et la mettre à disposition d'autres utilisateurs, enregistrez le contenu de votre instance de notebooks gérés par l'utilisateur 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).

Initialiser un dépôt GitHub à l'aide d'un fichier README.

Clonez votre dépôt GitHub dans votre instance de notebooks gérés par l'utilisateur

Pour cloner votre dépôt GitHub dans votre instance de notebooks gérés par l'utilisateur, 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 par l'utilisateur.

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

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

  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.

    Dossier de base Notebook.

  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.

    Coller l'URL du dépôt et le cloner.

  9. Cliquez sur Clone (Cloner).

Configurez votre instance de notebooks gérés par l'utilisateur 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 par l'utilisateur, 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 par l'utilisateur affiche votre dépôt en tant que 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.

    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 par l'utilisateur.

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

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

      Ajouter un fichier 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.

      Ajouter un fichier notebook.

      Le nouveau fichier notebook s'ouvre.

  4. Renommez le nouveau fichier notebook.

    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.