Notebook auf GitHub speichern

Auf dieser Seite wird beschrieben, wie Sie die Notebookdateien Ihrer Vertex AI Workbench-Instanz mit der Erweiterung jupyterlab-git in GitHub speichern. Dies können Sie tun, um eine Sicherung des Notebooks zu erstellen oder das Notebook anderen Nutzern zur Verfügung zu stellen.

In Vertex AI Workbench-Instanzen können Sie die Erweiterung jupyterlab-git verwenden, um die Versionsverwaltung zu unterstützen. Weitere Informationen finden Sie auf GitHub unter jupyterlab-git.

GitHub-Repository erstellen

Wenn Sie noch kein GitHub-Repository haben, müssen Sie eines erstellen.

Achten Sie beim Erstellen des GitHub-Repositorys darauf, dass Ihr GitHub-Repository geklont werden kann, indem Sie das Kästchen Dieses Repository mit einer README-Datei initialisieren anklicken.

GitHub-Repository mit README-Datei initialisieren

Klonen Sie das GitHub-Repository in der Vertex AI Workbench-Instanz.

Führen Sie die folgenden Schritte aus, um das GitHub-Repository in der Vertex AI Workbench-Instanz zu klonen:

  1. Klicken Sie in Ihrem GitHub-Repository auf die Schaltfläche Code und dann auf den Tab Lokal.

  2. Kopieren Sie die URL unter HTTPS.

  3. Rufen Sie in der Google Cloud Console die Seite Instanzen auf.

    Zur Seite „VM-Instanzen“

  4. Klicken Sie auf JupyterLab öffnen, um die Vertex AI Workbench-Instanz zu öffnen.

  5. Im JupyterLab Dateibrowser den Ordner aus, in den Sie das GitHub-Repository klonen möchten. Beispiel: der Basisordner.

  6. Wählen Sie in JupyterLab Git > Repository klonen aus.

  7. Fügen Sie im Dialogfeld Repository klonen die HTTPS-URL für Ihr GitHub-Repository ein.

  8. Geben Sie Ihre Anmeldedaten ein, wenn Sie dazu aufgefordert werden.

    • Wenn Sie einen GitHub-Nutzernamen und ein GitHub-Passwort verwenden, geben Sie Ihren GitHub-Nutzernamen und das Passwort ein.

    • Wenn Sie die 2-Faktor-Authentifizierung mit GitHub nutzen, erstellen Sie ein persönliches Zugriffstoken und verwenden Sie dieses.

  9. Klicken Sie auf Klonen.

  10. Ihre Vertex AI Workbench-Instanz zeigt Ihr Repository als neuen Ordner an. Wenn Ihr geklontes GitHub-Repository nicht als Ordner angezeigt wird, klicken Sie auf die Schaltfläche Dateiliste aktualisieren, wie nachstehend gezeigt:

Vertex AI Workbench-Instanz mit den GitHub-Nutzerinformationen konfigurieren

  1. Öffnen Sie in JupyterLab den Ordner, in dem sich Ihr Repository befindet.

  2. Wählen Sie Git > Git Repository in Terminal öffnen aus, um ein Git-Terminalfenster zu öffnen.

  3. Geben Sie im Git-Terminalfenster die folgenden Befehle ein, um Ihren Git-Nutzernamen und Ihre E-Mail-Adresse zu konfigurieren:

    git config --global user.name "USERNAME"
    git config --global user.email "EMAIL_ADDRESS"
    

    Ersetzen Sie Folgendes:

    • USERNAME: Ihr GitHub-Nutzername
    • EMAIL_ADDRESS: die E-Mail-Adresse Ihres GitHub-Kontos
  4. Wenn für Ihr GitHub-Konto eine SSH-Authentifizierung erforderlich ist, führen Sie die folgenden Schritte aus, um Ihr Konto zu verbinden:

    1. Folgen Sie im Git-Terminal in Ihrer Vertex AI Workbench-Instanz der GitHub-Anleitung zum Generieren eines neuen SSH-Schlüssels.

    2. Folgen Sie dann der Anleitung zum Hinzufügen des SSH-Schlüssels zu Ihrem GitHub-Konto.

  5. Schließen Sie das Git-Terminalfenster.

Dateien, für die ein Commit durchgeführt wurde, zum GitHub-Repository hinzufügen

  1. Öffnen Sie in JupyterLab den Ordner, in dem sich Ihr Repository befindet.

  2. Neues Notebook hinzufügen

  3. Wählen Sie den Tab Git aus. Das neue Notebook wird in der Gruppe Untracked aufgelistet.

  4. Klicken Sie mit der rechten Maustaste auf das neue Notebook und wählen Sie Nachverfolgen aus, um das neue Notebook als Datei für das GitHub-Repository hinzuzufügen. Auf dem Tab Git wird Ihr Notebook nun zur Gruppe Staged hinzugefügt.

  5. Führen Sie auf dem Tab Git im Feld Zusammenfassung einen Commit-Kommentar hinzu und klicken Sie dann auf Commit um einen Commit für das neue Notebook im GitHub-Repository durchzuführen.

  6. Wählen Sie Git > Zu Remote übertragen aus.

    • Wenn Sie einen GitHub-Nutzernamen und -Passwort verwenden, geben Sie bei entsprechender Aufforderung den GitHub-Nutzernamen und das Passwort ein.

    • Wenn Sie die 2-Faktor-Authentifizierung mit GitHub nutzen, geben Sie Ihren GitHub-Nutzernamen und Ihr persönliches Zugriffstoken ein.

    Nachdem der Befehl git push ausgeführt wurde, befinden sich die Dateien, für die ein Commit durchgeführt wurde, in Ihrem GitHub-Repository.