Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
En esta página se describen algunos aspectos que debes tener en cuenta para empezar a desarrollar un servicio para Cloud Run.
Requisitos del código
Debe cumplir los siguientes requisitos al desarrollar un servicio:
El servicio debe escuchar las solicitudes.
Puedes configurar el puerto
en el que se envían las solicitudes.
En las instancias de Cloud Run, el valor de la variable de entorno PORT
siempre refleja el puerto al que se envían las solicitudes.
Tu código debe comprobar si existe esta variable de entorno PORT y, si está presente, debe usarla para maximizar la portabilidad.
El servicio debe ser sin estado. No puede depender de un estado local persistente.
Si el servicio realiza actividades en segundo plano fuera del ámbito de la gestión de solicitudes, debe usar la opción de facturación basada en instancias para que se le asigne CPU fuera del ciclo de solicitud estándar.
El despliegue de código fuente de Cloud Run admite varios runtimes de lenguaje, cada uno de los cuales está disponible a través de imágenes base de contenedor proporcionadas por los buildpacks de Google Cloud. También puedes usar otros lenguajes de programación o frameworks, siempre que el código fuente esté en una imagen compatible con OCI.
Puedes usar un servidor web para escuchar en el puerto necesario y para procesar y enrutar las solicitudes entrantes. Por ejemplo, los desarrolladores de Node.js pueden usar Express.js, los de Python pueden usar Flask y los de Ruby pueden usar Sinatra, entre otros.
Diseñar aplicaciones de Cloud Run con la ayuda de Gemini
Puedes obtener ayuda basada en IA de la conversación de Gemini Cloud Assist para diseñar aplicaciones de forma óptima. Con Gemini Cloud Assist, puedes descubrir las configuraciones y estrategias más adecuadas para desplegar tus aplicaciones en Cloud Run, lo que te permite aprovechar los recursos de forma eficiente y disfrutar de un funcionamiento fluido.
Para usar Gemini Cloud Assist desde la Google Cloud consola, haz lo siguiente:
En la barra de herramientas de la consola, selecciona un Google Cloud proyecto. Usa un proyecto asociado a un ID de proyecto que hayas enviado después de que se te concediera acceso a Gemini Cloud Assist.
Haz clic en spark.
Abrir o cerrar el chat de IA de Gemini
Se abre el panel de Gemini.
Si es necesario, haz clic en Aceptar si estás de acuerdo con los términos.
Si tienes alguna pregunta sobre una aplicación específica, proporciona contexto. Para ello, ve a la página que muestra tu recurso antes de hacer la pregunta. Cuando genera una respuesta, Gemini incluye información sobre la página de la consola y el proyecto actuales.
Escribe una petición en el panel Gemini.
En la siguiente tabla se muestran algunas peticiones de ejemplo para usar Gemini Cloud Assist con Cloud Run.
Petición
Tipo de respuesta
"Quiero diseñar una aplicación de Node.js en Cloud Run. ¿Cuál es el enfoque recomendado y qué debo saber?"
Resumen de cómo crear un contenedor para tu aplicación, estructurar tu aplicación Node.js y el proceso de implementación.
"¿Qué permiso necesito para desplegar una aplicación de Cloud Run?"
Lista de permisos y roles necesarios.
"Quiero desplegar una aplicación web de tres niveles con Cloud Run"
Descripción general de los pasos para diseñar una aplicación web de tres niveles.
"¿Cómo puedo migrar mi aplicación de App Engine a Cloud Run?"
Resumen general de los pasos clave para preparar tu entorno de desarrollo de Cloud Run y algunas diferencias importantes entre ambos productos. Enlaces a un tutorial de ejemplo que se puede usar para personalizar la solución y adaptarla a tus necesidades específicas.
"¿Cuál es el comando de la CLI de gcloud para actualizar el ajuste de instancias mínimas a 2 en mi servicio de Cloud Run 'example-service'?"
Comando de gcloud CLI sugerido para actualizar el ajuste de instancias mínimas.
"¿Cómo actualizo la cuenta de servicio de mi servicio de Cloud Run? hello-world"
Comando de la CLI de gcloud sugerido para actualizar la cuenta de servicio.
"Muéstrame un ejemplo de cómo crear una aplicación de IA generativa en Cloud Run con LangChain"
Pasos para crear una aplicación de ejemplo con Cloud Run y LangChain.
"Genera una configuración de Terraform con el recurso google_cloud_run_v2_service para un servicio de Cloud Run que defina la facturación por instancia"
Configuración de Terraform sugerida para actualizar el ajuste de facturación.
Para obtener más información, consulta los siguientes recursos:
Para consultar las prácticas recomendadas a la hora de diseñar, implementar, probar e implementar un servicio de Cloud Run, consulta los consejos de desarrollo.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-21 (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)."]]
