Développer du code à l'aide d'IDE JetBrains locaux

Le plug-in Cloud Workstations vous permet de lancer des sessions de développement à distance pour Cloud Workstations à l'aide d'IDE JetBrains tels que IntelliJ IDEA Ultimate, PyCharm Professional, Rider, CLion, PhpStorm et WebStorm.

Systèmes d'exploitation compatibles

Le plug-in Cloud Workstations est compatible avec les systèmes d'exploitation suivants:

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

Versions compatibles

Le plug-in Cloud Workstations est compatible avec la dernière version et une version précédente des IDE JetBrains et de la passerelle JetBrains. Lorsqu'une nouvelle version majeure de l'IDE JetBrains est publiée, la prochaine version du plug-in Cloud Workstations est compatible avec la nouvelle version et abandonne la compatibilité avec la première version précédemment compatible.

Remarque :La compatibilité du plug-in Cloud Workstations avec le programme d'accès anticipé JetBrains (EAP) est la meilleure possible. Le PAA introduit parfois des modifications destructives, dont la résolution peut prendre un certain temps.

Pour faciliter la mise à jour des applications JetBrains, vous pouvez également installer JetBrains Toolbox.

Pour en savoir plus sur les versions de l'IDE JetBrains dans les images de base préconfigurées, consultez les notes de version de Cloud Workstations.

Avant de commencer

Assurez-vous de suivre ces étapes avant d'installer le plug-in Cloud Workstations:

1. Suivez les étapes pour créer un poste de travail. Lorsque vous êtes invité à renseigner la section Configuration, choisissez l'image correspondant à l'IDE JetBrains que vous souhaitez utiliser.

2. Après avoir saisi le nom de votre station de travail, cliquez sur Créer.

3. Cliquez sur la page Workstations et attendez la fin de la création de la station de travail.

4. Téléchargez et installez une version compatible de JetBrains Gateway.

Installer le plug-in Cloud Workstations

Remarque :Si vous êtes un utilisateur BYOID, passez à la section Autres instructions de connexion pour les utilisateurs BYOID.

1. Installez le plug-in Cloud Workstations:

   1. Ouvrez JetBrains Gateway.

   2. Sélectionnez Tous les fournisseurs.

   3. Dans la section Install More Providers (Installer plus de fournisseurs), recherchez Google Cloud, puis cliquez sur Install (Installer) pour télécharger le plug-in Cloud Workstations.

      

2. Après l'installation, Cloud Workstations apparaît dans la section Exécuter l'IDE à distance.

Se connecter à l'aide du plug-in Cloud Workstations

Pour vous connecter à une station de travail à l'aide du plug-in, procédez comme suit:

1. Ouvrez JetBrains Gateway.

2. Dans la section Exécuter l'IDE à distance, cliquez sur Se connecter à Google Cloud.

3. Cliquez sur Connexion pour vous connecter à votre compte Google.

   1. Suivez les instructions pour autoriser le plug-in Cloud Workstations à accéder à Google Cloud.

   2. Cliquez sur Continuer pour terminer la procédure de connexion.

4. Cliquez sur Parcourir pour ouvrir une boîte de dialogue de sélection de projet et sélectionner un projet Cloud.

   

5. Sélectionnez une station de travail sous le projet cloud, cliquez sur Suivant et attendez que la station de travail sélectionnée démarre.

6. Sélectionnez votre IDE et votre projet:

   1. Sélectionnez une version d'IDE sur l'hôte distant.

   2. Saisissez le chemin d'accès d'un projet IDE sur l'hôte distant.

      

   Remarque :N'oubliez pas que seuls les fichiers stockés dans le répertoire /home sont conservés entre les sessions.

7. Cliquez sur Connecter, puis attendez que l'IDE et le projet s'ouvrent.

Se reconnecter à une station de travail

Pour vous reconnecter rapidement à une station de travail et à un projet IDE:

1. Ouvrez le panneau Connexions récent.

2. Cliquez sur le chemin d'un projet pour ouvrir un IDE dans Cloud Workstations.

   

3. Attendez que l'IDE et le projet s'ouvrent.

Utiliser le transfert de port

Une fois le client JetBrains ouvert avec votre IDE et votre projet, vous pouvez accéder aux ports distants sur Cloud Workstations à partir de votre ordinateur local. Par exemple, lorsque vous exécutez un serveur Python sur le poste de travail, python -m SimpleHTTPServer 8080. Dans certains cas, JetBrains Gateway effectue automatiquement le transfert de port pour vous afin que vous puissiez accéder aux projets exécutés à distance via votre navigateur local.

Vous pouvez également effectuer un transfert de port manuel de Cloud Workstations vers votre ordinateur local comme suit:

