检查主机环境

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 <<EOF >/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 <<EOF > /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 <<EOF > /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 <control-plane-host>:<control-plane-port> --token <token> --discovery-token-ca-cert-hash sha256:<hash>

3. 加入worker节点到集群

登陆到worker主机,执行第二步master节点创建成功后显示的命令 kubeadm join <control-plane-host>:<control-plane-port> --token <token> --discovery-token-ca-cert-hash sha256:<hash> ,完成后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