Installer l'extension Cloud Code pour VS Code

L'extension Cloud Code pour VS Code offre la prise en charge du développement Google Cloud avec VS Code.

Avant de commencer

Avant d'installer Cloud Code, vérifiez que les outils suivants sont installés et configurés sur votre système :

  1. Installez et configurez Visual Studio Code sur votre ordinateur.
  2. Installez et configurez le module de compatibilité des langages de programmation.

    L'extension Cloud Code fonctionne mieux avec les langages suivants :

  3. Installez Git. Git est nécessaire pour copier des exemples sur votre ordinateur.

  4. Installez le client Docker et ajoutez-le à la variable d'environnement PATH :

    • Si vous compilez exclusivement à l'aide de Cloud Build ou Jib, vous pouvez ignorer l'installation de Docker.
    • Si vous utilisez Windows Home, pour obtenir la procédure de configuration de votre client Docker, consultez le guide Docker Desktop pour Windows Home.
    • Si vous utilisez WSL, mais que vous ne pouvez pas installer "Docker for Desktop", utilisez plutôt Minikube pour le développement local avec Cloud Code.
  5. Si vous utilisez Google Cloud, créez un projet Google Cloud , puis activez la facturation.

    Les projets vous permettent de rassembler les ressources associées à une application donnée au même endroit, de gérer les API, d'activer les Google Cloud services, d'ajouter et de supprimer des collaborateurs, et de gérer les autorisations pour les Google Cloud ressources.

Installer Cloud Code

Installez l'extension Google Cloud Code à partir de Visual Studio Code Marketplace.

Vous pouvez également ouvrir la vue Extensions dans VS Code:

  1. Cliquez sur Icône de l'extension Extensions ou appuyez sur Ctrl/Cmd+Shift+X.

  2. Recherchez Google Cloud Code.

    Extension Cloud Code sur le marché VSC

  3. Cliquez sur Installer.

  4. Si vous y êtes invité, redémarrez VS Code.

    Une fois l'extension correctement installée, l'icône Cloud Code est ajoutée à la barre des tâches et est prête à être utilisée. Vous pouvez procéder à une configuration plus avancée de votre installation Cloud Code en spécifiant vos préférences à l'aide de la barre des tâches de niveau supérieur de l'application : accédez à Code > Paramètres > Paramètres > Extensions, puis recherchez Gemini Code Assist + Google Cloud Code.

Versions personnalisées des dépendances

Par défaut, les dépendances automatiques sont activées dans Cloud Code et certaines dépendances de ligne de commande sont installées automatiquement. Si vous désactivez les dépendances automatiques, vous pouvez utiliser des versions personnalisées des dépendances, mais vous devez les installer vous-même pour que Cloud Code fonctionne.

Pour utiliser des versions personnalisées des dépendances Cloud Code:

  1. Cliquez sur settings (Paramètres) > Manage (Gérer) > Settings (Paramètres), puis définissez Auto Dependencies (Dépendances automatiques) (cloudcode.autoDependencies) sur off.

  2. Installez les dépendances suivantes sur votre PATH :

Installer Google Cloud CLI

La première fois que vous utilisez une fonctionnalité nécessitant gcloud CLI, vous avez la possibilité d'apprendre à installer la CLI à partir de votre IDE, d'utiliser une installation existante ou de continuer avec les dépendances gérées. Si vous préférez installer gcloud CLI manuellement, consultez la section Installer gcloud CLI.

Facultatif: Vérifier le fichier vsix Cloud Code à l'aide de VsixSignTool

Pour vérifier le fichier vsix Cloud Code avec VsixSignTool, procédez comme suit:

  1. Assurez-vous d'utiliser les éléments suivants:

    • Gestionnaire de paquets NuGet
    • Système d'exploitation Windows
    • Une version de production de Cloud Code
  2. Installez Microsoft VsixSignTool et notez le chemin d'installation.

  3. Ouvrez VS Code, puis accédez à Icône Extensions dans VSC Extensions > Cloud Code.

  4. Dans l'onglet Détails, sous Ressources de l'extension, cliquez sur Place de marché.

  5. Sur la page de la place de marché dans votre navigateur, sous Ressources, cliquez sur Télécharger l'extension pour télécharger la version empaquetée de Cloud Code. La version empaquetée de Cloud Code, qui porte l'extension de fichier .vsix, est alors téléchargée dans votre répertoire de téléchargement par défaut.

  6. Si vous préférez vérifier une version autre que la dernière, cliquez sur l'onglet Historique des versions et sélectionnez une autre version à télécharger.

  7. Une fois le téléchargement terminé, ouvrez une fenêtre de terminal et exécutez la commande suivante:

    PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX
    
  8. Vérifiez que le résultat correspond à ce qui suit:

    VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.

