Cette page a été traduite par l'API Cloud Translation.
Switch to English

Développer un service en local

Configurer le service pour le développement

Pour exécuter votre service localement, vous devez d'abord spécifier votre configuration:

  1. Sélectionnez Exécuter sur l'émulateur Cloud Run à l'aide de la palette de commandes (accessible via Ctrl/Cmd+Maj+ P).
  2. La boîte de dialogue "Run/Debug on Cloud Run Emulator" (Exécuter/Déboguer sur l'émulateur Cloud Run) s'ouvre et vous permet de définir les spécifications de votre configuration.

    UI de "Cloud Run: Run/Debug Locally" (Cloud Run : Exécuter/Déboguer localement)

Facultatif : personnaliser la configuration

Outre les paramètres ci-dessus, vous pouvez spécifier des paramètres avancés tels qu'un compte de service et des variables d'environnement, à l'aide de la section des paramètres avancés.

Variables d'environnement

Les variables d'environnement suivantes sont automatiquement ajoutées aux conteneurs en cours d'exécution :

Nom Description Exemple
PORT Port sur lequel le serveur HTTP doit écouter. 8080
K_SERVICE Nom du service Cloud Run en cours d'exécution. hello-world
K_REVISION Nom de la révision Cloud Run en cours d'exécution. hello-world.1
K_CONFIGURATION Nom de la configuration Cloud Run ayant créé la révision. hello-world

Exécuter votre service localement

  1. Après avoir défini vos paramètres préférés, vous pouvez cliquer sur Run (Exécuter).
  2. Surveillez l'état de votre déploiement dans la fenêtre de sortie.

    Une fois l'opération terminée, vous pouvez afficher votre service en cours en suivant l'URL affichée dans la fenêtre de sortie.

  3. Accédez à la vue détaillée de Cloud Run dans la fenêtre de sortie pour afficher des journaux détaillés.

    Volet de sortie avec "hello-world-5 - Detailed" dans la liste déroulante des canaux de sortie

  4. Une fois votre session terminée, d'autres options de menu contextuel sont disponibles pour surveiller votre application et ses ressources via la barre d'état Cloud Code, y compris:

    • Ouvrir les journaux de déploiement:ouvrez les journaux d'application d'un déploiement spécifique à l'aide de la visionneuse de journaux Cloud Code.
    • URL du service ouvert:ouvrez l'URL d'un service spécifique dans un navigateur Web.
    • Activer/Désactiver le mode de lecture:activez ou désactivez le mode de lecture pour la session en cours (non disponible pour les sessions de débogage).

      Options disponibles via la barre d'état Cloud Code: en plus des actions standards de Cloud Code, ouvrez les journaux de déploiement, ouvrez l'URL du service et du mode Lecture,

  5. Pour arrêter le déploiement, vous pouvez cliquer sur le bouton Stop (Arrêter) dans la barre d'action de votre déploiement actuel.

    Barre d'action pour le déploiement de Cloud Run

Stocker des secrets

Si votre code inclut des données potentiellement sensibles telles que des clés API, des mots de passe et des certificats, nous vous recommandons de les stocker en tant que secrets. Avec Cloud Code, vous pouvez stocker ces secrets en toute sécurité dans Secret Manager et les récupérer de manière automatisée lorsque vous en avez besoin. Pour plus d'informations sur la création et la gestion des secrets avec Cloud Code, consultez le guide de Secret Manager.

Personnaliser une configuration launch.json existante

Pour configurer la façon dont votre service est exécuté, vous pouvez personnaliser votre fichier skaffold.yaml et spécifier les champs suivants dans votre fichier .vscode/launch.json:

  • watch: recherche les modifications dans l'espace de travail en mode d'exécution, puis exécute à nouveau le service. À moins qu'il ne soit défini explicitement sur "false", "true" par défaut.
  • build : spécifiez le compilateur (Docker, Buildpacks) avec lequel vous souhaitez compiler vos images.
  • image : spécifiez le nom de l'image que vous souhaitez utiliser.
  • service : spécifiez le service Cloud Run que vous souhaitez utiliser.
  • debug : spécifiez les paramètres de débogage de votre choix, tels que le mappage de chemin d'accès à distance, pour mapper un chemin d'accès local à un chemin d'accès sur le conteneur distant.

Assistance

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