Rancher Kubernetes Engine, an extremely simple, lightning fast Kubernetes installer that works everywhere.
Please check the releases page.
- Docker versions 1.12.6, 1.13.1, or 17.03 should be installed for Kubernetes 1.8.
- OpenSSH 7.0+ must be installed on each node for stream local forwarding to work.
- The SSH user used for node access must be a member of the
docker
group:
usermod -aG docker <user_name>
- Ports 6443, 2379, and 2380 should be opened between cluster nodes.
- Swap disabled on worker nodes.
Starting out with RKE? Check out this blog post.
Standing up a Kubernetes is as simple as creating a cluster.yml
configuration file and running the command:
./rke up --config cluster.yml
You can view full sample of cluster.yml here.
nodes:
- address: 1.1.1.1
user: ubuntu
role: [controlplane,worker,etcd]
services:
etcd:
image: quay.io/coreos/etcd:latest
kube-api:
image: rancher/k8s:v1.8.3-rancher2
kube-controller:
image: rancher/k8s:v1.8.3-rancher2
scheduler:
image: rancher/k8s:v1.8.3-rancher2
kubelet:
image: rancher/k8s:v1.8.3-rancher2
kubeproxy:
image: rancher/k8s:v1.8.3-rancher2
RKE supports the following network plugins:
- Flannel
- Calico
- Canal
- Weave
To use specific network plugin configure cluster.yml
to include:
network:
plugin: flannel
There are extra options that can be specified for each network plugin:
- flannel_image: Flannel daemon Docker image
- flannel_cni_image: Flannel CNI binary installer Docker image
- flannel_iface: Interface to use for inter-host communication
- calico_node_image: Calico Daemon Docker image
- calico_cni_image: Calico CNI binary installer Docker image
- calico_controllers_image: Calico Controller Docker image
- calicoctl_image: Calicoctl tool Docker image
- calico_cloud_provider: Cloud provider where Calico will operate, currently supported values are:
aws
,gce
- canal_node_image: Canal Node Docker image
- canal_cni_image: Canal CNI binary installer Docker image
- canal_flannel_image: Canal Flannel Docker image
- weave_node_image: Weave Node Docker image
- weave_cni_image: Weave CNI binary installer Docker image
RKE support pluggable addons on cluster bootstrap, user can specify the addon yaml in the cluster.yml file, and when running
rke up --config cluster.yml
RKE will deploy the addons yaml after the cluster starts, RKE first uploads this yaml file as a configmap in kubernetes cluster and then run a kubernetes job that mounts this config map and deploy the addons.
Note that RKE doesn't support yet removal of the addons, so once they are deployed the first time you can't change them using rke
To start using addons use addons:
option in the cluster.yml
file for example:
addons: |-
---
apiVersion: v1
kind: Pod
metadata:
name: my-nginx
namespace: default
spec:
containers:
- name: my-nginx
image: nginx
ports:
- containerPort: 80
Note that we are using |-
because the addons option is a multi line string option, where you can specify multiple yaml files and separate them with ---
RKE is HA ready, you can specify more than one controlplane host in the cluster.yml
file, and rke will deploy master components on all of them, the kubelets are configured to connect to 127.0.0.1:6443
by default which is the address of nginx-proxy
service that proxy requests to all master nodes.
to start an HA cluster, just specify more than one host with role controlplane
, and start the cluster normally.
RKE support adding/removing nodes for worker and controlplane hosts, in order to add additional nodes you will only need to update the cluster.yml
file with additional nodes and run rke up
with the same file.
To remove nodes just remove them from the hosts list in the cluster configuration file cluster.yml
, and re run rke up
command.
RKE support rke remove
command, the command does the following:
- Connect to each host and remove the kubernetes services deployed on it.
- Clean each host from the directories left by the services:
- /etc/kubernetes/ssl
- /var/lib/etcd
- /etc/cni
- /opt/cni
- /var/run/calico
Note that this command is irreversible and will destroy the kubernetes cluster entirely.
RKE support kubernetes cluster upgrade through changing the image version of services, in order to do that change the image option for each services, for example:
image: rancher/k8s:v1.8.2-rancher1
TO
image: rancher/k8s:v1.8.3-rancher2
And then run:
rke up --config cluster.yml
RKE will first look for the local kube_config_cluster.yml
and then tries to upgrade each service to the latest image.
Note that rollback isn't supported in RKE and may lead to unxpected results
RKE support command rke config
which generates a cluster config template for the user, to start using this command just write:
rke config --name mycluster.yml
RKE will ask some questions around the cluster file like number of the hosts, ips, ssh users, etc, --empty
option will generate an empty cluster.yml file, also if you just want to print on the screen and not save it in a file you can use --print
.
RKE will deploy Nginx controller by default, user can disable this by specifying none
to ingress provider
option in the cluster configuration, user also can specify list of options for nginx config map listed in this doc, for example:
ingress:
provider: nginx
options:
map-hash-bucket-size: "128"
ssl-protocols: SSLv2
By default, RKE will deploy ingress controller on all schedulable nodes (controlplane and workers), to specify only certain nodes for ingress controller to be deployed, user has to specify node_selector
for the ingress and the right label on the node, for example:
nodes:
- address: 1.1.1.1
role: [controlplane,worker,etcd]
user: root
labels:
app: ingress
ingress:
provider: nginx
node_selector:
app: ingress
RKE will deploy Nginx Ingress controller as a DaemonSet with hostnetwork: true
, so ports 80
, and 443
will be opened on each node where the controller is deployed.
RKE supports using external etcd instead of deploying etcd servers, to enable external etcd the following parameters should be populated:
services:
etcd:
path: /etcdcluster
external_urls:
- https://etcd-example.com:2379
ca_cert: |-
-----BEGIN CERTIFICATE-----
xxxxxxxxxx
-----END CERTIFICATE-----
cert: |-
-----BEGIN CERTIFICATE-----
xxxxxxxxxx
-----END CERTIFICATE-----
key: |-
-----BEGIN PRIVATE KEY-----
xxxxxxxxxx
-----END PRIVATE KEY-----
Note that RKE only supports connecting to TLS enabled etcd setup, user can enable multiple endpoints in the external_urls
field. RKE will not accept having external urls and nodes with etcd
role at the same time, user should only specify either etcd role for servers or external etcd but not both.
- Container volumes may have some issues in Atomic OS due to SELinux, most of volumes are mounted in rke with option
z
, however user still need to run the following commands before running rke:
# mkdir /opt/cni /etc/cni
# chcon -Rt svirt_sandbox_file_t /etc/cni
# chcon -Rt svirt_sandbox_file_t /opt/cni
- OpenSSH 6.4 shipped by default on Atomic CentOS which doesn't support SSH tunneling and therefore breaks rke, upgrading OpenSSH to the latest version supported by Atomic host will solve this problem:
# atomic host upgrade
- Atomic host doesn't come with docker group by default, you can change ownership of docker.sock to enable specific user to run rke:
# chown <user> /var/run/docker.sock
Copyright (c) 2017 Rancher Labs, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.