Ansible CLI 速查表

此页面显示了每个 Ansible 命令行实用程序的一个或多个示例，其中添加了一些常见的标志，并提供了指向该命令完整文档的链接。此页面仅提供一些常见用例的快速提醒 - 它可能已过时或不完整，或者两者兼而有之。有关规范文档，请按照链接到 CLI 页面的链接进行操作。

ansible-playbook 

ansible-playbook -i /path/to/my_inventory_file -u my_connection_user -k -f 3 -T 30 -t my_tag -M /path/to/my_modules -b -K my_playbook.yml

从当前工作目录加载my_playbook.yml，并

-i - 使用my_inventory_file（在提供的路径中）作为清单，以匹配模式。
-u - 以my_connection_user身份通过 SSH 连接。
-k - 请求密码，然后将其提供给 SSH 身份验证。
-f - 分配 3 个fork。
-T - 设置 30 秒的超时时间。
-t - 仅运行标记有标签my_tag的任务。
-M - 从/path/to/my/modules加载本地模块。
-b - 以提升的权限执行（使用become）。
-K - 提示用户输入 become 密码。

请参阅ansible-playbook以获取详细文档。

ansible-galaxy 

安装集合 

安装单个集合

ansible-galaxy collection install mynamespace.mycollection

从配置的 Galaxy 服务器（默认为galaxy.ansible.com）下载mynamespace.mycollection。

安装集合列表

ansible-galaxy collection install -r requirements.yml

下载requirements.yml文件中指定的集合列表。

列出所有已安装的集合

ansible-galaxy collection list

安装角色 

安装名为example.role的角色

ansible-galaxy role install example.role

# SNIPPED_OUTPUT
- extracting example.role to /home/user/.ansible/roles/example.role
- example.role was installed successfully

列出所有已安装的角色

ansible-galaxy role list

请参阅ansible-galaxy以获取详细文档。

ansible 

运行 Ad-hoc 命令 

安装软件包

ansible localhost -m ansible.builtin.apt -a "name=apache2 state=present" -b -K

运行ansible localhost- 在您的本地系统上。 - name=apache2 state=present - 在基于 Debian 的系统上安装apache2软件包。 - -b - 使用become以提升的权限执行。 - -m - 指定模块名称。 - -K - 提示输入提权密码。

localhost | SUCCESS => {
"cache_update_time": 1709959287,
"cache_updated": false,
"changed": false
#...

ansible-doc 

显示插件名称及其源文件

ansible-doc -F
#...

显示可用的插件

ansible-doc -t module -l
#...

Ansible CLI 速查表

ansible-playbook

ansible-galaxy

安装集合

安装角色

ansible

运行 Ad-hoc 命令

ansible-doc