History

mattyw 3c44752931 cluster/juju: Updated the url for the getting started doc		2016-05-16 20:56:17 +01:00
..
actions	Fetch the guestbook action from master for now	2016-03-23 12:22:39 -04:00
reactive	Fix file headers for License bot	2016-03-16 14:25:26 -04:00
templates	fixing for jinja2 syntax	2016-03-16 14:25:26 -04:00
README.md	cluster/juju: Updated the url for the getting started doc	2016-05-16 20:56:17 +01:00
actions.yaml	Rework `cluster/juju` to reflect current work	2016-03-16 14:25:26 -04:00
config.yaml	Rework `cluster/juju` to reflect current work	2016-03-16 14:25:26 -04:00
icon.svg	Rework `cluster/juju` to reflect current work	2016-03-16 14:25:26 -04:00
layer.yaml	Rework `cluster/juju` to reflect current work	2016-03-16 14:25:26 -04:00
metadata.yaml	Rework `cluster/juju` to reflect current work	2016-03-16 14:25:26 -04:00

README.md

kubernetes

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

This charm is an encapsulation of the Running Kubernetes locally via Docker document. The released hyperkube image (gcr.io/google_containers/hyperkube) is currently pulled from a Google owned container repository repository. For this charm to work it will need access to the repository to docker pull the images.

This charm was built from other charm layers using the reactive framework. The layer:docker is the base layer. For more information please read Getting Started Developing charms

Deployment

The kubernetes charms require a relation to a distributed key value store (ETCD) which Kubernetes uses for persistent storage of all of its REST API objects.

juju deploy trusty/etcd
juju deploy local:trusty/kubernetes
juju add-relation kubernetes etcd

Configuration

For your convenience this charm supports some configuration options to set up a Kuberentes cluster that works in your environment:

version: Set the version of the Kubernetes containers to deploy. The default value is "v1.0.6". Changing the version causes the all the Kubernetes containers to be restarted.

cidr: Set the IP range for the Kubernetes cluster. eg: 10.1.0.0/16

State Events

While this charm is meant to be a top layer, it can be used to build other solutions. This charm sets or removes states from the reactive framework that other layers could react appropriately. The states that other layers would be interested in are as follows:

kubelet.available - The hyperkube container has been run with the kubelet service and configuration that started the apiserver, controller-manager and scheduler containers.

proxy.available - The hyperkube container has been run with the proxy service and configuration that handles Kubernetes networking.

kubectl.package.created - Indicates the availability of the kubectl application along with the configuration needed to contact the cluster securely. You will need to download the /home/ubuntu/kubectl_package.tar.gz from the kubernetes leader unit to your machine so you can control the cluster.

skydns.available - Indicates when the Domain Name System (DNS) for the cluster is operational.

Kubernetes information

Contact

Charm Author: Matthew Bruzek <Matthew.Bruzek@canonical.com>
Charm Contributor: Charles Butler <Charles.Butler@canonical.com>