Code mithilfe lokaler JetBrains-IDEs entwickeln

Mit dem Cloud Workstations-Plug-in können Sie Remote-Entwicklungssitzungen für Cloud Workstations mit JetBrains-IDEs wie IntelliJ IDEA Ultimate, PyCharm Professional, Rider, CLion, PhpStorm und WebStorm starten.

Unterstützte Betriebssysteme

Das Cloud Workstations-Plug-in unterstützt die folgenden Betriebssysteme:

• Windows
• macOS (Intel und Apple Silicon)
• Linux

Unterstützte Versionen

Das Cloud Workstations-Plug-in unterstützt die neueste und eine vorherige Version von JetBrains-IDEs und JetBrains Gateway. Wenn eine neue Hauptversion der JetBrains-IDE veröffentlicht wird, unterstützt die nächste Version des Cloud Workstations-Plug-ins die neue Version. Die Unterstützung für die früheste, zuvor unterstützte Version wird eingestellt.

Hinweis: Die Unterstützung des Cloud Workstations-Plug-ins für das Early Access-Programm von JetBrains (EAP) erfolgt auf Best-Effort-Basis. Das EAP führt manchmal funktionsgefährdende Änderungen ein, deren Behebung einige Zeit in Anspruch nehmen kann.

Sie können auch die JetBrains Toolbox installieren, um JetBrains-Anwendungen einfacher auf dem neuesten Stand zu halten.

Weitere Informationen zu JetBrains-IDE-Versionen in vorkonfigurierten Basis-Images finden Sie in den Versionshinweisen zu Cloud Workstations.

Hinweise

Führen Sie die folgenden Schritte aus, bevor Sie das Cloud Workstations-Plug-in installieren:

1. Folgen Sie der Anleitung zum Erstellen einer Workstation. Wenn Sie zur Konfiguration aufgefordert werden, wählen Sie das Image aus, das der JetBrains-IDE entspricht, die Sie verwenden möchten.

2. Nachdem Sie den Namen für die Workstation eingegeben haben, klicken Sie auf Erstellen.

3. Klicken Sie auf die Seite Workstations und warten Sie, bis die Erstellung der Workstation abgeschlossen ist.

4. Laden Sie eine unterstützte Version von JetBrains Gateway herunter und installieren Sie sie.

Cloud Workstations-Plug-in installieren

Hinweis: Wenn Sie ein BYOID-Nutzer sind, fahren Sie mit dem Abschnitt Anleitung zur alternativen Verbindung für BYOID-Nutzer fort.

1. Installieren Sie das Cloud Workstations-Plug-in:

   1. Öffnen Sie JetBrains Gateway.

   2. Wählen Sie Alle Anbieter aus.

   3. Suchen Sie im Abschnitt Install More Providers (Weitere Anbieter installieren) nach Google Cloud und klicken Sie dann auf Install (Installieren), um das Cloud Workstations-Plug-in herunterzuladen.

      

2. Nach der Installation wird Cloud Workstations im Abschnitt IDE Remotely ausführen angezeigt.

Über das Cloud Workstations-Plug-in verbinden

So stellen Sie mithilfe des Plug-ins eine Verbindung zu einer Workstation her:

1. Öffnen Sie JetBrains Gateway.

2. Klicken Sie im Abschnitt IDE Remotely ausführen auf Mit Google Cloud verbinden.

3. Klicken Sie auf Anmelden, um sich in Ihrem Google-Konto anzumelden.

   1. Folgen Sie den Aufforderungen, um dem Cloud Workstations-Plug-in Zugriff auf Google Cloud zu gewähren.

   2. Klicken Sie auf Weiter, um die Anmeldung abzuschließen.

4. Klicken Sie auf Durchsuchen, um das Dialogfeld zur Projektauswahl zu öffnen und ein Cloud-Projekt auszuwählen.

   

