Développer un service Cloud Run en local

Avant de déployer un service sur Cloud Run, vous pouvez le développer localement à l'aide d'un émulateur Cloud Run.

Configurer votre service pour le développement

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

  1. Ouvrez la palette de commandes (appuyez sur Ctrl/Cmd+Shift+P), puis exécutez la commande Exécuter sur l'émulateur Cloud Run.
  2. Dans la boîte de dialogue "Run/Debug on Cloud Run Emulator" (Exécuter/Déboguer sur l'émulateur Cloud Run), définissez les spécifications de votre configuration.

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 en local

  1. Après avoir défini vos paramètres préférés, exécutez votre service en cliquant sur 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 votre 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, accédez à la vue détaillée de Cloud Run dans la fenêtre de sortie.

    Volet de sortie avec "hello-world-5" détaillé dans la liste déroulante du canal 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 pour un déploiement spécifique à l'aide de la visionneuse de journaux Cloud Code.
    • Open Service URL (Ouvrir l'URL du service) : ouvrez l'URL du service d'application d'un service spécifique dans un navigateur Web.
    • Activer/Désactiver le mode de visionnage:activez/désactivez le mode de lecture pour la session en cours. Par défaut, Cloud Code surveille en permanence les modifications apportées à vos fichiers, telles que la configuration ou le code de Kubernetes, recompile les conteneurs et redéploie l'application sur le cluster afin que votre{ 101}les modifications sont reflétées quasiment en temps réel.

      Options disponibles dans la barre d'état Cloud Code: ouvrir les journaux de déploiement, ouvrir l'URL du service et activer le mode de surveillance, en plus des actions standards de Cloud Code

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

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

Personnaliser une configuration launch.json existante

Pour configurer le mode d'exécution de votre service, vous pouvez personnaliser votre skaffold.yaml et spécifier les champs suivants dans votre fichier .vscode/launch.json:

  • watch: surveille les modifications apportées à l'espace de travail en mode "Run" (Exécuter) et réexécute 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.