Configure CPU limits for worker pools

Console

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

   Go to Cloud Run

2. Select Worker poolsfrom the menu, and click Deploy containerto configure a new worker pool. If you are configuring an existing worker pool, click the worker pool, then click Edit and deploy new revision.

3. If you are configuring a new worker pool, fill out the initial worker pool page, then click Container(s), Volumes, Networking, Securityto expand the worker pools configuration page.

4. Click the Containertab.

   

   • Select the CPU limit from the CPU dropdown list.

5. Click Createor Deploy.

gcloud

You can update the CPU limits for a given worker pool by using the following command:

gcloud  
beta  
run  
worker-pools  
update  
 WORKER_POOL 
  
--cpu  
 CPU 

Replace

• WORKER_POOL with the name of your worker pool
• CPU with the CPU limit. Specify the value 1 , 2 , 4 , 6 , or 8 CPUs, following the requirements shown in the CPU and memory table.

You can also set CPU during deployment using the command:

gcloud  
beta  
run  
worker-pools  
deploy  
--image  
 IMAGE_URL 
  
--cpu  
 CPU 

Replace

• IMAGE_URL : a reference to the container image that contains the worker pool, such as us-docker.pkg.dev/cloudrun/container/worker-pool:latest .
• CPU with the value 1 , 2 , 4 , 6 , or 8 CPUs, following the requirements shown in the CPU and memory table.

YAML

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

   gcloud  
   beta  
   run  
   worker-pools  
   describe  
    WORKER_POOL 
     
   --format  
    export 
     
   >  
   workerpool.yaml

2. The following example contains the YAML configuration:

    apiVersion 
    : 
     
    run.googleapis.com/v1 
    kind 
    : 
     
    WorkerPool 
    metadata 
    : 
     
    name 
    : 
     
     WORKER_POOL 
    
     
    annotations 
    : 
     
    run.googleapis.com/launch-stage 
    : 
     
    BETA 
    spec 
    : 
     
    template 
    : 
     
    spec 
    : 
     
    containers 
    : 
     
    - 
     
    image 
    : 
     
     IMAGE_URL 
    
     
    resources 
    : 
     
    limits 
    : 
     
    cpu 
    : 
     
    ` 
     CPU 
    
   `

   Replace the following:

   • WORKER_POOL : the name of your Cloud Run worker pool.
   • IMAGE_URL : a reference to the container image that contains the worker pool, such as us-docker.pkg.dev/cloudrun/container/worker-pool:latest .
   • CPU : the CPU limit value. Specify the value 1 , 2 , 4 , 6 , or 8 CPUs, or for less than 1 CPU, specify a value from 0.08 to less than 1.00, in increments of 0.01. (See the table under Setting and updating CPU limits for required settings.)

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

   gcloud  
   beta  
   run  
   worker-pools  
   replace  
   workerpool.yaml

Terraform

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

  resource 
  
 "google_cloud_run_v2_worker_pool" 
  
 "default" 
  
 { 
  
 name 
  
 = 
  
 " WORKER_POOL 
" 
  
 location 
  
 = 
  
 " REGION 
" 
  
 launch_stage 
  
 = 
  
 "BETA" 
  
 template 
  
 { 
  
 containers 
  
 { 
  
 image 
  
 = 
  
 " IMAGE_URL 
" 
  
 resources 
  
 { 
  
 limits 
  
 = 
  
 { 
  
 cpu 
  
 = 
  
 " CPU 
" 
  
 } 
  
 } 
  
 } 
  
 } 
 } 
 

Replace:

• WORKER_POOL with the name of the worker pool.
• REGION with the Google Cloud region. For example, europe-west1.
• IMAGE_URL : a reference to the container image that contains the worker pool, such as us-docker.pkg.dev/cloudrun/container/worker-pool:latest
• CPU with the value 1 , 2 , 4 , 6 , or 8 CPUs, following the requirements shown in the CPU and memory table.