Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page décrit quelques éléments à connaître pour commencer à développer un service pour Cloud Run.
Exigences relatives au code
Lorsque vous développez un service, vous devez répondre aux exigences suivantes :
Le service doit écouter les requêtes.
Vous pouvez configurer le port sur lequel sont envoyées les requêtes.
Dans les instances Cloud Run, la valeur de la variable d'environnement PORT correspond toujours au port auquel les requêtes sont envoyées.
Votre code doit vérifier l'existence de cette variable d'environnement PORT et, si elle est présente, écouter le port correspondant afin de maximiser la portabilité.
Le service doit être sans état. Il ne peut pas reposer sur un état local persistant.
Si le service effectue des activités en arrière-plan qui sortent du cadre du traitement des requêtes, il doit utiliser le paramètre de facturation basée sur les instances pour que le processeur soit alloué en dehors du cycle de requête standard.
Le déploiement de code source Cloud Run est compatible avec plusieurs environnements d'exécution de langage, chacun disponible via des images de base de conteneur fournies par les buildpacks de Google Cloud. Vous pouvez également utiliser d'autres langages de programmation ou frameworks, à condition que le code source se trouve dans une image conforme à l'OCI.
Vous pouvez utiliser un serveur Web pour écouter le port requis, ainsi que pour traiter et acheminer les requêtes entrantes. Par exemple, les développeurs en Node.js peuvent utiliser Express.js, les développeurs en Python, Flask, les développeurs en Ruby, Sinatra, etc.
Concevoir des applications Cloud Run avec l'aide de Gemini
Vous pouvez obtenir de l'aide optimisée par l'IA dans le chat Gemini Cloud Assist pour concevoir des applications de manière optimale. Avec Gemini Cloud Assist, vous pouvez découvrir les configurations et les stratégies les plus adaptées au déploiement de vos applications sur Cloud Run, ce qui garantit une utilisation efficace des ressources et un fonctionnement fluide.
Pour utiliser Gemini Cloud Assist depuis la console Google Cloud :
Dans la barre d'outils de la console, sélectionnez un projet Google Cloud . Utilisez un projet associé à un ID de projet que vous avez envoyé après avoir obtenu l'accès à Gemini Cloud Assist.
Cliquez sur sparkOuvrir ou fermer le chat Gemini AI.
Le panneau Gemini s'ouvre.
Si nécessaire, cliquez sur Accepter si vous acceptez les conditions.
Si vous avez une question sur une application spécifique, fournissez du contexte en accédant à la page qui affiche votre ressource avant de poser votre question. Lorsqu'il génère une réponse, Gemini inclut des informations sur la page et le projet de la console en cours.
Saisissez une requête dans le panneau Gemini.
Le tableau suivant fournit quelques exemples de requêtes pour utiliser Gemini Cloud Assist avec Cloud Run.
Requête
Type de réponse
"Je souhaite concevoir une application Node.js sur Cloud Run. Quelle est l'approche recommandée et que dois-je savoir ?"
Résumé de la conteneurisation de votre application, de la structuration de votre application Node.js et du processus de déploiement.
"De quelle autorisation ai-je besoin pour déployer une application Cloud Run ?"
Liste des autorisations et rôles requis.
"Je veux déployer une application Web à trois niveaux à l'aide de Cloud Run"
Présentation générale des étapes de conception d'une application Web à trois niveaux.
"Comment migrer mon application App Engine vers Cloud Run ?"
Aperçu général des principales étapes de préparation de votre environnement de développement Cloud Run, et de certaines différences clés entre les deux produits. Liens vers un exemple de tutoriel qui peut être utilisé pour personnaliser la solution en fonction de vos besoins spécifiques.
"Quelle est la commande gcloud CLI permettant de définir le paramètre d'instance minimale sur 2 pour mon service Cloud Run 'example-service' ?"
Commande gcloud CLI suggérée pour mettre à jour le paramètre du nombre minimal d'instances.
"Comment mettre à jour mon compte de service pour mon service Cloud Run hello-world"
Commande gcloud CLI suggérée pour mettre à jour le compte de service.
"Montre-moi un exemple de création d'une application d'IA générative sur Cloud Run avec LangChain"
Étapes à suivre pour créer un exemple d'application à l'aide de Cloud Run avec LangChain.
"Génère une configuration Terraform à l'aide de la ressource google_cloud_run_v2_service pour un service Cloud Run qui définit le paramètre de facturation sur la facturation basée sur les instances"
Configuration Terraform suggérée pour mettre à jour le paramètre de facturation.
Pour en savoir plus, consultez les ressources suivantes :
Pour connaître les bonnes pratiques de conception, de mise en œuvre, de test et de déploiement d'un service Cloud Run, consultez les Conseils de développement.
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)."],[],[],null,["# Developing your service\n\nThis page describes a few things you need to know to get started in developing\na service for Cloud Run.\n\nCode requirements\n-----------------\n\nYou must meet the following requirements when you develop a service:\n\n- The service must listen for requests. You can [configure the port](/run/docs/configuring/services/containers#configure-port) on which requests are sent. Inside Cloud Run instances, the value of the `PORT` environment variable always reflects the port to which requests are sent. Your code should check for the existence of this `PORT` environment variable and if it is present, should listen on it to maximize portability.\n- The service must be *stateless* . It cannot rely on a persistent **local** state.\n- If the service performs background activities outside the scope of request handling it must use the [instance-based billing](/run/docs/configuring/billing-settings#choosing-background-execution) setting in order to have CPU allocated outside of the standard request cycle.\n- If your service uses NFS, it must use the [second generation execution environment](/run/docs/about-execution-environments).\n\nYou can find more details about these constraints in the [Container runtime contract](/run/docs/reference/container-contract).\n\nProgramming language support\n----------------------------\n\nCloud Run source deployment conveniently supports multiple\n[language runtimes](/run/docs/configuring/services/runtime-base-images), each of\nwhich is available through container base images provided by\nGoogle Cloud's buildpacks. You can also use other programming languages or\nframeworks, as long as the source code is in an OCI-compliant image.\n\nThe [build and deploy quickstarts](/run/docs/quickstarts#build-and-deploy-a-web-service)\nprovides samples in many popular languages.\n\nUsing a web server\n------------------\n\nYou can use a web server to listen on the required port, and to process and\nroute incoming requests. For example, Node.js developers can use\n[Express.js](https://expressjs.com/), Python developers can use\n[Flask](http://flask.pocoo.org/), Ruby developers can use\n[Sinatra](http://sinatrarb.com/), and so forth.\n\nContainerizing your code\n------------------------\n\nSee [Containerize your code](/run/docs/building/containerize-your-code) for\ndetails.\n\nDesign Cloud Run apps with Gemini assistance\n--------------------------------------------\n\n\u003cbr /\u003e\n\n|\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nYou can get AI-powered help from\n[Gemini Cloud Assist](/gemini/docs/cloud-assist/overview) chat to\ndesign applications optimally. With Gemini Cloud Assist, you can\ndiscover the most suitable configurations and strategies for deploying your\napplications on Cloud Run, ensuring efficient resource\nutilization and seamless operation.\n\nTo use Gemini Cloud Assist from the Google Cloud console, do\nthe following:\n\n1. [Ensure that Gemini Cloud Assist is set up for your Google Cloud user account and project](/gemini/docs/cloud-assist/set-up-gemini).\n\n2. [Set up your Cloud Run development environment](/run/docs/setup)\n in your Google Cloud project and ensure you have the appropriate\n [deployment permissions](/run/docs/reference/iam/roles#additional-configuration).\n\n3. Go to the Cloud Run page in the Google Cloud console.\n\n [Go to Cloud Run](https://console.cloud.google.com/run)\n4. In the console toolbar, select a Google Cloud project. Use a project\n associated with a project ID you submitted after you were granted access to\n Gemini Cloud Assist.\n\n5. Click spark\n **Open or close Gemini AI chat**.\n\n The Gemini panel opens.\n6. If necessary, click **Accept** if you agree to the terms.\n\n7. If you have a question about a specific application, provide context by\n going to the page that shows your resource before asking your question. When\n generating a response, Gemini includes information about the\n current console page and project.\n\n8. Enter a prompt in the **Gemini** panel.\n\n The following table provide some example prompts for using\n Gemini Cloud Assist with Cloud Run.\n\nFor more details, see the following resources:\n\n- Learn how to [write better prompts](/gemini/docs/discover/write-prompts).\n- Learn how to use the [Gemini Cloud Assist panel](/gemini/docs/cloud-assist-panel).\n- Read [Use Gemini for AI assistance and development](/gemini/docs/overview).\n- Learn [how Gemini for Google Cloud uses your data](/gemini/docs/discover/data-governance).\n\nWhat's next\n-----------\n\n- Once you have your service code and Dockerfile, you should [build a container image](/run/docs/building/containers) then continue iterating in [local testing](/run/docs/testing/local).\n- If you are migrating an existing web application, see [Migrating Your Service to Cloud Run](/run/docs/migrating).\n- For best practices for designing, implementing, testing, and deploying a Cloud Run service, see the [Development tips](/run/docs/tips)."]]
