Establece instancias mínimas (servicios)

Console

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

   Ir a Cloud Run

2. Si quieres configurar un servicio nuevo, haz clic en Implementar contenedor y selecciona Servicio para mostrar el formulario Crear servicio. Si quieres configurar un servicio existente, haz clic en el servicio para mostrar su panel de detalles y, luego, haz clic en el ícono de lápiz junto a Cantidad mínima de instancias en la parte superior derecha del panel de detalles.

3. Ubica el formulario Ajuste de escala automático del servicio:

   

   • En el campo Número mínimo de instancias, especifica la cantidad de instancias de contenedor que se mantendrán en espera, listas para recibir solicitudes.

4. Haz clic en Crear para un servicio nuevo o en Implementar en un servicio existente.

gcloud

Actualiza service-min-instances para un servicio determinado mediante el siguiente comando:

gcloud run services update SERVICE --service-min-instances MIN-VALUE

Reemplaza lo siguiente:

• SERVICE por el nombre de tu servicio.
• MIN-VALUE por la cantidad de instancias de contenedor que deseas que se mantengan en espera, listas para recibir solicitudes. Especifica default para borrar cualquier configuración de número mínimo de instancias

Como alternativa, puedes configurar el valor de service-min-instances durante la implementación mediante el siguiente comando:

gcloud run deploy --image IMAGE_URL --service-min-instances MIN-VALUE

Reemplazar

• IMAGE_URL por una referencia a la imagen del contenedor, como us-docker.pkg.dev/cloudrun/container/hello:latest Si usas Artifact Registry, el repositorio REPO_NAME debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
• MIN-VALUE por la cantidad de instancias de contenedor que deseas que se mantengan en espera, listas para recibir solicitudes. Especifica default para borrar cualquier configuración de número mínimo de instancias

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. Actualiza el atributo run.googleapis.com/minScale:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
     annotations:
       run.googleapis.com/minScale: 'MIN_INSTANCE'

   Reemplaza lo siguiente:

   • SERVICE por el nombre del servicio de Cloud Run
   • MIN-INSTANCE por la cantidad de instancias que se mantendrán en espera, listas para recibir solicitudes.

3. Crea o actualiza el servicio con el siguiente comando:

   gcloud run services replace service.yaml

Bibliotecas cliente

Para actualizar las instancias mínimas a nivel del servicio desde el código, sigue estos pasos:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

API de REST

Para actualizar la cantidad mínima de instancias a nivel de servicio para un servicio determinado, envía una solicitud HTTP PATCH al extremo service de la API de Cloud Run Admin.

Por ejemplo, con curl:

curl -H "Content-Type: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-X PATCH \
-d '{ "scaling": { "minInstanceCount": MIN-VALUE }}' \
https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE?update_mask=scaling.minInstanceCount

Reemplaza lo siguiente:

• ACCESS_TOKEN por un token de acceso válido para una cuenta que tenga los permisos de IAM para actualizar un servicio. Por ejemplo, si accediste a gcloud, puedes recuperar un token de acceso con gcloud auth print-access-token. Desde una instancia de contenedor de Cloud Run, puedes recuperar un token de acceso a través del servidor de metadatos de instancias de contenedor.
• MIN-VALUE por la cantidad de instancias de contenedor que deseas que se mantengan en espera, listas para recibir solicitudes.
• SERVICE por el nombre del servicio
• REGION por la región de Google Cloud del servicio.
• PROJECT-ID por el ID del proyecto de Google Cloud.

Console

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

   Ir a Cloud Run

2. Haz clic en el servicio que te interesa para abrir el panel Detalles del servicio.

3. La configuración actual se muestra en la parte superior derecha del panel de detalles del servicio, junto a Cantidad mínima de instancias.

gcloud

1. Usa el siguiente comando:

   gcloud run services describe SERVICE

2. Busca el valor de Instancias mínimas de nivel de servicio: en la configuración que se muestra.

Console

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

   Ir a Cloud Run

2. Haz clic en Implementar contenedor y selecciona Servicio para configurar un servicio nuevo. Si quieres configurar un servicio existente, haz clic en el servicio y, luego, en implementar y editar la nueva revisión.

3. Si configuras un servicio nuevo, completa la página de configuración del servicio inicial como desees y haz clic en Contenedores, volúmenes, Herramientas de redes y seguridad para expandir la página de configuración del servicio.

4. Haz clic en la pestaña Contenedor.

   

   • En el campo Número mínimo de instancias, especifica la cantidad de instancias de contenedor que se mantendrán en espera, listas para recibir solicitudes.

5. Haz clic en Crear o Implementar.

gcloud

Puedes actualizar el valor de min-instance de un servicio determinado mediante el siguiente comando:

gcloud run services update SERVICE --min-instances MIN-VALUE

Reemplaza lo siguiente:

• SERVICE por el nombre de tu servicio.
• MIN-VALUE por la cantidad de instancias de contenedor que deseas que se mantengan en espera, listas para recibir solicitudes. Especifica default para borrar cualquier configuración de número mínimo de instancias

También puedes configurar el valor de min-instance durante la implementación mediante el siguiente comando:

gcloud run deploy --image IMAGE_URL --min-instances MIN-VALUE

Reemplaza lo siguiente:

• IMAGE_URL por una referencia a la imagen del contenedor, como us-docker.pkg.dev/cloudrun/container/hello:latest Si usas Artifact Registry, el repositorio REPO_NAME debe estar creado. La URL tiene el formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
• MIN-VALUE por la cantidad de instancias de contenedor que deseas que se mantengan en espera, listas para recibir solicitudes. Especifica default para borrar cualquier configuración de número mínimo de instancias

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. Actualiza el atributo autoscaling.knative.dev/minScale::

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           autoscaling.knative.dev/minScale: 'MIN-INSTANCE'
         name: REVISION

   Reemplaza lo siguiente:

   • SERVICE por el nombre del servicio de Cloud Run
   • MIN-INSTANCE por la cantidad de instancias que se mantendrán en espera, listas para recibir solicitudes.
   • REVISION por un nombre de revisión nuevo o bórralo (si está presente). Si proporcionas un nuevo nombre de revisión, debe cumplir con los siguientes criterios:
     • Comienza con SERVICE-
     • Solo contiene letras minúsculas, números y -
     • No termina con -
     • No supera los 63 caracteres

3. Crea o actualiza el servicio con el siguiente comando:

   gcloud run services replace service.yaml

Terraform

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

El siguiente recurso google_cloud_run_v2_service especifica una cantidad mínima de instancias de 1 en template.scaling. Reemplaza 1 por tu propia cantidad mínima de instancias.

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-min-instances"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    scaling {
      # Min instances
      min_instance_count = 1
    }
  }
}

Console

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

   Ir a Cloud Run

2. Haz clic en el servicio que te interesa para abrir la página Detalles del servicio.

3. Haz clic en la pestaña Revisiones.

4. En el panel de detalles a la derecha, la configuración de instancias mínimas a nivel de revisión se muestra en la pestaña Contenedor.

gcloud

1. Usa el siguiente comando:

   gcloud run services describe SERVICE

2. Busca la configuración de instancias mínimas a nivel de revisión en la configuración que se muestra.