跳转至

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

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

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

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

Note

本文演示的节点环境为:

  • X86 架构
  • CentOS 7 Linux 发行版

前提条件

  • 准备一个 Kubean 所在的管理集群,并且当前环境已经部署支持 podmanskopeominio 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 离线资源

  1. 准备 manifest.yml 文件。

    cat > "manifest.yml" <<EOF
    image_arch:
      - "amd64" ## "arm64"
    kube_version: ## 根据实际场景填写集群版本
      - "v1.23.0"
      - "v1.24.0"
    EOF
    
  2. 制作离线增量包。

    # 创建 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}
    
    1. 镜像 spray-job 这里可以采用加速器地址,镜像地址根据选择制品版本来决定
  3. 导入对应 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)!
    
    1. IP 替换为实际的仓库地址
    2. IP 替换为实际的仓库地址
  4. manifestlocalartifactset.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
    

部署和升级 K8s 集群兼容版本

部署

  1. 前往 容器管理 ,在 集群列表 页面中,点击 创建集群 按钮。

  2. 被纳管参数选择 manifestlocalartifactset.cr.yaml 自定义资源部署的集群,本例使用的是 Global 集群。

    cluster01

  3. 其余参数参考创建集群

    cluster02

升级

  1. 选择新创建的集群,进去详情界面。

  2. 然后在左侧导航栏点击 集群运维 -> 集群升级 ,在页面右上角点击 版本升级

    cluster03

  3. 选择可用的集群进行升级。

    cluster04

评论