iiriix/gcloud repository overview

⁠Google Cloud SDK Docker Image

⁠What is this?

A docker image based on Alpine Linux⁠ that includes Google Cloud SDK⁠. To keep it small and minimal, it only installs gcloud core components and kubectl by default, but you can customize it based on your needs.

⁠Use Cases

• It can be used in CI/CD deployment pipelines or in other automated build/deploy processes where you need gcloud or kubectl to deploy into Google Cloud Platform⁠ or Kubernetes⁠ clusters.

⁠Usage

Just execute:

  $ docker run -it iiriix/gcloud

⁠Mounting Configuration Directories

You can mount configuration files as a volume to skip the authenticate step.

• For gcloud:

  $ docker run --rm -it \
      -v ~/.config/gcloud:/root/.config/gcloud \
      iiriix/gcloud sh

• For kubectl:

  $ docker run --rm -it \
      -v ~/.config/gcloud:/root/.config/gcloud \
      -v ~/.kube:/root/.kube \
      iiriix/gcloud kubectl get pod

⁠Environment Variables

Set environment variables to the container to initialize and activate service account. Read more about Google Cloud Service Account⁠.

Here is the list of variables:

• CLOUDSDK_SERVICE_ACCOUNT: base64 encoded service key
• CLOUDSDK_SERVICE_ACCOUNT_FILE: Service key file path. Note that in addition to this variable, you still need to mount the key file as a volume.
• CLOUDSDK_PROJECT_NAME: Google Cloud project name
• CLOUDSDK_COMPUTE_ZONE: Zone for Compute and Container Engine
• CLOUDSDK_CLUSTER_NAME: Kubernetes cluster name (Container Engine)

  $ docker run --rm -it \
      -e "CLOUDSDK_SERVICE_ACCOUNT=$(base64 service-key.json)" \
      -e "CLOUDSDK_PROJECT_NAME=myproject" \
      -e "CLOUDSDK_COMPUTE_ZONE=europe-west1-b" \
      -e "CLOUDSDK_CLUSTER_NAME=mycluster" \
      iiriix/gcloud gcloud compute instances list

  $ docker run --rm -it \
      -v $(pwd)/service-key.json:/service-key.json \
      -e "CLOUDSDK_SERVICE_ACCOUNT_FILE=/service-key.json" \
      -e "CLOUDSDK_PROJECT_NAME=myproject" \
      -e "CLOUDSDK_COMPUTE_ZONE=europe-west1-b" \
      -e "CLOUDSDK_CLUSTER_NAME=mycluster" \
      iiriix/gcloud kubectl get deploy

⁠Docker Inside Docker

Mount docker socket into the container and run docker commands to build, push and etc.

  $ docker run --rm -it \
      -v /var/run/docker.sock:/var/run/docker.sock \
      iiriix/gcloud docker ps

⁠Running a Custom Script

The init script looks for a file named /code/ci.sh and runs it when the container starts. This can be useful to put whatever you want to run inside the container in this file and just mount it as /code/ci.sh in the container.

  $ docker run --rm -it \
      -v /your_script.sh:/code/ci.sh \
      iiriix/gcloud

⁠Real World Example

Mount your code as /code. The /code/ci.sh script will be run in the container to build, test, push and deploy your code on your infrastructure:

	$ docker run --rm -it \
      -v $(pwd)/service-key.json:/service-key.json \
      -v /var/run/docker.sock:/var/run/docker.sock \
      -v $(pwd)/sample-nginx:/code \
      -e "CLOUDSDK_SERVICE_ACCOUNT_FILE=/service-key.json" \
      -e "CLOUDSDK_PROJECT_NAME=myproject" \
      -e "CLOUDSDK_COMPUTE_ZONE=europe-west1-b" \
      -e "CLOUDSDK_CLUSTER_NAME=mycluster" \
      iiriix/gcloud

⁠Build

If you need to customize or build it yourself:

  $ git clone https://github.com/iiriix/gcloud.git
  $ cd gcloud
  $ docker build -t iiriix/gcloud:customized .
  $ docker run --rm -it iiriix/gcloud:customized

⁠ToDO

• Add support for environment variables to initialize the SDK and authenticate to GCP.
• Add docker package.
• Add support for running a custom script mounted in a predefined path.
• Support for different Cloud SDK versions.

⁠Feedback

For bug reports or suggestion, please open an issue on GitHub⁠.