En esta página, se muestra cómo usar NGINX como proxy de frontend para el contenedor de tu aplicación. Esto es útil si deseas procesar solicitudes o respuestas. Puedes agregar compresión gzip o traducir HTTP/2 a HTTP/1 si los contenedores de tu aplicación solo admiten HTTP/1 y necesitas usar HTTP/2 de extremo a extremo por razones de rendimiento.
En el ejemplo proporcionado en esta página, un contenedor Nginx se ejecuta en cada instancia de Cloud Run como el contenedor de entrega principal y está configurado para reenviar solicitudes al contenedor de la aplicación, que se ejecuta. como un contenedor de sidecar, como se muestra en este diagrama:
La forma más eficaz de realizar un proxy de frontend en Cloud Run es implementar el contenedor del servidor proxy del servidor Nginx y el contenedor de la app web como un único servicio de Cloud Run:
Este único servicio de Cloud Run acepta solicitudes y las entrega al contenedor de entrada (entrega), que en este caso es el servidor proxy. Luego, el servidor proxy envía solicitudes a la app web a través de la interfaz de red localhost
, lo que evita cualquier red externa.
La implementación como un solo servicio de Cloud Run reduce las latencias, la sobrecarga de administración de servicios y elimina la exposición a las redes externas. Cloud Run no interactúa directamente con los contenedores de sidecar, excepto cuando se inician o se detienen cada vez que se inicia o se detiene el servicio.
El contenedor de la app web y cualquier contenedor de sidecar pueden escribirse en diferentes lenguajes de programación. Para ver una muestra escrita en PHP, consulta la muestra de nginx de PHP en GitHub.
Antes de comenzar
- Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Enable the Cloud Run and Secret Manager APIs.
- Instala e inicializa la CLI de gcloud
- Actualiza Google Cloud CLI:
gcloud components update
- Configura Google Cloud CLI:
gcloud init
- Realiza la autenticación con Google Cloud CLI:
gcloud auth login
Permisos necesarios para realizar una implementación
Debes tener UNA de las siguientes funciones:
- Los roles de administrador de Cloud Run y usuario de cuenta de servicio
- Cualquier rol personalizado que incluya esta lista específica de permisos
Descripción general de la configuración
En estas instrucciones, se usan imágenes de contenedor compiladas previamente, por lo que lo único que se requiere para el proxy de frontend es configurar los contenedores y el servicio en sí.
Configura el contenedor de entrada de Nginx
La imagen de contenedor está nginx
disponible en Docker Hub.
Por lo general, está listo para usarse tal como está, excepto que debe configurarse para ejecutarse como un servicio de proxy y entregar las solicitudes de proxy al puerto en el que escucha el contenedor de sidecar en localhost
. En el ejemplo de esta página, también se habilita la compresión gzip para solicitudes y respuestas.
La configuración se proporciona con un archivo de texto activado en /etc/nginx/conf.d/nginx.conf
. Debido a que no puedes editar archivos directamente en el contenedor, debes activar un volumen en /etc/nginx/conf.d/
que contenga el archivo de configuración. Una forma de activar un archivo en una ubicación específica en un contenedor que se ejecuta en Cloud Run es almacenar el contenido del archivo en un Secret de Secret Manager y activar ese Secret en la ubicación de volumen deseada, que se carga en el entorno de ejecución.
Copia lo siguiente en un archivo llamado nginx.conf
en el directorio actual de tu máquina local.
En la configuración, haz lo siguiente:
- Asigna
nginx
para escuchar en el mismo puerto predeterminado de Cloud Run8080
, ubicado enlocalhost
. - Aplica la compresión gzip para mejorar el rendimiento.
- Indica a
proxy_pass
que entregue las solicitudes de este contenedor de entrada al contenedor de sidecar de la app web en el puerto localhost8888
.
Crea un Secret con el contenido del archivo nginx.conf
.
Console
Ve a la página de Secret Manager en la consola de Google Cloud:
Haz clic en Crear Secreto.
En el campo del formulario
name
, ingresa nginx_config.Sube el archivo
nginx.conf
ubicado enmulti-container/hello-nginx-sample/nginx.conf
como el valor del Secret.Mantén los valores predeterminados (
Google-managed encryption key, etc
).Haz clic en Crear secreto.
Otorga a la cuenta de servicio de procesamiento del proyecto acceso a este nuevo Secret. Para hacerlo, ve a la página de IAM en la consola de Google Cloud:
Localiza la cuenta de servicio principal con el nombre:
Compute Engine default service account
y haz clic en Editar principal.Haz clic en Agregar otro rol y selecciona Descriptor de acceso a secretos de Secret Manager.
Haz clic en Guardar.
gcloud
En una terminal, usa el siguiente comando para crear un nuevo Secret
nginx_config
en Secret Manager:gcloud secrets create nginx_config --replication-policy='automatic' --data-file='./nginx.conf'
Otorga a la cuenta de servicio de procesamiento del proyecto acceso a este nuevo Secret mediante el comando
export PROJECT_NUMBER=$(gcloud projects describe $(gcloud config get-value project) --format='value(projectNumber)') gcloud secrets add-iam-policy-binding nginx_config --member=serviceAccount:$PROJECT_NUMBER-compute@developer.gserviceaccount.com --role='roles/secretmanager.secretAccessor'
Ejecuta
gcloud secrets list
para verificar que se creó el Secret.
Acerca de la imagen de muestra del sidecar de la app web
En estas instrucciones, se usa la imagen de contenedor de muestra en us-docker.pkg.dev/cloudrun/container/hello
. Debes especificar el número de puerto en el que el contenedor escuchará y localhost
como el host, como se describe en Especifica la configuración del contenedor de sidecar, como se describe en las siguientes secciones.
Configura el servicio de varios contenedores
Puedes usar la consola de Google Cloud o el archivo YAML de Cloud Run para configurar un servicio de Cloud Run con más de un contenedor.
En la configuración del servicio, especifica el servidor proxy Nginx como contenedor de entrada (entrega), el puerto que escuchará, si acepta solicitudes HTTP 1 o HTTP 2 y el orden de inicio del contenedor. El contenedor de entrada (servidor proxy) depende del sidecar de la app web, por lo que primero se debe iniciar el sidecar de la app web.
Estas configuraciones se muestran en las siguientes secciones.
Agrega metadatos YAML
Console
Navega a Implementa el servicio para obtener instrucciones completas de la consola.
YAML
Si creas un servicio nuevo, omite este paso. Si actualizas un servicio existente, descarga su configuración de YAML:
gcloud run services describe SERVICE --format export > service.yaml
En
service.yaml
, agrega lo siguiente:
La sección describe la revisión del servicio, que incluye propiedades que pueden variar de una revisión a otra.
Especifica el orden de inicio del contenedor
Console
Navega a Implementa el servicio para obtener instrucciones completas de la consola.
YAML
En service.yaml
, agrega lo siguiente:
Ten en cuenta la anotación container-dependencies
que le indica a Cloud Run que espere a que el contenedor hello se inicie antes de iniciar el contenedor nginx. De lo contrario, si el contenedor nginx se inicia primero, podría intentar enviar una solicitud web mediante un proxy al contenedor de app web que no está listo, lo que generaría respuestas de error web.
De forma opcional, cada contenedor puede tener una propiedad de nombre definida para él, que se puede usar para hacer referencia a él en otras directivas.
El contenedor de entrega ejecuta el servidor proxy, llamado nginx
. Este es el contenedor al que Cloud Run entrega las solicitudes entrantes, por lo que debes especificar la versión de HTTP
y el puerto del contenedor para entregarlas.
Especifica la configuración del contenedor de entrega
Console
Navega a Implementa el servicio para obtener instrucciones completas de la consola.
YAML
En el archivo service.yaml
, agrega lo siguiente:
El servidor nginx
requiere un archivo de configuración en el directorio /etc/nginx/conf.d/
. Para ello, activa un volumen que contenga el archivo en esa ubicación. En la sección volumeMount
, se especifica un volumen llamado configuration
para que se coloque allí. El volumen se define en su propia sección más adelante en el archivo.
Especifica la configuración del contenedor del sidecar
Console
Navega a Implementa el servicio para obtener instrucciones completas de la consola.
YAML
En service.yaml
, agrega lo siguiente:
La aplicación hello
también necesita información de configuración. Detecta las solicitudes entrantes en el puerto que se especifica en la variable de entorno PORT
. Ese nombre y valor se especifican en la sección env
.
Especifica el volumen del secreto
Console
Navega a Implementa el servicio para obtener instrucciones completas de la consola.
YAML
En el archivo service.yaml
, agrega lo siguiente:
Especifica la configuración volume
activada en la sección volumeMount
. Contiene un solo archivo llamado nginx.conf
cuyo contenido se define como el valor del Secret llamado nginx-conf-secret
.
Implemente el servicio
Console
Ve a la página de Cloud Run en la consola de Google Cloud.
Haz clic en Crear servicio.
- Selecciona Implementar una revisión desde una imagen de contenedor existente y luego, ingresa
nginx
como URL de imagen de contenedor. - En el campo Nombre del servicio, ingresa un nombre para tu servicio, por ejemplo,
hello-mc
. - En la lista Región, selecciona una ubicación en la que deseas realizar la implementación, por ejemplo,
us-west1
. - En Autenticación, selecciona
Allow unauthenticated invocations
.
- Selecciona Implementar una revisión desde una imagen de contenedor existente y luego, ingresa
Haz clic en Contenedores, volúmenes, herramientas de redes y seguridad para expandir el formulario de configuración.
- Haz clic en la pestaña Volúmenes.
- Haz clic en Agregar volumen.
- En la lista Tipo de volumen, selecciona Secreto.
- En el campo Nombre del volumen, ingresa
nginx-conf-secret
. - En el campo Secret, ingresa nginx_config.
- En Rutas especificadas para las versiones de Secret, especifica default.conf como la ruta y latest como la versión.
- Haz clic en Crear para crear el volumen del secreto.
Haz clic en la pestaña Contenedores para mostrar el formulario Editar contenedor.
- Haz clic en Configuración, luego en Recursos, cambia la memoria a 256MiB y CPU a 1 CPU.
- Haz clic en Activaciones de volúmenes.
- Haz clic en Volumen de activación.
- Selecciona nginx-conf-secret de la lista de nombres.
- En Ruta de activación, ingresa etc/nginx/conf.d.
- Haz clic en Listo para completar la configuración del primer contenedor.
Haz clic en Agregar contenedor para agregar el contenedor de sidecar y mostrar el formulario Contenedor nuevo.
- Selecciona la URL de imagen de contenedor predeterminada us-docker.pkg.dev/cloudrun/container/hello
- Haz clic en la pestaña Configuración, luego en Recursos, cambia la memoria a 256MiB y CPU a 1 CPU.
- Haz clic en Variables y secretos.
- Haz clic en Agregar variable.
- Ingresa PORT como el nombre de la variable de entorno nueva y PORT como el valor.
- Haz clic en Listo.
Navega al formulario Editar contenedor del primer contenedor (
nginx
).- Haz clic en la pestaña Configuración.
- En Orden de inicio del contenedor, selecciona
nginx
de la lista Depends on. Esto significa que el contenedornginx
se inicia sólo después de que se inicia correctamente el contenedorhello
. - Haz clic en Crear y espera a que se implemente el servicio.
gcloud
Para implementar el contenedor del servidor proxy y el contenedor de la app web como un solo servicio, haz lo siguiente:
gcloud run services replace service.yaml
Verifica el servicio implementado
gcloud
Si deseas verificar que la implementación se realizó de forma correcta, copia la URL de Cloud Run generada y ábrela en un navegador, o usa este comando para enviar una solicitud autenticada:
curl --header "Authorization: Bearer $(gcloud auth print-identity-token)"
Deberías recibir un proxy nginx que se haya transferido correctamente al contenedor de sidecar de hello con el estado de respuesta 200
.
Pruébalo
Para continuar con este instructivo:
gcloud
En una terminal, clona el repositorio de la app de muestra en la máquina local:
git clone https://github.com/GoogleCloudPlatform/cloud-run-samples
Ve al directorio que contiene el código de muestra de Cloud Run:
cd cloud-run-samples/multi-container/hello-nginx-sample/
¿Qué sigue?
Para explorar más sobre el uso de archivos adicionales en un servicio de Cloud Run:
- Los archivos adicionales de Cloud Run habilitan patrones avanzados de contenedores
- Implementa en Cloud Run