Ubuntu 部署 Kubernetes 的标准步骤
一 环境准备
- 系统要求：64 位 Ubuntu、至少 2 核 CPU、4GB 内存、20GB 磁盘；各节点建议统一操作系统与内核版本，并配置静态 IP与主机名（便于管理）。
- 基础工具：更新索引并安装常用工具（如 apt-transport-https、curl、ca-certificates）。
- 容器运行时：安装 Docker 或 containerd（二选一，下文给出两种做法）。
- 内核与网络：开启 br_netfilter 与 overlay 模块，开启桥接流量转发；禁用 Swap；确保 kubelet 开机自启。
- 建议：节点间时间同步（如 chrony），并规划好用于 apiserver 的网卡与 Pod 网段（如 10.244.0.0/16 或 10.10.0.0/16）。
二 安装容器运行时
- 方案 A Docker（示例）
- 安装：sudo apt update && sudo apt install -y docker.io
- 启动与自启：sudo systemctl start docker && sudo systemctl enable docker
- 建议将 Docker 的 cgroup 驱动设为 systemd（与 kubelet 一致）：
- /etc/docker/daemon.json
{
“exec-opts”: [“native.cgroupdriver=systemd”],
“log-driver”: “json-file”,
“log-opts”: { “max-size”: “100m” },
“storage-driver”: “overlay2”
}
- 使配置生效：sudo systemctl daemon-reload && sudo systemctl restart docker
- 方案 B containerd（示例）
- 安装：sudo apt install -y containerd.io
- 生成默认配置并启用 SystemdCgroup：
- sudo mkdir -p /etc/containerd
- containerd config default | sudo tee /etc/containerd/config.toml
- 在 /etc/containerd/config.toml 中将 SystemdCgroup = true
- 启动与自启：sudo systemctl start containerd && sudo systemctl enable containerd
说明：两种运行时均可与 kubeadm 配合使用，关键在于 cgroup 驱动与 kubelet 保持一致。
三 安装 kubeadm kubelet kubectl
- 添加 Kubernetes APT 源（示例为国内镜像，提升可达性）
- curl -s https://mirrors.aliyun.com/kubernetes/apt/doc/apt-key.gpg | sudo apt-key add -
- echo “deb https://mirrors.aliyun.com/kubernetes/apt/ kubernetes-xenial main” | sudo tee /etc/apt/sources.list.d/kubernetes.list
- 安装指定版本（示例：1.23.3；可按需调整）
- sudo apt update && sudo apt install -y kubeadm=1.23.3-00 kubelet=1.23.3-00 kubectl=1.23.3-00
- 锁定版本：sudo apt-mark hold kubeadm kubelet kubectl
- 启动 kubelet：sudo systemctl enable --now kubelet
提示：若国内拉取镜像受限，可先通过镜像仓库拉取所需组件镜像并重新打 tag（见下文“镜像准备”）。
四 初始化控制平面与网络插件
- 控制平面初始化（Master）
- 预拉取镜像（可选，提升成功率）：kubeadm config images list --kubernetes-version v1.23.3
- 初始化命令（按需替换参数）：
- sudo kubeadm init \
–pod-network-cidr=10.244.0.0/16 \
–apiserver-advertise-address=YOUR_MASTER_IP \
–kubernetes-version=v1.23.3
- 若初始化异常或中断，先执行：sudo kubeadm reset 再重试
- 配置 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/manifests/calico.yaml
- 验证：kubectl get nodes 应显示 Ready 状态
说明：Pod 网段需与所选网络插件默认网段匹配（如 Flannel 常用 10.244.0.0/16）。
五 加入工作节点与验证
- 获取加入命令
- 在 Master 查看：kubeadm token create --print-join-command
- 或复制初始化完成时的输出：kubeadm join MASTER_IP:6443 --token TOKEN --discovery-token-ca-cert-hash sha256:HASH
- 在工作节点执行上述 join 命令，完成后回到 Master：kubectl get nodes 应看到所有节点 Ready
- 快速业务验证
- 部署测试应用：kubectl create deployment nginx --image=nginx
- 暴露服务：kubectl expose deployment nginx --port=80 --target-port=80 --type=ClusterIP
- 查看服务：kubectl get svc nginx
- 常见问题与排障
- 镜像拉取失败：使用国内镜像源预先拉取并打 tag（见上文“镜像准备”）
- cgroup 驱动不一致：确保 Docker/containerd 与 kubelet 均使用 systemd
- 节点 NotReady：检查 Pod 网段与网络插件是否匹配、节点网络与防火墙策略是否放行 6443/10250 等端口
- 忘记 join 命令：在 Master 重新生成（kubeadm token create --print-join-command）
