En esta página, se describen algunas consideraciones que debes tener en cuenta para comenzar a desarrollar un servicio de Cloud Run.
Requisitos de código
Debes cumplir con los siguientes requisitos cuando desarrolles un servicio:
- El servicio debe detectar las solicitudes.
Puedes configurar el puerto al que se envían las solicitudes.
Dentro de 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 la existencia de esta variable de entornoPORT
y, si está presente, escuchar en ella para maximizar la portabilidad. - Debe ser un servicio sin estado. No puede depender de un estado local persistente.
- Si el servicio realiza actividades en segundo plano fuera del alcance del control de solicitudes, debe usar la configuración de facturación basada en instancias para tener la CPU asignada fuera del ciclo de solicitud estándar.
- Si tu servicio usa un sistema de archivos de red, debe usar el entorno de ejecución de segunda generación.
Puedes encontrar más información sobre estas restricciones en Contrato del entorno de ejecución de contenedores.
Compatibilidad con lenguajes de programación
La implementación de fuentes de Cloud Run admite de forma conveniente varios entorno de ejecución de lenguajes, cada uno de los cuales está disponible a través de imágenes base de contenedores proporcionadas por los paquetes de compilación de Google Cloud. También puedes usar otros lenguajes de programación o marcos de trabajo, siempre y cuando el código fuente esté en una imagen que cumpla con OCI.
Las guías de inicio rápido de compilación y de implementación proporcionan muestras en muchos lenguajes populares.
Usa un servidor web
Puedes usar un servidor web para escuchar en el puerto requerido, y procesar y enrutar las solicitudes entrantes. Por ejemplo, los desarrolladores de Node.js pueden usar Express.js, los de Python pueden usar Flask, los de Ruby pueden usar Sinatra, etcétera.
Crea contenedores en tu código
Consulta Crea contenedores en tu código para obtener más detalles.
Diseña apps de Cloud Run con la asistencia de Gemini
Puedes obtener ayuda potenciada por IA del chat de Gemini Cloud Assist para diseñar aplicaciones de manera óptima. Con Gemini Cloud Assist, puedes descubrir las configuraciones y estrategias más adecuadas para implementar tus aplicaciones en Cloud Run, lo que garantiza una utilización eficiente de los recursos y una operación sin problemas.
Para usar Gemini Cloud Assist desde la consola de Google Cloud, haz lo siguiente:
- Asegúrate de que Gemini Cloud Assist esté configurado para tu Google Cloud cuenta de usuario y proyecto.
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 de Cloud Run en la consola de Google Cloud.
En la barra de herramientas de la consola, selecciona un proyecto Google Cloud . Usa un proyecto asociado con un ID de proyecto que hayas enviado después de que se te otorgó acceso a Gemini Cloud Assist.
Haz clic en spark Abrir o cerrar chat de IA de Gemini.
Se abrirá el panel de Gemini.
Si es necesario, haz clic en Aceptar si estás de acuerdo con las condiciones.
Si tienes una pregunta sobre una aplicación específica, ve a la página que muestra tu recurso antes de formularla para proporcionar contexto. Cuando se genera una respuesta, Gemini incluye información sobre la página y el proyecto de la consola actuales.
Ingresa una instrucción en el panel de Gemini.
En la siguiente tabla, se proporcionan algunas instrucciones de ejemplo para usar Gemini Cloud Assist con Cloud Run.
Instrucción Tipo de respuesta "Quiero diseñar una app de Node.js en Cloud Run. ¿Cuál es el enfoque recomendado y qué debo saber?" Resumen de la creación de contenedores para tu app, la estructuración de tu app de Node.js y el proceso de implementación. "¿Qué permiso necesito para implementar una app de Cloud Run?" Es la lista de permisos y roles obligatorios. "Quiero implementar una aplicación web de tres niveles con Cloud Run" Descripción general de los pasos para diseñar una app web de tres niveles. "¿Cómo migro mi app de App Engine a Cloud Run?" Descripción general de alto nivel de los pasos clave para preparar tu entorno de desarrollo de Cloud Run y algunas diferencias clave entre ambos productos. Vínculos a un instructivo de ejemplo que se puede usar para personalizar la solución y satisfacer tus necesidades específicas. "¿Cuál es el comando de gcloud CLI para actualizar el parámetro de configuración de instancia mínima a 2 para mi servicio de Cloud Run "example-service"?" Comando sugerido de gcloud CLI para actualizar la configuración de instancias mínimas. "¿Cómo actualizo mi cuenta de servicio para mi servicio de Cloud Run hello-world
?"Comando sugerido de la CLI de gcloud para actualizar la cuenta de servicio. "Muéstrame un ejemplo de cómo compilar una app de IA generativa en Cloud Run con LangChain" Pasos para crear una app 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 establezca la configuración de facturación en la facturación basada en instancias"Configuración sugerida de Terraform para actualizar la configuración de facturación
Obtén más información en los vínculos siguientes:
- Obtén más información para escribir mejores instrucciones.
- Obtén información para usar el panel de Gemini Cloud Assist.
- Lee Usa Gemini para obtener asistencia y desarrollo con IA.
- Descubre cómo Gemini para Google Cloud usa tus datos.
¿Qué sigue?
- Una vez que tengas el Dockerfile y el código del servicio, debes compilar una imagen de contenedor y, luego, seguir iterando en las pruebas locales.
- Si estás migrando una aplicación web existente, consulta Migra el servicio a Cloud Run.
- Si deseas obtener prácticas recomendadas para diseñar, implementar y probar un servicio de Cloud Run, consulta las Sugerencias de desarrollo.