本文永久链接: 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。

解决方法

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

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

    • Rancher HA ： 通过 chart 安装 rancher 的时候，添加 --set useBundledSystemChart=true。
    • Rancher 单容器：Rancher 单容器安装，传递环境变量： CATTLE_SYSTEM_CATALOG=bundled。

  3. 如果要从内置 system chart 切换到外部 git repo，需要添加环境变量：CATTLE_SYSTEM_CATALOG=external。