CentOS系统下Kubernetes安装教程

CentOS 下使用 kubeadm 安装 Kubernetes 教程

一环境准备与前置条件

节点规划：至少准备 1 台 Master 与 1 台 Worker，推荐 CentOS 7/8，各节点间网络互通，具备外网访问以拉取镜像。硬件建议每节点至少 2 CPU 核心、2 GB 内存（生产环境建议更高）。
系统初始化（所有节点执行）：
- 关闭防火墙：sudo systemctl stop firewalld && sudo systemctl disable firewalld
- 关闭 SELinux：sudo setenforce 0 并修改 /etc/selinux/config 将 SELINUX=enforcing 改为 SELINUX=disabled
- 禁用 Swap：sudo swapoff -a 并在 /etc/fstab 中注释含 swap 的行
- 设置主机名：sudo hostnamectl set-hostname <master|nodeX>
- 配置主机解析：编辑 /etc/hosts，添加各节点 IP 与主机名 映射
- 内核网络参数：
```
cat > /etc/sysctl.d/k8s.conf <<EOF
net.bridge.bridge-nf-call-ip6tables = 1
net.bridge.bridge-nf-call-iptables  = 1
net.ipv4.ip_forward                 = 1
EOF
sysctl --system
```
- 时间同步：sudo yum install -y ntpdate && sudo ntpdate ntp.aliyun.com
  以上为常见且必要的初始化步骤，可显著提升安装成功率与稳定性。

二安装容器运行时与 Kubernetes 组件

安装 Docker（所有节点执行）：

sudo yum install -y yum-utils device-mapper-persistent-data lvm2
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install -y docker-ce docker-ce-cli containerd.io
sudo systemctl start docker && sudo systemctl enable docker

添加 Kubernetes YUM 源（所有节点执行）：

cat <<EOF | sudo tee /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-\$basearch
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

安装 kubeadm、kubelet、kubectl（所有节点执行）：
```
sudo yum install -y kubeadm kubelet kubectl --disableexcludekubernetes
sudo systemctl enable --now kubelet
```
说明：kubelet 会持续重启直至集群初始化完成，这是正常现象。

三初始化 Master 节点

初始化命令（在 Master 执行，按需替换参数）：
```
sudo kubeadm init \
  --apiserver-advertise-address=<Master_IP> \
  --pod-network-cidr=10.244.0.0/16 \
  --image-repository registry.aliyuncs.com/google_containers
```
常见参数说明：
- --apiserver-advertise-address：指定 Master IP
- --pod-network-cidr：Pod 网段，Flannel 常用 10.244.0.0/16
- --image-repository：国内镜像加速，避免拉取 gcr.io 失败

配置 kubectl（在 Master 执行）：

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

记录输出中的 kubeadm join ... 命令，稍后在 Worker 节点执行以加入集群。

四安装 CNI 网络插件

选择其一部署（在 Master 执行）：

Flannel（推荐新手）：

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

Calico（功能更丰富）：

kubectl apply -f https://docs.projectcalico.org/manifests/calico.yaml

网络插件就绪后，节点将变为 Ready 状态。

五加入 Worker 节点与验证

加入集群（在各 Worker 执行 Master 输出的 join 命令，示例）：
```
sudo kubeadm join <Master_IP>:6443 \
  --token <token> \
  --discovery-token-ca-cert-hash sha256:<hash>
```
若 token 过期，可在 Master 执行 kubeadm token create --print-join-command 重新生成。
验证集群状态（在 Master 执行）：
```
kubectl get nodes
kubectl get pods -A
kubectl cluster-info
```
正常时所有节点状态为 Ready，核心系统 Pod 均为 Running。

六常见问题与优化建议

镜像拉取慢或失败：优先使用 --image-repository registry.aliyuncs.com/google_containers；必要时配置 Docker 国内镜像加速。
防火墙与端口：若未关闭防火墙，需放行 6443、10250、10251、10252、2379、2380 等端口，或直接使用 firewalld 停止/禁用策略简化排障。
版本选择与一致性：生产环境建议固定版本，所有节点 kubelet/kubeadm/kubectl 版本保持一致，避免兼容性问题。
高可用与控制平面端点：多 Master 场景可使用 --control-plane-endpoint 与 --upload-certs 参数进行高可用部署。
安全建议：完成安装后可按需开启 SELinux、启用 firewalld 并精细化放行规则，提升生产安全性。

最新问答

相关标签