Sviluppare codice utilizzando gli IDE JetBrains locali

Il plug-in Cloud Workstations ti consente di avviare sessioni di sviluppo remoto per Cloud Workstations utilizzando IDE JetBrains come IntelliJ IDEA Ultimate, PyCharm Professional, Rider, CLion, PhpStorm e WebStorm.

Sistemi operativi supportati

Il plug-in Cloud Workstations supporta i seguenti sistemi operativi:

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

Versioni supportate

Il plug-in Cloud Workstations supporta la versione più recente e una precedente degli IDE JetBrains e di JetBrains Gateway. Quando viene rilasciata una nuova versione principale dell'IDE JetBrains, la successiva release del plug-in Cloud Workstations supporta la nuova versione e non supporta più la versione precedente supportata.

Nota: il supporto del plug-in Cloud Workstations per il programma di accesso in anteprima di JetBrains (EAP) avviene secondo il criterio del massimo impegno. A volte l'EAP introduce modifiche che comportano interruzioni, e la loro risoluzione potrebbe richiedere del tempo.

Per semplificare il mantenimento aggiornato delle app JetBrains, puoi anche installare JetBrains Toolbox.

Per ulteriori informazioni sulle versioni dell'IDE JetBrains nelle immagini di base preconfigurate, consulta le note di rilascio di Cloud Workstations.

Prima di iniziare

Prima di installare il plug-in Cloud Workstations, segui questi passaggi:

1. Segui i passaggi per creare una workstation. Quando ti viene chiesto di selezionare la configurazione, scegli l'immagine corrispondente all'IDE JetBrains che vuoi utilizzare.

2. Dopo aver inserito il nome della workstation, fai clic su Crea.

3. Fai clic sulla pagina Workstation e attendi il completamento della creazione della workstation.

4. Scarica e installa una versione supportata di JetBrains Gateway.

Installa il plug-in Cloud Workstations

Nota: se sei un utente BYOID, vai alla sezione Istruzioni per una connessione alternativa per gli utenti BYOID.

1. Installa il plug-in Cloud Workstations:

   1. Apri JetBrains Gateway.

   2. Seleziona Tutti i fornitori.

   3. Nella sezione Installa altri provider, individua Google Cloud e poi fai clic su Installa per scaricare il plug-in Cloud Workstations.

      

2. Dopo l'installazione, Cloud Workstations viene visualizzato nella sezione Esegui l'IDE in remoto.

Connettiti utilizzando il plug-in Cloud Workstations

Per connetterti a una workstation utilizzando il plug-in:

1. Apri JetBrains Gateway.

2. Nella sezione Esegui l'IDE in remoto, fai clic su Connettiti a Google Cloud.

3. Fai clic su Accedi per accedere al tuo Account Google.

   1. Segui le istruzioni per concedere al plug-in Cloud Workstations l'accesso a Google Cloud.

   2. Fai clic su Continua per completare l'accesso.

4. Fai clic su Sfoglia per aprire una finestra di dialogo di selezione del progetto e seleziona un progetto cloud.

   

5. Seleziona una workstation nel progetto cloud, fai clic su Avanti e attendi che la workstation selezionata venga avviata.

6. Seleziona l'IDE e il progetto:

   1. Seleziona una versione dell'IDE nell'host remoto.

   2. Inserisci il percorso di un progetto IDE sull'host remoto.

      

   Nota: ricorda che solo i file archiviati nella directory /home vengono conservati tra le sessioni.

7. Fai clic su Connetti e attendi l'apertura dell'IDE e del progetto.

Riconnettiti a una workstation

Per riconnetterti rapidamente a una workstation e a un progetto IDE:

1. Apri il riquadro Connessioni recenti.

2. Fai clic sul percorso di un progetto per aprire un IDE in Cloud Workstations.

   

3. Attendi l'apertura dell'IDE e del progetto.

Utilizzare il port forwarding

Dopo aver aperto il client JetBrains con l'IDE e il progetto, potresti voler accedere alle porte remote su Cloud Workstations dalla tua macchina locale. Ad esempio, quando esegui un server Python sulla workstation, python -m SimpleHTTPServer 8080. In alcuni casi, JetBrains Gateway esegue automaticamente il forwarding delle porte in modo da poter accedere ai progetti in esecuzione da remoto tramite il browser locale.

Puoi anche eseguire manualmente il forwarding delle porte da Cloud Workstations alla tua macchina locale come segue:

