En esta página, se proporciona una descripción general de las opciones de configuración para los servicios de Cloud Run. Estas configuraciones se enumeran en el orden en que aparecen en la consola deGoogle Cloud cuando implementas un servicio nuevo.
Después de especificar la opción de implementación, el nombre del servicio y la región, verás la siguiente configuración que se describe en esta página. Algunos parámetros de configuración requieren permisos adicionales o la habilitación de APIs, y algunos parámetros de configuración adicionales aparecerán en la interfaz web si seleccionas GitHub o Functions como opción de implementación.
Configura los parámetros a nivel del servicio
Configura los parámetros a nivel del servicio, como la autenticación, la facturación, el escalamiento del servicio y la entrada.
En la siguiente tabla, se explican las funciones de esta sección:
| Sección | Función | Descripción |
|---|---|---|
| A | Autenticación | Todos los servicios de Cloud Run se implementan de forma privada de forma predeterminada, lo que significa que no se puede acceder a ellos sin proporcionar credenciales de autenticación en la solicitud. En su lugar, puedes permitir el acceso público (sin autenticación). |
| B | Facturación | Usa la configuración de facturación para controlar cómo se te cobra, ya sea por solicitud y solo cuando la instancia procesa una solicitud, o por todo el ciclo de vida de la instancia. |
| C | Escalamiento de servicios | Puedes configurar tu servicio para que se ajuste de escala de forma automática o manual, según el nivel de control que necesites sobre su comportamiento de escalamiento. Cuando se usa el escalamiento automático, cada revisión de Cloud Run se escala automáticamente a la cantidad de instancias necesarias para controlar todas las solicitudes entrantes, los eventos o la utilización de CPU. Puedes controlar cuántas instancias crea tu servicio de Cloud Run para atender solicitudes configurando instancias máximas y instancias mínimas. Puedes evitar los inicios en frío para tu aplicación y reducir la latencia de esta configurando una cantidad mínima de instancias. Establecer una cantidad máxima de instancias puede ayudar a reducir los costos y protegerte contra los niveles de solicitud más altos de lo normal. El ajuste de escala manual te permite establecer un recuento de instancias específico, independientemente del tráfico o la utilización, y sin necesidad de volver a implementar. De forma predeterminada, Cloud Run se escala horizontalmente de forma automática hasta una cantidad máxima de instancias especificada o predeterminada. Sin embargo, para algunos casos de uso, es posible que desees establecer una cantidad específica de instancias. |
| D | Entrada | Usa la configuración de entrada para restringir el acceso de red a tu servicio de Cloud Run. |
Contenedor
Puedes configurar el contenedor especificando el puerto, la configuración, las variables y los secretos del contenedor, y las activaciones de volúmenes.
| Sección | Función | Descripción |
|---|---|---|
| A | Puerto de contenedor | Especifica el puerto al que deseas que se envíen las solicitudes. El valor predeterminado es 8080. En los servicios de Cloud Run, Cloud Run inserta la variable de entorno PORT en el contenedor. Si implementas varios contenedores en un servicio, este es el contenedor de entrada. Consulta Configura el puerto del contenedor para un servicio. |
| B | Configuraciones de contenedores | Puedes configurar aún más tu contenedor en las pestañas Settings, Variables & Secrets y Volumes. Estas funciones se explican en las siguientes secciones. |
Configuración
Personaliza tu servicio configurando el contenedor, la capacidad, la GPU y las verificaciones de estado.
En la siguiente tabla, se explican las funciones de esta sección:
| Sección | Función | Descripción |
|---|---|---|
| A | Contenedores | Configura el punto de entrada y los argumentos para los servicios si deseas anular los valores predeterminados de la imagen. |
| B | Capacidad | Puedes controlar la cantidad de memoria y CPU que puede usar un servicio. |
| C | GPU | Si necesitas alojar cargas de trabajo de IA, como modelos de inferencia y entrenamiento de modelos, puedes configurar servicios de Cloud Run con GPUs. |
| D | Verificaciones de estado | Cloud Run te permite configurar tres tipos de sondeos de verificación de estado. El sondeo de inicio determina cuándo el contenedor está listo para aceptar tráfico, el sondeo de funcionamiento determina si se debe reiniciar el contenedor y el sondeo de preparación (versión preliminar) determina cuándo una instancia de tu servicio de Cloud Run debe entregar tráfico. Obtén más información sobre las verificaciones de estado de los contenedores. |
También puedes configurar tiempos de espera, la simultaneidad máxima, el entorno de ejecución, el ajuste de escala de la revisión, el aumento de CPU durante el inicio o conectarte a una instancia de Cloud SQL.
En la siguiente tabla, se explican las funciones de esta sección:
| Sección | Función | Descripción |
|---|---|---|
| A | Tiempos de espera | Puedes establecer un tiempo de espera de la solicitud de Cloud Run que especifique el tiempo en el que se debe devolver una respuesta. |
| B | Simultaneidad máxima | Puedes configurar la cantidad máxima de solicitudes simultáneas por instancia para especificar la cantidad máxima de solicitudes que una instancia determinada puede procesar simultáneamente. Puedes aumentarlo hasta un máximo de 1,000. |
| C | Entorno de ejecución | Cloud Run tiene dos entornos de ejecución. Obtén información sobre las diferencias entre ambos entornos de ejecución y cómo elegir cuál usar. |
| D | Escalamiento de revisión | Cualquier cambio en la configuración conlleva la creación de una revisión nueva. De forma predeterminada, las revisiones de Cloud Run están configuradas para escalar verticalmente hasta un máximo de 100 instancias. Si necesitas cambiar la cantidad predeterminada de instancias de contenedor que se mantienen en espera, listas para recibir solicitudes, puedes establecer instancias máximas y instancias mínimas a nivel de la revisión. |
| E | Aumento de CPU de inicio | El aumento de la CPU de inicio para las revisiones proporciona CPU adicional durante el tiempo de inicio de la instancia y durante 10 segundos después de que se haya iniciado la instancia. |
| F | Conexiones de Cloud SQL | Conéctate a una instancia de Cloud SQL desde un servicio que se ejecuta en Cloud Run. |
Variables y Secrets
Configura variables de entorno y secretos para administrar tu servicio de forma segura.
En la siguiente tabla, se explican las funciones de esta sección:
| Sección | Función | Descripción |
|---|---|---|
| A | Variables de entorno | Puedes crear pares clave-valor para usar con tu servicio de Cloud Run. Consulta Cómo configurar variables de entorno para los servicios para obtener más información. |
| B | Secrets | Puedes usar Secret Manager con Cloud Run para almacenar de manera segura claves de API, contraseñas y otra información sensible. Consulta Configura secretos para obtener más información. |
Activaciones de volúmenes
Configura activaciones de volúmenes para tu servicio.
Los activadores de volúmenes de Cloud Run te permiten acceder a los datos compartidos almacenados en un sistema de archivos local, como el contenido de un bucket de almacenamiento o un servidor de archivos, desde tu contenedor. Puedes activar un bucket de Cloud Storage, un recurso compartido de NFS, como una instancia de Filestore, un sistema de archivos en memoria proporcionado por Cloud Run o un sistema de archivos de red CIFS/SMB.
Redes
Conéctate a otros servicios con HTTP/2, división del tráfico, una red de VPC o una malla de servicios. Google Cloud
En la siguiente tabla, se explican las funciones de esta sección:
| Sección | Función | Descripción |
|---|---|---|
| A | Usa HTTP/2 para los servicios | Configura tu servicio para usar HTTP/2 de extremo a extremo, lo que evita que Cloud Run cambie las solicitudes a HTTP/1. |
| B | Afinidad de sesión | Cada vez que implementas o vuelves a implementar un servicio, se crea automáticamente una revisión nueva del servicio subyacente de Cloud Run. Consulta Afinidad de sesión y división del tráfico para obtener más detalles. |
| C | Conectarse a una VPC | Habilita tu servicio de Cloud Run para enviar tráfico a una red de VPC a través de la salida de VPC directa. Consulta las opciones de VPC. |
| D | Malla de servicios | Cloud Service Mesh te permite habilitar las funciones avanzadas de administración del tráfico de la malla, como la división de tráfico ponderada y el balanceo de cargas global, así como las políticas de observabilidad y seguridad para el tráfico de un servicio de Cloud Run a otro. |
Seguridad
Configura la cuenta de servicio, la Autorización binaria o las claves de encriptación para tu servicio.
En la siguiente tabla, se explican las funciones de esta sección:
| Sección | Función | Descripción |
|---|---|---|
| A | Cuenta de servicio | La identidad del servicio de Cloud Run es la cuenta de servicio que se usa como la cuenta autenticada para acceder a las APIs de Google Cloud desde el contenedor de instancias de Cloud Run. Te recomendamos que crees una cuenta de servicio y determines el conjunto de permisos más mínimo que necesita la cuenta de servicio para acceder a recursos Google Cloud específicos. |
| B | Autorización binaria | La Autorización binaria es un control de seguridad de tiempo de implementación que garantiza que solo se implementen imágenes de contenedor confiables en tus recursos de Cloud Run. |
| C | Encriptación | Si quieres controlar tus claves de encriptación, puedes usar claves de encriptación administradas por el cliente. |
Posterior a la implementación
Después de que se implemente correctamente tu servicio, puedes seguir configurando parámetros adicionales.
Etiquetas
Las etiquetas de Cloud Run son pares clave-valor que puedes aplicar a los servicios, las revisiones y las funciones de Cloud Run. Las etiquetas te ayudan a organizar tus recursos de Cloud Run y a administrar los costos a gran escala con el nivel de detalle que necesitas.
Las etiquetas que configuraste anteriormente para tus funciones de Cloud Run con los comandos gcloud functions o la API de Cloud Functions v2 se propagan a Cloud Run cuando implementas tus funciones en Cloud Run.
Recomendaciones
Consulta Optimiza con el Recomendador para conocer las optimizaciones que proporciona el Recomendador en Cloud Run.
Etiqueta servicios
Las etiquetas son pares clave-valor que puedes aplicar a tus recursos para obtener un control de acceso detallado con la consola de Cloud Run.
Los administradores de etiquetas crean etiquetas para los recursos en Google Cloud a nivel de la organización o del proyecto. Las etiquetas proporcionan una forma de permitir o rechazar políticas de manera condicional en función de si un recurso tiene una etiqueta específica. Para obtener más información, consulta Servicios de etiquetado.