Ajuste de escala manual para grupos de trabajadores

Vista previa — Cloud Run manual scaling

Esta función está sujeta a las “Condiciones de la Oferta de la Fase Previa a la DG” en la sección Condiciones del Servicio Generales de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “tal cual” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta página, se muestra cómo ajustar la escala de tu grupo de trabajadores de forma manual.

Descripción general

El ajuste de escala manual te permite establecer un recuento de instancias específico sin necesidad de volver a implementar. Esto te permite escribir tu propia lógica de ajuste de escala con un sistema externo. Consulta el escalador automático de Kafka para ver un ejemplo de esto.

Consideraciones de facturación cuando se usa el ajuste de escala manual

Cuando usas el ajuste de escala manual, todas las instancias que solicitaste se facturan como instancias activas, incluso si están inactivas. Para obtener todos los detalles de facturación, consulta la página de precios.

Roles requeridos

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 servicio de Cloud Run
• Usuario de la cuenta de servicio (roles/iam.serviceAccountUser) en la identidad del servicio
• Lector de Artifact Registry (roles/artifactregistry.reader) en el repositorio de Artifact Registry de la imagen de contenedor implementada (si corresponde)

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.

Configura el escalamiento

Cambiar el modo de ajuste de escala o la cantidad de instancias manual no crea una revisión nueva.

Para configurar el modo de ajuste de escala, usa la consola de Google Cloud o Google Cloud CLI:

Console

1. En la consola de Google Cloud , ve a Cloud Run:

   Ir a Cloud Run

2. Si quieres configurar un grupo de trabajadores nuevo, selecciona Grupos de trabajadores en el menú y haz clic en Implementar contenedor. Si quieres configurar un grupo de trabajadores existente, haz clic en el grupo de trabajadores para mostrar su panel de detalles y, luego, haz clic en el ícono de lápiz junto a Ajuste de escala en la parte superior derecha del panel de detalles.

3. Ubica el formulario Scaling (Escalamiento) para un grupo de trabajadores nuevo o el formulario Edit scaling (Editar escalamiento) para un grupo de trabajadores existente.

   

4. En el campo Cantidad de instancias, especifica la cantidad de instancias de contenedor para el servicio.

5. Finaliza la especificación.

6. Haz clic en Crear para un grupo de trabajadores nuevo o en Guardar para un grupo de trabajadores existente.

gcloud

Para especificar el ajuste de escala de un grupo de trabajadores nuevo, usa el comando deploy:

gcloud beta run worker-pools deploy WORKER_POOL \
    --scaling=INSTANCE_COUNT \
    --image IMAGE_URL

Reemplaza lo siguiente:

• WORKER_POOL: El nombre de tu grupo de trabajadores.
• INSTANCE_COUNT: Es la cantidad de instancias del grupo de trabajadores. Esto establece el grupo de trabajadores en el escalamiento manual. Especifica un valor de 0 para inhabilitar el grupo de trabajadores.
• IMAGE_URL: Es una referencia a la imagen del contenedor que contiene el grupo de trabajadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.

Especifica el escalamiento para un grupo de trabajadores existente con el siguiente comando update:

gcloud beta run worker-pools update WORKER_POOL \
   --scaling=INSTANCE_COUNT

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

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

  template {
    containers {
      image = "IMAGE_URL"
    }
  }
  scaling {
    scaling_mode = "MANUAL"
    manual_instance_count = "INSTANCE_COUNT"
  }
}

Reemplaza lo siguiente:

• WORKER_POOL: Es el nombre del grupo de trabajadores.
• REGION: La región Google Cloud , por ejemplo,europe-west1.
• IMAGE_URL: Es una referencia a la imagen del contenedor que contiene el grupo de trabajadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
• INSTANCE_COUNT: Es la cantidad de instancias del grupo de trabajadores. Esto establece el grupo de trabajadores en el escalamiento manual. Especifica un valor de 0 para inhabilitar el grupo de trabajadores.

Cómo ver la configuración de escalamiento de un grupo de trabajadores

1. En la consola de Google Cloud , ve a Cloud Run:

   Ir a Cloud Run

2. Haz clic en Grupos de trabajadores para ver la lista de grupos de trabajadores implementados.

3. Haz clic en el grupo de trabajadores que deseas examinar para mostrar su panel de detalles.

4. El parámetro de configuración de escalamiento actual se muestra sobre la lista de revisión de los grupos de trabajadores: Scaling: Manual (Instances: ).

Nota: También puedes usar el comando gcloud beta run worker-pools describe de Google Cloud CLI para ver los detalles de la configuración.

Inhabilita un grupo de trabajadores

Para inhabilitar un grupo de trabajadores, usa el siguiente comando para establecer el ajuste de escala en cero:

gcloud beta run worker-pools update WORKER_POOL --scaling=0

Reemplaza WORKER_POOL por el nombre de tu grupo de trabajadores.