Turbulence

Tools to help you connect to Google Cloud pods.

Rationale

You can point you web browser to https://console.cloud.google.com and click your way to your cloud-deployed servers. You've probably done that before you've contrived the arguably particular commands (providing you installed Python, the Google Cloud SDK and kubectl on your own computer).

If you wanted something simpler than that, just something to get you to the command prompt you're otherwise used to, then this may help.

Usage

Prerequisites

• Docker & Docker Compose

Invocation

make

This will:

1. download and install the Google Cloud SDK into a Docker container, so you need not install it
2. build the application container, so you don't need Ruby or a local installation
3. authenticate with Google Cloud, so you can access your GCloud stuff
4. show your GCloud projects, so you can pick the one you want
5. show the K8S clusters in that project, so you can pick the one you want
6. show the K8S namespaces in that cluster, so you can pick the one you want
7. show the K8S pods in that cluster, so you can pick the one you want
8. show the K8S containers in that pod, so you can pick the one you want
9. connect to your container, using bash, so you can do what you wanted to do.

Information entered at each stage will be stored for the next time, up to the pods, though you can start afresh too.

Architecture

Clean-Up

make clean

This will:

1. stop any currently-running instances
2. remove the instances
3. remove cached data, e.g. Google auth tokens, last project used

Changes to the Google APIs may require the Google SDK image to be updated. This can be achieved by:

make vacuum

This will:

0. all steps in make clean
1. remove the Google SDK image.

The make command will then download the latest Google SDK image.