控制任务运行位置：委托和本地操作

默认情况下，Ansible 在与剧本 hosts 行匹配的机器上收集事实并执行所有任务。此页面介绍了如何将任务委托给其他机器或组，将事实委托给特定机器或组，或者在本地运行整个剧本。使用这些方法，您可以精确有效地管理相互关联的环境。例如，更新 Web 服务器时，您可能需要暂时将它们从负载均衡池中删除。您无法在 Web 服务器本身上执行此任务。通过将任务委托给 localhost，您可以在同一剧本中保留所有任务。

无法委托的任务 

某些任务始终在控制节点上执行。这些任务（包括 include、add_host 和 debug）无法委托。您可以从 connection 属性文档确定某个操作是否可以委托。如果 connection 属性指示 support 为 False 或 None，则该操作不使用连接，无法委托。

委托任务 

如果要对一台主机执行任务，并引用其他主机，请在任务中使用 delegate_to 关键字。这非常适合管理负载均衡池中的节点，或控制停机时间。您可以将委托与 serial 关键字一起使用，以控制一次执行的主机数量

---
- hosts: webservers
  serial: 5

  tasks:
    - name: Take out of load balancer pool
      ansible.builtin.command: /usr/bin/take_out_of_pool {{ inventory_hostname }}
      delegate_to: 127.0.0.1

    - name: Actual steps would go here
      ansible.builtin.yum:
        name: acme-web-stack
        state: latest

    - name: Add back to load balancer pool
      ansible.builtin.command: /usr/bin/add_back_to_pool {{ inventory_hostname }}
      delegate_to: 127.0.0.1

此剧本中的第一和第三个任务在 127.0.0.1 上运行，即运行 Ansible 的机器。您还可以使用在每个任务的基础上使用的简写语法：local_action。以下是与上面相同的剧本，但使用简写语法委托给 127.0.0.1

---
# ...

  tasks:
    - name: Take out of load balancer pool
      local_action: ansible.builtin.command /usr/bin/take_out_of_pool {{ inventory_hostname }}

# ...

    - name: Add back to load balancer pool
      local_action: ansible.builtin.command /usr/bin/add_back_to_pool {{ inventory_hostname }}

您可以使用本地操作来调用“rsync”将文件递归地复制到受管服务器

---
# ...

  tasks:
    - name: Recursively copy files from management server to target
      local_action: ansible.builtin.command rsync -a /path/to/files {{ inventory_hostname }}:/path/to/target/

请注意，您必须具有无密码的 SSH 密钥或已配置的 ssh-agent，才能使其正常工作，否则 rsync 会要求输入密码。

要指定更多参数，请使用以下语法

---
# ...

  tasks:
    - name: Send summary mail
      local_action:
        module: community.general.mail
        subject: "Summary Mail"
        to: "{{ mail_recipient }}"
        body: "{{ mail_body }}"
      run_once: True

注意

如果存在，ansible_host 变量和其他连接变量反映的是委托给主机的相关信息，而不是 inventory_hostname。
委托任务的主机不会继承委托任务的主机的变量。

警告

虽然您可以 delegate_to 一个不在清单中的主机（通过添加 IP 地址、DNS 名称或连接插件要求的任何内容），但这不会将主机添加到您的清单中，可能会导致问题。以这种方式委托给的主机不会继承“all”组的变量（假设 VARIABLE_PRECEDENCE 包含 all_inventory）。如果必须 delegate_to 一个非清单主机，请使用 add host 模块。

委托上下文中的模板化 

请注意，在委托下，执行解释器（通常为 Python）、connection、become 和 shell 插件选项现在将使用委托给主机的值进行模板化。除了 inventory_hostname 之外的所有变量现在都将从此主机而不是原始任务主机中获取。如果您需要来自原始任务主机的变量来使用这些选项，则必须使用 hostvars[inventory_hostname]['varname']，即使 inventory_hostname_short 也指的是委托主机。

委托和并行执行 

默认情况下，Ansible 任务是并行执行的。委托任务不会改变这一点，也不会处理并发问题（多个 fork 写入同一文件）。最常见的是，当用户为所有主机更新委托给主机上的单个文件（使用 copy、template 或 lineinfile 模块，例如）时，会遇到此问题。它们仍然将在并行 fork 中运行（默认 5 个），并相互覆盖。

可以通过几种方法来解决此问题

- name: "handle concurrency with a loop on the hosts with `run_once: true`"
  lineinfile: "<options here>"
  run_once: true
  loop: '{{ ansible_play_hosts_all }}'

使用带有 serial: 1 的中间剧本或在任务级别使用 throttle: 1，有关更多详细信息，请参阅控制剧本执行：策略等

委托事实 

委托 Ansible 任务就像在现实世界中委托任务一样 - 您的杂货属于您，即使是其他人将它们送到您的家。同样，委托任务收集的任何事实默认情况下都会分配给 inventory_hostname（当前主机），而不是分配给生成这些事实的主机（委托给主机）。要将收集的事实分配给委托主机而不是当前主机，请将 delegate_facts 设置为 true

---
- hosts: app_servers

  tasks:
    - name: Gather facts from db servers
      ansible.builtin.setup:
      delegate_to: "{{ item }}"
      delegate_facts: true
      loop: "{{ groups['dbservers'] }}"

此任务收集 dbservers 组中机器的事实，并将事实分配给这些机器，即使剧本针对的是 app_servers 组。这样，即使 dbservers 不是剧本的一部分，或通过使用 --limit 被排除在外，您也可以查找 hostvars[‘dbhost1’][‘ansible_default_ipv4’][‘address’]。

本地剧本 

在远程主机上本地使用剧本可能很有用，而不是通过 SSH 连接。这对于通过将剧本放入 crontab 来确保系统配置可能很有用。这也可以用于在操作系统安装程序（如 Anaconda kickstart）中运行剧本。

要本地运行整个剧本，只需将 hosts: 行设置为 hosts: 127.0.0.1，然后像这样运行剧本

ansible-playbook playbook.yml --connection=local

或者，即使剧本中的其他剧本使用默认的远程连接类型，也可以在单个剧本剧本中使用本地连接

---
- hosts: 127.0.0.1
  connection: local

注意

如果将连接设置为本地，并且没有设置 ansible_python_interpreter，则模块将在 /usr/bin/python 下运行，而不是在 {{ ansible_playbook_python }} 下运行。请确保在 host_vars/localhost.yml 中设置 ansible_python_interpreter: “{{ ansible_playbook_python }}”，例如。您可以通过使用 local_action 或 delegate_to: localhost 来避免此问题。

另请参阅

Ansible 剧本: 剧本简介
控制剧本执行：策略等: 更多方法来控制 Ansible 的执行方式和位置
用户邮件列表: 有问题吗？请访问 Google 群组！
实时聊天: 如何加入 Ansible 聊天频道

控制任务运行位置：委托和本地操作

无法委托的任务

委托任务

委托上下文中的模板化

委托和并行执行

委托事实

本地剧本