/k8s-docker-provisioner

Primary LanguageShell

Getting started with k8s-docker-provisioner

This guide will take you through the steps of deploying Kubernetes to Openstack using docker. The primary concept is described here: docker-multinode

This guide assumes you have a working OpenStack cluster.

Pre-Requisites

Install OpenStack CLI tools

  • heat >= 0.9.0
  • nova >= 3.2.0
 sudo pip install -U python-heatclient

 sudo pip install -U python-novaclient

Configure Openstack CLI tools

Please get your OpenStack credential and modify the variables in the following files:

  • config-default.sh Sets all parameters needed for heat template.
  • openrc-default.sh Sets environment variables for communicating to OpenStack. These are consumed by the cli tools (heat, nova).

Get kubectl

If you already have the kubectl, you can skip this step.

kubectl is a command-line program for interacting with the Kubernetes API. The following steps should be done from a local workstation to get kubectl. Download kubectl from the Kubernetes release artifact site with the curl tool.

The linux kubectl binary can be fetched with a command like:

$ curl -O https://storage.googleapis.com/kubernetes-release/release/v1.2.0/bin/linux/amd64/kubectl

Make kubectl visible in your system.

sudo cp kubectl /usr/local/bin

Prepare Openstack image

The provisioning works on any operating system that has a Docker >= 1.10 and Docker-bootstrap service installed. This service is used to run flannel network inside of Docker containers themselves.

If you want to build your own image you can use this project: k8s-nodeos-builder

You can download such a prepared image from here: Download image

Uncompress it and upload to your OpenStack.

curl -L https://github.com/FujitsuEnablingSoftwareTechnologyGmbH/k8s-nodeos-builder/releases/download/0.1/k8s_nodeOS.qcow2.xz -O
unxz k8s_nodeOS.qcow2.xz
source openrc-default.sh
glance image-create --name centos7-docker --disk-format qcow2 --container-format bare --file k8s_nodeOS.qcow2

Don't forget update IMAGE_ID variable in config-default.sh file.

Starting a cluster

Execute command:

./kube-up.sh

When your settings are correct you should see installation progress. Script checks if cluster is available as a final step.

... calling verify-prereqs
heat client installed
nova client installed
kubectl client installed
... calling kube-up
kube-up for provider openstack
[INFO] Execute commands to create Kubernetes cluster
[INFO] Key pair already exists
Stack not found: KubernetesStack
[INFO] Create stack KubernetesStack
+--------------------------------------+-----------------+--------------------+----------------------+--------------+
| id                                   | stack_name      | stack_status       | creation_time        | updated_time |
+--------------------------------------+-----------------+--------------------+----------------------+--------------+
| d5ac5664-4dd8-4643-ad89-f71401970892 | KubernetesStack | CREATE_IN_PROGRESS | 2016-04-19T08:23:33Z | None         |
+--------------------------------------+-----------------+--------------------+----------------------+--------------+
... calling validate-cluster
Cluster status CREATE_IN_PROGRESS
Cluster status CREATE_IN_PROGRESS
Cluster status CREATE_IN_PROGRESS
Cluster status CREATE_IN_PROGRESS
Cluster status CREATE_IN_PROGRESS
Cluster status CREATE_IN_PROGRESS
Cluster status CREATE_IN_PROGRESS
Cluster status CREATE_COMPLETE
cluster "heat-docker-kubernetes" set.
context "heat-docker-kubernetes" set.
switched to context "heat-docker-kubernetes".
Wrote config for heat-docker-kubernetes to /home/stack/.kube/config
... calling configure-kubectl
cluster "heat-docker-kubernetes" set.
context "heat-docker-kubernetes" set.
switched to context "heat-docker-kubernetes".
Wrote config for heat-docker-kubernetes to /home/stack/.kube/config
... checking nodes
NAME       STATUS    AGE
10.0.0.3   Ready     1m
10.0.0.4   Ready     20s