Cloud Run te permite ver detalles, inhabilitar grupos de trabajadores activos o borrar los que no necesites. Puedes verificar las configuraciones implementadas, detener las instancias en ejecución y quitar los recursos que no se usan.
Roles obligatorios
Para obtener los permisos que
necesitas para administrar los grupos de trabajadores de Cloud Run y las revisiones de los grupos de trabajadores,
pídele a tu administrador que te otorgue el
rol de IAM de desarrollador de Cloud Run (roles/run.developer) en tu grupo de trabajadores de Cloud Run.
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 lasGoogle Cloud APIs, 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 los permisos de implementación y cómo administrar el acceso.
Crear un grupo de trabajadores
Cloud Run crea un grupo de trabajadores nuevo la primera vez que implementas una imagen de contenedor. Consulta Implementa un grupo de trabajadores nuevo para obtener más instrucciones.
Visualiza la lista de grupos de trabajadores de tu proyecto
Usa la consola de Google Cloud o Google Cloud CLI para ver una lista de los grupos de trabajadores disponibles en tu proyecto:
Console
En la consola Google Cloud , ve a Cloud Run:
Selecciona Grupos de trabajadores en el menú. Los grupos de trabajadores disponibles se enumeran en la página.
gcloud
Para enumerar los grupos de trabajadores de tu proyecto, ejecuta el siguiente comando:
gcloud run worker-pools list
Puedes filtrar esta lista por propiedades de la definición del grupo de trabajadores, como una etiqueta asignada.
Bibliotecas cliente
Para ver una lista de grupos de trabajadores desde el código, haz lo siguiente:
API de REST
Para ver la lista de grupos de trabajadores de tu proyecto, envía una solicitud HTTP GET al
extremo workerPool de la API de Cloud Run Admin.
Por ejemplo, con curl:
curl -H "Authorization: Bearer ACCESS_TOKEN" \ -X GET \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools
Reemplaza lo siguiente:
- ACCESS_TOKEN: un token de acceso válido para una cuenta que
tenga los permisos de IAM para ver grupos de trabajadores.
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. - PROJECT_ID: Es el ID del proyecto de Google Cloud .
- REGION: Es la región de Google Cloud de los grupos de trabajadores.
Consulta más detalles sobre un grupo de trabajadores
Usa la consola de Google Cloud , Google Cloud CLI o YAML para ver más detalles sobre un grupo de trabajadores:
Console
En la consola Google Cloud , ve a Cloud Run:
Selecciona Grupos de trabajadores en el menú para mostrar los grupos de trabajadores disponibles.
Haz clic en el grupo de trabajadores para mostrar su panel de detalles.
gcloud
Para ver los detalles de un grupo de trabajadores, sigue estos pasos:
gcloud run worker-pools describe WORKER_POOL
Puedes usar la marca --format para dar formato al resultado. Por ejemplo, para dar formato al resultado como YAML, haz lo siguiente:
gcloud run worker-pools describe WORKER_POOL --region REGION --format yaml
Reemplaza lo siguiente:
- WORKER_POOL por el nombre del grupo de trabajadores.
- REGION por la región de Google Cloud del grupo de trabajadores.
YAML
Para ver los detalles de un grupo de trabajadores, descarga su configuración YAML:
gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
Bibliotecas cliente
Para ver los detalles de un grupo de trabajadores desde el código, haz lo siguiente:
API de REST
Para ver los detalles de un grupo de trabajadores, envía una solicitud HTTP GET al
extremo workerPool de la API de Cloud Run Admin.
Por ejemplo, con curl:
curl -H "Authorization: Bearer ACCESS_TOKEN" \ -X GET \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL
Reemplaza lo siguiente:
- ACCESS_TOKEN: Es un token de acceso válido para una cuenta que
tiene los permisos de IAM para ver los detalles del grupo de trabajadores.
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. - PROJECT_ID: Es el ID del proyecto de Google Cloud .
- REGION: Es la región de Google Cloud del grupo de trabajadores.
- WORKER_POOL: Es el nombre del grupo de trabajadores.
Inhabilita un grupo de trabajadores existente
Inhabilitar un grupo de trabajadores cierra todas las instancias de ese grupo. Para inhabilitar un grupo de trabajadores, establece el escalamiento en cero:
Console
En la consola Google Cloud , ve a Cloud Run:
Selecciona Grupos de trabajadores en el menú y, luego, en la lista de grupos de trabajadores, haz clic en el grupo de trabajadores que deseas inhabilitar.
Haz clic en el ícono de lápiz a la derecha de Escalamiento: Manual (instancias: ) y cambia el valor a 0.
Haz clic en Guardar para actualizar y, luego, inhabilitar el grupo de trabajadores.
gcloud
gcloud run worker-pools update WORKER_POOL --instances=0
Reemplaza WORKER_POOL por el nombre de tu grupo de trabajadores.
YAML
Si creas un grupo de trabajadores nuevo, omite este paso. Si actualizas un grupo de trabajadores existente, descarga su configuración de YAML:
gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
Establece el escalamiento en un valor de
0para inhabilitar el grupo de trabajadores. En el siguiente ejemplo, se incluye la configuración de YAML:apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL annotations: run.googleapis.com/scalingMode: manual run.googleapis.com/manualInstanceCount: `0`
Reemplaza lo siguiente:
- WORKER_POOL: Es el nombre de tu grupo de trabajadores de Cloud Run.
Crea o actualiza el grupo de trabajadores con el siguiente comando:
gcloud run worker-pools replace worker-pool.yaml
El comando
gcloud run worker-pools replaceusa de forma predeterminada el archivoworker-pool.yamlsi está presente.
Bibliotecas cliente
Para inhabilitar un grupo de trabajadores desde el código, sigue estos pasos:
API de REST
Para inhabilitar un grupo de trabajadores, envía una solicitud HTTP PATCH al
extremo workerPool de la API de Cloud Run Admin.
Por ejemplo, con curl:
curl -H "Authorization: Bearer ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -X PATCH \ -d '{"scaling":{"manualInstanceCount":0}}' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL?update_mask=scaling.manualInstanceCount
Reemplaza lo siguiente:
- ACCESS_TOKEN: Es un token de acceso válido para una cuenta que
tiene los permisos de IAM para inhabilitar un grupo de trabajadores.
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. - PROJECT_ID: Es el ID del proyecto de Google Cloud .
- REGION: Es la región de Google Cloud del grupo de trabajadores.
- WORKER_POOL: El nombre de tu grupo de trabajadores
Borra grupos de trabajadores existentes
Las siguientes consideraciones se aplican a la eliminación de un grupo de trabajadores:
- Si borras un grupo de trabajadores, se borrarán todos los recursos relacionados con él, incluidas todas las revisiones de ese grupo, sin importar si procesan cargas de trabajo o no.
- Borrar un grupo de trabajadores no quita de forma automática las imágenes de contenedor de Artifact Registry. Para borrar imágenes de contenedor que usan las revisiones borradas de Artifact Registry, consulta Borra imágenes.
- Después de borrar un grupo de trabajadores, este permanece visible en Google Cloud CLI hasta que se complete la eliminación. Sin embargo, no puedes actualizar el grupo de trabajadores.
La acción de borrar un grupo de trabajadores es permanente. No se puede deshacer ni restablecer.
Console
En la consola Google Cloud , ve a Cloud Run:
Selecciona Grupos de trabajadores en el menú y, luego, en la lista de grupos de trabajadores, selecciona el grupo de trabajadores que quieres borrar.
Haz clic en Borrar.
gcloud
Para borrar un grupo de trabajadores, usa el siguiente comando:
gcloud run worker-pools delete WORKER_POOL --region REGION
Reemplaza lo siguiente:
- WORKER_POOL por el nombre de tu grupo de trabajadores.
- REGION por la región de Google Cloud del grupo de trabajadores.
Bibliotecas cliente
Para borrar un grupo de trabajadores desde el código, sigue estos pasos:
API de REST
Para borrar un grupo de trabajadores, envía una solicitud HTTP DELETE al
endpoint workerPool de la API de Cloud Run Admin.
Por ejemplo, con curl:
curl -H "Authorization: Bearer ACCESS_TOKEN" \ -X DELETE \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL
Reemplaza lo siguiente:
- ACCESS_TOKEN: un token de acceso válido para una cuenta que
tenga los permisos de IAM para borrar un grupo de trabajadores.
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. - PROJECT_ID: Es el ID del proyecto de Google Cloud .
- REGION: Es la región de Google Cloud del grupo de trabajadores.
- WORKER_POOL: El nombre de tu grupo de trabajadores