Console

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

   Go to Cloud Run

2. If you are configuring a new worker pool, selectWorker pools from the menu, andclickDeploy container. If you areconfiguring an existing worker pool, click the worker pool to display itsdetail pane, then click the pen icon next toScaling at the top rightof the detail panel.

3. Locate theScaling form (for a new worker pool) or theEdit scaling form for an existing worker pool.

   

4. In the field labelledNumber of instances, specify the number of container instances for the service.

5. Finish the specification.

6. ClickCreate for a new worker pool orSave for an existing worker pool.

gcloud

To specify scaling for a new worker pool, use thedeploycommand:

gcloudbetarunworker-poolsdeployWORKER_POOL\--instances=INSTANCE_COUNT\--imageIMAGE_URL

Replace the following:

• WORKER_POOL: the name of your worker pool.
• INSTANCE_COUNT: the number of instances for the worker pool.This sets the worker pool to manual scaling. Specify a value of0 to disablethe worker pool.
• IMAGE_URL: a reference to the container image thatcontains the worker pool, such asus-docker.pkg.dev/cloudrun/container/worker-pool:latest.

Specify scaling for an existing worker pool by using the followingupdate command:

gcloudbetarunworker-poolsupdateWORKER_POOL\--instances=INSTANCE_COUNT

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. The following example contains the YAML configuration:

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

   Replace the following:

   • WORKER_POOL: the name of your Cloud Run worker pool.
   • INSTANCE_COUNT: the number of instances you are manuallyscaling for the worker pool. Specify a value of0 to disable theworker pool.

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

   gcloudbetarunworker-poolsreplaceworkerpool.yaml

Terraform

To learn how to apply or remove a Terraform configuration, seeBasic Terraform commands.

resource"google_cloud_run_v2_worker_pool""default"{name="WORKER_POOL"location="REGION"launch_stage="BETA"template{containers{image="IMAGE_URL"}}scaling{scaling_mode="MANUAL"manual_instance_count="INSTANCE_COUNT"}}

Replace the following:

• WORKER_POOL: the name of the worker pool.
• REGION: the Google Cloud region—for example,europe-west1.
• IMAGE_URL: a reference to the container image thatcontains the worker pool, such asus-docker.pkg.dev/cloudrun/container/worker-pool:latest.
• INSTANCE_COUNT: the number of instances for the worker pool.This sets the worker pool to manual scaling. Specify a value of0 todisable the worker pool.

REST API

To update the number of instances for a given worker pool, send aPATCHHTTP request to the Cloud Run Admin APIworkerPools endpoint.

For example, usingcurl:

curl-H"Content-Type: application/json"\-H"Authorization: BearerACCESS_TOKEN"\-XPATCH\-d'{"scaling":{"manualInstanceCount":INSTANCE_COUNT }}'\https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL?update_mask=scaling.manualInstanceCount

Replace the following:

• ACCESS_TOKEN: a valid access token for an account thathas theIAM permissions to update a worker pool.For example, if you are logged intogcloud, you can retrieve anaccess token usinggcloud auth print-access-token.From within a Cloud Run container instance, you can retrievean access token using thecontainer instance metadata server.
• INSTANCE_COUNT: the number of instances for the worker pool.
• PROJECT_ID: the Google Cloud project ID.
• REGION: the Google Cloud region that the worker pool isdeployed in.
• WORKER_POOL: the name of the worker pool.