检查主机环境
1. 确保每一台主机的MAC地址和 product_uuid 唯一
- 获取mac地址
ifconfig -a
- 获取 product_uuid
cat /sys/class/dmi/id/product_uuid
一般不同的物理主机mac地址和product_uuid是不会相同的,但是不同的虚拟机可能会相同。kubernetes 安装集群时会使用这些值来唯一标识一个 node,因此如果这些值存在冲突会导致集群安装失败。
2. 确保 iptables 后端不使用 nftables
当前 nftables 和 kubeadm 存在兼容性问题,如果主机内核使用了 nftables, 应该设置 iptables 为legacy
模式来避免这个问题。这个问题只在 Debian 10 (Buster), Ubuntu 19.04, Fedora 29和更新的发行版内核出现。
Debian\Ubuntu
sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy
sudo update-alternatives --set arptables /usr/sbin/arptables-legacy
sudo update-alternatives --set ebtables /usr/sbin/ebtables-legacys
Fedora
update-alternatives --set iptables /usr/sbin/iptables-legacy
3. 检查主机port
检查master主机port,确保表中端口没有被占用
Protocol | Direction | Port Range | Purpose Used By |
---|---|---|---|
TCP | Inbound | 6443* | Kubernetes API server All |
TCP | Inbound | 2379-2380 | etcd server client API kube-apiserver, etcd |
TCP | Inbound | 10250 | Kubelet API Self, Control plane |
TCP | Inbound | 10251 | kube-scheduler Self |
TCP | Inbound | 10252 | kube-controller-manager Self |
检查worker node port,确保表中端口没有被占用
Protocol | Direction | Port Range | Purpose Used By |
---|---|---|---|
TCP | Inbound | 10250 | Kubelet API Self, Control plane |
TCP | Inbound | 30000-32767 | NodePort Services** All |
依赖组件安装
1. 安装docker
参考官方文档
2. 安装kubectl、kubelet、kubeadm
官网提供的安装源需要翻墙,可以使用k8s阿里源
- Debian/Ubuntu
apt-get update && apt-get install -y apt-transport-https
curl https://mirrors.aliyun.com/kubernetes/apt/doc/apt-key.gpg | apt-key add -
cat </etc/apt/sources.list.d/kubernetes.list
deb https://mirrors.aliyun.com/kubernetes/apt/ kubernetes-xenial main
EOF
apt-get update
apt-get install -y kubelet-v1.13.4 kubeadm-v1.13.4 kubectl-v1.13.4
- CentOS / RHEL / Fedora
cat < /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://mirrors.aliyun.com/kubernetes/yum/repos/kubernetes-el7-x86_64/
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://mirrors.aliyun.com/kubernetes/yum/doc/yum-key.gpg https://mirrors.aliyun.com/kubernetes/yum/doc/rpm-package-key.gpg
EOF
setenforce 0
yum install -y kubelet-v1.13.4 kubeadm-v1.13.4 kubectl-v1.13.4
systemctl enable kubelet && systemctl start kubelet
由于官网未开放同步方式, 可能会有索引gpg检查失败的情况, 这时请用 yum install -y --nogpgcheck kubelet kubeadm kubectl 安装
集群初始化
1. 配置kubeadm
cd /root
cat < /root/kubeadm-config
apiVersion: kubeadm.k8s.io/v1beta1
kind: ClusterConfiguration
kubernetesVersion: v1.13.4
imageRepository: registry.cn-beijing.aliyuncs.com/hsxue
networking:
dnsDomain: cluster.local
podSubnet: 10.128.0.0/23
serviceSubnet: 10.192.0.0/22
EOF
配置说明:
- 要安装的集群版本:
kubernetesVersion: v1.13.4
- 拉去镜像使用的镜像仓库:
imageRepository: registry.cn-beijing.aliyuncs.com/hsxue
不配置默认使用 k8s 官方镜像仓库,由于墙的问题,这儿最好指定可以访问的镜像仓库。- 配置基础网络:
networking
以上是简单配置,更详细配置参考官网
2. 初始化master
kubeadm init --config=/root/kubeadm-config --node-name=master
执行以上命令,安装成功后会显示如下信息:
Your Kubernetes control-plane has initialized successfully!
To start using your cluster, you need to run the following as a regular user:
mkdir -p $HOME/.kube
sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config
You should now deploy a pod network to the cluster.
Run "kubectl apply -f [podnetwork].yaml" with one of the options listed at:
/docs/concepts/cluster-administration/addons/
You can now join any number of machines by running the following on each node
as root:
kubeadm join : --token --discovery-token-ca-cert-hash sha256:
3. 加入worker节点到集群
登陆到worker主机,执行第二步master节点创建成功后显示的命令 kubeadm join
,完成后worker节点即可加入集群。
4. 安装 pod network 插件
目前集群的 node 状态都是 norready,因为集群还没有安装 pod网络插件。如下安装 flannel
为例,执行如下命令:
kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/2140ac876ef134e0ed5af15c65e414cf26827915/Documentation/kube-flannel.yml
等待flannel pod都running了之后,集群node会更新为ready
详情参考:pod network addon