Kubespray 是一个基于 Ansible 的 Kubernetes 安装工具,它可以在离线环境下进行安装。以下是使用离线方式安装 Kubespray 的步骤:
- 下载 Kubespray 源代码及依赖文件:将 Kubespray 项目源代码下载到本地,并下载其所需的依赖文件(如 etcd、docker 等)。可以使用以下命令进行下载:
git clone https://github.com/kubernetes-sigs/kubespray.git
cd kubespray
pip install -r requirements.txt
ansible-galaxy install -r requirements.yml
准备配置文件:在
inventory目录中创建主机清单文件,定义需要安装 Kubernetes 的主机信息;在group_vars/all.yml文件中设置全局变量,如镜像仓库地址、Pod 网络等。准备离线镜像包:从互联网上下载所有必需的镜像并打包为 tar 文件,在无法连接外部网络时提供给 Kubespray 使用。
将离线镜像导入到本地 Docker Registry:将上一步准备好的 tar 包解压缩后导入到 Docker Registry 中,以便后续 K8s 组件部署时能够从本地 registry 获取所需的镜像。
执行 Ansible playbook:通过执行 ansible-playbook 命令运行 Kubespray 安装脚本,例如:
ansible-playbook -i inventory/mycluster/hosts.ini cluster.yml -b --become-user=root
- 等待安装完成:根据实际环境和集群规模,安装可能需要数小时甚至更长时间,请耐心等待安装过程完成。
通过以上步骤,就可以在离线环境下成功地使用 Kubespray 安装 Kubernetes 集群。但需要注意的是,在离线情况下进行部署时,需要提前准备好所有必需的软件包及依赖文件,并且确保版本和配置与在线环境一致,以免出现不可预期的错误。