5. Wählen Sie eine Workstation unter dem Cloud-Projekt aus, klicken Sie auf Weiter und warten Sie, bis die ausgewählte Workstation gestartet wurde.

6. Wählen Sie Ihre IDE und Ihr Projekt aus:

   1. Wählen Sie eine IDE-Version auf dem Remote-Host aus.

   2. Geben Sie einen IDE-Projektpfad auf dem Remote-Host ein.

      

   Hinweis: Nur Dateien, die im Verzeichnis /home gespeichert sind, werden zwischen den Sitzungen beibehalten.

7. Klicken Sie auf Verbinden und warten Sie, bis die IDE und das Projekt geöffnet wurden.

Verbindung zu einer Workstation wiederherstellen

So stellen Sie schnell wieder eine Verbindung zu einer Workstation und einem IDE-Projekt her:

1. Öffnen Sie den aktuellen Bereich Verbindungen.

2. Klicken Sie auf einen Projektpfad, um eine IDE in Cloud Workstations zu öffnen.

   

3. Warten Sie, bis die IDE und das Projekt geöffnet wurden.

Portweiterleitung verwenden

Nachdem der JetBrains-Client mit Ihrer IDE und Ihrem Projekt geöffnet wurde, möchten Sie möglicherweise von Ihrem lokalen Computer auf Remote-Ports in Cloud Workstations zugreifen. Wenn Sie beispielsweise einen Python-Server auf der Workstation python -m SimpleHTTPServer 8080 ausführen. In bestimmten Fällen führt JetBrains Gateway automatisch eine Portweiterleitung für Sie durch, damit Sie über Ihren lokalen Browser auf Projekte zugreifen können, die remote ausgeführt werden.

So können Sie eine manuelle Portweiterleitung von Cloud Workstations auf Ihren lokalen Computer ausführen:

1. Wählen Sie unter Windows und Linux im Hauptmenü Datei > Einstellungen aus.

   Unter macOS wählen Sie im Hauptmenü IntelliJ IDEA > Einstellungen aus.

2. Gehen Sie zu Tools > Portweiterleitung und fügen Sie eine neue Regel zur Weiterleitung von TCP für Port 8080 hinzu.

3. Nachdem Sie diese Regel festgelegt haben, können Sie lokal auf Port 8080 von Cloud Workstations unter http://localhost:8080 zugreifen.

API-Endpunkte überschreiben

Für Virtual Private Cloud-Nutzer, die API-Endpunkte überschreiben müssen, muss das Plug-in eine Verbindung zu Ihren Cloud-Diensten herstellen können. So überschreiben Sie API-Endpunkte:

1. Klicken Sie unter Windows und Linux auf Einstellungen Optionsmenü > Einstellungen.

   

   Klicken Sie unter macOS auf Einstellungen Optionsmenü > Einstellungen.

   

2. Optional: Informationen zum Zugriff auf die Einstellungen von JetBrains für IntelliJ und andere IDEs finden Sie unter Projekteinstellungen konfigurieren.

3. Gehen Sie zu Tools > Google Cloud Workstations > Advanced.

4. Fügen Sie API-Endpunktüberschreibungs-URLs hinzu.

   Hinweis: Verwenden Sie p.googleapis.com-DNS-Namen der Virtual Private Cloud. Verwenden Sie keine IP-Adressen.

   

5. Klicken Sie auf Anwenden.

Weitere Informationen zur Verwendung von Endpunkten in Google Cloud finden Sie in der Virtual Private Cloud-Beschreibung zum Zugriff auf Google APIs über Endpunkte.

Alternative Verbindungsanleitung für BYOID-Nutzer

Wenn Sie BYOID verwenden, müssen Sie zusätzliche Schritte ausführen, um eine Verbindung zu Jetbrains Gateway herzustellen. Gehen Sie so vor:

Workstation starten und eine TCP-Verbindung öffnen

