手把手教你从零开始在Linux服务器上配置Kubernetes集群

一、准备工作

1.1 硬件要求

• Master节点：至少2核CPU，4GB内存，20GB存储
• Worker节点：建议2核CPU，2GB内存，20GB存储
• 所有节点需要保持时间同步（建议安装NTP服务）

1.2 软件要求

• Linux操作系统（推荐Ubuntu 20.04+/CentOS 7+）
• Docker 18.06+或containerd 1.2+
• 关闭交换分区（swapoff -a）
• 禁用SELinux（如使用CentOS）

二、安装Docker容器运行时

# Ubuntu安装Docker
sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl enable docker
sudo systemctl start docker

# CentOS安装Docker
sudo yum install -y yum-utils
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 enable docker
sudo systemctl start docker

三、安装Kubernetes组件

3.1 添加Kubernetes仓库

# 适用于Ubuntu/Debian
sudo apt-get update && sudo apt-get install -y apt-transport-https curl
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list

# 适用于CentOS/RHEL
cat < /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://packages.cloud.google.com/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

3.2 安装kubeadm, kubelet和kubectl

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl

# CentOS/RHEL
sudo yum install -y kubelet kubeadm kubectl
sudo systemctl enable --now kubelet

四、初始化Kubernetes集群

4.1 Master节点初始化

sudo kubeadm init --pod-network-cidr=10.244.0.0/16

成功后会显示加入集群的命令，请保存好这些信息。

4.2 配置kubectl

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

4.3 安装网络插件（以Flannel为例）

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

五、加入Worker节点

在Worker节点上执行Master节点初始化后提供的kubeadm join命令：

kubeadm join : --token  --discovery-token-ca-cert-hash 

六、验证集群状态

kubectl get nodes  # 查看所有节点状态
kubectl get pods --all-namespaces  # 查看所有Pod状态

七、常见问题排查

• 节点状态为NotReady：检查网络插件是否正确安装
• kubeadm init卡住：检查镜像是否成功拉取
• Pod无法正常启动：检查容器运行时是否正常运行