Kubespray-Offline 安装与配置指南

Kubespray-Offline 安装与配置指南

一、项目目录结构及介绍

Kubespray-Offline 是一个针对 Kubernetes 的离线部署工具包，旨在帮助用户在无网络连接或限制网络访问的环境中部署 Kubernetes 集群。以下是 kubespray-offline 项目的典型目录结构概览及其重要组成部分：

.
├── README.md                  # 项目的主要说明文档
├── LICENSE                    # Apache-2.0 开源许可证
├── extract-kubespray.sh       # 脚本用于提取 Kubespray 并应用补丁
├── kubespray-[version]        # 解压后的 Kubespray 目录，包含部署脚本和配置文件
│   ├── ansible                 # Ansible 相关的角色、剧本和库文件
│   ├── inventories             # 示例库存目录，存放集群配置
│   │   └── mycluster           # 具体集群的配置样例
│   ├── docs                    # 文档资料
│   ├── hack                    # 辅助脚本和工具
│   ├── plugins                 # Ansible 插件
│   ├── requirements.txt        # Ansible 及其依赖的外部Python包列表
│   └── ...                     # 其他支持文件
├── playbook                   # 离线部署相关剧本
│   └── offline-repo.yml        # 离线部署仓库配置剧本
├── download-all.sh            # 下载所有必要文件的脚本
└── ...                         # 其余工具脚本如安装Docker、Containerd等

每个模块都有明确的职责，例如，ansible 目录存储了自动化部署所需的所有Ansible剧本和角色，而inventories则包含了集群的详细配置信息。

二、项目的启动文件介绍

主要启动流程

1. extract-kubespray.sh: 用于从在线资源中下载原始的Kubespray代码并应用任何必需的离线环境补丁。
2. requirements.txt: 安装Ansible及其依赖项的指令文件，使用 pip install -r requirements.txt 来执行。
3. offline-repo.yml: 通过Ansible运行这个剧本可以将离线软件包部署到目标节点上，设置好本地仓库，以便在没有互联网的情况下完成部署。

启动Kubernetes集群的核心命令通常涉及调用Ansible来执行部署剧本，例如:

ansible-playbook -i inventory/mycluster/hosts.yaml cluster.yaml --become --become-user=root

三、项目的配置文件介绍

组变量配置 (group_vars/all/offline.yml)

• ** offline.yml**: 这是关键的配置文件，位于inventory目录下的相应位置，用于设定离线部署的具体参数。你需要编辑此文件以适应你的环境，比如修改镜像仓库地址（YOUR_HOST），确保符合你的离线环境需求。

  • 容器镜像下载: 需要在脱机环境下提前下载所有必要的容器镜像，并通过更改配置来指向这些离线镜像位置。
  • 软件包仓库: 对于OS包，可能需要配置Yum或Deb仓库的离线路径或本地ISO镜像。

Ansible Inventory 文件 (如 inventory/mycluster/hosts.yaml)

• 包含集群中每个节点的信息，定义主机名称、角色等，是Ansible定位和操作目标系统的基础。

Role-Specific Variables

• Kubespray使用Ansible的角色结构，每个角色有自己的默认配置文件(roles/<role_name>/defaults/main.yml)，你可以覆盖这些默认值，在你的inventory的特定组变量或主机变量中。

在进行离线部署前，深入理解这些配置文件和脚本的作用对于成功部署至关重要。确保根据自己的具体需求调整各项配置，从而实现顺畅的离线Kubernetes部署过程。