L'extension Cloud Code pour VS Code offre la prise en charge du développement sur 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 :
- Installez et configurez Visual Studio Code sur votre ordinateur.
Installez et configurez le module de compatibilité des langages de programmation.
L'extension Cloud Code fonctionne mieux avec les langages suivants :
Installez Git. Git est nécessaire pour copier des exemples sur votre ordinateur.
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.
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 services Google Cloud, d'ajouter et de supprimer des collaborateurs, et de gérer les autorisations pour les ressources Google Cloud.
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:
Cliquez sur Extensions ou appuyez sur
Ctrl
/Cmd
+Shift
+X
.Recherchez
Google Cloud Code
.Cliquez sur Install (Installer).
Si vous y êtes invité, redémarrez VS Code.
Une fois l'extension installée, l'icône Cloud Code est ajoutée à la barre des activités et prête à être utilisée. Vous pouvez affiner votre installation de Cloud Code en spécifiant vos préférences à l'aide de la barre des tâches de l'application de premier niveau : Code > Preferences > Settings > Extensions > Cloud Code.
Versions personnalisées des dépendances
Par défaut, les dépendances automatiques sont activées dans Cloud Code et installent automatiquement certaines dépendances de ligne de commande. Si vous désactivez les dépendances automatiques, vous pouvez utiliser des versions personnalisées de celles-ci, mais vous devrez les installer vous-même pour que Cloud Code fonctionne.
Pour utiliser des versions personnalisées des dépendances Cloud Code, procédez comme suit:
- Cliquez sur settings
Gérer > Paramètres, puis définissez Dépendances automatiques (
cloudcode.autoDependencies
) suroff
. Installez les dépendances suivantes sur votre
PATH
:- kubectl
- Skaffold
- minikube pour le développement local
- Google Cloud CLI, en cas de développement avec Google Cloud
Facultatif: Vérifier Cloud Code vsix à l'aide de VsixSignTool
Pour vérifier Cloud Code vsix à l'aide de VsixSignTool, procédez comme suit:
Assurez-vous d'utiliser les éléments suivants:
- Gestionnaire de packages Nuget
- Système d'exploitation Windows
- Une version de production de Cloud Code
Installez Microsoft VsixSignTool et notez le chemin d'installation.
Ouvrez VS Code et accédez à Extensions > Cloud Code.
Dans l'onglet Détails, sous Ressources des extensions, cliquez sur Place de marché.
Sur la page Marketplace de votre navigateur, sous Ressources, cliquez sur Télécharger l'extension pour télécharger la version empaquetée de Cloud Code. Cette opération télécharge la version empaquetée de Cloud Code, qui comporte une extension de fichier
.vsix
, dans votre répertoire de téléchargement par défaut.Si vous préférez valider une version différente de la dernière, cliquez sur l'onglet Historique des versions et sélectionnez une autre version à télécharger.
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
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 faciliter le développement d'applications avec les API Google Cloud, vos identifiants par défaut de l'application sont mis à jour lorsque vous vous connectez à la gcloud CLI.
Se connecter à Google Cloud
Si vous n'êtes pas connecté à Google Cloud, procédez comme suit:
- Dans la barre d'état Cloud Code, cliquez sur Cloud Code - Se connecter.
Si vous vous connectez pour la première fois à Google Cloud dans votre IDE, vous êtes invité à ajouter
https://accounts.google.com
au domaine de confiance. Cliquez sur Configure Trusted Domains (Configurer des domaines de confiance) dans la boîte de dialogue qui s'affiche:Suivez les instructions pour vous connecter à l'aide de votre navigateur Web.
Lorsque vous êtes invité à autoriser Cloud Code à accéder à votre compte Google, cliquez sur Allow (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 remarquerez peut-être que le navigateur Edge redirige l'URL http://localhost:3000
vers https://localhost:3000
. Cela entraîne le message d'échec suivant:
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:
Dans la barre d'adresse de votre navigateur Edge, saisissez
edge://net-internals/#hsts
.Accédez à la section Supprimer les règles de sécurité du domaine.
Saisissez
localhost
, puis cliquez sur Supprimer.
Se déconnecter de Google Cloud
- Cliquez sur Cloud Code, puis développez Aide et commentaires.
- Cliquez sur Sign out of Google Cloud (Se déconnecter de Google Cloud). Lorsque vous y êtes invité, sélectionnez Sign-out (Se déconnecter).
- 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 sur Se déconnecter de tous les comptes dans le SDK Google Cloud.
Modifier le projet Google Cloud actif
Dans la barre d'état Cloud Code, cliquez sur le nom du projet actif.
Dans le menu "Quick Pick" (Sélection rapide) qui s'affiche, sélectionnez sync_alt Switch Project (Changer de projet).
Sélectionnez un projet ou saisissez des mots clés dans la barre de recherche pour filtrer les projets.
Authentifier les identifiants pour déboguer des applications en local
En plus des étapes d'authentification décrites dans la section Se connecter à Google Cloud, vous devez authentifier vos identifiants pour déboguer une application qui effectue des appels d'API Google localement dans votre IDE.
Si vous n'authentifiez pas vos identifiants pour déboguer des applications, un message d'erreur s'affiche dans votre IDE lorsque vous tentez d'exécuter ou de déboguer une application locale qui tente d'appeler une API Google.
Pour authentifier vos identifiants afin de déboguer des applications localement, procédez comme suit:
Si ce n'est pas déjà fait, installez gcloud sur votre machine.
Exécutez la commande ci-dessous.
gcloud auth application-default login
Une fois le débogage local terminé, 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 S'authentifier auprès des services cloud à l'aide de bibliothèques clientes.