在 CentOS 上部署 Kubernetes 的标准流程
一 环境准备
- 准备至少 3 台服务器(建议 CentOS 7/8),推荐配置:2 核 CPU、2 GB 内存、20 GB 磁盘以上,并确保节点间 IP 互通、时间 同步(chrony/ntpd)。
- 主机名与解析:为每台机器设置唯一 hostname,并在 /etc/hosts 中做好解析(便于内网通信)。
- 关闭交换分区:执行 swapoff -a,并在 /etc/fstab 中注释 swap 行,避免 kubelet 启动失败。
- 防火墙与 SELinux:为简化入门可临时 停止 firewalld 并 setenforce 0;生产环境请改为精细化放行所需端口与策略。
- 容器运行时:安装 Docker/Containerd 并启动服务(见下一节)。
二 安装容器运行时与 Kubernetes 组件
- 安装 Docker(所有节点)
- 安装依赖与仓库:
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
sudo yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
- 安装并启动:
sudo yum install -y docker-ce docker-ce-cli containerd.io
sudo systemctl enable --now docker
- 安装 kubeadm、kubelet、kubectl(所有节点)
- 配置 Kubernetes YUM 源(国内镜像示例):
cat <<EOF | sudo tee /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://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOF
- 安装与开机自启:
sudo yum install -y kubelet kubeadm kubectl --disableexcludekubernetes
sudo systemctl enable --now kubelet
三 初始化控制平面与加入工作节点
- 初始化 Master(仅在控制平面执行)
- 推荐指定版本与 Pod 网段(示例使用 v1.21.0 与 10.244.0.0/16):
sudo kubeadm init --kubernetes-version=v1.21.0 --pod-network-cidr=10.244.0.0/16
- 若需指定 API 地址(多网卡/云环境):
sudo kubeadm init --apiserver-advertise-address=<Master_IP> --pod-network-cidr=10.244.0.0/16
- 配置 kubectl:
mkdir -p $HOME/.kube
sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config
- 安装网络插件(控制平面执行,二选一)
- Flannel:
kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml
- Calico:
kubectl apply -f https://docs.projectcalico.org/v3.16/manifests/calico.yaml
- 加入 Worker 节点(在每台工作节点执行)
- 使用 kubeadm init 输出中的完整命令,形如:
sudo kubeadm join <Master_IP>:<Master_Port> --token --discovery-token-ca-cert-hash sha256:
四 验证与常见问题
- 验证集群状态
- 查看节点:kubectl get nodes(状态应为 Ready)
- 查看系统 Pod:kubectl get pods -A
- 常见问题速查
- 节点 NotReady:检查 kubelet/docker 是否运行、节点间 网络连通 与 防火墙策略、以及 Pod 网段是否与网络插件一致。
- 镜像拉取失败:为 Docker 配置 国内镜像加速,或确保节点可访问外部镜像仓库。
- token 过期:在 Master 重新生成并分发新的 join 命令。
五 单机与快速体验方案
- Minikube(适合本地开发/验证)
- 安装与启动(示例):
curl -Lo minikube https://kubernetes.oss-cn-hangzhou.aliyuncs.com/minikube/releases/v1.2.0/minikube-linux-amd64 && chmod +x minikube && sudo mv minikube /usr/local/bin/
minikube start --vm-driver=none --kubernetes-version v1.15.0
- 注意:–vm-driver=none 直接在本机运行,需满足资源与内核要求。