The gcr.io/cloud-builders/gcloud image is maintained by the Cloud Build team, but it may not support the most recent versions of gcloud. We also do not provide historical pinned versions of gcloud nor support across multiple platforms.

The Cloud SDK team maintains a cloud-sdk image that supports multiple tagged versions of Cloud SDK across multiple platforms. Please visit https://github.com/GoogleCloudPlatform/cloud-sdk-docker for details.

Suggested alternative images include:

gcr.io/google.com/cloudsdktool/cloud-sdk
gcr.io/google.com/cloudsdktool/cloud-sdk:alpine
gcr.io/google.com/cloudsdktool/cloud-sdk:debian_component_based
gcr.io/google.com/cloudsdktool/cloud-sdk:slim
google/cloud-sdk
google/cloud-sdk:alpine
google/cloud-sdk:debian_component_based
google/cloud-sdk:slim

Please note that the gcloud entrypoint must be specified if you are using these images.

When executed in the Cloud Build environment, commands are executed with credentials of the builder service account for the build project.

To migrate to the Cloud SDK team's official image, please make the following changes to your cloudbuild.yaml:

- name: 'gcr.io/cloud-builders/gcloud'
+ name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
+ entrypoint: 'gcloud'

The following examples demonstrate build requests that use gcloud.

This cloudbuild.yaml invokes gcloud source repos clone to clone the default Cloud Source Repository.

steps:
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  args: ['gcloud', 'source', 'repos', 'clone', 'default']

There are two variants of the gcloud builder in this repository:

• gcloud installs all optional gcloud components, and is much larger.
• gcloud-slim installs only the gcloud CLI and no components, and is smaller.