Setting Up Your Environment

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. Select or create a GCP project.

    Go to the project selector page

  3. Make sure that billing is enabled for your Google Cloud Platform project. Learn how to enable billing.

  4. Enable the Cloud Run API
  5. Install and initialize the Cloud SDK.
  6. Install the gcloud beta component:
    gcloud components install beta
  7. Update components:
    gcloud components update
  8. Optionally, set your platform and default Cloud Run region with the gcloud properties to avoid prompts from the command line:
    gcloud config set run/platform managed
    gcloud config set run/region REGION
    replacing REGION with the default region you want to use.
  9. Optionally, install Docker locally. If you do so, you must invoke the following gcloud commands to add the gcloud Docker credential helper:
    gcloud auth configure-docker
    gcloud components install docker-credential-gcr
    For more information about Docker credential helpers, see the documentation for the docker-credential-gcr project.

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.

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 GCP products that are used by your Cloud Run service. Using GCP products together across multiple locations can affect your service's latency as well as cost.

Cloud Run is available in the following regions:

  • asia-northeast1 (Tokyo)
  • europe-west1 (Belgium)
  • us-central1 (Iowa)
  • us-east1 (South Carolina)

If you already created a Cloud Run service, you can view the region in the Cloud Run dashboard in the GCP Console.

What's next

To learn how to build a container from code source, push to Container Registry, and deploy, see:

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Run Documentation