Authentifier les identifiants pour Google Cloud

Pour vous aider à développer des applications avec les API Google Cloud , vos identifiants par défaut d'application sont mis à jour lorsque vous vous connectez à la CLI gcloud.

Se connecter à Google Cloud

Si vous n'êtes pas connecté à Google Cloud, procédez comme suit pour vous connecter:

  1. Dans la barre d'état Cloud Code, cliquez sur Cloud Code - Se connecter.
  2. Si vous vous connectez à Google Cloud pour la première fois dans votre IDE, vous êtes invité à ajouter https://accounts.google.com au domaine de confiance. Cliquez sur Configurer les domaines approuvés dans la boîte de dialogue qui s'affiche:

    Boîte de dialogue "Configurer le domaine de confiance"

  3. Suivez les instructions pour vous connecter à l'aide de votre navigateur Web.

  4. Lorsque vous êtes invité à autoriser Cloud Code à accéder à votre compte Google, cliquez sur Autoriser.

Problème connu: le navigateur Edge redirige vers HTTPS lors du rappel d'authentification

Lorsque vous utilisez le navigateur Microsoft Edge pour authentifier vos identifiants, vous pouvez remarquer que le navigateur Edge redirige l'URL http://localhost:3000 vers https://localhost:3000. Le message d'erreur suivant s'affiche:

The connection for this site is not secure. localhost sent an invalid response. Try running Windows Network Diagnostics. ERR_SSL_PROTOCOL_ERROR.

Pour résoudre ce problème, vous pouvez exclure localhost de la redirection:

  1. Dans la barre d'adresse de votre navigateur Edge, saisissez edge://net-internals/#hsts.

  2. Accédez à la section Supprimer les stratégies de sécurité du domaine.

  3. Saisissez localhost, puis cliquez sur Supprimer.

Se déconnecter de Google Cloud

  1. Cliquez sur Cloud Code, puis développez Aide et commentaires.
  2. Cliquez sur Se déconnecter de Google Cloud, puis sélectionnez Se déconnecter lorsque vous y êtes invité.
  3. Vous pouvez également vous déconnecter à l'aide de la palette de commandes. Appuyez sur Ctrl/Cmd+Shift+P ou cliquez sur Affichage > Palette de commandes, puis cliquez sur Déconnexion de tous les comptes dans le SDK Google Cloud.

Modifier le projet Google Cloud actif

  1. Dans la barre d'état Cloud Code, cliquez sur le nom du projet actif.

    Nom du projet actif dans la barre d'état

  2. Dans le menu "Démarrage rapide" qui s'affiche, sélectionnez sync_alt Changer de projet.

  3. Sélectionnez un projet ou saisissez des mots clés dans la barre de recherche pour filtrer les projets.

Authentifier des identifiants pour déboguer des applications en local

En plus des étapes d'authentification de la section Se connecter à Google Cloud, vous devez authentifier vos identifiants pour déboguer une application localement dans votre IDE qui effectue des appels d'API Google.

Si vous n'authentifiez pas vos identifiants pour déboguer des applications, un message d'erreur s'affiche dans votre IDE lorsque vous essayez d'exécuter/de déboguer une application locale qui tente d'appeler une API Google.

Pour authentifier vos identifiants pour le débogage d'applications en local, procédez comme suit:

  1. Installez gcloud sur votre ordinateur, si ce n'est pas déjà fait.

  2. Exécutez la commande suivante :

    gcloud auth application-default login
    
  3. Lorsque vous avez terminé le débogage localement, vous pouvez vous déconnecter en exécutant la commande suivante:

    gcloud auth application-default revoke
    

Pour en savoir plus sur les identifiants par défaut de l'application et les API Google, consultez la section S'authentifier auprès de services Cloud à l'aide de bibliothèques clientes.

Étape suivante

Obtenir de l'aide

Pour envoyer vos commentaires, signalez tout problème sur GitHub ou posez une question sur Stack Overflow.