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.
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:
Segui i passaggi per creare una workstation. Quando viene richiesta la configurazione, scegli l'immagine corrispondente all'IDE JetBrains che vuoi utilizzare.
Dopo aver inserito il nome della workstation, fai clic su Crea.
Fai clic sulla pagina Workstations e attendi che la creazione della workstation termini.
Scarica e installa una versione supportata del gateway JetBrains.
Installa il plug-in Cloud Workstations
Installa il plug-in Cloud Workstations:
Apri il gateway JetBrains.
Seleziona Tutti i provider.
Nella sezione Installa altri provider, trova Google Cloud e fai clic su Installa per scaricare il plug-in Cloud Workstations.
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:
Apri il gateway JetBrains.
Nella sezione Esegui l'IDE da remoto, fai clic su Connetti a Google Cloud.
Fai clic su Accedi per accedere al tuo Account Google.
Segui le istruzioni per concedere al plug-in Cloud Workstations l'accesso a Google Cloud.
Fai clic su Continua per completare l'accesso.
Fai clic su Sfoglia per aprire una finestra di dialogo del selettore progetti e selezionare un progetto Cloud.
Seleziona una workstation nel progetto cloud, fai clic su Avanti e attendi l'avvio della workstation selezionata.
Seleziona il tuo IDE e il tuo progetto:
Seleziona una versione IDE nell'host remoto.
Inserisci un percorso del progetto IDE sull'host remoto.
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:
Apri il riquadro Connessioni recente.
Fai clic sul percorso di un progetto per aprire un IDE in Cloud Workstations.
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:
Per Windows e Linux, seleziona File > Impostazioni dal menu principale.
Per macOS, seleziona IntelliJ IDEA > Preferenze dal menu principale.
Vai a Strumenti > Port Forwarding e aggiungi una nuova regola per inoltrare TCP per la porta
8080
.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:
In Windows e Linux, fai clic su Impostazioni menu Opzioni > Impostazioni.
In macOS, fai clic su Impostazioni menu Opzioni > Preferenze.
(Facoltativo) Per accedere alle impostazioni di JetBrains per IntelliJ e altri IDE, consulta la pagina relativa alla configurazione delle impostazioni di progetto.
Vai a Strumenti > Google Cloud Workstations > Avanzate.
Aggiungi URL di override degli endpoint API.
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:
- Segui le istruzioni nella sezione Prima di iniziare.
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
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
Una volta completate la configurazione e l'installazione iniziali, il passaggio successivo consiste nell'avviare il gateway Jetbrains.
Avvia gateway JetBrains
Dopo aver avviato il gateway Jetbrains, seleziona Connetti tramite SSH.
Nella pagina Connetti a SSH, fai clic su Impostazioni per configurare una nuova connessione.
Dalla pagina di configurazione SSH:
- Fai clic su aggiungiAggiungi una nuova connessione.
- 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. - Imposta Tipo di autenticazione su Password e lascia vuoto il campo della password.
- Deseleziona l'opzione Parse config file ~/.ssh/config (file di configurazione di analisi).
- Fai clic su OK per creare la connessione.
- Fai clic su Verifica connessione e continua.
Nella pagina Scegli IDE e progetto, seleziona quanto segue:
- Seleziona l'IDE che vuoi utilizzare.
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
Dopo aver selezionato la directory del progetto, fai clic su Scarica e avvia IDE.
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.