Implementa grupos de trabajadores en Cloud Run

En esta página, se muestra cómo implementar imágenes de contenedor en un grupo de trabajadores nuevo de Cloud Run o en una revisión nueva de un grupo de trabajadores existente de Cloud Run.

Los grupos de trabajadores son un recurso de Cloud Run diseñado específicamente para cargas de trabajo que no son de solicitud. A diferencia de los servicios de Cloud Run, los grupos de trabajadores no tienen las siguientes funciones:

• URL o extremo público
• Requisito para exponer un puerto de entrada
• Ajuste de escala automático impulsado por solicitudes

Para ver un ejemplo de cómo implementar un grupo de trabajadores nuevo, consulta Implementa una guía de inicio rápido de grupo de trabajadores de muestra.

Roles obligatorios

Para obtener los permisos que necesitas para implementar grupos de trabajadores de Cloud Run, pídele a tu administrador que te otorgue los siguientes roles de IAM:

• Desarrollador de Cloud Run (roles/run.developer) en el grupo de trabajadores de Cloud Run
• Usuario de la cuenta de servicio (roles/iam.serviceAccountUser) en la identidad que usan tus grupos de trabajadores para interactuar con otros servicios de Google Cloud
• Lector de Artifact Registry (roles/artifactregistry.reader) en el repositorio de Artifact Registry de la imagen de contenedor implementada

Para obtener una lista de los roles y los permisos de IAM asociados con Cloud Run, consulta los roles de IAM de Cloud Run y los permisos de IAM de Cloud Run. Si tu grupo de trabajadores de Cloud Run interactúa con las APIs deGoogle Cloud , como las bibliotecas cliente de Cloud, consulta la guía de configuración de identidades del servicio. Para obtener más información sobre cómo otorgar roles, consulta permisos de implementación y administra el acceso.

Imágenes y registros de contenedores compatibles

Puedes usar directamente imágenes de contenedor almacenadas en Artifact Registry o Docker Hub. Google recomienda el uso de Artifact Registry. Las imágenes de Docker Hub se almacenan en caché por hasta una hora.

Puedes usar imágenes de contenedor de otros registros públicos o privados (como JFrog Artifactory, Nexus o GitHub Container Registry) a través de la configuración de un repositorio remoto de Artifact Registry.

Solo debes considerar Docker Hub para implementar imágenes de contenedor populares, como las imágenes oficiales de Docker o las imágenes de OSS patrocinadas por Docker. Para obtener una mayor disponibilidad, Google recomienda implementar estas imágenes de Docker Hub con un repositorio remoto de Artifact Registry.

Cloud Run no admite capas de imágenes de contenedor de más de 9.9 GB cuando se realiza la implementación desde Docker Hub o un repositorio remoto de Artifact Registry con un registro externo.

Implementa grupos de trabajadores

Puedes implementar grupos de trabajadores de las siguientes maneras:

• Implementa un grupo de trabajadores nuevo
• Actualiza un grupo de trabajadores existente
• Implementa imágenes de otros Google Cloud proyectos
• Implementa varios contenedores (sidecars) en un grupo de trabajadores

Implementa un grupo de trabajadores nuevo

Puedes especificar una imagen de contenedor con una etiqueta (por ejemplo, us-docker.pkg.dev/my-project/container/my-image:latest) o con un resumen exacto (por ejemplo, us-docker.pkg.dev/my-project/container/my-image@sha256:41f34ab970ee...).

Cuando implementas un grupo de trabajadores por primera vez, se crea su primera revisión. Ten en cuenta que las revisiones son inmutables. Si implementas desde una etiqueta de imagen de contenedor, se resolverá en un resumen y la revisión siempre entregará este resumen en particular.

Sigue las instrucciones con Google Cloud CLI o Terraform.

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"
  launch_stage = "BETA"

  template {
    containers {
      image = "IMAGE_URL"
    }
  }
}

Implementa una revisión nueva de un grupo de trabajadores existente

Ten en cuenta que cambiar la configuración de un grupo de trabajadores genera la creación de una revisión nueva, incluso si no hay cambios en la imagen del contenedor. Cada revisión creada es inmutable.

Cloud Run importa la imagen del contenedor cuando se implementa. Cloud Run conserva esta copia de la imagen de contenedor mientras la use una revisión.

Sigue estas instrucciones con Google Cloud CLI o Terraform:

Implementa imágenes de otros Google Cloud proyectos

