Sviluppa il codice utilizzando gli IDE JetBrains locali

Il plug-in Cloud Workstations consente di avviare sessioni di sviluppo remoto per Cloud Workstations utilizzando gli 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 versione precedente degli IDE JetBrains e del gateway JetBrains. 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 la versione precedente supportata in precedenza.

Nota: il supporto del plug-in Cloud Workstations per il programma di accesso in anteprima JetBrains (EAP) è basato sul "best effort". L'EAP a volte introduce modifiche che provocano un errore e la risoluzione di questi problemi potrebbe richiedere un po' di tempo.

Per tenere aggiornate le app JetBrains più facilmente, puoi anche installare gli Strumenti per JetBrains.

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

Prima di iniziare

Assicurati di seguire questi passaggi prima di installare il plug-in Cloud Workstations:

1. Segui i passaggi per creare una workstation. Quando viene richiesta 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 Workstations e attendi che la creazione della workstation termini.

4. Scarica e installa una versione supportata del gateway JetBrains.

Installa il plug-in Cloud Workstations

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

1. Installa il plug-in Cloud Workstations:

   1. Apri il gateway JetBrains.

   2. Seleziona Tutti i provider.

   3. Nella sezione Installa altri provider, trova Google Cloud e 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, segui questi passaggi:

1. Apri il gateway JetBrains.

2. Nella sezione Esegui l'IDE da remoto, fai clic su Connetti 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 del selettore progetti e selezionare un progetto Cloud.

   

5. Seleziona una workstation nel progetto cloud, fai clic su Avanti e attendi l'avvio della workstation selezionata.

6. Seleziona il tuo IDE e il tuo progetto:

   1. Seleziona una versione IDE nell'host remoto.

   2. Inserisci un percorso del progetto IDE sull'host remoto.

      

   Nota: ricorda che solo i file archiviati nella directory /home vengono conservati tra una sessione e l'altra.

7. Fai clic su Connetti e attendi che l'IDE e il progetto vengano aperti.

Riconnettiti a una workstation

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

1. Apri il riquadro Connessioni recente.

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

   

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

Utilizza il port forwarding

Dopo che il client JetBrains si apre con l'IDE e il progetto, puoi accedere alle porte remote su Cloud Workstations dalla tua macchina locale. Ad esempio, quando esegui un server Python sulla workstation, viene visualizzato python -m SimpleHTTPServer 8080. In alcuni casi, il gateway JetBrains esegue automaticamente il port forwarding per consentirti di accedere ai progetti eseguiti in remoto tramite il tuo browser locale.

Puoi anche eseguire manualmente il port forwarding da Cloud Workstations alla tua macchina locale nel seguente modo:

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

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

2. Vai a Strumenti > Port Forwarding 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 in locale all'indirizzo http://localhost:8080

Esegui l'override degli 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 servizi cloud. Per eseguire l'override degli endpoint API, segui questi passaggi:

1. In Windows e Linux, fai clic su Impostazioni menu Opzioni > Impostazioni.

   

   In macOS, fai clic su Impostazioni menu Opzioni > Preferenze.

   

2. (Facoltativo) Per accedere alle impostazioni di JetBrains per IntelliJ e altri IDE, consulta la pagina relativa alla configurazione delle impostazioni di progetto.

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

4. Aggiungi URL di override degli endpoint API.

   Nota: assicurati di utilizzare i nomi DNS p.googleapis.com di Virtual Private Cloud. 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 al gateway Jetbrains. Segui questi passaggi:

Avvia la workstation e apri una connessione TCP

I passaggi seguenti avviano la workstation e apri una connessione TCP:

1. Segui le istruzioni nella sezione Prima di iniziare.

2. Assicurati che la tua workstation sia in esecuzione. Puoi utilizzare il seguente comando dell'interfaccia a riga di comando gcloud 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 interfaccia a riga di comando 387.0.0 o versioni successive. Controlla la versione dell'interfaccia a riga di comando gcloud eseguendo il comando gcloud version. Se necessario, esegui l'aggiornamento con il comando gcloud components update.

Una volta completate la configurazione e l'installazione iniziali, il passaggio successivo consiste nell'avviare il gateway Jetbrains.

Avvia gateway JetBrains

1. Dopo aver avviato il gateway Jetbrains, seleziona Connetti tramite SSH.

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

   Dalla pagina di configurazione SSH:

   1. Fai clic su aggiungiAggiungi una nuova connessione.
   2. Inserisci le informazioni di connessione. Ad esempio, Local Host=127.0.0.1, Port=2222 e Username=user. Assicurati di utilizzare valori appropriati alla tua configurazione per l'host, la porta e il nome utente locali.
   3. Imposta Tipo di autenticazione su Password e lascia vuoto il campo della password.
   4. Deseleziona l'opzione Parse config file ~/.ssh/config (file di configurazione di analisi).
   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 che contiene 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 home directory:

      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. Una volta connesso l'IDE, puoi accedere ai file nella tua workstation direttamente dall'IDE Jetbrains, che può anche utilizzare l'estensione Cloud Workstations per creare ed eseguire il codice.