Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

SSH-Unterstützung

Auf dieser Seite wird beschrieben, wie Sie mit der gcloud CLI über SSH (oder ein anderes TCP-Protokoll) von einem lokalen Computer aus eine Verbindung zu Ihrer Workstation herstellen.

Cloud Workstations verwendet einen Tunnel, um TCP-Traffic zwischen einem Port auf Ihrem lokalen Computer und einem Port auf Ihrer Workstation weiterzuleiten, ohne Ihre Workstation offen im Internet zu präsentieren. Verbindungen werden mit Anmeldedaten aus der gcloud CLI authentifiziert und gemäß den IAM-Richtlinien der Zielworkstation autorisiert.

Sobald der TCP-Tunnel zwischen Ihrem lokalen Port und der Workstation eingerichtet ist, können Sie ihn verwenden, um Traffic von einem SSH-Client, `curl` oder einer anderen Anwendung, die TCP verwendet, weiterzuleiten.

Cloud Workstations bietet den gcloud workstations ssh Befehl, mit dem Sie den TCP-Tunnel einrichten und einen SSH-Client mit einem einzigen gcloud CLI-Befehl ausführen können.

Verwenden Sie für alle anderen Anwendungsfälle den gcloud workstations start-tcp-tunnel Befehl, um den TCP-Tunnel einzurichten und die Anwendung, die den Tunnel verwenden soll (z. B. curl), in einem separaten Terminal auszuführen.

Hinweis

Wenn Sie noch keine Workstation haben, zu der Sie eine Verbindung herstellen können, richten Sie eine Workstation ein.
Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl:
```
gcloud init
```
Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
Prüfen Sie, ob Sie die IAM-Rolle „Cloud Workstations-Nutzer“ für die Workstation haben, zu der Sie eine Verbindung herstellen möchten.

IAM aufrufen

Über SSH eine Verbindung zu Ihrer Workstation herstellen

Verwenden Sie den gcloud workstations ssh Befehl, um eine sichere SSH-Verbindung zu Ihrer Workstation herzustellen. Dieser Befehl startet einen TCP-Tunnel und führt einen SSH-Client aus.

Führen Sie den folgenden Befehl in einem lokalen Terminalfenster aus:

gcloud workstations ssh \
    --project=PROJECT_ID \
    --region=REGION \
    --cluster=CLUSTER_NAME \
    --config=CONFIG_NAME  \
    --port=WORKSTATION_PORT  \
    --local-host-port=localhost:LOCAL_PORT  \
    WORKSTATION_NAME

Ersetzen Sie die folgenden Werte:

PROJECT_ID: die Google Cloud Projekt-ID für das Projekt, das die Workstation enthält. Wenn nichts angegeben ist, wird das aktuelle Projekt verwendet.
REGION: Die Region, in der sich der Cluster der Workstation befindet, z. B. us-central1.
CLUSTER_NAME: Der Name des Workstation-Clusters, der die Workstation enthält.
CONFIG_NAME: Der Name der Workstationkonfiguration, die diese Workstation enthält.
WORKSTATION_PORT (Optional): Der Port auf der Workstation, an den der Traffic gesendet werden soll. Wenn nichts angegeben ist, wird der Traffic an Port 22 gesendet. Alle vorkonfigurierten Cloud Workstations-Images enthalten einen SSH-Server, der auf dem Workstation-Port 22 ausgeführt wird.
LOCAL_PORT (Optional): Der localhost-Port, von dem der Traffic gesendet wird. Gültige Portnummern sind 1024 bis 65535. Wenn Sie das Flag --local-host-port weglassen oder den Port 0 angeben, wird automatisch ein nicht verwendeter Port ausgewählt.
WORKSTATION_NAME: Der Name der Workstation.

SSH-Konfiguration und die Datei `.ssh/config`

Wenn Sie gcloud workstations ssh verwenden, leitet der Befehl Ihre Verbindung über localhost weiter. Daher werden Host-Einträge aus Ihrer Datei ~/.ssh/config, die den Namen der Workstation verwenden, nicht automatisch angewendet.

