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

Le plug-in Cloud Workstations vous permet de lancer des sessions de développement à distance pour Cloud Workstations à l'aide des 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 JetBrains Gateway. 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 ne prend plus en charge la version la plus ancienne précédemment prise en charge.

Remarque :La compatibilité du plug-in Cloud Workstations pour la Programme JetBrains en accès anticipé (PAA) s'effectue de la manière la plus optimale possible. Le programme EAP introduit parfois des modifications incompatibles, et leur 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 images de base préconfigurées, consultez la Notes de version de Cloud Workstations

Avant de commencer

Avant d'installer le plug-in Cloud Workstations, veillez à suivre ces étapes :

1. Suivez les étapes pour créer un station de travail. Lorsque vous êtes invité à indiquer la 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 (Stations de travail) et attendez que la station de travail soit créée.

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 Instructions de connexion alternatives pour les utilisateurs BYOID.

1. Installez le plug-in Cloud Workstations:

   1. Ouvrez JetBrains Gateway.

   2. Sélectionnez All Providers (Tous les fournisseurs).

   3. Dans la section Installer d'autres fournisseurs, recherchez Google Cloud et Cliquez ensuite sur Installer pour télécharger le plug-in Cloud Workstations.

      

2. Après l'installation, Cloud Workstations s'affiche dans le 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 Se connecter 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 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 la station de travail sélectionnée à démarrer.

6. Sélectionnez votre IDE et votre projet :

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

   2. Saisissez un chemin d'accès au 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écentes.

2. Cliquez sur le chemin d'accès 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 que le client JetBrains s'ouvre avec votre IDE et votre projet, vous pouvez accéder aux ports distants sur Cloud Workstations depuis votre machine locale. Par exemple : lorsque vous exécutez un serveur Python sur la station de travail, python -m SimpleHTTPServer 8080. Dans certains cas, JetBrains Gateway transfère automatiquement les ports pour vous permettre d'accéder aux projets exécutés à distance via votre navigateur local.

Vous pouvez également transférer manuellement des ports de Cloud Workstations vers votre ordinateur local comme suit :

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

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

2. Accédez à Tools > Port Forwarding (Outils > Transfert de port), puis ajoutez une règle pour transférer le protocole TCP pour le port 8080.

3. Après avoir défini cette règle, vous pouvez accéder au port 8080 de Cloud Workstations en local à 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 settings (paramètres) Options menu (menu d'options) > Settings (paramètres).

   

   Sous macOS, cliquez sur paramètres Menu d'options > Préférences.

   

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

3. Accédez à Outils >. Google Cloud Workstations > Avancé.

4. Ajoutez des URL de forçage du point de terminaison de l'API.

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

   

5. Cliquez sur Appliquer.

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

Instructions de connexion alternatives pour les utilisateurs BYOID

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

Démarrer votre station de travail et ouvrir une connexion TCP

Les étapes suivantes démarrent votre station de travail et ouvrent 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 les éléments suivants : gcloud 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 387.0.0 ou version ultérieure pour effectuer cette opération doit être compatible. Vérifiez la version de votre CLI gcloud en exécutant la commande gcloud version. Si nécessaire, mettez à jour avec 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 Connect via SSH (Se connecter via SSH).

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

   À partir de la page "Configuration SSH" :

   1. Cliquez sur add (ajouter) Add a new connection (Ajouter une nouvelle connexion).
   2. Saisissez vos informations de connexion. Par exemple, "Local Host"=127.0.0.1, "Port"=2222 et "Username"=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 conservez le mot de passe. le champ est vide.
   4. Décochez 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 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 contenant 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 ouvrir qu'un projet. Pour créer un projet, sélectionnez Ouvrir un terminal SSH et exécutez des commandes pour 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 d'exemples de code Cloud 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 station de travail directement depuis votre IDE Jetbrains, qui peut également utiliser l'extension Cloud Workstations pour vous aider à compiler et à exécuter votre code.