The Google Cloud CLI Docker image lets you pull a specific version of gcloud CLI as a Docker image from Artifact Registry and quickly execute Google Cloud CLI commands in an isolated, correctly configured container.

You can refer to the image’s documentation page for complete details.

Google Cloud CLI Docker

The Google Cloud CLI Docker image is the gcloud CLI installed on top of a Debian or Alpine image. The Google Cloud CLI Docker Images enable the usage of gcloud as well as its bundled components without having to manually install gcloud in your local machine.

What’s new / Important updates

May 21, 2025

[!WARNING]
We have removed the docker-buildx dependency from all
Google Cloud CLI Docker images to mitigate customers’ exposure to vulnerabilities
found in this component and its dependencies according to the following
timeline. If your workflows rely on docker-buildx, you will need to
pin to the respective Pin-To gcloud version or earlier.
Alternatively, you could build your own docker image and include
docker-buildx using a custom Dockerfile. Here are some examples:
Dockerfile Examples. For any questions or
concerns about the change, reach out to the
gcloud support team.

Update Timeline

Date	Removed in gcloud version	`Pin-to` gcloud version to continue using `docker-buildx`	`docker-buildx` removed from images
Apr 22, 2025	519.0.0	518.0.0	`:alpine` and `:debian_component_based`
May 20, 2025	523.0.0	522.0.0	`:slim` and `:latest`

Docker image options

There are six Google Cloud CLI Docker images, and all will install the
gcloud, gsutil and bq command-line tools. We recommend that you install
the :stable image for a minimal environment. You can also
use the stable image as the base image for your own deployments which gives you
the flexibility of installing only the components and packages that you need in
your image:

:stable, :VERSION-stable: Provides a gcloud installation
with gsutil and bq components. The image is built upon the latest
Google-Provided
Debian 12 base image. This image supports both linux/amd and linux/arm
platforms. To install specific gcloud versions, use
the :VERSION-stable tag.

If you want to use an Alpine-based image, you can install the following
image:

:alpine, :VERSION-alpine: Similar to stable but built upon the latest
Alpine 3.20
base image. This image supports both linux/amd and linux/arm platforms. To
install specific gcloud versions, use the :VERSION-alpine tag.

If you want images with additional
components or packages pre-installed,
you can install one of the following options:

:emulators, :VERSION-emulators: Similar to stable, with the
addition of all the emulator components. The image is build upon the latest
Google-Provided
Debian 12 base image and uses component manager to install the components. This
image supports both linux/amd and linux/arm platforms. To install specific
gcloud versions, use the :VERSION-emulators
tag.
:latest, :VERSION: Similar to stable, with additional components
(List of components installed in the image are listed
below) pre-installed. The image is build
upon the latest
Google-Provided
Debian 12 base image and uses deb packages to install the components. To install
specific gcloud versions, use the :VERSION
tag.
:slim, :VERSION-slim: Similar to stable but includes the additional
third party packages like curl, python3-crcmod, apt-transport-https,
lsb-release, openssh-client, git, make, and gnupg. This image is
built upon the latest
Google-Provided
Debian 12 base image. This image supports both linux/amd and linux/arm
platforms. To install specific gcloud versions, use
the :VERSION-slim tag.
:debian_component_based, :VERSION-debian_component_based: Similar to
stable, with additional components
(List of components installed in the image are listed
below) pre-installed. The image is build
upon the latest
Google-Provided
Debian 12 base image and uses component manager to install the components. This
image supports both linux/amd and linux/arm platforms. To install specific
gcloud versions, use the :VERSION-debian_component_based tag.

Installing a Docker image

The Docker image is hosted on
Artifact Registry
with the following repository name:
gcr.io/google.com/cloudsdktool/google-cloud-cli. The images are also available
using the us.gcr.io, eu.gcr.io, and asia.gcr.io repositories.

To use the image of the stable Google Cloud CLI release,
gcr.io/google.com/cloudsdktool/google-cloud-cli:stable,
pull it from Artifact Registry
by running the following command:
```
docker pull gcr.io/google.com/cloudsdktool/google-cloud-cli:489.0.0-stable
```

Verify the installation by running:

docker run --rm gcr.io/google.com/cloudsdktool/google-cloud-cli:489.0.0-stable gcloud version

If you have used the floating :stable tag (which always point to the latest
release), verify the installation by running the following command:

docker run --rm gcr.io/google.com/cloudsdktool/google-cloud-cli:stable gcloud version

Legacy image (Google App Engine based)

The original image in this repository was based off of

FROM gcr.io/google_appengine/base

The full Dockerfile for that can be found
here for archival as well as in image tag
google/cloud-sdk-docker:legacy

Cloud SDK Release Tracking

You can also follow the Cloud SDK Release schedule here

https://groups.google.com/forum/#!forum/google-cloud-sdk-announce