Wählen Sie eine der folgenden Optionen aus, um benutzerdefinierte SSH-Konfigurationen anzuwenden:

Option 1: Flags in der Befehlszeile übergeben

Sie können SSH-Optionen direkt an den zugrunde liegenden SSH-Client übergeben, indem Sie sie nach einem doppelten Bindestrich (--) anhängen:

gcloud workstations ssh \
    --project=PROJECT_ID \
    --region=REGION \
    --cluster=CLUSTER_NAME \
    --config=CONFIG_NAME \
    WORKSTATION_NAME \
    -- -o SSH_OPTION=VALUE

Option 2: Persistenter TCP-Tunnel und `.ssh/config` verwenden

Wenn Sie die Datei ~/.ssh/config verwenden möchten, gehen Sie so vor:

Starten Sie einen persistenten TCP-Tunnel in einem separaten Terminalfenster und geben Sie einen lokalen Port an:

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

Fügen Sie Ihrer Datei ~/.ssh/config auf Ihrem lokalen Computer einen Konfigurationsblock hinzu:

Host WORKSTATION_NAME
    HostName localhost
    Port LOCAL_PORT
    User user
    # Disable host key checking for ephemeral cloud workstations
    StrictHostKeyChecking no
    UserKnownHostsFile /dev/null
    # Add any other SSH options here

Stellen Sie über Standard-SSH eine Verbindung zu Ihrer Workstation her:
```
ssh WORKSTATION_NAME
```

TCP-Tunnel verwenden, um beliebigen TCP-Traffic an Ihre Workstation weiterzuleiten

Wenn Sie mit einer anderen TCP-Anwendung als ssh eine Verbindung zu einer Workstation herstellen möchten, verwenden Sie den gcloud workstations start-tcp-tunnel Befehl:

Führen Sie den folgenden gcloud CLI-Befehl aus, um einen authentifizierten TCP-Tunnel zu erstellen:

Klicken Sie auf Codebeispiel kopieren, um den Befehl in die Zwischenablage zu kopieren, und fügen Sie ihn dann in ein lokales Terminalfenster ein:
```
gcloud workstations start-tcp-tunnel \
    --project=PROJECT_ID \
    --region=REGION \
    --cluster=CLUSTER_NAME \
    --config=CONFIG_NAME \
    --local-host-port=localhost:LOCAL_PORT \
    WORKSTATION_NAME \
    WORKSTATION_PORT
```
Ersetzen Sie die folgenden Werte:
- PROJECT_ID: die Google Cloud Projekt-ID für das Projekt, das die Workstation enthält. Wenn nichts angegeben ist, wird das aktuelle Projekt verwendet.
- REGION: Die Region, in der sich der Cluster der Workstation befindet, z. B. us-central1.
- CLUSTER_NAME: Der Name des Workstation-Clusters, der die Workstation enthält.
- CONFIG_NAME: Der Name der Workstationkonfiguration, die diese Workstation enthält.
- LOCAL_PORT (Optional): Der localhost-Port, von dem der Traffic gesendet wird. Gültige Portnummern sind 1024 bis 65535. Wenn Sie das Flag --local-host-port weglassen oder den Port 0 angeben, wird automatisch ein nicht verwendeter Port ausgewählt.
- WORKSTATION_NAME: Der Name der Workstation.
- WORKSTATION_PORT: Der Workstation-Port, an den der Traffic gesendet werden soll. Vorkonfigurierte Cloud Workstations-Images enthalten einen SSH-Server, der auf dem Workstation-Port 22 ausgeführt wird.
Der gcloud CLI-Befehl führt einen Konnektivitätstest mit der Workstation durch, öffnet einen Tunnel und zeigt dann eine Portnummer an:
```
Listening on port [LOCAL_PORT].
```
Der gesamte an localhost:LOCAL_PORT gesendete Traffic wird an die Workstation weitergeleitet. Der Port ist nur für Anwendungen zugänglich, die auf Ihrem lokalen Computer ausgeführt werden.
Lassen Sie die gcloud CLI ausgeführt und öffnen Sie ein weiteres Terminal, um die Anwendung auszuführen, die eine Verbindung zu Ihrer Workstation herstellt.