离线升级可观测性模块¶

本页说明下载可观测性模块后，应该如何安装或升级。

解压下载的包得到bundle包¶

tar -xvf insight_v0.25.3_amd64.tar

解压后可得到 insight 和 insight-agent 对应 2 个 bundle.tar 包

$ ll insight_v0.25.3_amd64
总用量 2899996
-rw-r--r-- 1 root root 2367463936 4月   2 18:36 insight_0.25.3.bundle.tar
-rw-r--r-- 1 root root  602125824 4月   2 18:35 insight-agent_0.25.3.bundle.tar

从安装包中加载镜像¶

您可以根据下面两种方式之一加载镜像，当环境中存在镜像仓库时，建议选择 chart-syncer 同步镜像到镜像仓库，该方法更加高效便捷。 需注意，charts-syncer 版本需大于等于 v0.0.22。

chart-syncer 同步镜像到镜像仓库¶

1. 创建 load-image.yaml

   Note

   该 YAML 文件中的各项参数均为必填项。您需要一个私有的镜像仓库，并修改相关配置。

   已安装 HARBOR chart repo已安装 CHARTMUSEUM chart repo未安装 chart repo

   若当前环境已安装 HARBOR chart repo，chart-syncer 也支持将 chart 导出为 tgz 文件。

   load-image.yaml

   source:
     intermediateBundlesPath: insight-offline # (1)!
   target:
     containerPrefixRegistry: 10.16.10.111 # (2)!
     appendOriginRegistry: true
     repo:
       kind: HARBOR # (3)!
       url: http://10.16.10.111/chartrepo/release.daocloud.io # (4)!
       auth:
         username: "admin" # (5)!
         password: "Harbor12345" # (6)!
     containers:
       auth:
         username: "admin" # (7)!
         password: "Harbor12345" # (8)!
   

   1. 到执行 charts-syncer 命令的相对路径，而不是此 YAML 文件和离线bundle包之间的相对路径
   2. 需更改为你的镜像仓库 url
   3. 也可以是任何其他支持的 Helm Chart 仓库类别
   4. 需更改为 chart repo project url
   5. 你的镜像仓库用户名
   6. 你的镜像仓库密码
   7. 你的镜像仓库用户名
   8. 你的镜像仓库密码

   若当前环境已安装 CHARTMUSEUM chart repo，chart-syncer 也支持将 chart 导出为 tgz 文件。 当charts-syncer同步成功后，再次同步则会提示 There are no charts out of sync!。可通过/api/charts/insight` 接口查看已有版本号来确定是否同步成功。

   load-image.yaml

   source:
     intermediateBundlesPath: insight-offline # (1)!
   target:
     containerPrefixRegistry: 10.16.10.111 # (2)!
     appendOriginRegistry: true
     repo:
       kind: CHARTMUSEUM # (3)!
       url: http://10.16.10.111 # (4)!
       auth:
         username: "rootuser" # (5)!
         password: "rootpass123" # (6)!
     containers:
       auth:
         username: "rootuser" # (7)!
         password: "rootpass123" # (8)!
   

   1. 到执行 charts-syncer 命令的相对路径，而不是此 YAML 文件和离线 bundle 包之间的相对路径
   2. 需更改为你的镜像仓库 url
   3. 也可以是任何其他支持的 Helm Chart 仓库类别
   4. 需更改为 chart repo url
   5. 你的镜像仓库用户名, 如果 chartmuseum 没有开启登录验证，就不需要填写 auth
   6. 你的镜像仓库密码
   7. 你的镜像仓库用户名
   8. 你的镜像仓库密码

   若当前环境未安装 chart repo，chart-syncer 也支持将 chart 导出为 tgz 文件，并存放在指定路径。

   load-image.yaml

   source:
     intermediateBundlesPath: insight-offline # (1)!
   target:
     containerPrefixRegistry: 10.16.10.111 # (2)!
     repo:
       kind: LOCAL
       path: ./local-repo # (3)!
     containers:
       auth:
         username: "admin" # (4)!
         password: "Harbor12345" # (5)!
   

   1. 到执行 charts-syncer 命令的相对路径，而不是此 YAML 文件和离线包之间的相对路径
   2. 需更改为你的镜像仓库 url
   3. chart 本地路径
   4. 你的镜像仓库用户名
   5. 你的镜像仓库密码

2. 执行同步镜像命令。

   charts-syncer sync --config load-image.yaml --insecure
   

Docker 或 containerd 直接加载¶

解压并加载镜像文件。

1. 解压 tar 压缩包。

   tar -xvf insight_0.25.3.bundle.tar
   

   解压成功后会得到 3 个文件：

   • hints.yaml
   • images.tar
   • original-chart

2. 从本地加载镜像到 Docker 或 containerd。

   Dockercontainerd

   docker load -i images.tar
   

   ctr -n k8s.io image import images.tar
   

升级¶

推荐以下两种升级方式。您可以根据前置操作，选择对应的升级方案。升级前，请关注升级注意事项。 需要注意的是，如果通过 Helm 应用 升级，则需在 Helm 仓库 中进行同步仓库后再升级。

评论