本文永久链接: https://www.xtplayer.cn/rancher/cattle-global-data-system-library-rancher-monitoring-not-found/

rancher2.x 环境下,可能会出现以下错误信息,尤其是在离线环境下更容易出现。

CatalogTemplate.management.cattle.io "cattle-global-data/system-library-rancher-monitoring" not found。

问题分析

  1. rancher2.x 很多附件功能是以 helm chart 部署,比如 monitoring。在 全局|工具|商店设置 可以看到 system-library 这个 repo,这个 repo 中存放了 system 相关的 helm chart

  2. rancher 在启动时会去 system-library repo 拉取 helm chart 文件,如果无法拉取 chart 文件,CatalogTemplate control 就会提示:

    CatalogTemplate.management.cattle.io "cattle-global-data/system-library-rancher-monitoring" not found。

    解决方法

  3. 如果是离线环境,可以把 https://github.com/rancher/system-charts 同步到本地 git 查看,然后在 全局|工具|商店设置 中修改 system-library 中对应的 URL 地址。

  4. 从 rancher v2.3.0 版本开始,system-library 相关的 chart 已内置到镜像中,只需要在安装的时候设置使用内置 chart 即可。

    • Rancher HA : 通过 chart 安装 rancher 的时候,添加 --set useBundledSystemChart=true
    • Rancher 单容器:Rancher 单容器安装,传递环境变量: CATTLE_SYSTEM_CATALOG=bundled
  5. 如果要从内置 system chart 切换到外部 git repo,需要添加环境变量:CATTLE_SYSTEM_CATALOG=external