Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina descrive la visualizzazione delle informazioni su un pool di worker e l'eliminazione
dei pool di worker.
Ruoli obbligatori
Per ottenere le autorizzazioni
necessarie per gestire i pool di worker Cloud Run e le revisioni dei pool di worker,
chiedi all'amministratore di concederti il
ruolo IAM Sviluppatore Cloud Run (roles/run.developer)
nel pool di worker Cloud Run.
Cloud Run crea un nuovo pool di worker la prima volta che esegui il deployment di un'immagine container. Per ulteriori istruzioni, consulta la sezione Eseguire il deployment di un nuovo worker pool.
Visualizza l'elenco dei pool di worker nel tuo progetto
Utilizza la console Google Cloud o Google Cloud CLI per visualizzare un elenco dei pool di worker disponibili nel tuo progetto:
Sostituisci WORKER_POOL con il nome del tuo pool di worker.
Elimina i worker pool esistenti
Per l'eliminazione di un worker pool valgono le seguenti considerazioni:
L'eliminazione di un worker pool comporta l'eliminazione di tutte le risorse correlate, incluse tutte le revisioni del worker pool, indipendentemente dal fatto che stiano elaborando carichi di lavoro o meno.
L'eliminazione di un pool di worker non rimuove automaticamente le immagini dei container da Artifact Registry.
Per eliminare le immagini container utilizzate dalle revisioni eliminate da Artifact Registry,
consulta Eliminazione delle immagini.
Dopo aver eliminato un worker pool, questo rimane visibile nella Google Cloud CLI
finché l'eliminazione non è completamente terminata. Tuttavia, non puoi aggiornare il worker pool.
L'eliminazione di un pool di worker è definitiva. Non è possibile annullare o ripristinare l'operazione.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]
