如何让Ansible的shell任务具备幂等性？

单任务幂等实现方案 #

你提到的通过标记文件实现幂等的方案完全可行，Ansible的shell、command模块原生支持creates参数，不需要额外编写判断逻辑。
creates参数的逻辑是：如果指定的文件路径已存在，直接跳过当前任务，状态标记为ok；如果文件不存在才执行任务，执行成功后状态标记为changed。你只需要在脚本执行成功后生成对应的标记文件即可，修改你的示例任务如下：

- name: Add release application config
  become: yes  
  shell: "./applicationConfig.sh && touch /opt/.ansible_marks/app_config_done"
  args:
    creates: /opt/.ansible_marks/app_config_done
  tags: upgrade

如果你的脚本本身执行成功后会生成固定的产出文件（比如配置文件、初始化完成标识等），可以直接用该产出文件作为creates的判断依据，不需要额外创建标记文件。

全局规则统一配置方案 #

不需要每个任务单独重复配置幂等逻辑，两种常用方案可以实现规则复用：

方案1：play级别配置module_defaults #

在play的开头统一给所有shell、command模块配置默认的creates规则，结合Ansible内置变量自动生成每个任务的唯一标记文件：

- name: 应用部署play
  hosts: your_target_hosts
  vars:
    # 统一存放所有标记文件的目录
    ansible_mark_dir: /opt/.ansible_deploy_marks
    # 可选：配置强制执行开关，跑play时加-e force_run=true可忽略所有标记重跑
    force_run: false
  module_defaults:
    shell:
      creates: "{{ not force_run | default(false) | ternary(ansible_mark_dir ~ '/' ~ ansible_task_name | hash('sha1'), omit) }}"
    command:
      creates: "{{ not force_run | default(false) | ternary(ansible_mark_dir ~ '/' ~ ansible_task_name | hash('sha1'), omit) }}"
  pre_tasks:
    # 提前创建标记目录
    - name: 初始化Ansible幂等标记目录
      file:
        path: "{{ ansible_mark_dir }}"
        state: directory
        mode: '0700'

配置完成后，你不需要修改原有任务的其他参数，只需要在每个shell脚本的末尾加一行touch {{ creates }}即可自动生成对应标记文件，所有任务自动具备幂等性。

方案2：封装可重用任务模板 #

如果你不想修改原有脚本，可以把幂等逻辑封装为独立的公共任务文件，所有shell任务统一调用即可：

1. 新建公共任务文件tasks/idempotent_shell.yml

- name: "执行幂等任务: {{ task_name }}"
  shell: "{{ task_command }}"
  become: "{{ task_become | default('no') }}"
  args:
    creates: "{{ not force_run | default(false) | ternary(ansible_mark_dir ~ '/' ~ task_name | hash('sha1'), omit) }}"
  register: shell_exec_result
  changed_when: shell_exec_result.rc == 0 and not shell_exec_result.skip | default(false)
  tags: "{{ task_tags | default([]) }}"

- name: 生成任务成功标记
  file:
    path: "{{ ansible_mark_dir }}/{{ task_name | hash('sha1') }}"
    state: touch
  when: shell_exec_result is changed

2. 原有任务替换为调用公共模板即可：

- include_tasks: tasks/idempotent_shell.yml
  vars:
    task_name: Add release application config
    task_command: "./applicationConfig.sh"
    task_become: yes
    task_tags: upgrade

后续要调整幂等规则只需要修改公共任务文件即可，不会产生任何冗余配置。

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