Configuring your Cloud Run environment lets you set up the Google Cloud CLI and specify default properties such as your target project and region. Establishing configuration defaults ensures consistent deployments and prevents repetitive command-line prompts when managing your services. 1. [Enable the Cloud Run Admin API](http://console.cloud.google.com/apis/library/run.googleapis.com) 2. [Install and initialize](https://docs.cloud.google.com/sdk/docs) the gcloud CLI. 3. Update components: ```bash gcloud components update ``` 4. Optionally, set your platform and default Cloud Run region with the gcloud properties to avoid prompts from the command line: ``` gcloud config set run/region REGION ``` replacing REGION with the default [region](https://docs.cloud.google.com/run/docs/setup#before-you-begin) you want to use. 5. Optionally, [install Docker](https://docs.docker.com/install/) to build [Docker containers locally](https://docs.cloud.google.com/run/docs/building/containers#building_using_a_dockerfile). You can configure Docker to get access to Artifact Registry using the [gcloud CLI credential helper](https://docs.cloud.google.com/artifact-registry/docs/docker/authentication#gcloud-helper): ```bash gcloud auth configure-docker LOCATION-docker.pkg.dev ``` Replace `LOCATION` with the region name of your container repository, for example, `us-west2`. ### Cloud Run regions
Cloud Run is regional, which means the infrastructure that runs your Cloud Run services is located in a specific region and is managed by Google to be redundantly available across [all the zones within that region](https://docs.cloud.google.com/docs/geography-and-regions).
Meeting your latency, availability, or durability requirements are primary factors for selecting the region where your Cloud Run services are run. You can generally select the region nearest to your users but you should consider the location of the [other Google Cloud products](https://cloud.google.com/about/locations/#locations) that are used by your Cloud Run service. Using Google Cloud products together across multiple locations can affect your service's latency as well as cost. Cloud Run is available in the following regions: #### Subject to [Tier 1 pricing](https://cloud.google.com/run/pricing#tables) - `asia-east1` (Taiwan) - `asia-northeast1` (Tokyo) - `asia-northeast2` (Osaka) - `asia-south1` (Mumbai, India) - `asia-southeast3 ` (Bangkok) - `europe-north1` (Finland) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `europe-north2` (Stockholm) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `europe-southwest1` (Madrid) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `europe-west1` (Belgium) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `europe-west4` (Netherlands) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `europe-west8` (Milan) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `europe-west9` (Paris) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `me-west1` (Tel Aviv) - `northamerica-south1` (Mexico) - `us-central1` (Iowa) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `us-east1` (South Carolina) - `us-east4` (Northern Virginia) - `us-east5` (Columbus) - `us-south1` (Dallas) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `us-west1` (Oregon) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) #### Subject to [Tier 2 pricing](https://cloud.google.com/run/pricing#tables) - `africa-south1` (Johannesburg) - `asia-east2` (Hong Kong) - `asia-northeast3` (Seoul, South Korea) - `asia-southeast1` (Singapore) - `asia-southeast2 ` (Jakarta) - `asia-south2` (Delhi, India) - `australia-southeast1` (Sydney) - `australia-southeast2` (Melbourne) - `europe-central2` (Warsaw, Poland) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `europe-west10` (Berlin) - `europe-west12` (Turin) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `europe-west2` (London, UK) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `europe-west3` (Frankfurt, Germany) - `europe-west6` (Zurich, Switzerland) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `me-central1` (Doha) - `me-central2` (Dammam) - `northamerica-northeast1` (Montreal) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `northamerica-northeast2` (Toronto) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `southamerica-east1` (Sao Paulo, Brazil) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `southamerica-west1` (Santiago, Chile) ![leaf icon](https://cloud.google.com/sustainability/region-carbon/gleaf.svg) [Low CO~2~](https://cloud.google.com/sustainability/region-carbon#region-picker) - `us-west2` (Los Angeles) - `us-west3` (Salt Lake City) - `us-west4` (Las Vegas) If you already created a Cloud Run service, you can view the region in the Cloud Run dashboard in the [Google Cloud console](https://console.cloud.google.com/run). ## Optional: Develop a new service using Cloud Code tools Instead of using the Google Cloud console or the Google Cloud CLI to create a new service, you can use the following Cloud Code tools: - [Intellij](https://docs.cloud.google.com/code/docs/intellij/creating-a-cloud-run-app) - [VSCode](https://docs.cloud.google.com/code/docs/vscode/creating-a-cloud-run-app) - [Cloud Shell](https://docs.cloud.google.com/code/docs/shell/creating-a-cloud-run-app) ## What's next To learn how to build a container from code source, push to Artifact Registry, and deploy, see: - [Quickstart: Build and Deploy](https://docs.cloud.google.com/run/docs/quickstarts#build-and-deploy-a-web-service) - [Create and manage instances](https://docs.cloud.google.com/run/docs/create-instances) - [Developing your service](https://docs.cloud.google.com/run/docs/developing) - [Building containers](https://docs.cloud.google.com/run/docs/building/containers)