google/cloud-sdk repository overview

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

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. 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. 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. 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 here⁠) 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. 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 here⁠) pre-installed. The image is build upon the latest Google-Provided⁠ Debian 12 base image and uses component manager to install the components. To install specific gcloud versions, use the :VERSION-debian_component_based tag.

→ Check out Docker Hub⁠ for available tags.

⁠Installing a Docker image

The gcloud CLI Docker image is hosted on Docker Hub Repository⁠ with the following repository name: google/cloud-sdk. The images are also available in Artifact Registry⁠.

• To use the image of the stable Google Cloud CLI release from this repository google/cloud-sdk:stable, pull it from Docker Hub Repository⁠ by running the following command:

  docker pull google/cloud-sdk:489.0.0-stable
  

  Copy

• Verify the installation by running:

  docker run --rm google/cloud-sdk:489.0.0-stable gcloud version
  

  Copy

  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 google/cloud-sdk:stable gcloud version
  

  Copy

⁠Cloud SDK Release Tracking

You can also follow the Cloud SDK Release schedule here

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