cloud-sdk-docker

by GoogleCloudPlatform

GoogleCloudPlatform /cloud-sdk-docker

Docker image with all the components of the Google Cloud SDK

496 Stars 167 Forks Last release: Not found Apache License 2.0 359 Commits 129 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Google Cloud SDK Docker

This is Docker image for the Google Cloud SDK.

The

:latest
tag of this image is Debian-based and includes default command line tools of Google Cloud SDK (
gcloud
,
gsutil
,
bq
) as well as all additional components.

Repositories

The Google Cloud SDK Docker Image is hosted on both Container Registry and Docker Hub.

The full repository name for Container Registry is

gcr.io/google.com/cloudsdktool/cloud-sdk
.

The full repository name for Docker Hub is

google/cloud-sdk
.

Supported tags

  • :latest
    ,
    :VERSION
    : (large image with additional components pre-installed, Debian-based)
  • :slim
    ,
    :VERSION-slim
    : (smaller image with no components pre-installed, Debian-based)
  • :alpine
    ,
    :VERSION-alpine
    : (smallest image with no additional components installed, Alpine-based)
  • :debian_component_based
    ,
    :VERSION
    : (Similar to :latest but component installer based)

→ Check out Container Registry for available tags.

Docker Pulls Docker Build Status Docker Automated buil

Usage

To use this image, pull from Container Registry and then run the following command:

docker pull gcr.io/google.com/cloudsdktool/cloud-sdk:latest

(Note: To pull from Docker Hub, replace all instances of

gcr.io/google.com/cloudsdktool/cloud-sdk
with
google/cloud-sdk
.)

Verify the install

docker run gcr.io/google.com/cloudsdktool/cloud-sdk:latest gcloud version
Google Cloud SDK 159.0.0

or use a particular version number:

docker run gcr.io/google.com/cloudsdktool/cloud-sdk:260.0.0 gcloud version

You can authenticate

gcloud
with your user credentials by running
gcloud auth login
:
docker run -ti --name gcloud-config gcr.io/google.com/cloudsdktool/cloud-sdk gcloud auth login

If you need to authenticate any program that uses the Google Cloud APIs, you need to pass the

--update-adc
option:
docker run -ti --name gcloud-config gcr.io/google.com/cloudsdktool/cloud-sdk gcloud auth login --update-adc

Once you authenticate successfully, credentials are preserved in the volume of the

gcloud-config
container.

To list compute instances using these credentials, run the container with

--volumes-from
:
docker run --rm --volumes-from gcloud-config gcr.io/google.com/cloudsdktool/cloud-sdk gcloud compute instances list --project your_project
NAME        ZONE           MACHINE_TYPE   PREEMPTIBLE  INTERNAL_IP  EXTERNAL_IP      STATUS
instance-1  us-central1-a  n1-standard-1               10.240.0.2   8.34.219.29      RUNNING

:warning: Warning: The

gcloud-config
container now has a volume containing your Google Cloud credentials. Do not use
gcloud-config
volume in other containers.

Alternatively, you can use

auth/credential_file_override
property to set a path to a mounted service account and then the config to read that using
CLOUDSDK_CONFIG
environment variable.

for example,

mycloud
configuration below has the
auth/credential_file_override
already set and points towards a certificate file that will be present within the container as a separate volume mount.

See issue#152

$ docker run -ti -e CLOUDSDK_CONFIG=/config/mygcloud \
                 -v `pwd`/mygcloud:/config/mygcloud \
                 -v `pwd`:/certs  gcr.io/google.com/cloudsdktool/cloud-sdk:alpine /bin/bash

bash-4.4# gcloud config list [auth] credential_file_override = /certs/svc_account.json

bash-4.4# head -10 /certs/svc_account.json { "type": "service_account", "project_id": "project_id1", ....

bash-4.4# gcloud projects list PROJECT_ID NAME PROJECT_NUMBER project_id1 GCPAppID 1071284184432

Components Installed in Each Tag

| Component | :latest | :alpine | :slim | :debiancomponentbased | |:----------------------------------------------:|:-------:|:-------:|:-----:|:-----------------------:| | App Engine Go Extensions | x | | | x | | BigQuery Command Line Tool | x | x | x | x | | Cloud Bigtable Command Line Tool | x | | | x | | Cloud Bigtable Emulator | x | | | x | | Cloud Datalab Command Line Tool | x | | | x | | Cloud Datastore Emulator | x | | | x | | Cloud Pub/Sub Emulator | x | | | x | | Cloud Storage Command Line Tool | x | x | x | x | | gcloud Alpha Commands | x | | x | x | | gcloud Beta Commands | x | | x | x | | gcloud app Java Extensions | x | | | x | | gcloud app Python Extensions | x | | | x | | gcloud app Python Extensions (Extra Libraries) | x | | | x | | kubectl | x | | | x |

Installing additional components

By default, all gcloud components are installed on the default images (

gcr.io/google.com/cloudsdktool/cloud-sdk:latest
and
gcr.io/google.com/cloudsdktool/cloud-sdk:VERSION
).

The

gcr.io/google.com/cloudsdktool/cloud-sdk:slim
and
gcr.io/google.com/cloudsdktool/cloud-sdk:alpine
images do not contain additional components pre-installed. You can extend these images by following the instructions below:

Debian-based images

cd debian_slim/
docker build --build-arg CLOUD_SDK_VERSION=159.0.0 \
    --build-arg INSTALL_COMPONENTS="google-cloud-sdk-datastore-emulator" \
    -t my-cloud-sdk-docker:slim .

Alpine-based images

To install additional components for Alpine-based images, create a Dockerfile that uses the

cloud-sdk
image as the base image. For example, to add
kubectl
and
app-engine-java
components:
FROM gcr.io/google.com/cloudsdktool/cloud-sdk:alpine
RUN apk --update add openjdk7-jre
RUN gcloud components install app-engine-java kubectl

and run:

docker build -t my-cloud-sdk-docker:alpine .

Note that in this case, you have to install dependencies of additional components manually.

Installing different version of gcloud sdk:

docker build -t my-cloud-sdk-docker:alpine --build-arg CLOUD_SDK_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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.