Prometheus Helm Chart代理模式下移除rule_files字段的配置方法

问题背景 #

在Kubernetes集群中以代理模式部署prometheus-community/helm-charts/prometheus Helm Chart时，prometheus-server Pod陷入CrashLoopBackOff状态，报错信息如下：

"Error loading config (--config.file=/etc/config/prometheus.yml) file=/etc/config/prometheus.yml err="field rule_files is not allowed in agent mode""

手动删除prometheus-server ConfigMap中的rule_files字段后Pod可正常启动，但希望通过配置Helm values避免手动操作，确保部署时rule_files字段从一开始就不存在。当前使用的Helm values.yaml内容如下：

alertmanager:
  enabled: false
prometheus-pushgateway:
  enabled: false
server:
  configPath: /etc/config/prometheus.yml
  defaultFlagsOverride:
  - --enable-feature=agent
  - --config.file=/etc/config/prometheus.yml
  extraFlags:
  - web.enable-lifecycle
  global:
    evaluation_interval: 30s
    scrape_interval: 30s
    scrape_timeout: 10s
  remoteWrite:
  - basic_auth:
      password: xxxx
      username: yyyy
    url: https://my-external-prometheus.com/api/v1/write

解决方法 #

直接在server节点下添加两行配置，彻底让Helm不生成rule_files字段：

ruleFiles: null
rules:
  enabled: false

修改后的完整values.yaml如下：

alertmanager:
  enabled: false
prometheus-pushgateway:
  enabled: false
server:
  configPath: /etc/config/prometheus.yml
  defaultFlagsOverride:
  - --enable-feature=agent
  - --config.file=/etc/config/prometheus.yml
  extraFlags:
  - web.enable-lifecycle
  global:
    evaluation_interval: 30s
    scrape_interval: 30s
    scrape_timeout: 10s
  remoteWrite:
  - basic_auth:
      password: xxxx
      username: yyyy
    url: https://my-external-prometheus.com/api/v1/write
  # 新增配置：禁止生成rule_files字段
  ruleFiles: null
  rules:
    enabled: false

原理说明 #

• rules.enabled: false：关闭Helm Chart默认的规则配置生成逻辑，不会创建任何规则文件；
• ruleFiles: null：触发Chart模板的条件判断，使其不在prometheus.yml中生成rule_files字段，完全符合Prometheus代理模式的配置要求，避免触发报错。

内容的提问来源于stack exchange，提问作者Andriy Simonov