Proxy de frontend con Nginx

Console

1. Ve a la página de Secret Manager en la consola de Google Cloud:

   Ir a Secret Manager

2. Haz clic en Crear secreto.

3. En el campo de formulario name, ingresa nginx_config.

4. Sube el archivo nginx.conf ubicado en multi-container/hello-nginx-sample/nginx.conf como el valor del Secret.

5. Conserva los valores predeterminados (Google-managed encryption key, etc).

6. Haz clic en Crear secreto.

7. 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:

   Ir a IAM

8. Localiza la cuenta de servicio principal con el nombre: Compute Engine default service account y haz clic en Editar principal.

9. Haz clic en Agregar otro rol y selecciona Descriptor de acceso a secretos de Secret Manager.

10. Haz clic en Guardar.

gcloud

1. 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'

2. 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'

3. Ejecuta gcloud secrets list para verificar que se creó el Secret.

Console

Navega a Implementa el servicio para obtener las instrucciones completas de la consola.

YAML

1. 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

2. En service.yaml, agrega lo siguiente:

   metadata:
     name: "MC_SERVICE_NAME"
     labels:
       cloud.googleapis.com/location: "REGION"
     annotations:
       # Required to use Cloud Run multi-containers (preview feature)
       run.googleapis.com/launch-stage: BETA
       run.googleapis.com/description: sample tutorial service
       # Externally available
       run.googleapis.com/ingress: all

La sección describe la revisión del servicio, que incluye propiedades que pueden variar de una revisión a otra.

Console

Navega a Implementa el servicio para obtener las instrucciones completas de la consola.

YAML

En service.yaml, agrega lo siguiente:

spec:
  template:
    metadata:
      annotations:
        # Defines container startup order within multi-container service.
        # Below requires hello container to spin up before nginx container,
        # which depends on the hello container.
        # https://cloud.google.com/run/docs/configuring/containers#container-ordering
        run.googleapis.com/container-dependencies: "{nginx: [hello]}"

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 manera opcional, cada contenedor puede tener definida una propiedad de nombre 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 al que se las entregará.

Console

Navega a Implementa el servicio para obtener las instrucciones completas de la consola.

YAML

En el archivo service.yaml, agrega lo siguiente:

spec:
  containers:
    # A) Serving ingress container "nginx" listening at PORT 8080
    # Main entrypoint of multi-container service.
    # Source is stored in nginx_config secret in Secret Manager.
    # Any pings to this container will proxy over to hello container at PORT 8888.
    # https://cloud.google.com/run/docs/container-contract#port
    - image: nginx
      name: nginx
      ports:
        - name: http1
          containerPort: 8080
      resources:
        limits:
          cpu: 500m
          memory: 256Mi
      # Referencing declared volume below,
      # Declaring volume to mount in current ingress container's filesystem
      # https://cloud.google.com/run/docs/reference/rest/v2/Container#volumemount
      volumeMounts:
        - name: nginx-conf-secret
          readOnly: true
          mountPath: /etc/nginx/conf.d/
      startupProbe:
        timeoutSeconds: 240
        periodSeconds: 240
        failureThreshold: 1
        tcpSocket:
          port: 8080

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. La sección volumeMount especifica un volumen llamado configuration que se colocará allí. El volumen en sí se define en su propia sección más adelante en el archivo.

Console

Navega a Implementa el servicio para obtener las instrucciones completas de la consola.

YAML

En service.yaml, agrega lo siguiente:

- image: us-docker.pkg.dev/cloudrun/container/hello
  name: hello
  env:
    - name: PORT
      value: "8888"
  resources:
    limits:
      cpu: 1000m
      memory: 512Mi
  startupProbe:
    timeoutSeconds: 240
    periodSeconds: 240
    failureThreshold: 1
    tcpSocket:
      port: 8888

La aplicación hello también necesita información de configuración. Detecta las solicitudes entrantes en el puerto especificado en la variable de entorno PORT. Ese nombre y valor se especifican en la sección env.

Console

Navega a Implementa el servicio para obtener las instrucciones completas de la consola.

YAML

En el archivo service.yaml, agrega lo siguiente:

volumes:
  - name: nginx-conf-secret
    secret:
      secretName: nginx_config
      items:
        - key: latest
          path: default.conf

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 secreto llamado nginx-conf-secret.

Console

1. Ve a la página de Cloud Run en la consola de Google Cloud.

   Ir a Cloud Run

2. Haz clic en Desplegar contenedor y selecciona Servicio para mostrar el formulario Crear servicio.

   1. Selecciona Implementar una revisión desde una imagen de contenedor existente y luego, ingresa nginx como URL de imagen de contenedor.
   2. En el campo Nombre del servicio, ingresa un nombre para tu servicio, por ejemplo, hello-mc.
   3. En la lista Región, selecciona una ubicación para la implementación, por ejemplo, us-west1.
   4. En Autenticación, selecciona Allow unauthenticated invocations. Si no tienes permisos (rol de administrador de Cloud Run) para seleccionar esta opción, el servicio se implementará y requerirá autenticación.

3. Haz clic en Contenedores, volúmenes, herramientas de redes y seguridad para expandir el formulario de configuración.

   1. Haz clic en la pestaña Volúmenes.
   2. Haz clic en Agregar volumen.
   3. En la lista Tipo de volumen, selecciona Secreto.
   4. En el campo Volume name, ingresa nginx-conf-secret.
   5. En el campo Secret, ingresa nginx_config.
   6. En Rutas especificadas para las versiones de Secret, especifica default.conf como la ruta y latest como la versión.
   7. Haz clic en Crear para crear el volumen del secreto.

4. Haz clic en la pestaña Contenedores para mostrar el formulario Editar contenedor.

   1. Haz clic en Configuración, luego en Recursos, cambia la memoria a 256MiB y CPU a 1 CPU.
   2. Haz clic en Activaciones de volumen.
   3. Haz clic en Volumen de activación.
   4. Selecciona nginx-conf-secret en la lista de nombres.
   5. En Ruta de activación, ingresa etc/nginx/conf.d.
   6. Haz clic en Listo para completar la configuración del primer contenedor.

5. Haz clic en Agregar contenedor para agregar el contenedor de sidecar y mostrar el formulario Contenedor nuevo.

   1. Selecciona la URL de imagen de contenedor predeterminada us-docker.pkg.dev/cloudrun/container/hello
   2. Haz clic en la pestaña Configuración y, luego, en Recursos, cambia la memoria a 256 MiB y la CPU a 1 CPU.
   3. Haz clic en Variables y secretos.
   4. Haz clic en Agregar variable.
   5. Ingresa PORT como el nombre de la variable de entorno nueva y 8888 como el valor.
   6. Haz clic en Listo.

6. Navega al formulario Editar contenedor del primer contenedor (nginx).

   1. Haz clic en la pestaña Configuración.
   2. En Orden de inicio del contenedor, selecciona nginx de la lista Depends on. Esto significa que el contenedor nginx se inicia sólo después de que se inicia correctamente el contenedor hello.
   3. Haz clic en Crear y espera a que se implemente tu 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

gcloud

Para verificar que la implementación se realizó correctamente, 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.

gcloud

1. En una terminal, clona el repositorio de la app de ejemplo en tu máquina local:

   git clone https://github.com/GoogleCloudPlatform/cloud-run-samples

2. Ve al directorio que contiene el código de muestra de Cloud Run:

   cd cloud-run-samples/multi-container/hello-nginx-sample/