CentOS 7 上安装 Kubernetes 集群指南

前置条件

• 两台 CentOS 7 服务器
  • Master 节点: 192.168.50.106
  • Worker 节点: 192.168.50.107
• 每台服务器至少 2 CPU，2GB 内存，20GB 磁盘空间
• root 访问权限

1. 系统准备（两台服务器都执行）

# 关闭防火墙
systemctl stop firewalld
systemctl disable firewalld

# 关闭selinux
setenforce 0
sed -i 's/^SELINUX=enforcing$/SELINUX=permissive/' /etc/selinux/config

# 关闭swap
swapoff -a
sed -i '/swap/d' /etc/fstab

# 设置主机名
hostnamectl set-hostname master  # 在192.168.50.106上执行
hostnamectl set-hostname worker  # 在192.168.50.107上执行

# 添加hosts
cat >> /etc/hosts << EOF
192.168.50.106 master
192.168.50.107 worker
EOF

# 将桥接的IPv4流量传递到iptables的链
cat > /etc/sysctl.d/k8s.conf << EOF
net.bridge.bridge-nf-call-ip6tables = 1
net.bridge.bridge-nf-call-iptables = 1
EOF
sysctl --system

# 加载br_netfilter模块
modprobe br_netfilter

# 时间同步
yum install -y chrony
cat > /etc/chrony.conf << EOF
server ntp.aliyun.com iburst
server ntp1.aliyun.com iburst
server ntp2.aliyun.com iburst
server ntp3.aliyun.com iburst
EOF
systemctl enable chronyd && systemctl start chronyd

2. 安装 Docker（两台服务器都执行）

2.1 配置 yum 源

如果遇到无法连接官方镜像源的问题，请按以下步骤操作：

# 备份当前的 CentOS-Base.repo 文件
sudo mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup

# 下载阿里云的 CentOS 镜像源文件
sudo curl -o /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo

# 如果 curl 不可用，可以使用 wget
# sudo wget -O /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo

# 清除缓存并生成新的缓存
sudo yum clean all
sudo yum makecache

如果仍然遇到 DNS 解析问题，可以尝试添加公共 DNS：

echo "nameserver 8.8.8.8" | sudo tee -a /etc/resolv.conf
echo "nameserver 114.114.114.114" | sudo tee -a /etc/resolv.conf

2.2 安装 Docker

# 安装必要的依赖
yum install -y yum-utils device-mapper-persistent-data lvm2

# 添加Docker仓库
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

# 安装Docker
yum makecache fast
yum install -y docker-ce docker-ce-cli containerd.io

# 配置Docker
mkdir -p /etc/docker
cat > /etc/docker/daemon.json <<EOF
{
  "data-root": "/data/docker",
  "registry-mirrors": ["https://registry.cn-hangzhou.aliyuncs.com"],
  "exec-opts": ["native.cgroupdriver=systemd"],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m"
  },
  "storage-driver": "overlay2"
}
EOF

# 启动Docker并设置开机自启
systemctl daemon-reload
systemctl start docker
systemctl enable docker

3. 安装 kubeadm, kubelet 和 kubectl（两台服务器都执行）

# 添加Kubernetes仓库
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

# 安装Kubernetes组件
yum install -y kubelet kubeadm kubectl --disableexcludes=kubernetes
sudo yum install -y kubeadm-1.21.0-0 kubelet-1.21.0-0 kubectl-1.21.0-0 --disableexcludes=kubernetes


# 启动kubelet并设置开机自启
systemctl enable --now kubelet

4. 初始化 master 节点（只在 192.168.50.106 上执行）

# 拉取所需镜像
kubeadm config images pull --image-repository registry.aliyuncs.com/google_containers
## 注意：
如果CRI 插件被禁用了，会导致"CRI v1 image API is not implemented" 错误的原因
vim /etc/containerd/config.toml
### 删除或注释掉这一行：
# disabled_plugins = ["cri"]
### 添加以下内容：
[plugins."io.containerd.grpc.v1.cri"]
  disable = false

### 重启 containerd 服务：
systemctl restart containerd
### 验证 containerd 服务状态：
systemctl status containerd
## 再次尝试拉取镜像：
kubeadm config images pull --image-repository registry.aliyuncs.com/google_containers


# 初始化master节点
kubeadm init \
  --apiserver-advertise-address=192.168.50.106 \
  --image-repository registry.aliyuncs.com/google_containers \
  --kubernetes-version v1.21.0 \
  --service-cidr=10.96.0.0/12 \
  --pod-network-cidr=10.244.0.0/16

# 如果以上命令报错：
kubeadm init \
  --apiserver-advertise-address=192.168.50.106 \
  --image-repository registry.aliyuncs.com/google_containers \
  --kubernetes-version v1.21.14 \
  --service-cidr=10.96.0.0/12 \
  --pod-network-cidr=10.244.0.0/16 \
  --ignore-preflight-errors=ImagePull

mkdir -p $HOME/.kube
cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
chown $(id -u):$(id -g) $HOME/.kube/config

5. 安装网络插件（只在 master 节点 192.168.50.106 上执行）

kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml

6. 加入 worker 节点（在 192.168.50.107 上执行）

使用 kubeadm init 输出的 join 命令：

kubeadm join 192.168.50.106:6443 --token <token> --discovery-token-ca-cert-hash sha256:<hash>

7. 验证集群状态（在 master 节点 192.168.50.106 上执行）

kubectl get nodes

如果一切正常，您应该能看到两个节点都处于 Ready 状态。

故障排除

如果在安装过程中遇到任何问题，请检查以下几点：

1. 确保所有命令都以 root 用户或使用 sudo 执行。
2. 检查网络连接，确保能够访问所需的镜像源。
3. 如果遇到 DNS 解析问题，尝试添加公共 DNS 服务器。
4. 检查服务器的时间同步状态。
5. 确保已经正确关闭了 SELinux 和防火墙。

如果问题仍然存在，请收集相关的错误日志并寻求进一步的帮助。

这份 Markdown 文档包含了完整的安装步骤，以及针对可能遇到的镜像源问题的解决方案。您可以根据需要进一步调整或扩展这个文档。