offline_install.md

离线安装集群

使用kubeasz 离线安装 k8s集群需要下载四个部分：

• kubeasz 项目代码
• 二进制文件（k8s、etcd、containerd等组件）
• 容器镜像文件（calico、coredns、metrics-server等容器镜像）
• 系统软件安装包（ipset、libseccomp2等，仅无法使用本地yum/apt源时需要）

离线文件准备

在一台能够访问互联网的服务器上执行：

• 下载工具脚本ezdown，举例使用kubeasz版本3.6.0

export release=3.6.0
wget https://github.com/easzlab/kubeasz/releases/download/${release}/ezdown
chmod +x ./ezdown

• 使用工具脚本下载（更多关于ezdown的参数，运行./ezdown 查看）

下载kubeasz代码、二进制、默认容器镜像

# 国内环境
./ezdown -D

[可选]如果需要更多组件，请下载额外容器镜像（cilium,flannel,prometheus等）

./ezdown -X flannel
./ezdown -X prometheus
...

下载离线系统包 (适用于无法使用yum/apt仓库情形)

# 如果操作系统是ubuntu 22.04
./ezdown -P ubuntu_22

上述脚本运行成功后，所有文件（kubeasz代码、二进制、离线镜像）均已整理好放入目录/etc/kubeasz

• /etc/kubeasz 包含 kubeasz 版本为 ${release} 的发布代码
• /etc/kubeasz/bin 包含 k8s/etcd/docker/cni 等二进制文件
• /etc/kubeasz/down 包含集群安装时需要的离线容器镜像
• /etc/kubeasz/down/packages 包含集群安装时需要的系统基础软件

离线安装

上述下载完成后，把/etc/kubeasz整个目录复制到目标离线服务器相同目录，然后在离线服务器/etc/kubeasz目录下执行：

• 离线安装 docker，检查本地文件，正常会提示所有文件已经下载完成，并上传到本地私有镜像仓库

./ezdown -D
./ezdown -X flannel
./ezdown -X prometheus
...

• 启动 kubeasz 容器

./ezdown -S

• 设置参数允许离线安装系统软件包

sed -i 's/^INSTALL_SOURCE.*$/INSTALL_SOURCE: "offline"/g' /etc/kubeasz/example/config.yml 

• 举例安装单节点集群，参考 https://github.com/easzlab/kubeasz/blob/master/docs/setup/quickStart.md

source ~/.bashrc
dk ezctl start-aio
# 或者执行 docker exec -it kubeasz ezctl start-aio

• 多节点集群，进入kubeasz 容器内 docker exec -it kubeasz bash，参考https://github.com/easzlab/kubeasz/blob/master/docs/setup/00-planning_and_overall_intro.md 进行集群规划和设置后使用./ezctl 命令安装