1. Sous Windows et Linux, sélectionnez File > Settings (Fichier > Paramètres) dans le menu principal.

   Pour macOS, sélectionnez IntelliJ IDEA > Preferences (Préférences) dans le menu principal.

2. Accédez à Outils > Transfert de port et ajoutez une règle pour transférer le trafic TCP pour le port 8080.

3. Après avoir défini cette règle, vous pouvez accéder localement au port 8080 de Cloud Workstations à l'adresse http://localhost:8080.

Remplacer les points de terminaison de l'API

Pour les utilisateurs de cloud privé virtuel qui doivent remplacer les points de terminaison de l'API, assurez-vous que le plug-in peut se connecter à vos services cloud. Pour remplacer les points de terminaison de l'API, procédez comme suit:

1. Sous Windows et Linux, cliquez sur Paramètres Menu d'options > Paramètres.

   

   Sous macOS, cliquez sur settings Menu d'options > Préférences.

   

2. Facultatif: Pour accéder aux paramètres JetBrains pour IntelliJ et d'autres IDE, consultez Configurer les paramètres du projet.

3. Accédez à Tools > Google Cloud Workstations > Advanced (Outils > Avancé).

4. Ajoutez des URL de remplacement des points de terminaison de l'API.

   Remarque :Veillez à utiliser les noms DNS p.googleapis.com du cloud privé virtuel. N'utilisez pas d'adresses IP.

   

5. Cliquez sur Appliquer.

Pour en savoir plus sur l'utilisation de points de terminaison dans Google Cloud, consultez la description du cloud privé virtuel de l'accès aux API Google via des points de terminaison.

Autres instructions de connexion pour les utilisateurs BYOID

Si vous utilisez la fonctionnalité BYOID, vous devez prendre des mesures supplémentaires pour vous connecter à JetBrains Gateway. Procédez comme suit :

Démarrez votre station de travail et ouvrez une connexion TCP

Suivez les étapes ci-dessous pour démarrer votre station de travail et ouvrir une connexion TCP:

1. Suivez les instructions de la section "Avant de commencer".

2. Assurez-vous que votre station de travail est en cours d'exécution. Vous pouvez utiliser la commande CLI gcloud suivante pour le démarrer.

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

3. Démarrez un tunnel TCP vers votre station de travail sur le port 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
   

Remarque :Vous devez disposer de la CLI gcloud version 387.0.0 ou ultérieure pour que cette commande soit compatible. Vérifiez la version de la CLI gcloud en exécutant la commande gcloud version. Si nécessaire, effectuez la mise à jour à l'aide de la commande gcloud components update.

Une fois la configuration et l'installation initiales terminées, l'étape suivante consiste à lancer JetBrains Gateway.

Lancer JetBrains Gateway

1. Après avoir lancé JetBrains Gateway, sélectionnez Se connecter via SSH.

2. Sur la page Se connecter à SSH, cliquez sur Paramètres pour configurer une nouvelle connexion.

   Sur la page de configuration SSH:

   1. Cliquez sur addAjouter une nouvelle connexion.
   2. Saisissez vos informations de connexion. Par exemple, Hôte local=127.0.0.1, Port=2222 et Nom d'utilisateur=user. Veillez à utiliser des valeurs adaptées à votre configuration pour l'hôte local, le port et le nom d'utilisateur.
   3. Définissez le type d'authentification sur Mot de passe et laissez le champ du mot de passe vide.
   4. Effacez l'option Parse config file ~/.ssh/config.
   5. Cliquez sur OK pour créer la connexion.
   6. Cliquez sur Vérifier la connexion et continuer.

3. Sur la page Choose IDE and Project (Choisir un IDE et un projet), sélectionnez les éléments suivants:

   1. Sélectionnez l'IDE que vous souhaitez utiliser.

   2. Sélectionnez le répertoire qui contient votre projet en cliquant sur more_horiz Plus. Notez que vous ne pouvez pas créer de projet à partir de ce menu. Vous ne pouvez qu'ouvrir un projet. Pour créer un projet, sélectionnez Ouvrir un terminal SSH et exécutez les commandes permettant de créer un répertoire pour votre projet JetBrains.

      Vous pouvez également cliquer sur Ouvrir un terminal SSH pour exécuter des commandes git dans vos stations de travail. Par exemple, la commande suivante clone le projet Exemples Cloud Code dans votre répertoire d'accueil:

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

   3. Après avoir sélectionné le répertoire du projet, cliquez sur Télécharger et démarrer l'IDE.

4. Une fois l'IDE connecté, vous pouvez accéder aux fichiers de votre poste de travail directement depuis votre IDE JetBrains, qui peut également utiliser l'extension Cloud Workstations pour compiler et exécuter votre code.