无法更新Prometheus Ansible Role中的配置属性

使用Prometheus社区Ansible Role部署Prometheus，自定义playbook配置后，修改了Role内的模板文件与任务文件，但运行playbook后出现以下问题：

• 生成的Prometheus配置仍使用默认路径，自定义的rules.d路径未生效
• 手动添加的Role任务未执行
• 运行时触发SCP/SFTP传输失败警告
• 手动修改服务器配置后，再次运行playbook也未将配置重置为默认（说明Role的配置任务未执行）

排查与解决步骤 #

1. 先解决SCP/SFTP传输失败问题 #

传输失败会导致Role的模板、配置文件无法正常推送，直接引发后续任务不执行：

• 强制Ansible使用paramiko作为传输方式，在inventory或playbook中添加变量：

  ansible_ssh_transfer_method: paramiko
  

• 检查跳板机与目标服务器的SSH配置，确保scp命令可用；确认目标服务器/sites/prometheus目录存在且权限符合要求（如root可读写）

2. 确保Role修改被正确加载 #

直接修改社区Role文件时，需确认Ansible加载的是你修改的版本：

• 运行playbook时添加-vvv参数，查看输出中Role的加载路径，确认指向你修改的目录
• 建议使用项目内Role覆盖替代直接修改社区Role：在项目目录下创建roles/prometheus/templates和roles/prometheus/tasks目录，将修改后的prometheus.yml.j2和configure.yml放入对应路径，Ansible会优先加载项目内的文件，避免后续更新Role时覆盖自定义内容

3. 检查Role任务的执行逻辑 #

修改configure.yml时，需确保任务逻辑完整且无跳过条件：

• 确认复制规则文件的任务包含完整循环与通知重启逻辑，示例：

  - name: Copy prometheus alert rules files
    copy:
      src: "{{ item }}"
      dest: "{{ prometheus_config_dir }}/rules.d/"
      owner: root
      mode: 0644
    with_items: "{{ prometheus_alert_rules_files }}"
    notify: restart prometheus
  

• 通过-vvv输出检查该任务是否被when条件限制执行

4. 验证模板渲染逻辑 #

修改prometheus.yml.j2后，确认渲染条件满足：

• 检查prometheus_agent_mode变量是否为false（默认值即为false，除非主动开启agent模式）
• 确认prometheus_alert_rules_files非空（你的playbook已配置该变量，条件应满足）
• 运行以下命令单独测试模板渲染，查看生成的配置是否正确：

  ansible prometheus-server -m template -a "src=roles/prometheus/templates/prometheus.yml.j2 dest=/tmp/test_prometheus.yml" -e "@playbook.yaml" -vvv
  

  查看/tmp/test_prometheus.yml，确认rule_files块是否正确生成

5. 清除Ansible缓存并检查执行顺序 #

• 运行playbook时添加--flush-cache参数，清除可能存在的facts或任务结果缓存
• 检查playbook是否使用了tags导致配置任务被跳过；确认become: true已生效（通过-vvv输出查看是否获取root权限）

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