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] [-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: 如果 repo 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 配合使用效果很好

--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: 仅运行标签与这些值不匹配的剧本和任务。此参数可以多次指定。

--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: 将冒号分隔的路径(s)附加到模块库的前面（默认值={{ 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: 设置额外的变量，以键值对或 YAML/JSON 格式指定，如果文件名以 @ 开头，则将其作为文件名。此参数可以多次指定。

-f, --force: 即使仓库无法更新，也运行剧本。

-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: 仅当仓库已更新时才运行剧本。

-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 剧本运行的 YAML 格式文件的名称。这可以是检出中的相对路径。默认情况下，Ansible 会根据主机的完全限定域名、主机主机名以及名为 *local.yml* 的剧本查找剧本。

环境 

可以指定以下环境变量。

ANSIBLE_INVENTORY – 覆盖默认的 Ansible 库存文件。

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

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

ansible.cfg 中的多数选项都支持更多的环境变量。

文件 

/etc/ansible/hosts – 默认库存文件。

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

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