Ansible任务优化需求：满足条件时仅执行一次容器内命令

你的需求很清晰：不想固定在主机组的第一台执行，而是要在任意一台存在目标容器的主机上只执行一次最后的命令，同时避免在无容器主机上触发报错。这里有个可靠的实现思路：先筛选出符合条件的主机，再在这个子集内执行单次任务。

修改后的Playbook示例 #

- name: 检查目标服务容器是否存在
  shell: docker ps | grep '{{service}}:'
  register: ps
  changed_when: ps.stdout != ""
  # 避免grep未匹配到内容时触发任务失败
  failed_when: false

- name: 标记存在目标容器的主机
  set_fact:
    has_target_container: true
  when: ps.stdout != ""

- name: 按容器存在状态动态分组
  group_by:
    key: "has_target_container_{{ has_target_container | default(false) }}"
  run_once: yes

- name: 获取目标容器ID（仅在有容器的主机执行）
  shell: docker ps | grep '{{service}}:' | awk '{print $1}'
  register: container_id
  when: has_target_container is defined

- name: 仅在任意一台有容器的主机执行最终命令
  shell: docker exec -i {{ container_id.stdout }} bash -c 'pwd'
  register: pwd
  delegate_to: "{{ groups['has_target_container_true'] | first }}"
  run_once: yes
  when: groups['has_target_container_true'] is defined and groups['has_target_container_true'] | length > 0

- name: 输出命令执行结果
  debug:
    var: pwd.stdout_lines
  when: pwd is defined

关键步骤解释 #

1. 标记符合条件的主机：通过set_fact给存在目标容器的主机打上has_target_container: true的标记，无容器的主机不会生成这个事实变量。
2. 动态分组：用group_by把有标记的主机分到临时组has_target_container_true中，run_once: yes确保分组操作仅执行一次。
3. 指定执行主机：通过delegate_to选择临时组内的第一台主机（该组内所有主机都存在目标容器，选任意一台均可），配合run_once: yes实现单次执行。同时增加判断条件，确保临时组存在且非空时才执行，彻底避免无匹配主机时的报错。

这样修改后，不管主机组规模多大，只要有至少一台存在目标容器，最终命令就会在其中一台执行一次；如果所有主机都无目标容器，该任务会自动跳过，不会触发任何错误。

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