Mit SSH auf JupyterLab zugreifen

Wenn Sie keinen HTTPS-Zugriff auf eine JupyterLab-Instanz haben, müssen Sie mit SSH eine Verbindung herstellen.

Zum Einrichten der SSH-Portweiterleitung führen Sie die folgenden Schritte aus und greifen dann über einen lokalen Browser auf die JupyterLab-Sitzung zu:

  1. Führen Sie den folgenden Befehl mithilfe der Google Cloud CLI in Ihrem bevorzugten Terminal oder in Cloud Shell aus:

    gcloud compute ssh INSTANCE_NAME \
    --project PROJECT_ID \
    --zone ZONE \
    -- -NL 8080:localhost:8080

    Ersetzen Sie Folgendes:

  2. Greifen Sie über einen lokalen Browser auf Ihre JupyterLab-Sitzung zu:

    • Wenn Sie den Befehl auf Ihrem lokalen Rechner ausgeführt haben, rufen Sie https://localhost:8080 auf, um auf JupyterLab zuzugreifen.

    • Wenn Sie den Befehl mit Cloud Shell ausgeführt haben, greifen Sie über die  Webvorschau auf Port 8080 auf JupyterLab zu.

Mögliche Gründe für fehlenden HTTPS-Zugriff

Um HTTPS-Zugriff auf JupyterLab zu erhalten, muss Ihre Vertex AI Workbench-Instanz Zugriff auf einen Google Cloud-Proxydienst haben. Wenn die Instanz gestartet wird, versucht sie, sich beim Proxydienst zu registrieren. Wenn kein Proxyzugriff möglich ist, fordert Ihre Instanz Sie dazu auf, über SSH auf JupyterLab zuzugreifen.

Im Folgenden sind einige häufige Gründe aufgeführt, warum Sie möglicherweise keinen HTTPS-Zugriff auf JupyterLab haben:

  • Die Proxymodus-Metadateneinstellung der JupyterLab-Instanz ist falsch.

  • Das Netzwerk ist so konfiguriert, dass der Internetzugriff für die virtuellen Maschinen (VMs) blockiert wird, auf denen JupyterLab-Notebooks ausgeführt werden.

  • Ihre Instanz hat keine externe IP-Adresse.

  • Ihre Einstellungen für VPC Service Controls blockieren den Zugriff auf Artifact Registry.

In den folgenden Abschnitten wird beschrieben, wie Sie diese Probleme beheben können.

Damit Änderungen wirksam werden, müssen Sie möglicherweise die VM des Notebooks neu starten, wenn Sie versuchen, diese Probleme zu beheben.

Falsche Proxymodus-Metadateneinstellung der JupyterLab-Instanz

Wenn Sie eine Vertex AI Workbench-Instanz erstellen, fügt Vertex AI Workbench standardmäßig die Metadateneinstellung im Proxymodus hinzu. Wenn Sie die Metadateneinstellung im Proxymodus ändern oder entfernen, kann die Instanz keine Verbindung zum Proxydienst herstellen.

So sorgen Sie für eine gültige Proxymodus-Metadateneinstellung:

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

    Zur Seite „VM-Instanzen“

  2. Wählen Sie die Instanz aus, die Sie ändern möchten.

  3. Klicken Sie neben VM-Details ansehen auf In Compute Engine ansehen.

  4. Klicken Sie auf der Seite "VM-Details" auf Bearbeiten.

  5. Fügen Sie im Abschnitt Metadaten die Metadaten hinzu oder ändern Sie sie, damit für den Proxymodus-Eintrag der richtige Wert festgelegt ist, zum Beispiel project_editors.

  6. Klicken Sie auf Speichern.

Netzwerk blockiert den Internetzugriff

Die JupyterLab-Instanz greift über eine öffentliche URL auf den Proxydienst zu. Wenn Ihre Virtual Private Cloud-Netzwerkeinstellungen den Zugriff auf das öffentliche Internet blockieren oder Ihre Firewallregeln den ausgehenden Traffic blockieren, müssen Sie SSH für den Zugriff auf Ihre Vertex AI Workbench-Instanz verwenden. Wenn möglich, sollten Sie mit Ihren Netzwerk- und Firewall-Administratoren zusammenarbeiten, um den Zugriff auf die Instanz über das öffentliche Internet zu ermöglichen.

Instanz hat keine externe IP-Adresse

Möglicherweise haben Sie die Vertex AI Workbench-Instanz ohne externe IP-Adresse erstellt. Wenn Sie dies ändern möchten, führen Sie die folgenden Schritte aus:

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

    Zur Seite „VM-Instanzen“

  2. Klicken Sie auf den Namen der Instanz, die Sie ändern müssen.

  3. Klicken Sie auf VM-Details ansehen.

  4. Klicken Sie auf Bearbeiten.

  5. Maximieren Sie im Abschnitt Netzwerkschnittstellen das Netzwerk, in dem Sie eine externe IP-Adresse verwenden möchten.

  6. Klicken Sie auf das Drop-down-Menü Externe IP-Adresse und wählen Sie die gewünschte Option aus. Zur Behebung dieses Problems dürfen Sie nicht Keine auswählen.

  7. Klicken Sie im Bereich Netzwerkschnittstellen auf Fertig.

  8. Klicken Sie auf Speichern.

VPC Service Controls-Einstellungen blockieren den Zugriff auf Artifact Registry

Die Vertex AI Workbench-Instanz führt einen Agent aus, der von Artifact Registry heruntergeladen wird, um eine Verbindung zum Proxydienst herzustellen. Ohne diesen Agent kann sich die Instanz nicht mit dem Proxydienst verbinden.

Wenn die Einstellungen für VPC Service Controls den Zugriff auf Artifact Registry blockieren, müssen Sie den Artifact Registry-Dienst dem Dienstperimeter von VPC Service Controls hinzufügen. Hier finden Sie weitere Informationen zur Funktionsweise von Dienstperimetern und dazu, welche Dienste mit VPC Service Controls gesichert werden können.

Weitere Fehlerbehebung

Wenn Sie weiterhin keine Verbindung herstellen können, prüfen Sie die Konsolenlogs Ihrer virtuellen Maschine. Mit diesen Logs können Sie unter Umständen herausfinden, warum sich die Vertex AI Workbench-Instanz nicht beim Proxydienst registrieren kann.

Führen Sie die folgenden Schritte aus, um auf diese Logs zuzugreifen:

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

    Zur Seite „VM-Instanzen“

  2. Wählen Sie die Instanz aus, für die Sie eine Fehlerbehebung ausführen möchten.

  3. Klicken Sie in Logs auf Serieller Port 1 (Konsole).

Nächste Schritte

Tipps zur Behebung anderer Probleme finden Sie im Abschnitt zur Fehlerbehebung bei Vertex AI Workbench-Instanzen.