簡要說明:
RKE (Rancher Kubernetes Engine)是RancherLabs提供的一個工具,可以在裸機、虛擬機、公私有雲上快速安裝Kubernetes集群。整個集群的部署只需要一個命令、一個配置文件,解決了如何輕松部署Kubernetes的問題。
盡管Rancher提供了免費的視頻培訓(見后面的參考鏈接),但用戶在使用RKE時,還是會遇到了很多報錯信息,無法安裝成功,這主要是因為一些基本的前置條件沒有滿足。
為了用戶使用RKE部署Kubernetes更順利,有必要梳理一下,把部署要點整理出來,讓使用RKE的用戶少走彎路。
部署要點:
系統版本:
建議使用Ubuntu 16.04.3 LTS版本,如果是CentOS7,建議7.3以上版本;
Docker版本:
RKE在Github上的readme中已有說明,Kubernetes1.8需要Docker 1.12.6、1.13.1、17.03,Kubernetes1.8不支持更高版本的Docker;
主機名:
如果是克隆的系統一定要修改主機名,hostname主機名必須不同!
主機文件:
/etc/hosts要配置正確,一定要有127.0.0.1 localhost 這一項。Hosts文件中包含所有主機節點的IP和名稱列表。使用vi進行編輯,不能使用中文全角的空格;
SELinux:
必須關閉!Ubuntu 16.04默認未安裝,無需設置。CentOS7下可修改配置文件/etc/sysconfig/selinux,設置SELINUX=disabled ,重啟后永久關閉。
IPV4轉發:
必須開啟!Ubuntu 16.04下默認已啟用,無需設置。CentOS7 下可編輯配置文件/etc/sysctl.conf,設置啟用轉發,
net.ipv4.ip_forward = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.bridge.bridge-nf-call-iptables = 1
執行sudo sysctl -p 立刻生效。
防火牆:
開放集群主機節點之間6443、2379、2380端口,如果是剛開始試用,可以先關閉防火牆;Ubuntu默認未啟用UFW防火牆,無需設置。也可手工關閉:sudo ufw disable
禁用SWAP:
一定要禁用swap,否則kubelet組件無法運行,永久禁用swap可以直接修改/etc/fstab文件,注釋掉swap項。swapoff -a 只是臨時禁用,下次關機重啟又恢復原樣;
啟用Cgroup:
修改配置文件/etc/default/grub,啟用cgroup內存限額功能,配置兩個參數:
GRUB_CMDLINE_LINUX_DEFAULT="cgroup_enable=memory swapaccount=1"
GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1"
注意:要執行sudo update-grub 更新grub,然后重啟系統后生效。
SSH免密登錄:
RKE通過SSH tunnel進行安裝部署,需要事先建立RKE到各節點的SSH免密登錄。如果集群中有5個節點,需要在RKE機器上執行1遍秘鑰生成命令ssh-keygen +5次公鑰分發命令ssh-copy-id user1@節點IP。如果執行RKE的本機也要加入到K8S集群中,也要使用ssh-copy-id user1@本機IP,將公鑰分發到本機,對本機執行ssh免密配置,否則也會報錯。免密配置方法:http://blog.csdn.net/csdn_duomaomao/article/details/79164073 。
RKE部署用戶:
1、RKE部署用戶是cluster.yml配置文件中的用戶,也就是上述能ssh免密登錄到其他機器的用戶;
2、CentOS7不能用root用戶,Ubuntu既可用root也可用普通用戶;
3、如果使用普通用戶進行RKE安裝,要將普通用戶(如user01)加入到docker組,命令:sudo usermod -aG docker user01 注意:重啟系統以后才能生效,只重啟Docker服務是不行的!重啟后,user01用戶也可以直接使用docker run命令。
4、在Ubuntu上使用apt安裝完docker后,會自動創建docker用戶組,無需手工創建docker組,只需要將部署RKE的用戶(如user01)加入到docker組即可,查看是否存在docker組、以及user01用戶是否在docker組中,可以直接查看/etc/group文件;
*5、如果Ubuntu使用root用戶進行RKE安裝,需要配置sshd服務,修改配置文件/etc/ssh/sshd_config,將PermitRootLogin prohibit-password 改為PermitRootLogin yes ,允許root遠程ssh登錄;取消注釋#AuthorizedKeysFile %h/.ssh/authorized_keys ,允許記錄授權秘鑰文件;
關鍵截圖:
01-創建user01用戶,將user01加入到docker組中
02-修改GRUB配置文件,啟用cgroup內存限額功能
03-修改etc下fstab文件,永久禁用swap
04-ubuntu下如果使用root用戶進行安裝,需要修改ssh配置,允許root遠程登錄
05-RKE安裝部署過程1
06-RKE安裝部署過程2
07-RKE安裝部署過程3
01-創建user01用戶,將user01加入到docker組中
02-修改GRUB配置文件,啟用cgroup內存限額功能
03-修改etc下fstab文件,永久禁用swap
04-ubuntu下如果使用root用戶進行安裝,需要修改ssh配置,允許root遠程登錄
05-RKE安裝部署過程1
06-RKE安裝部署過程2
07-RKE安裝部署過程3
參考配置文件:
一個可用的cluster.yml配置文件:
---
auth:
strategy: x509
options:
foo: bar
# supported plugins are:
# flannel
# calico
# canal
# weave
#
# If you are using calico on AWS, use the network plugin config option:
# 'cloud_provider: aws'
network:
plugin: flannel
options:
flannel_image: registry.cn-shenzhen.aliyuncs.com/rancher_cn/flannel
flannel_cni_image: registry.cn-shenzhen.aliyuncs.com/rancher_cn/flannel-cni
nodes:
- address: 192.168.3.161
user: user01
role: [controlplane, etcd]
ssh_key_path: ~/.ssh/id_rsa
- address: 192.168.3.162
user: user01
role: [worker]
ssh_key_path: ~/.ssh/id_rsa
- address: 192.168.3.163
user: user01
role: [worker]
ssh_key_path: ~/.ssh/id_rsa
services:
etcd:
image: registry.cn-shenzhen.aliyuncs.com/rancher_cn/etcd:latest
kube-api:
image: rancher/k8s:v1.8.3-rancher2
service_cluster_ip_range: 10.233.0.0/18
pod_security_policy: false
extra_args:
v: 4
kube-controller:
image: rancher/k8s:v1.8.3-rancher2
cluster_cidr: 10.233.64.0/18
service_cluster_ip_range: 10.233.0.0/18
scheduler:
image: rancher/k8s:v1.8.3-rancher2
kubelet:
image: rancher/k8s:v1.8.3-rancher2
cluster_domain: cluster.local
cluster_dns_server: 10.233.0.3
infra_container_image: registry.cn-shenzhen.aliyuncs.com/rancher_cn/pause-amd64:3.0
command: --fail-swap-on=false
kubeproxy:
image: rancher/k8s:v1.8.3-rancher2
system_images:
alpine: alpine:latest
nginx_proxy: rancher/rke-nginx-proxy:0.1.0
cert_downloader: rancher/rke-cert-deployer:0.1.0
kubedns_image: registry.cn-shenzhen.aliyuncs.com/rancher_cn/k8s-dns-kube-dns-amd64:1.14.5
dnsmasq_image: registry.cn-shenzhen.aliyuncs.com/rancher_cn/k8s-dns-dnsmasq-nanny-amd64:1.14.5
kubedns_sidecar_image: registry.cn-shenzhen.aliyuncs.com/rancher_cn/k8s-dns-sidecar-amd64:1.14.5
kubedns_autoscaler_image: registry.cn-shenzhen.aliyuncs.com/rancher_cn/cluster-proportional-autoscaler-amd64:1.0.0
# all addon manifests MUST specify a namespace
addons: |-
---
apiVersion: v1
kind: Pod
metadata:
name: my-nginx
namespace: default
spec:
containers:
- name: my-nginx
image: nginx
ports:
- containerPort: 80
參考鏈接:
RKE快速上手指南:開源的輕量級K8S安裝程序
https://www.cnrancher.com/an-introduction-to-rke/
免費視頻培訓:如何安裝使用RKE
http://www.itdks.com/liveevent/detail/8343
RKE 簡介
https://github.com/rancher/rke
RKE工具下載頁面
https://github.com/rancher/rke/releases/
RKE cluster.yml 文件說明