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 entornoPORT
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.
- Si tu servicio usa NFS, debe usar el entorno de ejecución de segunda generación.
Puedes consultar más detalles sobre estas restricciones en el contrato de tiempo de ejecución de contenedores.
Compatibilidad con lenguajes de programación
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.
En las guías de inicio rápido de compilación y despliegue, se ofrecen ejemplos en muchos lenguajes populares.
Usar un servidor web
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.
Insertar el código en contenedores
Consulta Inserta el código en contenedores para obtener más información.
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:
Configura tu entorno de desarrollo de Cloud Run en tu Google Cloud proyecto y asegúrate de tener los permisos de implementación adecuados.
Ve a la página Cloud Run de la Google Cloud consola.
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 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:
- Consulta cómo escribir mejores peticiones.
- Consulta cómo usar el panel de Gemini Cloud Assist.
- Consulta el artículo Usar Gemini para obtener asistencia y desarrollar con IA.
- Consulta cómo usa Gemini para Google Cloud tus datos.
Siguientes pasos
- Una vez que tengas el código de servicio y el Dockerfile, debes compilar una imagen de contenedor y, a continuación, seguir iterando en pruebas locales.
- Si vas a migrar una aplicación web, consulta el artículo Migrar un servicio a Cloud Run.
- 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.