Mit den folgenden Schritten starten Sie Ihre Workstation und öffnen eine TCP-Verbindung:

1. Folgen Sie der Anleitung im Abschnitt Bevor Sie beginnen.

2. Prüfen Sie, ob Ihre Workstation ausgeführt wird. Sie können ihn mit dem folgenden gcloud-Befehlszeile-Befehl starten.

   gcloud workstations start WORKSTATION_ID –-project=PROJECT \
     --cluster=WORKSTATION_CLUSTER_ID --config=WORKSTATION_CONFIG_ID \
     --region=WORKSTATION_CLUSTER_REGION
   

3. Starten Sie einen TCP-Tunnel zu Ihrer Workstation an Port 22:

   gcloud workstations start-tcp-tunnel --project=PROJECT \
       --cluster=WORKSTATION_CLUSTER_ID \
       --config=WORKSTATION_CONFIG_ID \
       --region=WORKSTATION_CLUSTER_REGION \
       WORKSTATION_ID 22 --local-host-port=127.0.0.1:2222
   

Hinweis: Sie benötigen die gcloud-Befehlszeilenversion 387.0.0 oder höher, damit dieser Befehl unterstützt wird. Prüfen Sie die Version der gcloud-Befehlszeile mit dem Befehl gcloud version. Führen Sie bei Bedarf den Befehl gcloud components update aus.

Nach Abschluss der Ersteinrichtung und Installation besteht der nächste Schritt im Starten von Jetbrains Gateway.

Jetbrains Gateway starten

1. Wählen Sie nach dem Start von Jetbrains Gateway Connect via SSH aus.

2. Klicken Sie auf der Seite Mit SSH verbinden auf Einstellungen, um eine neue Verbindung einzurichten.

   Auf der Seite „SSH-Konfiguration“:

   1. Klicken Sie auf HinzufügenNeue Verbindung hinzufügen.
   2. Geben Sie die Verbindungsinformationen ein. Beispiel: Lokaler Host=127.0.0.1, Port=2222 und Nutzername=user. Verwenden Sie für den lokalen Host, den Port und den Nutzernamen unbedingt die zu Ihrer Konfiguration passenden Werte.
   3. Legen Sie den Authentifizierungstyp auf Passwort fest und lassen Sie das Passwortfeld leer.
   4. Deaktivieren Sie die Option Parse config file ~/.ssh/config.
   5. Klicken Sie auf OK, um die Verbindung herzustellen.
   6. Klicken Sie auf Verbindung prüfen und fortfahren.

3. Wählen Sie auf der Seite IDE und Projekt auswählen Folgendes aus:

   1. Wählen Sie die IDE aus, die Sie verwenden möchten.

   2. Wählen Sie das Verzeichnis aus, das Ihr Projekt enthält, indem Sie auf more_horiz Mehr klicken. Beachten Sie, dass Sie über dieses Menü kein Projekt erstellen können. Sie können ein Projekt nur öffnen. Wählen Sie zum Erstellen eines neuen Projekts SSH-Terminal öffnen aus und führen Sie Befehle zum Erstellen eines Verzeichnisses für Ihr JetBrains-Projekt aus.

      Alternativ können Sie auch auf SSH-Terminal öffnen klicken, um git-Befehle auf Ihren Workstations auszuführen. Mit dem folgenden Befehl wird beispielsweise das Cloud Code Samples-Projekt in Ihrem Basisverzeichnis geklont:

      git clone https://github.com/GoogleCloudPlatform/cloud-code-samples.git
      

   3. Nachdem Sie das Projektverzeichnis ausgewählt haben, klicken Sie auf IDE herunterladen und starten.

4. Nachdem die IDE verbunden ist, können Sie direkt von der Jetbrains-IDE aus auf Dateien auf Ihrer Workstation zugreifen, die auch die Cloud Workstations-Erweiterung zum Erstellen und Ausführen Ihres Codes verwenden kann.