Sviluppa codice utilizzando un editor VS Code locale

Scopri come aprire un tunnel SSH dalla macchina locale a una workstation, quindi utilizza il supporto VS Code Remote Development per connetterti a Cloud Workstations dall'editor VS Code locale.

Suggerimento: per un'esperienza all'interno del browser, puoi utilizzare l'IDE di Cloud Workstations Code OSS per Cloud Workstations, che è basato sul progetto open source Code-OSS.

Prima di iniziare

Prima di iniziare, assicurati di seguire i passaggi per queste attività:

1. Assicurati che qualcuno del tuo team abbia creato una configurazione workstation.
2. Crea e avvia la tua workstation.

3. Nella console Google Cloud, copia le seguenti informazioni:

   1. Nome e ID del progetto: fai clic sul nome del progetto nella barra dei menu di Google Cloud e copia l'ID nella finestra di dialogo Nome e ID del progetto che si apre.
   2. Regione
   3. Nome del cluster
   4. Nome della configurazione

4. Dalla macchina locale, installa l'interfaccia a riga di comando gcloud.

   Se esegui l'interfaccia a riga di comando gcloud per la prima volta, potrebbe anche essere necessario eseguire gcloud auth login per ottenere le credenziali e gcloud config set project PROJECT_ID per impostare il progetto attuale sull'ID progetto copiato nel passaggio precedente.

5. Quando utilizzi ssh per la prima volta, installa un'estensione SSH remota in modo da poterti connettere a una workstation dall'editor di codice VS tramite il Marketplace delle estensioni o la tavolozza dei comandi.

   Marketplace estensioni

   1. Apri l'applicazione dell'editor di codice VS locale e poi apri il Marketplace delle estensioni selezionando
      Estensioni nella barra delle attività.

   2. Fai clic su Installa per installare l'estensione Remote - SSH.

   3. Inserisci remote ssh nel campo di ricerca. Verrà aperta la pagina dell'estensione per Remoto - SSH.

      

   Tavolozza dei comandi

   1. Per aprire la tavolozza dei comandi, premi Ctrl+Shift+P (o Comando+Shift+P su macOS) oppure fai clic su Visualizza > Tavolozza dei comandi.

   2. Inserisci ext install ms-vscode-remote.remote-ssh per installare l'estensione.

Apri un tunnel SSH

Apri un tunnel SSH dalla macchina locale a una workstation utilizzando il comando gcloud workstations start-tcp-tunnel:

1. Nella console Google Cloud, vai alla pagina Cloud Workstations > Workstations.

   Vai a Workstation

2. Fai clic sul nome della workstation per aprire la pagina Dettagli workstation.

3. Nell'esempio seguente, sostituisci i segnaposto per il nome della workstation, la regione (località), il nome del cluster di workstation e il nome della configurazione della workstation. Copia i valori dal riquadro Dettagli workstation nei segnaposto contrassegnati con l'icona Modifica.

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

   Consulta la sezione Prima di iniziare per trovare l'ID progetto.

   Il flag --local-host-port=:LOCAL_PORT è facoltativo. Se vuoi specificare una porta locale, sostituisci LOCAL_PORT con il numero di porta locale che vuoi utilizzare. Se non specifichi una porta locale, il sistema sceglie automaticamente una porta locale arbitraria e inutilizzata e restituisce un messaggio con il numero di porta, in modo che tu sappia quale porta locale utilizza.

4. Dopo aver compilato i segnaposto, fai clic su content_copy Copia esempio di codice per copiare il comando dell'interfaccia a riga di comando gcloud.

5. Incolla il comando nella finestra del terminale locale e premi Invio per creare il tunnel.

   Quando il comando ha esito positivo, viene visualizzato un messaggio Listening on port seguito dal numero di porta locale.

Per maggiori dettagli su ciascun flag di configurazione, consulta Tunnel SSH o start-tcp-tunnel.

Connettiti a un host Cloud Workstations

Segui questi passaggi per connetterti a un host Cloud Workstations:

1. Apri o torna all'applicazione VS Code.

2. Per avviare Remoto - SSH, fai clic su Apri una finestra remota nella barra di stato.

   

3. Seleziona l'opzione Connetti all'host all'apertura della tavolozza dei comandi.

   

4. Inserisci user@localhost:LOCAL_PORT, sostituendo LOCAL_PORT con il numero della tua porta locale.

   L'esempio seguente si connette alla porta locale 1025 specificando user@localhost:1025.

   

   Nota: le chiavi host per le workstation cambiano da una sessione all'altra perché le workstation vengono eseguite su VM temporanee. Assicurati che la convalida della chiave host sia disabilitata per la configurazione della workstation per questo motivo.

5. Se, dopo aver visualizzato il messaggio di conferma Host aggiunto, viene richiesto di eseguire la connessione, fai clic su Connetti.

   Il sistema potrebbe anche chiederti di confermare l'hash. Se richiesto, fai clic su Continua.

6. Si apre un nuovo editor di VS Code e la barra di stato di VS Code mostra SSH: localhost: seguito dal numero di porta.

   Ora hai accesso ai file e ai server del linguaggio sulla workstation remota e puoi creare ed eseguire processi all'interno della workstation.

   L'esempio seguente mostra una finestra dell'editor di codice VS connessa a Cloud Workstations tramite SSH: localhost: 1025.

   

   Puoi anche tornare su Extensions Marketplace per installare Cloud Code e altre estensioni VS Code locali per creare, eseguire e testare il tuo codice.