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 Services and click Deploy container to display the Create service form. Locate the Service scaling form.

3. If you are configuring an existing service, click the service to display its detail panel, then click the edit Edit service level scaling settings at 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 Create for a new service or Deploy for 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

• 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

• IMAGE_URL with 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 has the shape 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

   • 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 details panel.

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 revision to display the revision deployment form.

4. Click the Container tab.

5. Locate the Revision scaling section. 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

• 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

   • 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 details panel.

3. Click the Revisions tab.

4. In the details panel at the right, view the Revision max. instances setting listed under the Container tab.

gcloud

1. Use the following command:

   gcloud run services describe SERVICE

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