Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta página, se describe cómo ver información sobre un grupo de trabajadores y cómo borrar grupos de trabajadores.
Roles requeridos
Para obtener los permisos que
necesitas para administrar los grupos de trabajadores y las revisiones de grupos de trabajadores de Cloud Run,
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.
Cloud Run crea un nuevo grupo de trabajadores 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 en tu proyecto
Usa la Google Cloud consola o Google Cloud CLI para ver una lista de los grupos de trabajadores disponibles en tu proyecto:
WORKER_POOL por el nombre del grupo de trabajadores
REGION por la región Google Cloud del grupo de trabajadores.
Inhabilita un grupo de trabajadores existente
Si inhabilitas un grupo de trabajadores, se cierran todas las instancias de ese grupo. Para inhabilitar un grupo de trabajadores, establece el escalamiento en cero:
Reemplaza WORKER_POOL por 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 este grupo de trabajadores, independientemente de 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 la eliminación se complete por completo. Sin embargo, no puedes actualizar el grupo de trabajadores.
La eliminación de un grupo de trabajadores es permanente. No se puede deshacer ni restablecer.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[],[],null,["# Manage worker pools\n\n| **Preview\n| --- Cloud Run worker pools**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThis page describes viewing information about a worker pool, and deleting\nworker pools.\n\n### Required roles\n\n\nTo get the permissions that\nyou need to manage Cloud Run worker pools and worker pool revisions,\n\nask your administrator to grant you the\n\n\n[Cloud Run Developer](/iam/docs/roles-permissions/run#run.developer) (`roles/run.developer`)\nIAM role on your Cloud Run worker pool.\n\n\nFor a list of IAM roles and permissions that are associated with\nCloud Run, see\n[Cloud Run IAM roles](/run/docs/reference/iam/roles)\nand [Cloud Run IAM permissions](/run/docs/reference/iam/permissions).\nIf your Cloud Run worker pool interfaces with\nGoogle Cloud APIs, such as Cloud Client Libraries, see the\n[service identity configuration guide](/run/docs/configuring/workerpools/service-identity).\nFor more information about granting roles, see\n[deployment permissions](/run/docs/reference/iam/roles#additional-configuration)\nand [manage access](/iam/docs/granting-changing-revoking-access).\n\nCreate a worker pool\n--------------------\n\nCloud Run creates a new worker pool the first time you deploy a container image. See [Deploy a new worker pool](/run/docs/deploy-worker-pools#worker-pool)\nfor more instructions.\n\nView the list of worker pools in your project\n---------------------------------------------\n\nUse the Google Cloud console or the Google Cloud CLI to view a list of the\navailable worker pools in your project: \n\n### console\n\n1. In the Google Cloud console, go to Cloud Run:\n\n [Go to Cloud Run](https://console.cloud.google.com/run/worker-pools)\n2. Select **Worker pools** from the menu. The available worker pools are listed\n in the page.\n\n### gcloud\n\nTo list the worker pools in your project: \n\n gcloud beta run worker-pools list\n\nYou can filter this list by properties of the worker pool definition, such as an\n[assigned label](/run/docs/configuring/workerpools/labels#label-listing).\n\nView more details about a worker pool\n-------------------------------------\n\nUse the Google Cloud CLI to see more details about a worker pool: \n\n### console\n\n1. In the Google Cloud console, go to Cloud Run:\n\n [Go to Cloud Run](https://console.cloud.google.com/run/worker-pools)\n2. Select **Worker pools** from the menu to display the available worker pools.\n\n3. Click the worker pool to display its details pane.\n\n### gcloud\n\nTo view details about a worker pool: \n\n```bash\ngcloud beta run worker-pools describe WORKER_POOL\n```\nReplace \u003cvar translate=\"no\"\u003eWORKER_POOL\u003c/var\u003e with the name of the worker pool.\n\n\u003cbr /\u003e\n\nYou can use the [`--format` flag](/sdk/gcloud/reference#--format) to format\nthe output. For example, to format the output as YAML: \n\n```bash\ngcloud beta run worker-pools describe WORKER_POOL\n --region REGION\n --format yaml\n```\n\nReplace:\n\n- \u003cvar translate=\"no\"\u003eWORKER_POOL\u003c/var\u003e with the name of the worker pool.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e with the Google Cloud region of the worker pool.\n\nDisable an existing worker pool\n-------------------------------\n\nDisabling a worker pool shuts down all instances for that worker pool. To\ndisable a worker pool, set scaling to zero: \n\n### console\n\n1. In the Google Cloud console, go to Cloud Run:\n\n [Go to Cloud Run](https://console.cloud.google.com/run/worker-pools)\n2. Select **Worker pools** from the menu, then from the list of worker pools,\n click on the worker pool you want to disable.\n\n3. Click the pen icon at the right of **Scaling: Manual (Instances: )** and\n change the value to 0.\n\n4. Click **Save** to update and disable the worker pool.\n\n### gcloud\n\n```bash\ngcloud beta run worker-pools update WORKER_POOL --scaling=0\n```\n\nReplace \u003cvar translate=\"no\"\u003eWORKER_POOL\u003c/var\u003e with the name of your worker pool.\n\nDelete existing worker pools\n----------------------------\n\nThe following considerations apply to deleting a worker pool:\n\n- Deleting a worker pool deletes all resources related to this worker pool, including all revisions of this worker pool whether they are processing workloads or not.\n- Deleting a worker pool does not automatically remove container images from Artifact Registry. To delete container images used by the deleted revisions from Artifact Registry, refer to [Deleting images](/artifact-registry/docs/docker/manage-images#deleting_images).\n- After you delete a worker pool, the worker pool remains visible in the Google Cloud CLI until the deletion is fully complete. However, you cannot update the worker pool.\n- Deleting a worker pool is permanent. There is no undo or restore.\n\n### console\n\n1. In the Google Cloud console, go to Cloud Run:\n\n [Go to Cloud Run](https://console.cloud.google.com/run/worker-pools)\n2. Select **Worker pools** from the menu, then from the list of worker pools,\n select the worker pool you want to delete.\n\n3. Click **Delete**.\n\n### gcloud\n\nTo delete a worker pool, use the command: \n\n```\ngcloud beta run worker-pools delete WORKER_POOL --region REGION\n```\n\nReplace:\n\n- \u003cvar translate=\"no\"\u003eWORKER_POOL\u003c/var\u003e with the name of your worker pool.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e with the Google Cloud region of the worker pool."]]
