Notebook auf GitHub speichern

Notebook auf GitHub speichern

Von Nutzern verwaltete Vertex AI Workbench-Notebooks wurden verworfen. Am 30. Januar 2025 wird die Unterstützung für nutzerverwaltete Notebooks eingestellt und die Möglichkeit zum Erstellen von nutzerverwalteten Notebookinstanzen wird entfernt. Vorhandene Instanzen funktionieren weiterhin, aber Patches, Updates und Upgrades sind nicht verfügbar. Um Vertex AI Workbench weiterhin zu verwenden, empfehlen wir Ihnen, Ihre nutzerverwalteten Notebooks-Instanzen zu Vertex AI Workbench-Instanzen zu migrieren.

Wenn Sie Ihre nutzerverwaltete Notebookinstanz sichern und anderen Nutzern zur Verfügung stellen möchten, speichern Sie den Inhalt der vom Nutzer verwalteten Notebooks Instanz auf GitHub.

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.

Klonen Sie das GitHub-Repository in der nutzerverwalteten Notebookinstanz.

Führen Sie die folgenden Schritte aus, um das GitHub-Repository in der vom Nutzer verwalteten Notebookinstanz 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 Nutzerverwaltete Notebooks auf.

   Zu "Nutzerverwaltete Notebooks"

4. Klicken Sie auf JupyterLab öffnen, um die nutzerverwaltete Notebookinstanz 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. 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.

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

   

9. Klicken Sie auf Klonen.

Konfigurieren Sie die nutzerverwaltete Notebookinstanz mit den GitHub-Nutzerinformationen.

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

2. 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 "YOUR_NAME"
   git config --global user.email "YOUR_EMAIL"

3. 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 nutzerverwalteten Notebookinstanz 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.

4. Schließen Sie das Git-Terminalfenster.

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

1. Ihre nutzerverwaltete Notebookinstanz 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:

   

2. Doppelklicken Sie auf Ihren Repository-Ordner, um ihn zu öffnen.

3. Fügen Sie der nutzerverwalteten Notebookinstanz ein neues Notebook hinzu.

   Zum Hinzufügen einer Notebook-Datei können Sie das Menü oder den Launcher verwenden.

   Menü

   1. Um über das Menü eine neue Notebookdatei hinzuzufügen wählen Sie File > New > Notebook aus.

      

   2. Wählen Sie im Dialogfeld Select Kernel den Kernel für Ihr neues Notebook aus, z. B. Python 3, und klicken Sie dann auf Select.

      Ihre neue Notebookdatei wird geöffnet.

   Launcher

   1. Wählen Sie zum Hinzufügen einer neuen Notebook-Datei aus dem Launcher File > New > Launcher aus.

   2. Klicken Sie auf die Kachel für den Kernel, den Sie verwenden möchten.

      

      Ihre neue Notebookdatei wird geöffnet.

4. Benennen Sie die neue Notebook-Datei um.

   Menü

   1. Wählen Sie File > Rename notebook aus. Das Dialogfeld Rename file wird geöffnet.

   2. Ändern Sie im Feld New name Untitled.ipynb in einen aussagekräftigen Namen, beispielsweise install.ipynb.

   3. Klicken Sie auf Umbenennen.

   Launcher

   1. Klicken Sie mit der rechten Maustaste auf den Tab Untitled.ipynb und dann auf Rename Notebook. Das Dialogfeld Rename file wird geöffnet.

   2. Ändern Sie im Feld New name Untitled.ipynb in einen aussagekräftigen Namen, beispielsweise install.ipynb.

   3. Klicken Sie auf Umbenennen.

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

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

7. Fügen Sie auf dem Tab Git einen Commit-Kommentar hinzu und klicken Sie auf Commit, um einen Commit für das neue Notebook im GitHub-Repository durchzuführen.

8. Wählen Sie zum Öffnen eines Git-Terminalfensters Git > Git-Repository im Terminal öffnen aus.

9. Geben Sie im Git-Terminalfenster den Befehl git push ein.

   • 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, erstellen Sie ein persönliches Zugriffstoken zum Verwenden.

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