
1. 项目背景与核心挑战在国产化替代的大背景下越来越多的企业开始将业务系统迁移到国产操作系统平台。麒麟V10作为国产操作系统的代表之一其安全性和稳定性已得到广泛验证。而Kubernetesk8s作为容器编排领域的事实标准在国产系统上的部署需求也日益增长。这次我们要解决的问题是在麒麟V10系统上离线部署k8s 1.32.11版本。离线环境意味着我们无法直接使用包管理器的在线安装方式所有依赖都需要预先下载并传输到目标环境。这种部署方式常见于金融、军工等对网络安全要求严格的场景。提示离线安装的核心难点在于依赖包的完整性和版本匹配一个缺失的依赖可能导致整个安装过程失败。2. 环境准备与依赖检查2.1 系统基础环境配置麒麟V10基于openEuler开发采用Linux 5.10内核。在开始安装前需要确认以下系统配置关闭防火墙和SELinuxsystemctl stop firewalld systemctl disable firewalld setenforce 0 sed -i s/SELINUXenforcing/SELINUXdisabled/g /etc/selinux/config关闭swap分区swapoff -a sed -i / swap / s/^\(.*\)$/#\1/g /etc/fstab设置主机名解析echo 192.168.1.100 master /etc/hosts echo 192.168.1.101 node1 /etc/hosts2.2 离线资源包准备需要提前下载以下组件包kubeadm、kubelet、kubectl 1.32.11版本containerd或Docker运行时CNI插件推荐使用flannel或calico相关依赖库libseccomp、conntrack等建议在联网环境使用以下命令下载所需rpm包yum install --downloadonly --downloaddir/path/to/save kubelet-1.32.11 kubeadm-1.32.11 kubectl-1.32.113. 容器运行时安装与配置3.1 containerd安装containerd是Kubernetes推荐的容器运行时相比Docker更加轻量安装containerdrpm -ivh containerd-*.rpm配置containerdmkdir -p /etc/containerd containerd config default /etc/containerd/config.toml修改配置文件启用systemd cgroup[plugins.io.containerd.grpc.v1.cri.containerd.runtimes.runc] ... [plugins.io.containerd.grpc.v1.cri.containerd.runtimes.runc.options] SystemdCgroup true3.2 镜像仓库配置离线环境需要配置私有镜像仓库在可联网机器上拉取所需镜像kubeadm config images pull --image-repositoryregistry.aliyuncs.com/google_containers --kubernetes-versionv1.32.11将镜像打包并导入离线环境docker save -o k8s-images.tar $(docker images -q)4. Kubernetes集群部署4.1 主节点初始化安装kubeadm、kubelet和kubectlrpm -ivh kubelet-1.32.11*.rpm kubeadm-1.32.11*.rpm kubectl-1.32.11*.rpm初始化控制平面kubeadm init \ --image-repositorylocal-registry:5000/google_containers \ --kubernetes-versionv1.32.11 \ --pod-network-cidr10.244.0.0/16配置kubectlmkdir -p $HOME/.kube cp /etc/kubernetes/admin.conf $HOME/.kube/config chown $(id -u):$(id -g) $HOME/.kube/config4.2 网络插件安装以flannel为例下载flannel镜像和manifestwget https://raw.githubusercontent.com/flannel-io/flannel/master/Documentation/kube-flannel.yml修改配置文件中的网络CIDRnet-conf.json: | { Network: 10.244.0.0/16, Backend: { Type: vxlan } }应用配置kubectl apply -f kube-flannel.yml5. 节点加入与验证5.1 工作节点加入在工作节点上执行kubeadm join 192.168.1.100:6443 \ --token token \ --discovery-token-ca-cert-hash sha256:hash在主节点验证节点状态kubectl get nodes5.2 集群功能验证部署测试应用kubectl create deployment nginx --imagenginx kubectl expose deployment nginx --port80 --typeNodePort检查服务状态kubectl get pods,svc6. 常见问题排查6.1 镜像拉取失败现象Pod处于ImagePullBackOff状态解决方案检查镜像仓库配置是否正确确认镜像已导入本地仓库查看kubelet日志journalctl -u kubelet -f6.2 网络不通现象Pod间无法通信排查步骤检查flannel Pod是否正常运行验证节点路由表ip route show检查防火墙规则6.3 kubelet启动失败可能原因cgroup驱动不匹配证书过期端口冲突解决方法systemctl daemon-reload systemctl restart kubelet journalctl -xeu kubelet7. 性能优化建议内核参数调优echo net.ipv4.ip_forward 1 /etc/sysctl.conf echo net.bridge.bridge-nf-call-iptables 1 /etc/sysctl.conf sysctl -pkubelet资源配置--max-pods100 \ --kube-reservedcpu500m,memory1Gi \ --system-reservedcpu500m,memory1Gi容器日志轮转{ log-driver: json-file, log-opts: { max-size: 100m, max-file: 3 } }在实际部署过程中我发现麒麟V10的某些内核模块需要手动加载才能支持Kubernetes的某些功能。建议在部署前先检查内核模块是否完整特别是overlay和br_netfilter模块。另外由于是离线环境建议提前准备好所有可能的依赖包避免安装过程中因缺少依赖而中断。