Manage worker pools

Preview — Cloud Run worker pools

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of theService Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see thelaunch stage descriptions.

This page describes viewing information about a worker pool, and deletingworker pools.

Required roles

To get the permissions that you need to manage Cloud Run worker pools and worker pool revisions, ask your administrator to grant you theCloud Run Developer (roles/run.developer) IAM role on your Cloud Run worker pool.

For a list of IAM roles and permissions that are associated withCloud Run, seeCloud Run IAM rolesandCloud Run IAM permissions.If your Cloud Run worker pool interfaces withGoogle Cloud APIs, such as Cloud Client Libraries, see theservice identity configuration guide.For more information about granting roles, seedeployment permissionsandmanage access.

Create a worker pool

Cloud Run creates a new worker pool the first time you deploy a container image. SeeDeploy a new worker poolfor more instructions.

View the list of worker pools in your project

Use the Google Cloud console or the Google Cloud CLI to view a list of theavailable worker pools in your project:

console

  1. In the Google Cloud console, go to Cloud Run:

    Go to Cloud Run

  2. SelectWorker pools from the menu. The available worker pools are listedin the page.

gcloud

To list the worker pools in your project:

gcloud beta run worker-pools list

You can filter this list by properties of the worker pool definition, such as anassigned label.

View more details about a worker pool

Use the Google Cloud console, Google Cloud CLI, or YAML to see more detailsabout a worker pool:

console

  1. In the Google Cloud console, go to Cloud Run:

    Go to Cloud Run

  2. SelectWorker pools from the menu to display the available worker pools.

  3. Click the worker pool to display its details pane.

gcloud

To view details about a worker pool:

gcloudbetarunworker-poolsdescribeWORKER_POOL
ReplaceWORKER_POOL with the name of the worker pool.

You can use the--format flag to formatthe output. For example, to format the output as YAML:

gcloudbetarunworker-poolsdescribeWORKER_POOL--regionREGION--formatyaml

Replace:

  • WORKER_POOL with the name of the worker pool.
  • REGION with the Google Cloud region of the worker pool.

YAML

To view details about a worker pool, download itsYAML configuration:

gcloudbetarunworker-poolsdescribeWORKER_POOL--formatexport >workerpool.yaml

Disable an existing worker pool

Disabling a worker pool shuts down all instances for that worker pool. Todisable a worker pool, set scaling to zero:

console

  1. In the Google Cloud console, go to Cloud Run:

    Go to Cloud Run

  2. SelectWorker pools from the menu, then from the list of worker pools,click on the worker pool you want to disable.

  3. Click the pen icon at the right ofScaling: Manual (Instances: ) andchange the value to 0.

  4. ClickSave to update and disable the worker pool.

gcloud

gcloudbetarunworker-poolsupdateWORKER_POOL--instances=0

ReplaceWORKER_POOL with the name of your worker pool.

YAML

  1. If you are creating a new worker pool, skip this step.If you are updating an existing worker pool, download itsYAML configuration:

    gcloudbetarunworker-poolsdescribeWORKER_POOL--formatexport>workerpool.yaml

  2. Set scale to a value of0 to disable the worker pool.The following example contains the YAML configuration:

    apiVersion:run.googleapis.com/v1kind:WorkerPoolmetadata:name:WORKER_POOLannotations:run.googleapis.com/launch-stage:BETArun.googleapis.com/scalingMode:manualrun.googleapis.com/manualInstanceCount:`0`

    Replace the following:

    • WORKER_POOL: the name of your Cloud Run worker pool.

  3. Create or update the worker pool using the following command:

    gcloudbetarunworker-poolsreplaceworkerpool.yaml

Delete existing worker pools

The following considerations apply to deleting a worker pool:

  • Deleting a worker pool deletes all resources related to this worker pool, including allrevisions of this worker pool whether they are processing workloads or not.
  • 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 toDeleting images.
  • After you delete a worker pool, the worker pool remains visible in the Google Cloud CLIuntil the deletion is fully complete. However, you cannot update the worker pool.

  • Deleting a worker pool is permanent. There is no undo or restore.

console

  1. In the Google Cloud console, go to Cloud Run:

    Go to Cloud Run

  2. SelectWorker pools from the menu, then from the list of worker pools,select the worker pool you want to delete.

  3. ClickDelete.

gcloud

To delete a worker pool, use the command:

gcloud beta run worker-pools deleteWORKER_POOL --regionREGION

Replace:

  • WORKER_POOL with the name of your worker pool.
  • REGION with the Google Cloud region of the worker pool.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-18 UTC.