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.
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.
There are six Google Cloud Docker images. We recommend that you install the following stable image:
:stable, :VERSION-stable: Default, Smallest (Debian-based) image with a
standard gcloud installation.If you want to use an Alpine-based image, you can install the following image:
:alpine, :VERSION-alpine: Smaller (Alpine-based) image with no additional
components installed. This image supports linux/arm.If you want images with additional packages or gcloud components pre-installed, you can install one of the following options:
:emulators, :VERSION-emulators: Smaller (Debian-based) image with emulator
components pre-installed.:latest, :VERSION: Large (Debian-based) image with additional components
pre-installed.:slim, :VERSION-slim: Smaller (Debian-based) image with no components
pre-installed.:debian_component_based, :VERSION-debian_component_based: Large (Debian-based)
image with additional components pre-installed. As opposed to :latest which
used deb packages, this image uses the component manager to install components.
This image supports linux/arm.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-stableVerify the installation by running:
docker run --rm gcr.io/google.com/cloudsdktool/google-cloud-cli:489.0.0-stable gcloud versionIf 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 versionThe 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
You can also follow the Cloud SDK Release schedule here