CentOS离线Kubekey一键部署K8s集群指南

引言

在云计算与容器化技术日益普及的今天，Kubernetes（K8s）作为容器编排领域的标准，其部署效率与稳定性成为开发者与企业关注的焦点。对于CentOS用户而言，如何在离线环境中快速、可靠地部署K8s集群，成为一项重要需求。本文将详细介绍如何使用Kubekey工具，在CentOS环境下实现K8s集群的一键离线部署，涵盖环境准备、离线包制作、部署配置及验证等关键步骤。

一、环境准备

1.1 确定CentOS版本与硬件要求

• CentOS版本：推荐使用CentOS 7或CentOS 8，确保系统兼容性与稳定性。
• 硬件要求：根据集群规模确定，至少需要3台节点（1台Master，2台Node），每台节点建议配置4核CPU、8GB内存及100GB磁盘空间。

1.2 安装依赖工具

在所有节点上安装必要的依赖工具，包括但不限于：

yum install -y wget curl tar git

1.3 配置SSH免密登录

为简化操作，需在Master节点上配置对所有Node节点的SSH免密登录：

# 在Master节点生成SSH密钥对
ssh-keygen -t rsa
# 将公钥复制到所有Node节点
ssh-copy-id user@node1
ssh-copy-id user@node2
# ... 根据实际节点数量复制

二、离线包制作

2.1 下载Kubekey与K8s组件

• Kubekey下载：从Kubekey官方GitHub仓库下载最新版本。
• K8s组件下载：根据目标K8s版本，下载对应的kubeadm、kubelet、kubectl二进制文件及容器镜像。

2.2 制作离线安装包

将下载的Kubekey及K8s组件打包成离线安装包，便于在无网络环境下部署：

# 创建目录结构
mkdir -p kubekey-offline/{bin,images}
# 将Kubekey二进制文件放入bin目录
cp kubekey kubekey-offline/bin/
# 将K8s组件二进制文件放入bin目录（可选，根据实际需求）
cp kubeadm kubelet kubectl kubekey-offline/bin/
# 导出K8s容器镜像为tar包，并放入images目录
docker save k8s.gcr.io/kube-apiserver:v1.20.0 > kubekey-offline/images/kube-apiserver.tar
# ... 导出其他所需镜像
# 打包离线安装包
tar -czvf kubekey-offline.tar.gz kubekey-offline/

三、部署配置

3.1 上传离线安装包至Master节点

将制作好的kubekey-offline.tar.gz上传至Master节点的指定目录。

3.2 解压并运行Kubekey

# 解压离线安装包
tar -xzvf kubekey-offline.tar.gz
# 进入Kubekey目录
cd kubekey-offline
# 运行Kubekey，进行集群配置
./bin/kk create config --with-kubernetes v1.20.0 --with-local-storage --filename config.yaml

3.3 修改配置文件

根据实际环境修改config.yaml文件，包括节点IP、主机名、SSH端口、K8s组件版本等关键信息。

3.4 执行部署命令

# 使用Kubekey执行部署
./bin/kk create cluster --with-kubernetes v1.20.0 --config config.yaml

四、部署验证

4.1 检查节点状态

部署完成后，在Master节点上执行以下命令，检查所有节点是否已加入集群并处于Ready状态：

kubectl get nodes

4.2 验证K8s组件

检查K8s核心组件（如kube-apiserver、kube-controller-manager、kube-scheduler、etcd等）是否正常运行：

kubectl get pods -n kube-system

4.3 部署测试应用

为进一步验证集群功能，可部署一个简单的测试应用，如Nginx：

# 创建Nginx Deployment
kubectl create deployment nginx --image=nginx:latest
# 暴露Nginx服务
kubectl expose deployment nginx --port=80 --type=NodePort
# 获取服务访问地址
kubectl get svc nginx

通过浏览器或curl命令访问Node节点的对应端口，验证Nginx服务是否正常运行。

五、常见问题与解决方案

5.1 SSH连接失败

• 问题原因：SSH免密登录配置错误或防火墙阻止。
• 解决方案：检查SSH密钥对是否正确生成并复制，确认防火墙规则允许SSH连接。

5.2 镜像加载失败

• 问题原因：镜像tar包损坏或版本不匹配。
• 解决方案：重新导出镜像并验证其完整性，确保镜像版本与K8s版本兼容。

5.3 部署过程中断

• 问题原因：网络不稳定或资源不足。
• 解决方案：检查网络连接，确保节点资源充足，重新执行部署命令。

六、总结与展望

通过Kubekey工具在CentOS环境下实现K8s集群的离线一键部署，不仅提高了部署效率，还增强了环境的安全性。未来，随着K8s技术的不断发展，离线部署方案将更加完善，为开发者与企业提供更加灵活、可靠的容器化解决方案。希望本文能为读者在实际操作中提供有力支持，共同推动K8s技术的普及与应用。