Sviluppare codice utilizzando un editor VS Code locale

Scopri come aprire un tunnel SSH dalla tua macchina locale a una workstation e poi utilizzare lo sviluppo remoto di VS Code supporto per connetterti a Cloud Workstations dall'editor VS Code locale.

Suggerimento: per un'esperienza nel browser, puoi utilizzare l'IDE Cloud Workstations Code OSS per Cloud Workstations, basato sul progetto open source Code-OSS

Prima di iniziare

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

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

3. Mentre ti trovi nella Google Cloud console, copia le seguenti informazioni:

   1. Nome e ID progetto: fai clic sul nome del progetto nella Google Cloud barra dei menu 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 CLI.

   Se esegui gcloud CLI 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 in modo da poterti connettere a una workstation dall'editor VS Code tramite il Marketplace di estensioni o tramite la tavolozza dei comandi.

   Marketplace di estensioni

   1. Apri l'applicazione dell'editor VS Code locale e poi apri il Marketplace di 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, che apre la pagina dell'estensione per Remote - SSH.

      

   Tavolozza comandi

   1. Per aprire la tavolozza dei comandi, premi Control+Shift+P (o Command+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 gcloud workstations start-tcp-tunnel comando:

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

   Vai a Workstation

2. Fai clic sul nome della workstation per aprire la pagina Dettagli della 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 della workstation nei segnaposto contrassegnati con un' icona di modifica edit.

   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 della porta locale che vuoi utilizzare. Se non specifichi una porta locale, il sistema ne sceglie una 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 viene eseguito correttamente, viene visualizzato un messaggio Listening on port seguito da il numero della porta locale.

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

Connettersi a un host di Cloud Workstations

Per connetterti a un host di Cloud Workstations:

1. Apri o torna all'applicazione VS Code.

2. Per avviare Remote - 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.

   

   Nota: le chiavi host per le workstation cambiano tra le sessioni perché le workstation vengono eseguite su VM temporanee. Per questo motivo, assicurati che la convalida della chiave host sia disabilitata per la configurazione della workstation.

5. Se ti viene chiesto di connetterti dopo aver visualizzato il messaggio di conferma Host aggiunto, fai clic su Connetti.

   Il sistema potrebbe anche chiederti di confermare l'hash. Se ti viene 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 di linguaggio sulla workstation remota, e puoi creare ed eseguire processi che vengono eseguiti 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 di estensioni per installare Cloud Code e altre estensioni VS Code locali per aiutarti a creare, eseguire e testare il codice.