kubesnap

How to run

1. Prerequisites
2. Start work with Google Cloud Platform
3. Install kubesnap
4. Contributing
5. License
6. Acknowledgements

1. Prerequisites

• Kubernetes cluster - tested with Kubernetes on Google Cloud Environment (GCE)

2. Start work with Google Cloud Platform

a) Open Google Cloud Platform Console

• go to https://console.cloud.google.com/
• log in using your e-mail address
• follow the instruction how to create a Cloud Platform Console project

b) Select your project

• select your project from the drop-down menu in the top right corner

c) Switch to Compute Engine screen

• select Products & Services from GC Menu in the top left corner

  

• and then select Compute Engine from the drop-down list

  

d) Create an VM instance

• create a new VM instance

• set an unique name of a new instance

• choose a machine with 4 vCPUs (or more) and at least 15GB RAM

• select Ubuntu 16.04 with standard persistent disk with at least 100GB

  

e) Start GCE Virtual Machine

• select your VM and choose START option which is available on the top of screen

  

f) Open the VM terminal by click on SSH

• click on SSH to open the VM terminal (it will open as a new window)

g) Authorize access to Google Cloud Platform

• manage credentials for the Google Cloud SD. To do that, run the following command:

  gcloud auth login
  

  Answer Y to the question (see below) and follow the instructions:

  • copy the link in your browser and
  • authenticate with a service account which you use in Google Cloud Environment,
  • copy the verification code from browser window and enter it

  

• check if you are on credentialed accounts:

gcloud auth list

3. Install kubesnap

Clone kubesnap into your home directory:

git clone https://github.com/intelsdi-x/kubesnap

kubesnap supports automatic installation via script provision-kubesnap.sh

Go to kubesnap/tools:

cd kubesnap/tools

Building

• Build kubesnap:

./provision-kubesnap.sh

• Build Kubernetes:

./provision-kubesnap.sh --kubernetes build

Starting

• Start Kubernetes cluster:

./provision-kubesnap.sh --kubernetes start

4. Contributing

We love contributions!

There's more than one way to give back, from examples to blogs to code updates. See our recommended process in CONTRIBUTING.md.

And thank you! Your contribution, through code and participation, is incredibly important to us.

5. License

snap, along with this kubesnap, is an Open Source software released under the Apache 2.0 License.

6. Acknowledgements

• Author: Andrzej Kuriata