Sviluppa il codice utilizzando gli IDE JetBrains locali

Il plug-in Cloud Workstations consente di avviare sessioni di sviluppo remoto per Cloud Workstations che utilizzano 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 l'ultima versione e una precedente di Compute Engine, IDE JetBrains e Gateway JetBrains. Quando viene rilasciata una nuova versione principale dell'IDE JetBrains, quella successiva La release del plug-in Cloud Workstations supporta la nuova versione ed elimina il supporto per l'ultima versione supportata in precedenza.

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. L'EAP a volte introduce modifiche che provocano un errore, ma la risoluzione di questi problemi potrebbe richiedere del tempo.

Per mantenere aggiornate più facilmente le app JetBrains, puoi anche installare Strumenti JetBrains.

Per saperne di più sulle versioni dell'IDE JetBrains in 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 viene richiesto il Configurazione, scegli l'immagine che corrisponde 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 Gateway JetBrains.

Installa il plug-in Cloud Workstations

Nota: se sei un utente BYOID, passa al Istruzioni di connessione alternative 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 da remoto.

Connettiti utilizzando il plug-in Cloud Workstations

Per connetterti a una workstation utilizzando il plug-in, segui questi passaggi:

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 il tuo IDE e il tuo progetto:

   1. Seleziona una versione IDE nell'host remoto.

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

      

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

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 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 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, il gateway JetBrains esegue automaticamente la porta l'inoltro per te, in modo da poter accedere ai progetti in esecuzione da remoto browser locale.

Puoi anche eseguire manualmente il port forwarding 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 da il 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 localmente all'indirizzo http://localhost:8080

Sostituisci gli endpoint API

Per gli utenti del virtual private cloud che devono eseguire l'override degli endpoint API, assicurati che può connettersi ai tuoi servizi cloud. Per eseguire l'override degli endpoint API, segui questi passaggi:

1. In 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 URL di override degli 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'uso degli endpoint in Google Cloud, consulta Descrizione del virtual private cloud accesso alle API di Google tramite endpoint.

Istruzioni di connessione alternative per gli utenti BYOID

Se usi la funzionalità BYOID, devi seguire ulteriori passaggi per collegarti a JetBrains Gateway. 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 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 disporre della versione gcloud CLI 387.0.0 o successiva. Controlla la versione dell'interfaccia a riga di comando di gcloud eseguendo 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 il 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 Host locale=127.0.0.1, Porta=2222 e Nome utente=user. Assicurati di utilizzare valori appropriati per il tuo configurazione per l'host locale, la porta e il nome utente.
   3. Imposta Authentication type (Tipo di autenticazione) su Password e lascia la password è vuoto.
   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 Controlla 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 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. Dopo la connessione dell'IDE, puoi accedere ai file nella tua workstation direttamente dal tuo IDE JetBrains, che può utilizzare anche l'estensione Cloud Workstations per aiutarti a creare ed eseguire il codice.