Code mit einem lokalen VS Code-Editor entwickeln

Hier erfahren Sie, wie Sie einen SSH-Tunnel von Ihrem lokalen Computer zu einer Workstation öffnen und dann mithilfe der VS Code-Remote-Entwicklung eine Verbindung von Ihrem lokalen VS Code-Editor zu Cloud Workstations herstellen.

Hinweise

Führen Sie die folgenden Schritte aus, bevor Sie beginnen:

  1. Achten Sie darauf, dass jemand in Ihrem Team eine Workstation-Konfiguration erstellt hat.
  2. Workstation erstellen und starten
  3. Kopieren Sie in der Google Cloud Console die folgenden Informationen:

    1. Projektname und ‑ID: Klicken Sie in der Google Cloud-Menüleiste auf den Projektnamen und kopieren Sie die ID im Dialogfeld Projektname und ‑ID.
    2. Region
    3. Clustername
    4. Konfigurationsname
  4. Installieren Sie die gcloud CLI auf Ihrem lokalen Computer.

    Wenn Sie die gcloud CLI zum ersten Mal ausführen, müssen Sie möglicherweise auch gcloud auth login ausführen, um Anmeldedaten abzurufen, und gcloud config set project PROJECT_ID, um Ihr aktuelles Projekt auf die Projekt-ID festzulegen, die Sie im vorherigen Schritt kopiert haben.

  5. Wenn Sie ssh zum ersten Mal verwenden, installieren Sie eine Remote-SSH-Erweiterung, damit Sie über den Extension Marketplace oder die Befehlspalette eine Verbindung vom VS Code-Editor zu einer Workstation herstellen können.

    Extensions Marketplace

    1. Öffnen Sie den lokalen VS Code-Editor und dann den Extension Marketplace. Wählen Sie dazu in der Aktivitätsleiste
      Erweiterungen aus.

    2. Klicken Sie auf Installieren, um die Erweiterung Remote – SSH zu installieren.

    3. Geben Sie remote ssh in das Suchfeld ein. Daraufhin wird die Erweiterungsseite für Remote – SSH geöffnet.

      Remote-SSH-Erweiterung installieren

    Befehlspalette

    1. Drücken Sie zum Öffnen der Befehlspalette Strg + Umschalt + P (oder Befehl + Umschalt + P unter macOS) oder klicken Sie auf Ansicht > Befehlspalette.

    2. Geben Sie ext install ms-vscode-remote.remote-ssh ein, um die Erweiterung zu installieren.

SSH-Tunnel öffnen

Öffnen Sie mit dem Befehl gcloud workstations start-tcp-tunnel einen SSH-Tunnel von Ihrem lokalen Computer zu einer Workstation:

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

    Zu den Workstations

  2. Klicken Sie auf den Namen der Workstation, um die Seite Workstation-Details zu öffnen.

  3. Ersetzen Sie im folgenden Beispiel die Platzhalter für den Namen der Workstation, die Region (Standort), den Namen des Workstation-Clusters und den Namen der Workstation-Konfiguration. Kopieren Sie die Werte aus dem Bereich „Workstation-Details“ in die Platzhalter, die mit dem Symbol Bearbeiten gekennzeichnet sind.

    gcloud workstations start-tcp-tunnel \
      --project=PROJECT_ID \
      --region=REGION \
      --cluster=CLUSTER_NAME \
      --config=CONFIG_NAME \
      --local-host-port=:LOCAL_PORT \
      WORKSTATION_NAME 22
    

    Die Projekt-ID finden Sie im Abschnitt Vorbereitung.

    Das Flag --local-host-port=:LOCAL_PORT ist optional. Wenn Sie einen lokalen Port angeben möchten, ersetzen Sie LOCAL_PORT durch die gewünschte lokale Portnummer. Wenn Sie keinen lokalen Port angeben, wählt das System einen beliebigen, nicht verwendeten lokalen Port für Sie aus und gibt eine Meldung mit der Portnummer aus, damit Sie wissen, welcher lokale Port verwendet wird.

  4. Nachdem Sie die Platzhalter ausgefüllt haben, klicken Sie auf content_copy Codebeispiel kopieren, um den gcloud-Befehl zu kopieren.

  5. Fügen Sie den Befehl in das lokale Terminalfenster ein und drücken Sie die Eingabetaste, um den Tunnel zu erstellen.

    Wenn der Befehl erfolgreich war, wird die Meldung Listening on port gefolgt von der lokalen Portnummer angezeigt.

Weitere Informationen zu den einzelnen Konfigurationsflags finden Sie unter SSH-Tunnel oder start-tcp-tunnel.

Verbindung zu einem Cloud Workstations-Host herstellen

So stellen Sie eine Verbindung zu einem Cloud Workstations-Host her:

  1. Öffnen Sie die VS Code-Anwendung oder kehren Sie zu ihr zurück.
  2. Klicken Sie in der Statusleiste auf Remote-Fenster öffnen, um Remote – SSH zu starten.

  3. Wählen Sie in der Befehlspalette die Option Mit Host verbinden aus.

    Verbindung zum Host herstellen

  4. Geben Sie user@localhost:LOCAL_PORT ein und ersetzen Sie dabei LOCAL_PORT durch Ihre lokale Portnummer.

    Im folgenden Beispiel wird durch Angabe von user@localhost:1025 eine Verbindung zum lokalen Port 1025 hergestellt.

    SSH-Host hinzufügen

  5. Wenn Sie nach der Bestätigungsmeldung Host hinzugefügt aufgefordert werden, eine Verbindung herzustellen, klicken Sie auf Verbinden.

    Möglicherweise werden Sie vom System aufgefordert, den Hash zu bestätigen. Klicken Sie auf Weiter, wenn Sie dazu aufgefordert werden.

  6. Ein neuer VS Code-Editor wird geöffnet und in der VS Code-Statusleiste wird SSH: localhost: gefolgt von der Portnummer angezeigt.

    Sie haben jetzt Zugriff auf die Dateien und Sprachserver auf Ihrer Remote-Workstation und können Prozesse erstellen und ausführen, die auf Ihrer Workstation ausgeführt werden.

    Das folgende Beispiel zeigt ein VS Code-Editorfenster, das über SSH: localhost: 1025 mit Cloud Workstations verbunden ist.

    Mit Workstation verbunden

    Sie können auch zum Extensions Marketplace zurückkehren, um Cloud Code und andere lokale VS Code-Erweiterungen zu installieren, mit denen Sie Ihren Code erstellen, ausführen und testen können.