Set maximum instances for services

Console

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

   Go to Cloud Run

2. If you are configuring a new service, select Servicesand click Deploy containerto display the Create serviceform. Locate the Service scalingform.

3. If you are configuring an existing service, click the service to display its detail panel, then click the edit Edit service level scaling settingsat the top right of the detail panel.

4. In the field labelled Maximum number of instances, specify the required maximum number of container instances, using any integer value from 1 to the maximum limit possible for your service.

5. Click Createfor a new service or Deployfor an existing service.

gcloud

You can update the maximum number of instances of a given service by using the following command:

gcloud  
beta  
run  
services  
update  
 SERVICE 
  
--max  
 MAX-VALUE 

Replace the following:

• SERVICE : the name of your service.
• MAX-VALUE : the required maximum number of container instances, using any integer value from 1 to the maximum limit possible for your service.

You can also set the maximum number of instances during deployment using the command:

gcloud  
beta  
run  
deploy  
--image  
 IMAGE_URL 
  
--max  
 MAX-VALUE 

Replace the following:

• IMAGE_URL : a reference to the container image, for example, us-docker.pkg.dev/cloudrun/container/hello:latest . If you use Artifact Registry, the repository REPO_NAME must already be created. The URL follows the format of LOCATION -docker.pkg.dev/ PROJECT_ID / REPO_NAME / PATH : TAG .
• MAX-VALUE : the required maximum number of container instances, using any integer value from 1 to the maximum limit .

YAML

Any configuration change leads to the creation of a new revision. Subsequent revisions will also automatically get this configuration setting unless you make explicit updates to change it.

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

   gcloud  
   run  
   services  
   describe  
    SERVICE 
     
   --format  
    export 
     
   >  
   service.yaml

2. Update the run.googleapis.com/maxScale: attribute:

    apiVersion 
    : 
     
    serving.knative.dev/v1 
    kind 
    : 
     
    Service 
    metadata 
    : 
     
    name 
    : 
     
     SERVICE 
    
     
    annotations 
    : 
     
    run.googleapis.com/launch-stage 
    : 
     
    BETA 
     
    run.googleapis.com/maxScale 
    : 
     
    ' MAX-INSTANCE 
   ' 
   

   Replace the following:

   • SERVICE : the name of your Cloud Run service
   • MAX-INSTANCE : the required maximum number of container instances, using any integer value from 1 to the maximum limit possible for your service.

3. Create or update the service using the following command:

   gcloud  
   run  
   services  
   replace  
   service.yaml

Console

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

   Go to Cloud Run

2. Click that service to open its Service detailspanel.

3. View the current setting in the upper right of the service details panel, next to Scaling.

gcloud

1. Use the following command:

   gcloud  
   run  
   services  
   describe  
    SERVICE 
   

2. Locate the value for Scaling: Auto (Min: MIN_VALUE , Max: MAX_VALUE )in the returned configuration.

Console

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

   Go to Cloud Run

2. Find and click the service you want to update in the services list to open that service's details.

3. Click Edit and deploy new revisionto display the revision deployment form.

4. Click the Containertab.

5. Locate the Revision scalingsection. In the field labelled Maximum number of instances , specify the maximum number of container instances.

6. Click Deploy.

gcloud

You can update the maximum number of instances of a given service by using the following command:

gcloud  
beta  
run  
services  
update  
 SERVICE 
  
--max-instances  
 MAX-VALUE 

Replace the following:

• SERVICE : the name of your service.
• MAX-VALUE : the required maximum number of container instances, using any integer value from 1 to the maximum limit .

YAML

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

   gcloud  
   run  
   services  
   describe  
    SERVICE 
     
   --format  
    export 
     
   >  
   service.yaml

2. Update the autoscaling.knative.dev/maxScale: attribute:

    apiVersion 
    : 
     
    serving.knative.dev/v1 
    kind 
    : 
     
    Service 
    metadata 
    : 
     
    name 
    : 
     
     SERVICE 
    
     
    annotations 
    : 
     
    run.googleapis.com/launch-stage 
    : 
     
    BETA 
    spec 
    : 
     
    template 
    : 
     
    metadata 
    : 
     
    annotations 
    : 
     
    autoscaling.knative.dev/maxScale 
    : 
     
    ' MAX-INSTANCE 
   ' 
     
    name 
    : 
     
     REVISION 
    
   

   Replace the following:

   • SERVICE : the name of your Cloud Run service
   • MAX-INSTANCE : the required maximum number of container instances, using any integer value from 1 to the maximum limit .
   • REVISION with a new revision name or delete it (if present). If you supply a new revision name, it must meet the following criteria:
     • Starts with SERVICE -
     • Contains only lowercase letters, numbers and -
     • Does not end with a -
     • Does not exceed 63 characters

3. Create or update the service using the following command:

   gcloud  
   run  
   services  
   replace  
   service.yaml

Console

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

   Go to Cloud Run

2. Click that service to open its Service detailspanel.

3. Click the Revisionstab.

4. In the details panel at the right, view the Revision max. instancessetting listed under the Containertab.

gcloud

1. Use the following command:

   gcloud  
   run  
   services  
   describe  
    SERVICE 
   

2. Locate the value for Max instances:in the returned configuration.