Développer un service en local

Configurer le service pour le développement

Pour exécuter votre service localement, spécifiez votre configuration comme suit:

  1. Sélectionnez Exécuter sur l'émulateur Cloud Run à l'aide de la palette de commandes (accessible via Ctrl/Cmd+Maj+ P).
  2. Dans la boîte de dialogue de l'émulateur Cloud Run/Debug, définissez 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, exécutez votre service en cliquant sur Run (Exécuter).
  2. Surveillez l'état de votre déploiement dans la fenêtre de sortie.

    Une fois le déploiement terminé, vous pouvez afficher le service en cours d'exécution en ouvrant l'URL affichée dans la fenêtre de sortie.

  3. Pour afficher les journaux détaillés, passez à la vue détaillée de Cloud Run dans la fenêtre de sortie.

    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 à l'aide de 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 ouverte du service:ouvrez l'URL du service d'application d'un service spécifique dans un navigateur Web.
    • Turn / off watch mode (Activer/Désactiver le mode Watch) : activez le mode montre pour la session en cours (non disponible pour les sessions de débogage). Par défaut, Cloud Code surveille en permanence le système de fichiers pour détecter les modifications apportées à vos fichiers, telles que la configuration ou le code Kubernetes, reconstruit des conteneurs, et redéploie l'application sur le cluster afin que vos modifications soient modifiées. se reflètent presque en temps réel.

      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 de manière sécurisée dans Secret Manager, et les récupérer de manière automatisée lorsque vous en avez besoin. Pour un aperçu détaillé de la création et de la gestion des secrets avec Cloud Code, consultez le guide 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.