[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 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."]]