Para implementar imágenes desde otros proyectos de Google Cloud , tú o tu administrador deben otorgar los roles de IAM requeridos a la cuenta del implementador y al agente de servicio de Cloud Run.

Para conocer los roles necesarios para la cuenta del implementador, consulta roles requeridos.

Para otorgar los roles requeridos al agente de servicio de Cloud Run, consulta las siguientes instrucciones:

1. En la consola de Google Cloud , abre el proyecto de tu grupo de trabajadores de Cloud Run.

   Ve a la página IAM

2. Selecciona Incluir asignaciones de roles proporcionadas por Google.

3. Copia el correo electrónico del agente de servicio de Cloud Run. Tiene el sufijo @serverless-robot-prod.iam.gserviceaccount.com

4. Abre el proyecto que posee el registro de contenedores que deseas usar.

   Ve a la página IAM

5. Haz clic en Agregar para agregar una principal nueva.

6. En el campo Principales nuevas, pega el correo electrónico de la cuenta de servicio que copiaste antes.

7. En el menú desplegable Seleccionar una función, si usas Container Registry, elige la función Almacenamiento -> Visualizador de objetos de Storage. Si usas Artifact Registry, selecciona la función Artifact Registry -> Lector de Artifact Registry.

8. Implementa la imagen del contenedor en el proyecto que contiene tu grupo de trabajadores de Cloud Run.

Implementa imágenes de otros registros

Para implementar imágenes de contenedor públicas o privadas que no se almacenan en Artifact Registry ni en Docker Hub, configura un repositorio remoto de Artifact Registry.

Los repositorios remotos de Artifact Registry te permiten hacer lo siguiente:

• Implementar cualquier imagen de contenedor pública, por ejemplo, GitHub Container Registry (ghcr.io)
• Implementa imágenes de contenedor de repositorios privados que requieran autenticación, por ejemplo, JFrog Artifactory o Nexus.

Si no es posible usar un repositorio remoto de Artifact Registry, puedes extraer y enviar imágenes de contenedor de forma temporal a Artifact Registry implementándolas en Cloud Run con docker push. Cloud Run importa la imagen del contenedor durante la implementación y, después, puedes borrarla de Artifact Registry.

Implementa varios contenedores (sidecars) en un grupo de trabajadores

En una implementación de Cloud Run con sidecars, hay un contenedor principal del grupo de trabajadores y uno o más contenedores sidecar. Los sidecars pueden comunicarse entre sí y con el contenedor del grupo de trabajadores a través de un puerto localhost. El puerto de localhost varía según los contenedores que uses.

Puedes implementar hasta 10 contenedores por instancia, incluido el contenedor del grupo de trabajadores. Todos los contenedores dentro de una instancia comparten el mismo espacio de nombres de red y también pueden compartir archivos a través de un volumen compartido en la memoria.

Puedes exigir que todas las implementaciones usen un sidecar específico si creas políticas de organización personalizadas.

Implementa un servicio con contenedores de sidecar

Sigue estas instrucciones con Google Cloud CLI o Terraform para implementar varios contenedores en un grupo de trabajadores de Cloud Run:

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"
  launch_stage = "BETA"

  template {
    containers {
      name = "CONTAINER_NAME"
      image = "IMAGE_URL"
    }
    containers {
      name = "SIDECAR_CONTAINER_NAME"
      image = "SIDECAR_IMAGE_URL"
    }
  }
}

Funciones destacadas disponibles para implementaciones con sidecars

Puedes especificar el orden de inicio del contenedor dentro de una implementación con varios contenedores si tienes dependencias que requieren que algunos contenedores se inicien antes que otros contenedores en la implementación.

Si tienes contenedores que dependen de otros contenedores, debes usar verificaciones de estado en tu implementación. Cuando usas verificaciones de estado, Cloud Run sigue el orden de inicio del contenedor y verifica el estado de cada contenedor antes de iniciar el siguiente. Sin verificaciones de estado, Cloud Run intenta iniciar todos los contenedores, incluso si los contenedores de los que dependen aún no se están ejecutando o no se pudieron iniciar.

Varios contenedores dentro de una sola instancia pueden acceder a un volumen en memoria compartido, al que puede acceder cada contenedor con los puntos de activación que creas.

¿Qué sigue?

Después de implementar un grupo de trabajadores nuevo, puedes hacer lo siguiente:

• Cómo ver los registros del grupo de trabajadores
• Supervisa el rendimiento del grupo de trabajadores
• Establece límites de memoria
• Configure las variables de entorno
• Administra el grupo de trabajadores
• Administra revisiones del grupo de trabajadores