Si vous n'avez pas défini de fichier .vscode/launch.json, la boîte de dialogue Run/Debug on Cloud Run Emulator (Exécuter/Déboguer sur l'émulateur Cloud Run) vous permet de configurer votre lancement, puis d'enregistrer vos paramètres dans .vscode/launch.json. Si vous avez configuré un fichier .vscode/launch.json, vous pouvez le modifier directement.
Pour exécuter votre service en local, spécifiez votre configuration:
Ouvrez la palette de commandes (appuyez sur Ctrl/Cmd+Shift+P ou cliquez sur Affichage > Palette de commandes), puis exécutez la commande Run on Cloud Run Emulator (Exécuter sur l'émulateur Cloud Run).
Dans la boîte de dialogue "Run/Debug on Cloud Run Emulator" (Exécution/Débogage sur l'émulateur Cloud Run), définissez les spécifications de votre configuration :
Seuls les outils de compilation installés localement sont disponibles pour l'émulateur Cloud Run.
Choisissez Docker ou Buildpacks comme compilateur, puis spécifiez la source.
(Facultatif) Pour spécifier des variables d'environnement à transmettre aux conteneurs en cours d'exécution, développez Advanced Build Settings (Paramètres de compilation avancés), puis cliquez pour spécifier des paires clé-valeur.
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
(Facultatif) Pour spécifier des connexions Cloud SQL, développez Paramètres de service avancés, cliquez sur Connexions, puis spécifiez une connexion Cloud SQL par ligne.
(Facultatif) Cochez l'option Rendre le service accessible depuis d'autres appareils du réseau local.
(Facultatif) Si vous ne souhaitez recompiler et exécuter votre service manuellement, au lieu de le faire automatiquement lorsque vous apportez une modification, décochez l'option Recompiler et réexécuter automatiquement en cas de modification.
Exécuter votre service en local
Après avoir défini les paramètres de votre choix, exécutez votre service en cliquant sur Run (Exécuter).
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.
Pour afficher les journaux détaillés, passez à la vue détaillée de Cloud Run dans la fenêtre de sortie.
Une fois la session terminée, effectuez un clic droit pour utiliser les commandes suivantes:
Afficher les journaux:ouvrez les journaux d'application d'un déploiement spécifique avec l'explorateur de journaux Cloud Code.
Ouvrir l'URL:ouvrez l'URL du service d'application d'un service spécifique dans un navigateur Web.
Si vous avez désactivé le mode de surveillance dans votre configuration de lancement et que vous souhaitez modifier votre application, puis la recompiler et la redéployer, cliquez sur la barre d'état de Cloud Code, puis sur Activer le mode de surveillance.
Pour arrêter votre déploiement, vous pouvez cliquer sur le bouton Stop (Arrêter) dans la barre d'action correspondant à votre déploiement actuel.
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, les stocker en tant que secrets peut contribuer à les sécuriser. L'intégration de Secret Manager à Cloud Code vous permet de stocker ces secrets de manière sécurisée et de les récupérer de manière automatisée. Pour en savoir plus sur la création et la gestion des secrets avec Cloud Code, consultez le guide de Secret Manager.
Personnaliser une configuration launch.json existante
Le plug-in Cloud Code met automatiquement à jour le fichier de configuration launch.json lorsque vous choisissez une action d'exécution. Pour personnaliser davantage l'exécution de votre service, vous pouvez spécifier les champs suivants dans votre fichier .vscode/launch.json:
watch: surveille les modifications apportées à l'espace de travail et réexécute le service. "True" par défaut.
L'exemple suivant montre la montre définie sur true:
"watch":true,
build: spécifiez le compilateur (Docker, jibMaven, jibGradle ou Buildpacks) avec lequel vous souhaitez compiler vos images.
L'exemple suivant montre un buildeur Docker:
"build":{"docker":{"path":"Dockerfile"}},
L'exemple suivant montre un générateur de buildpack:
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.
L'exemple suivant montre une section de débogage qui indique l'emplacement des fichiers sources:
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eYou can develop services locally using a Cloud Run emulator before deploying them to Cloud Run, with configuration options accessible via the command palette or by editing the \u003ccode\u003e.vscode/launch.json\u003c/code\u003e file directly.\u003c/p\u003e\n"],["\u003cp\u003eThe Run/Debug on Cloud Run Emulator dialog allows you to configure build settings like selecting Docker or Buildpacks, setting environment variables, specifying Cloud SQL connections, and enabling network accessibility.\u003c/p\u003e\n"],["\u003cp\u003eAfter deploying, you can monitor the service status in the output window, access detailed logs, and open the service URL, with the ability to turn watch mode on or off to control automatic rebuilding and redeployment.\u003c/p\u003e\n"],["\u003cp\u003eSensitive data can be secured by storing them as secrets using Cloud Code Secret Manager integration.\u003c/p\u003e\n"],["\u003cp\u003eYou can further customize the service launch by modifying the \u003ccode\u003e.vscode/launch.json\u003c/code\u003e configuration file, allowing adjustments to build settings, image names, service parameters, and debug options like source file mapping.\u003c/p\u003e\n"]]],[],null,["# Develop a Cloud Run service locally in Cloud Code for Cloud Shell\n\nBefore you\n[deploy a service to Cloud Run](/code/docs/shell/deploy-service),\nyou can develop it locally using a Cloud Run emulator.\n\nConfiguring your service for development\n----------------------------------------\n\nIf you don't have a `.vscode/launch.json` file defined, the\n**Run/Debug on Cloud Run Emulator** dialog lets you configure your launch and\nthen saves your settings to `.vscode/launch.json`. If you have a\n`.vscode/launch.json` file configured, you can edit the file directly.\n\nTo run your service locally, specify your configuration:\n\n1. Open the command palette (press `Ctrl`/`Cmd`+`Shift`+`P` or click **View** \\\u003e **Command Palette** ) and then run the **Run on Cloud Run Emulator** command.\n2. In the Run/Debug on Cloud Run Emulator dialog, set the\n specifications for your configuration:\n\n - Only locally-installed build tools are available for Cloud Run Emulator\n - Choose **Docker** or **Buildpacks** as your builder and then specify the source\n - (Optional) To specify any environment variables to pass to the running containers, expand **Advanced Build Settings** and then click to specify key-value pairs.\n\n - (Optional) To specify Cloud SQL connections, expand **Advanced Service Settings** , click **Connections**, and then specify one Cloud SQL connection per line.\n - (Optional) Check the **Make the service accessible from other devices on the local network** option.\n - (Optional) If you only want to rebuild and run your service manually, instead of automatically when you make a change, clear the **Automatically re-build and re-run on changes** option.\n\nRunning your service locally\n----------------------------\n\n1. After you define your preferred settings, run your service by clicking\n **Run**.\n\n2. Monitor the status of your deployment in the **output window**.\n\n After deployment is complete, you can view your running service by opening\n the URL displayed in the output window.\n3. To view verbose logs, switch to the detailed Cloud Run view\n in the output window.\n\n4. After your session completes, right-click to use the following commands:\n\n - **View Logs:** Open the application logs of a specific deployment with the Cloud Code logs explorer.\n - **Open URL:** Open the application service URL of a specific service in a web browser.\n5. If you've turned off watch mode in your launch configuration and you want to\n make changes to your application and rebuild and redeploy the application,\n click the Cloud Code status bar and then click\n **Turn on watch mode**.\n\n6. To stop your deployment, you can click the **Stop** button in the action bar\n for your current deployment.\n\nStoring secrets\n---------------\n\nIf your code includes potentially sensitive data like API keys, passwords, and\ncertificates, storing them as secrets can help secure them. The\nCloud Code Secret Manager integration lets you securely\nstore these secrets and fetch them programmatically. For a detailed look at how\nyou can create and manage secrets with Cloud Code, see\n\n\nthe [Secret Manager guide](/code/docs/shell/secret-manager).\n\n\nCustomizing an existing launch.json configuration\n-------------------------------------------------\n\nThe Cloud Code plugin updates the `launch.json` configuration file\nautomatically when you choose a run action. To further customize how your\nservice is run, you can specify the following fields in your\n`.vscode/launch.json` file:\n\n- **watch**: Watches for changes in the workspace and reruns\n the service. True by default.\n\n The following sample shows watch set to `true`: \n\n \"watch\": true,\n\n- **build** : Specify the builder\n ([Docker](https://skaffold.dev/docs/pipeline-stages/builders/docker/),\n jibMaven, jibGradle, or\n [buildpacks](https://skaffold.dev/docs/pipeline-stages/builders/buildpacks/))\n to build your images with.\n\n The following sample shows a Docker builder: \n\n \"build\": {\n \"docker\": {\n \"path\": \"Dockerfile\"\n }\n },\n\n The following sample shows a buildpack builder: \n\n \"build\": {\n \"buildpacks\": {\n \"path\": \"src/requirements.txt\",\n \"builder\": \"gcr.io/buildpacks/builder:v1\"\n }\n },\n\n- **image**: Specify the name of the image to use.\n\n The following sample shows how to specify an image name: \n\n \"image\": \"hello-world\",\n\n- **service**: Specify the Cloud Run service to use.\n\n The following sample shows how to specify a service name, port, and resource\n limits: \n\n \"service\": {\n \"name\": \"hello-world\",\n \"containerPort\": 8080,\n \"resources\": {\n \"limits\": {\n \"memory\": \"256Mi\"\n }\n }\n },\n\n- **debug**: Specify debug settings such as remote path mapping to map a local\n path to a path on the remote container.\n\n The following sample shows a debug section that indicates the source files'\n location: \n\n \"debug\": {\n \"sourceFileMap\": {\n \"${workspaceFolder}\": \"/app\"\n }\n }"]]