离线场景 Kubean 向下兼容版本的部署与升级操作¶

为了满足客户对低版本的 K8s 集群的搭建，Kubean 提供了向下兼容并创建低版本的 K8s 集群能力，简称向下兼容版本的能力。

目前支持自建工作集群版本范围在 v1.26-v1.28，可以参阅 DCE 5.0 集群版本支持体系。

本文将演示如何部署低版本的 K8s 集群。

Note

本文演示的节点环境为：

X86 架构
CentOS 7 Linux 发行版

前提条件¶

准备一个 Kubean 所在的管理集群，并且当前环境已经部署支持 podman 、skopeo、minio client 命令。如果不支持，可通过脚本进行安装依赖组件，安装前置依赖。

前往 kubean 查看发布的制品，并根据实际情况选择具体的制品版本。目前支持的制品版本及对应的集群版本范围如下：

制品包版本	支持集群范围	DCE 5.0 支持情况
release-2.21	v1.23.0 ~ v1.25.6	安装器 v0.14.0+ 已支持
release-2.22	v1.24.0 ~ v1.26.13	安装器 v0.15.0+ 已支持
release-2.23	v1.25.0 ~ v1.27.10	安装器 v0.16.0+ 已支持
release-2.24	v1.26.0 ~ v1.29.1	安装器 v0.17.0+ 已支持
release-2.25	v1.27.0 ~ v1.29.5	安装器 v0.20.0+ 已支持

Tip

在选择制品版本时，不仅需要参考集群版本范围，还需判断该制品 manifest 资源中相应组件(如 calico、containerd)版本范围是否覆盖当前集群该组件版本！

本文演示离线部署 K8s 集群到 1.23.0 版本及离线升级 K8s 集群从 1.23.0 版本到 1.24.0 版本，所以选择 release-2.21 的制品。

操作步骤¶

准备 Kubespray Release 低版本的相关制品¶

将 spray-job 镜像导入到离线环境的 Registry（镜像仓库）中。

# 假设火种集群中的 registry 地址为 172.30.41.200
REGISTRY_ADDR="172.30.41.200"

# 镜像 spray-job 这里可以采用加速器地址，镜像地址根据选择制品版本来决定
SPRAY_IMG_ADDR="ghcr.m.daocloud.io/kubean-io/spray-job:2.21-d6f688f"

# skopeo 参数
SKOPEO_PARAMS=" --insecure-policy -a --dest-tls-verify=false --retry-times=3 "

# 在线环境：导出 release-2.21 版本的 spray-job 镜像，并将其转移到离线环境
skopeo copy docker://${SPRAY_IMG_ADDR} docker-archive:spray-job-2.21.tar

# 离线环境：导入 release-2.21 版本的 spray-job 镜像到火种 registry
skopeo copy ${SKOPEO_PARAMS} docker-archive:spray-job-2.21.tar docker://${REGISTRY_ADDR}/${SPRAY_IMG_ADDR/.m.daocloud/}

制作低版本 K8s 离线资源¶

准备 manifest.yml 文件。

cat > "manifest.yml" <<EOF
image_arch:
  - "amd64" ## "arm64"
kube_version: ## 根据实际场景填写集群版本
  - "v1.23.0"
  - "v1.24.0"
EOF

制作离线增量包。

# 创建 data 目录
mkdir data
# 制作离线包，
AIRGAP_IMG_ADDR="ghcr.m.daocloud.io/kubean-io/airgap-patch:2.21-d6f688f" # (1)!
podman run --rm -v $(pwd)/manifest.yml:/manifest.yml -v $(pwd)/data:/data -e ZONE=CN -e MODE=FULL ${AIRGAP_IMG_ADDR}

镜像 spray-job 这里可以采用加速器地址，镜像地址根据选择制品版本来决定

导入对应 k8s 版本的离线镜像与二进制包

# 将上一步 data 目录中的二进制导入二进制包至火种节点的 MinIO 中
cd ./data/amd64/files/
MINIO_ADDR="http://127.0.0.1:9000" # (1)!
MINIO_USER=rootuser MINIO_PASS=rootpass123 ./import_files.sh ${MINIO_ADDR}

# 将上一步 data 目录中的镜像导入二进制包至火种节点的镜像仓库中
cd ./data/amd64/images/
REGISTRY_ADDR="127.0.0.1"  ./import_images.sh # (2)!

IP 替换为实际的仓库地址
IP 替换为实际的仓库地址

将 manifest、localartifactset.cr.yaml 自定义资源部署到 Kubean 所在的管理集群或者 Global 集群 当中，本例使用的是 Global 集群。

# 部署 data 文件目录下的 localArtifactSet 资源
cd ./data
kubectl apply -f localartifactset.cr.yaml

# 下载 release-2.21 版本的 manifest 资源
wget https://raw.githubusercontent.com/kubean-io/kubean-manifest/main/manifests/manifest-2.21-d6f688f.yml

# 部署 release-2.21 对应的 manifest 资源
kubectl apply -f manifest-2.21-d6f688f.yml