1. Per Windows e Linux, seleziona File > Impostazioni dal menu principale.

   Per macOS, seleziona IntelliJ IDEA > Preferenze dal menu principale.

2. Vai a Strumenti > Inoltro di porte e aggiungi una nuova regola per inoltrare TCP per la porta 8080.

3. Dopo aver impostato questa regola, puoi accedere alla porta 8080 di Cloud Workstations localmente all'indirizzo http://localhost:8080

Sostituisci gli endpoint API

Per gli utenti di Virtual Private Cloud che devono eseguire l'override degli endpoint API, assicurati che il plug-in possa connettersi ai tuoi servizi cloud. Per eseguire l'override degli endpoint API, segui questi passaggi:

1. Su Windows e Linux, fai clic su Impostazioni Menu Opzioni > Impostazioni.

   

   Su macOS, fai clic su Impostazioni Menu Opzioni > Preferenze.

   

2. (Facoltativo) Per accedere alle Impostazioni di JetBrains per IntelliJ e altri IDE, consulta configurare le impostazioni del progetto.

3. Vai a Strumenti > Google Cloud Workstations > Avanzate.

4. Aggiungi gli URL di override dell'endpoint API.

   Nota: assicurati di utilizzare i nomi DNS di Virtual Private Cloud p.googleapis.com. Non utilizzare indirizzi IP.

   

5. Fai clic su Applica.

Per ulteriori informazioni sull'utilizzo degli endpoint in Google Cloud, consulta la descrizione di Virtual Private Cloud sull'accesso alle API di Google tramite endpoint.

Istruzioni di connessione alternative per gli utenti BYOID

Se utilizzi BYOID, devi eseguire ulteriori passaggi per connetterti a JetBrains Gateway. Segui questi passaggi:

Avvia la workstation e apri una connessione TCP

I passaggi che seguono avviano la workstation e aprono una connessione TCP:

1. Segui le istruzioni riportate nella sezione Prima di iniziare.

2. Assicurati che la workstation sia in esecuzione. Puoi utilizzare il seguente comando gcloud CLI per avviarlo.

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

3. Avvia un tunnel TCP sulla workstation sulla porta 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
   

Nota: per supportare questo comando, devi avere gcloud CLI versione 387.0.0 o successive. Controlla la versione di gcloud CLI eseguendo il comando gcloud version. Se necessario, esegui l'aggiornamento con il comando gcloud components update.

Una volta completata la configurazione e l'installazione iniziale, il passaggio successivo consiste nell'avviare JetBrains Gateway.

Avvia JetBrains Gateway

1. Dopo aver lanciato JetBrains Gateway, seleziona Connetti via SSH.

2. Nella pagina Connetti a SSH, fai clic su Impostazioni per configurare una nuova connessione.

   Nella pagina Configurazione SSH:

   1. Fai clic su Aggiungi una nuova connessione.
   2. Inserisci i dati di connessione. Ad esempio, Host locale=127.0.0.1, Porta=2222 e Nome utente=user. Assicurati di utilizzare valori appropriati per la tua configurazione per l'host locale, la porta e il nome utente.
   3. Imposta Tipo di autenticazione su Password e lascia vuoto il campo della password.
   4. Deseleziona l'opzione Esegui l'analisi del file di configurazione ~/.ssh/config.
   5. Fai clic su OK per creare la connessione.
   6. Fai clic su Verifica connessione e continua.

3. Nella pagina Scegli IDE e progetto, seleziona quanto segue:

   1. Seleziona l'IDE che vuoi utilizzare.

   2. Seleziona la directory contenente il progetto facendo clic su more_horiz Altro. Tieni presente che non puoi creare un progetto da questo menu. Puoi solo aprire un progetto. Per creare un nuovo progetto, seleziona Apri un terminale SSH ed esegui i comandi per creare una directory per il progetto JetBrains.

      In alternativa, puoi anche fare clic su Apri un terminale SSH per eseguire i comandi git all'interno delle tue workstation. Ad esempio, il seguente comando clona il progetto Cloud Code Samples nella tua directory home:

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

   3. Dopo aver selezionato la directory del progetto, fai clic su Scarica e avvia IDE.

4. Dopo la connessione dell'IDE, puoi accedere ai file della tua workstation direttamente dall'IDE JetBrains, che può anche utilizzare l'estensione Cloud Workstations per aiutarti a compilare ed eseguire il codice.