Ansible模板仅在文件内容不同时执行的实现问题

我刚接触Ansible，正在编写首个Linux服务器初始化配置的playbook，需求是让Jinja2模板仅在目标文件不存在或内容与渲染后的模板不一致时才应用，内容完全相同则跳过任务。

我已经为时区配置实现了这个逻辑：

- name: Check current Timezone
    command: timedatectl show --property=Timezone --value
    register: timezone_output
    changed_when: false

  - name: Configure Timezone
    command: timedatectl set-timezone {{ timezone }}
    when: timezone_output.stdout != timezone

但在处理文件内容对比时遇到问题：明明文件内容一致，计算出的校验和却不相等，我尝试的代码如下：

---
- name: Calculate checksum of Jinja2 template
  set_fact:
    template_content: "{{ lookup('file', 'templates/sshd_config.j2') }}"

- name: Display checksum template
  debug:
    var: template_content | md5

- name: Calculate checksum of remote file
  command: md5sum /etc/ssh/sshd_config.d/initial.conf
  register: md5sum_output
  changed_when: false
  check_mode: no

- set_fact:
    remote_file_checksum: "{{ md5sum_output.stdout.split()[0] }}"
      
- name: Display checksum
  debug:
    var: remote_file_checksum

- name: Update SSH configuration
  template:
    src: sshd_config.j2
    dest: /etc/ssh/sshd_config.d/initial.conf
  notify: Reload SSH Service

由于我有多个需要应用模板的角色，实现内容一致时跳过任务的逻辑对后续评估任务状态非常重要。

解决方案 #

1. 无需手动计算校验和，template模块自带对比逻辑 #

Ansible的template模块本身就内置了内容对比功能：它会先在本地渲染Jinja2模板（替换所有变量），然后将渲染后的内容与远程目标文件的内容进行对比，只有当两者不一致时才会更新文件并触发notify，内容一致则直接跳过任务，显示ok状态。

你之前的问题出在手动计算校验和时，获取的是模板原始文件的内容（未替换变量），而远程文件是已经渲染好的最终内容，两者自然MD5值不同。

正确的写法只需保留template任务即可，不需要那些校验和计算步骤：

- name: Update SSH configuration
  template:
    src: sshd_config.j2
    dest: /etc/ssh/sshd_config.d/initial.conf
  notify: Reload SSH Service

运行playbook时加上-v参数，可以清晰看到任务状态：内容一致时显示ok: [host]，内容变化时显示changed: [host]。

2. 时区配置改用官方模块更规范 #

你之前的时区配置可以用Ansible官方的timezone模块替代手动命令，同样自带状态检测逻辑：

- name: Configure Timezone
  timezone:
    name: "{{ timezone }}"

这个模块会自动检测当前系统时区是否与目标值一致，不一致才会修改，无需额外的检查任务，更符合Ansible的最佳实践。

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