Skip to content

Latest commit

 

History

History
131 lines (90 loc) · 4.62 KB

docker-multinode.md

File metadata and controls

131 lines (90 loc) · 4.62 KB
Raw

WARNING WARNING WARNING WARNING WARNING

PLEASE NOTE: This document applies to the HEAD of the source tree

If you are using a released version of Kubernetes, you should refer to the docs that go with that version.

The latest release of this document can be found [here](http://releases.k8s.io/release-1.1/docs/getting-started-guides/docker-multinode.md).

Documentation for other releases can be found at releases.k8s.io.

Running Multi-Node Kubernetes Using Docker

Note: These instructions are somewhat significantly more advanced than the single node instructions. If you are interested in just starting to explore Kubernetes, we recommend that you start there.

Table of Contents

Prerequisites

The only thing you need is a machine with Docker 1.7.1 or higher

Overview

This guide will set up a 2-node Kubernetes cluster, consisting of a master node which hosts the API server and orchestrates work and a worker node which receives work from the master. You can repeat the process of adding worker nodes an arbitrary number of times to create larger clusters.

Here's a diagram of what the final result will look like: Kubernetes Single Node on Docker

Bootstrap Docker

This guide also uses a pattern of running two instances of the Docker daemon

  1. A bootstrap Docker instance which is used to start system daemons like flanneld and etcd
  2. A main Docker instance which is used for the Kubernetes infrastructure and user's scheduled containers

This pattern is necessary because the flannel daemon is responsible for setting up and managing the network that interconnects all of the Docker containers created by Kubernetes. To achieve this, it must run outside of the main Docker daemon. However, it is still useful to use containers for deployment and management, so we create a simpler bootstrap daemon to achieve this.

You can specify the version on every node before install:

export K8S_VERSION=<your_k8s_version (e.g. 1.1.3)>
export ETCD_VERSION=<your_etcd_version (e.g. 2.2.1)>
export FLANNEL_VERSION=<your_flannel_version (e.g. 0.5.5)>
export FLANNEL_IFACE=<flannel_interface (defaults to eth0)>

Otherwise, we'll use latest hyperkube image as default k8s version.

Master Node

The first step in the process is to initialize the master node.

The MASTER_IP step here is optional, it defaults to the first value of hostname -I. Clone the Kubernetes repo, and run master.sh on the master machine with root:

$ export MASTER_IP=<your_master_ip (e.g. 1.2.3.4)>
$ cd kubernetes/docs/getting-started-guides/docker-multinode/
$ ./master.sh

Master done!

See here for detailed instructions explanation.

Adding a worker node

Once your master is up and running you can add one or more workers on different machines.

Clone the Kubernetes repo, and run worker.sh on the worker machine with root:

$ export MASTER_IP=<your_master_ip (e.g. 1.2.3.4)>
$ cd kubernetes/docs/getting-started-guides/docker-multinode/
$ ./worker.sh

Worker done!

See here for detailed instructions explanation.

Deploy a DNS

See here for instructions.

Testing your cluster

Once your cluster has been created you can test it out

For more complete applications, please look in the examples directory

Analytics