ansible-pull

从 VCS 仓库拉取 playbook 并将其执行到目标主机上

概要 

usage: ansible-pull [-h] [--version] [-v] [--private-key PRIVATE_KEY_FILE]
                 [-u REMOTE_USER] [-c CONNECTION] [-T TIMEOUT]
                 [--ssh-common-args SSH_COMMON_ARGS]
                 [--sftp-extra-args SFTP_EXTRA_ARGS]
                 [--scp-extra-args SCP_EXTRA_ARGS]
                 [--ssh-extra-args SSH_EXTRA_ARGS]
                 [-k | --connection-password-file CONNECTION_PASSWORD_FILE]
                 [--vault-id VAULT_IDS]
                 [-J | --vault-password-file VAULT_PASSWORD_FILES]
                 [-e EXTRA_VARS] [-t TAGS] [--skip-tags SKIP_TAGS]
                 [-i INVENTORY] [--list-hosts] [-l SUBSET] [--flush-cache]
                 [-M MODULE_PATH]
                 [-K | --become-password-file BECOME_PASSWORD_FILE]
                 [--purge] [-o] [-s SLEEP] [-f] [-d DEST] [-U URL] [--full]
                 [-C CHECKOUT] [--accept-host-key] [-m MODULE_NAME]
                 [--verify-commit] [--clean] [--track-subs] [--check]
                 [--diff]
                 [playbook.yml ...]

描述 

用于在每个受管节点上拉取 Ansible 的远程副本，每个副本都设置为通过 cron 运行并通过源代码库更新 playbook 源。这将 Ansible 的默认 *推送* 架构反转为 *拉取* 架构，后者具有几乎无限的扩展潜力。

没有一个 CLI 工具被设计为与自身同时运行，您应该使用外部调度程序和/或锁定来确保没有冲突的操作。

设置 playbook 可以调整以更改 cron 频率、日志位置和 ansible-pull 的参数。这对于极端扩展以及定期修复都很有用。使用 ‘fetch’ 模块从 ansible-pull 运行中检索日志将是收集和分析 ansible-pull 的远程日志的绝佳方法。

常用选项 

--accept-host-key: 如果尚未添加，则添加仓库 URL 的主机密钥

--become-password-file <BECOME_PASSWORD_FILE>, --become-pass-file <BECOME_PASSWORD_FILE>: 提升权限密码文件

--check: 不进行任何更改；而是尝试预测可能发生的某些更改

--clean: 工作存储库中的已修改文件将被丢弃

--connection-password-file <CONNECTION_PASSWORD_FILE>, --conn-pass-file <CONNECTION_PASSWORD_FILE>: 连接密码文件

--diff: 更改（小）文件和模板时，显示这些文件的差异；与 –check 配合使用效果很好

--flush-cache: 清除清单中每个主机的状态缓存

--full: 执行完整克隆，而不是浅克隆。

--list-hosts: 输出匹配主机的列表；不执行任何其他操作

--private-key <PRIVATE_KEY_FILE>, --key-file <PRIVATE_KEY_FILE>: 使用此文件对连接进行身份验证

--purge: 在 playbook 运行后清除检出

--scp-extra-args <SCP_EXTRA_ARGS>: 指定要传递给 scp 的额外参数（例如 -l）

--sftp-extra-args <SFTP_EXTRA_ARGS>: 指定要传递给 sftp 的额外参数（例如 -f、-l）

--skip-tags: 仅运行其标签与这些值不匹配的 play 和任务。此参数可以多次指定。

--ssh-common-args <SSH_COMMON_ARGS>: 指定要传递给 sftp/scp/ssh 的通用参数（例如 ProxyCommand）

--ssh-extra-args <SSH_EXTRA_ARGS>: 指定要传递给 ssh 的额外参数（例如 -R）

--track-subs: 子模块将跟踪最新的更改。这等效于为 git submodule update 指定 –remote 标记

--vault-id: 要使用的 vault 身份。此参数可以多次指定。

--vault-password-file, --vault-pass-file: vault 密码文件

--verify-commit: 验证签出的提交的 GPG 签名，如果失败，则中止运行 playbook。这需要相应的 VCS 模块来支持此类操作

--version: 显示程序的版本号、配置文件位置、已配置的模块搜索路径、模块位置、可执行文件位置并退出

-C <CHECKOUT>, --checkout <CHECKOUT>: 要检出的分支/标签/提交。默认为仓库模块的行为。

-J, --ask-vault-password, --ask-vault-pass: 询问 vault 密码

-K, --ask-become-pass: 询问提升权限密码

-M, --module-path: 将冒号分隔的路径预置到模块库（默认={{ ANSIBLE_HOME ~ “/plugins/modules:/usr/share/ansible/plugins/modules” }}）。此参数可以多次指定。

-T <TIMEOUT>, --timeout <TIMEOUT>: 以秒为单位覆盖连接超时（默认取决于连接）

-U <URL>, --url <URL>: playbook 仓库的 URL

-c <CONNECTION>, --connection <CONNECTION>

要使用的连接类型（默认=ssh）

-d <DEST>, --directory <DEST>: Ansible 将代码库检出到此目录的路径。

-e, --extra-vars: 设置额外的变量，格式为 key=value 或 YAML/JSON，如果文件名以 @ 开头。此参数可以指定多次。

-f, --force: 即使无法更新代码库，也运行 playbook。

-h, --help: 显示此帮助信息并退出。

-i, --inventory, --inventory-file: 指定清单主机路径或以逗号分隔的主机列表。–inventory-file 已弃用。此参数可以指定多次。

-k, --ask-pass: 询问连接密码。

-l <SUBSET>, --limit <SUBSET>: 将选定的主机进一步限制到其他模式。

-m <MODULE_NAME>, --module-name <MODULE_NAME>: 代码库模块名称，Ansible 将使用它来检出代码库。选项包括 (‘git’, ‘subversion’, ‘hg’, ‘bzr’)。默认为 git。

-o, --only-if-changed: 仅当代码库已更新时才运行 playbook。

-s <SLEEP>, --sleep <SLEEP>: 在开始之前随机休眠一段时间（介于 0 和 n 秒之间）。这是一种分散 git 请求的有用方法。

-t, --tags: 仅运行使用这些值标记的剧本和任务。此参数可以指定多次。

-u <REMOTE_USER>, --user <REMOTE_USER>: 以该用户身份连接（默认值为 None）。

-v, --verbose: 使 Ansible 打印更多调试消息。添加多个 -v 将增加详细程度，内置插件目前最多评估到 -vvvvvv。一个合理的起始级别是 -vvv，连接调试可能需要 -vvvv。此参数可以指定多次。

参数 

playbook.yml: 要作为 Ansible playbook 运行的 YAML 格式文件之一的名称。这可以是检出中的相对路径。默认情况下，Ansible 将根据主机的完全限定域名、主机主机名以及名为 local.yml 的 playbook 来查找 playbook。

环境 

可以指定以下环境变量。

ANSIBLE_INVENTORY – 覆盖默认的 Ansible 清单文件。

ANSIBLE_LIBRARY – 覆盖默认的 Ansible 模块库路径。

ANSIBLE_CONFIG – 覆盖默认的 Ansible 配置文件。

在 ansible.cfg 中还有更多可用于大多数选项的变量。

文件 

/etc/ansible/hosts – 默认清单文件。

/etc/ansible/ansible.cfg – 配置文件，如果存在则使用。

~/.ansible.cfg – 用户配置文件，如果存在则覆盖默认配置。