Console

1. In the Google Cloud console, go to the Cloud RunServices page:

   Go to Cloud Run

2. If you are configuring a new service, clickDeploy container todisplay theCreate service form. Locate theService scaling form.

3. If you are configuring an existing service, click the service to displayits detail panel, then click theeditEdit service level scaling settings at the top right of the detail panel.

4. In the field labelledMaximum number of instances, specify therequired maximum number of container instances, using any integer valuefrom1 to themaximum limitpossible for your service. To disable the service-level maximum instances,clear any values you set in theMaximum number of instances field.

5. ClickCreate for a new service orDeploy for an existing service.

gcloud

You canupdate the maximum number of instancesof a given service by using the following command:

gcloudrunservicesupdateSERVICE--maxMAX-VALUE

Replace the following:

• SERVICE: the name of your service.
• MAX-VALUE: the required maximum number of containerinstances, using any integer value from1 to themaximum limit possible for your service. To disable service-levelmaximum instances, set this value to0.

You can also set the maximum number of instances duringdeployment using the following command:

gcloudrundeploy--imageIMAGE_URL--maxMAX-VALUE

Replace the following:

• IMAGE_URL: a reference to the container image, forexample,us-docker.pkg.dev/cloudrun/container/hello:latest. If you use Artifact Registry,therepositoryREPO_NAME mustalready be created. The URL follows the format ofLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
• MAX-VALUE: the required maximum number of containerinstances, using any integer value from1 to themaximum limit.

YAML

Any configuration change leads to thecreation of a new revision. Subsequent revisions will also automatically getthis 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 itsYAML configuration:

   gcloudrunservicesdescribeSERVICE--formatexport>service.yaml

2. Update therun.googleapis.com/maxScale: attribute:

   apiVersion:serving.knative.dev/v1kind:Servicemetadata:name:SERVICEannotations:run.googleapis.com/maxScale:'MAX-INSTANCE'

   Replace the following:

   • SERVICE: the name of your Cloud Run service
   • MAX-INSTANCE: the required maximum number of containerinstances, using any integer value from1 to themaximum limit possible for your service. To disable service-level maximum instances, set this value to0.

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

   gcloudrunservicesreplaceservice.yaml

Terraform

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

resource"google_cloud_run_v2_service""default"{name="SERVICE"location="REGION"scaling{max_instance_count=MAX_INSTANCE}template{containers{image="IMAGE_URL"}}}

Replace the following:

• SERVICE: the name of your Cloud Run service.
• REGION: the Google Cloud region—for example,europe-west1.
• MAX_INSTANCE: the required maximum number of containerinstances, using any integer value from1 to themaximum limit.
• IMAGE_URL: a reference to the container image, forexample,us-docker.pkg.dev/cloudrun/container/hello:latest. If you use Artifact Registry,therepositoryREPO_NAME mustalready be created. The URL follows the format ofLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG

Console

1. In the Google Cloud console, go to the Cloud RunServices page:

   Go to Cloud Run

2. Click that service to open itsService detailspanel.

3. View the current setting in the upper right of the service detailspanel, next toScaling.

gcloud

1. Use the following command:

   gcloudrunservicesdescribeSERVICE

2. Locate the value forScaling: 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 listto open that service's details.

3. ClickEdit and deploy new revision to display the revision deployment form.

4. Click theContainer tab.

5. Locate theRevision scaling section. In the field labelledMaximum number of instances, specify the maximum number of container instances.

6. ClickDeploy.

gcloud

You canupdate the maximum number of instancesof a given service by using the following command:

gcloudrunservicesupdateSERVICE--max-instancesMAX-VALUE

Replace the following:

• SERVICE: the name of your service.
• MAX-VALUE: the required maximum number of containerinstances, using any integer value from1 to themaximum limit.

YAML

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

   gcloudrunservicesdescribeSERVICE--formatexport>service.yaml

2. Update theautoscaling.knative.dev/maxScale: attribute:

   apiVersion:serving.knative.dev/v1kind:Servicemetadata:name:SERVICEspec: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 containerinstances, using any integer value from1 to themaximum limit.
   • REVISION with a new revision name or delete it (if present). If you supply a new revision name, itmust meet the following criteria:
     • Starts withSERVICE-
     • 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:

   gcloudrunservicesreplaceservice.yaml

Console

1. In the Google Cloud console, go to the Cloud RunServices page:

   Go to Cloud Run

2. Click that service to open itsService detailspanel.

3. Click theRevisions tab.

4. In the details panel at the right, view theRevision max. instances settinglisted under theContainer tab.

gcloud

1. Use the following command:

   gcloudrunservicesdescribeSERVICE

2. Locate the value forMax instances: in the returned configuration.