在统信UOS上需通过国内镜像源安装适配的kubectl、kubeadm、kubelet二进制包，并手动配置kubelet systemd服务；kubectl直接放入PATH并赋权，kubeadm与kubelet须版本严格一致，且必须手工创建/etc/systemd/system/kubelet.service文件才能启用服务。
要在统信UOS上安装和配置Kubernetes核心工具（kubectl、kubeadm、kubelet），必须绕过默认源中缺失或版本陈旧的问题，直接使用国内镜像源下载适配UOS的二进制包并完成系统级注册。
安装kubectl命令行工具
这一步操作起来很简单，直接把二进制文件放进PATH路径就能全局调用。
1、创建工具目录并进入：sudo mkdir -p /usr/local/bin/k8s-tools && cd /usr/local/bin/k8s-tools
2、从阿里云镜像站下载适配UOS的kubectl v1.26.9（amd64）：sudo wget https://mirrors.aliyun.com/kubernetes/v1.26.9/bin/linux/amd64/kubectl -O /usr/local/bin/kubectl
3、赋予执行权限：sudo chmod +x /usr/local/bin/kubectl
4、验证安装：kubectl version --client --short，输出应为 Client Version: v1.26.9。若提示“command not found”，说明PATH未包含/usr/local/bin，需检查echo $PATH并修正~/.bashrc。
安装kubeadm与kubelet服务组件
kubeadm是集群初始化的核心指挥官，kubelet则是每个节点上运行Pod的守门人；二者必须严格匹配Kubernetes小版本号，否则kubeadm init会拒绝启动。
方法一：通过apt源安装（仅限UOS服务器版且已启用extras源）
1、启用uos-server-extras软件源：sudo uos-add-repository -y extras
2、更新索引并安装指定版本：sudo apt update && sudo apt install -y kubeadm=1.26.9-00 kubelet=1.26.9-00
3、锁定版本防止意外升级：sudo apt-mark hold kubeadm kubelet
方法二：离线二进制安装（全版本通用，推荐）
针对 Kubernetes 仪表板和 Web UI 的浏览器自动化。适用于与 Kubernetes Dashboard、Grafana、ArgoCD UI 或其他 Web 界面交互。需要设置 MCP_BROWSER_ENABLED=true。
1、分别下载对应二进制：sudo wget https://mirrors.aliyun.com/kubernetes/v1.26.9/bin/linux/amd64/kubeadm -O /usr/local/bin/kubeadm → sudo wget https://mirrors.aliyun.com/kubernetes/v1.26.9/bin/linux/amd64/kubelet -O /usr/local/bin/kubelet
2、设为可执行：sudo chmod +x /usr/local/bin/kubeadm /usr/local/bin/kubelet
【关键前提】必须确保kubelet已注册为systemd服务，否则后续无法启用。手动创建服务文件：sudo systemctl enable kubelet会失败，需先执行下一步。
配置kubelet systemd服务
UOS默认不提供kubelet的systemd单元文件，必须手工创建，否则systemctl start kubelet将报错“Unit kubelet.service not found”。
第一步：生成标准服务定义
运行以下命令写入服务文件：sudo tee /etc/systemd/system/kubelet.service
第二步：加载cgroup驱动配置
UOS内核默认使用cgroup v1，而kubelet v1.26+要求明确指定驱动类型。创建配置目录：sudo mkdir -p /var/lib/kubelet/config.yaml，然后写入驱动声明：sudo tee /var/lib/kubelet/config.yaml
第三步：重载并启用服务
sudo systemctl daemon-reload → sudo systemctl enable --now kubelet。此时sudo systemctl status kubelet应显示active (running)，且日志末尾无failed to run Kubelet字样。
注意：若状态卡在activating，大概率是/var/lib/kubelet/config.yaml路径写错或cgroupDriver值拼写错误，务必逐字符核对。
