History

Jeff Lowdermilk 553f9f822b Add ga-beacon analytics to gendocs scripts hack/run-gendocs.sh puts ga-beacon analytics link into all md files, hack/verify-gendocs.sh verifies presence of link.		2015-05-15 18:56:38 -07:00
..
files	Removing unused scripts from km and kubernetes.	2015-04-30 09:27:51 +02:00
hooks	Changing hooks.py back to executable.	2015-05-14 16:51:55 -05:00
unit_tests	Updating /cluster to use v1beta 3 specs, and change a lot of polling to	2015-05-15 14:17:55 -07:00
.bzrignore	Adding the Juju charms to the cluster directory.	2015-04-17 17:21:37 -05:00
.gitignore	Adding the Juju charms to the cluster directory.	2015-04-17 17:21:37 -05:00
.vendor-rc	Adding the Juju charms to the cluster directory.	2015-04-17 17:21:37 -05:00
Makefile	Adding the Juju charms to the cluster directory.	2015-04-17 17:21:37 -05:00
README.md	Add ga-beacon analytics to gendocs scripts	2015-05-15 18:56:38 -07:00
copyright	Changing the copyright to the Google.	2015-04-22 16:41:03 -05:00
icon.svg	Adding the Juju charms to the cluster directory.	2015-04-17 17:21:37 -05:00
metadata.yaml	Adding the Juju charms to the cluster directory.	2015-04-17 17:21:37 -05:00
requirements.txt	Adding the Juju charms to the cluster directory.	2015-04-17 17:21:37 -05:00

README.md

Kubernetes Minion Charm

Kubernetes is an open source system for managing containerized applications across multiple hosts. Kubernetes uses Docker to package, instantiate and run containerized applications.

The Kubernetes Juju charms enable you to run Kubernetes on all the cloud platforms that Juju supports.

A Kubernetes deployment consists of several independent charms that can be scaled to meet your needs

Etcd

Etcd is a key value store for Kubernetes. All persistent master state is stored in etcd.

Flannel-docker

Flannel is a software defined networking component that provides individual subnets for each machine in the cluster.

Docker

Docker is an open platform for distributing applications for system administrators.

Kubernetes master

The controlling unit in a Kubernetes cluster is called the master. It is the main management contact point providing many management services for the worker nodes.

Kubernetes minion

The servers that perform the work are known as minions. Minions must be able to communicate with the master and run the workloads that are assigned to them.

Usage

Deploying the Development Focus

To deploy a Kubernetes environment in Juju :

juju deploy cs:~kubernetes/trusty/etcd
juju deploy cs:trusty/flannel-docker
juju deploy cs:trusty/docker
juju deploy local:trusty/kubernetes-master
juju deploy local:trusty/kubernetes

juju add-relation etcd flannel-docker
juju add-relation flannel-docker:network docker:network
juju add-relation flannel-docker:docker-host docker
juju add-relation etcd kubernetes
juju add-relation etcd kubernetes-master
juju add-relation kubernetes kubernetes-master

Deploying the recommended configuration

A bundle can be used to deploy Kubernetes onto any cloud it can be orchestrated directly in the Juju Graphical User Interface, when using juju quickstart:

juju quickstart https://raw.githubusercontent.com/whitmo/bundle-kubernetes/master/bundles.yaml

For more information on the recommended bundle deployment, see the Kubernetes bundle documentation

Post Deployment

To interact with the kubernetes environment, either build or download the kubectl binary (available in the releases binary tarball) and point it to the master with :

$ juju status kubernetes-master | grep public
public-address: 104.131.108.99
$ export KUBERNETES_MASTER="104.131.108.99"

Configuration

For you convenience this charm supports changing the version of kubernetes binaries. This can be done through the Juju GUI or on the command line:

juju set kubernetes version=”v0.10.0”

If the charm does not already contain the tar file with the desired architecture and version it will attempt to download the kubernetes binaries using the gsutil command.

Congratulations you know have deployed a Kubernetes environment! Use the kubectl to interact with the environment.