Rancher¶

Install¶

Docker¶

Rancher 2.x:

$ docker run -d --restart=unless-stopped -p 80:80 -p 443:443 rancher/rancher

https://github.com/rancher/rancher#quick-start

Minimum System¶

For install etcd and Control Plane on one node:

Ram: 2GB

CPU: 1 core

Vagrant¶

$ vagrant init ubuntu/xenial64
$ vim Vagrantfile
# Set ping able Network from host
    config.vm.network "private_network", ip: "192.168.33.10
# Set More memory
    config.vm.provider "virtualbox" do |vb|
      vb.memory = "4096"
    end
# vagrant reload
$ vagrant up --provider virtualbox
$ vagrant ssh
$ apt-get update
$ apt-get upgrade
$ curl https://releases.rancher.com/install-docker/1.12.sh | sh
$ sudo usermod -aG docker ubuntu

Now go to:

http://192.168.10.119:1010/env/1a5/infra/hosts/add?driver=custom

https://www.vagrantup.com/docs/virtualbox/configuration.html

Setting Up a Rancher¶

http://docs.rancher.com/rancher/v1.5/en/quick-start-guide/

https://github.com/infracloudio/rancher-vagrant-setup

Resiliency Planes¶

For production deployments, it is best practice that each plane runs on dedicated physical or virtual hosts. For development, multi-tenancy may be used to simplify management and reduce costs.

Data Plane

This plane is comprised of one or more etcd containers. Etcd is a distributed reliable key-value store which stores all Kubernetes state. This plane may be referred to as stateful, meaning the software comprising the plane maintains application state.

Orchestration Plane

This plane is comprised of stateless components that power our Kubernetes distribution.

Compute Plane

This plane is comprised of the Kubernetes pods.

http://docs.rancher.com/rancher/v1.5/en/kubernetes/resiliency-planes/

http://docs.rancher.com/rancher/v1.5/en/kubernetes/resiliency-planes/#separated-planes

http://docs.rancher.com/rancher/v1.5/en/kubernetes/resiliency-planes/#overlapping-planes

Host Requirements for Kubernetes¶

For overlapping planes setup:

At least 1 CPU, 2GB RAM. Resource requirements vary depending on workload.

For separated planes setup:

A minimum of five hosts is required for this deployment type.

Data Plane:: Add 3 or more hosts with 1 CPU, >=1.5GB RAM, >=20GB DISK. When adding the host, label these hosts with etcd=true.
Orchestration Plane:: Add 1 or more hosts with >=1 CPU and >=2GB RAM. When adding the host, label these hosts with orchestration=true. You can get away with 1 host, but you sacrifice high availability. In the event of this host failing, some K8s features such as the API, rescheduling pods in the event of failure, etc. will not occur until a new host is provisioned.
Compute Plane:: Add 1 or more hosts. When adding the host, label these hosts with compute=true.

http://docs.rancher.com/rancher/v1.5/en/kubernetes/#host-requirements-for-kubernetes

My result:

with etcd=true 222MB RAM

with orchestration=true 400MB RAM

with compute=true 400MB RAM

Backup Rancher server data¶

$ docker stop <container_name_of_original_server>
$ docker create --volumes-from <container_name_of_original_server> --name rancher-data rancher/server
$ docker export rancher-data > rancher-data.tar
$ docker run -d --volumes-from rancher-data --restart=unless-stopped -p 80:8080 rancher/server

$ docker cp <container_name_of_original_server>:/var/lib/mysql <path on host>