Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página descreve a visualização de informações sobre um worker pool e a eliminação de worker pools.
Funções necessárias
Para receber as autorizações de que precisa para gerir pools de trabalhadores e revisões de pools de trabalhadores do Cloud Run, peça ao seu administrador para lhe conceder a função de IAM Programador do Cloud Run (roles/run.developer) no seu pool de trabalhadores do Cloud Run.
O Cloud Run cria um novo conjunto de trabalhadores na primeira vez que implementa uma imagem de contentor. Consulte o artigo Implemente um novo conjunto de trabalhadores
para obter mais instruções.
Veja a lista de conjuntos de trabalhadores no seu projeto
Use a Google Cloud consola ou a CLI Google Cloud para ver uma lista dos
pools de trabalhadores disponíveis no seu projeto:
REGION com a Google Cloud região do grupo de trabalhadores.
Desative um grupo de trabalhadores existente
A desativação de um grupo de trabalhadores encerra todas as instâncias desse grupo de trabalhadores. Para desativar um grupo de trabalhadores, defina o dimensionamento como zero:
Substitua WORKER_POOL pelo nome do seu conjunto de trabalhadores.
Elimine grupos de trabalhadores existentes
As seguintes considerações aplicam-se à eliminação de um conjunto de trabalhadores:
A eliminação de um grupo de trabalhadores elimina todos os recursos relacionados com este grupo de trabalhadores, incluindo todas as
revisões deste grupo de trabalhadores, quer estejam a processar cargas de trabalho ou não.
A eliminação de um conjunto de trabalhadores não remove automaticamente as imagens de contentores do Artifact Registry.
Para eliminar imagens de contentores usadas pelas revisões eliminadas do Artifact Registry,
consulte o artigo Eliminar imagens.
Depois de eliminar um grupo de trabalhadores, este permanece visível na CLI Google Cloud
até que a eliminação esteja totalmente concluída. No entanto, não pode atualizar o grupo de trabalhadores.
A eliminação de um grupo de trabalhadores é permanente. Não existe a opção de anular nem restaurar.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-21 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."]]
