Sviluppare codice utilizzando un editor VS Code locale

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

Prima di iniziare

Prima di iniziare, assicurati di seguire la procedura per queste attività:

1. Assicurati che un membro del tuo team abbia creato una configurazione della workstation.
2. Crea e avvia la workstation.

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

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

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

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

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

   Marketplace di estensioni

   1. Apri l'applicazione dell'editor VS Code locale e poi il Mercato 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 per aprire la pagina dell'estensione per Remote - SSH.

      

   Tavolozza comandi

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

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

Aprire un tunnel SSH

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

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

   Vai a Workstation

2. Fai clic sul nome della stazione di lavoro per aprire la pagina Dettagli stazione di lavoro.

3. Nell'esempio seguente, sostituisci i segnaposto per il nome della workstation, la regione (posizione), il nome del cluster di workstation e il nome della configurazione della workstation. Copia i valori dal riquadro dettagli della workstation nei segnaposto contrassegnati da un'icona di 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
   

   Per trovare l'ID progetto, consulta la sezione Prima di iniziare.

   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 ne sceglie una arbitraria e non utilizzata e visualizza un messaggio con il numero della porta in modo che tu sappia quale porta locale viene utilizzata.

4. Dopo aver compilato i segnaposto, fai clic su content_copy Copia esempio di codice per copiare il comando della CLI gcloud.

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

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

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

Connettiti a un host Cloud Workstations

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 quando si apre la tavolozza dei comandi.

   

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

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

   

5. Se ti viene chiesto di effettuare la connessione dopo aver visualizzato il messaggio di conferma Host aggiunto, 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 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 linguistici sulla tua workstation remota e puoi creare ed eseguire processi all'interno della workstation.

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

   

   Puoi anche tornare al marketplace delle estensioni per installare Cloud Code e altre estensioni VS Code locali che ti aiuteranno a compilare, eseguire e testare il codice.