模块类型

核心模块（Core Module）

无需额外下载和配置，在安装 Ansible 后就可以直接使用的；常用；经过严格测试；

附加模块（Extra Module）

需进行下载和额外的配置才能使用；不常用；可能包含 BUG 的模块；

安装附加模块

如果需要使用某个附加模块，则需要单独安装。介绍三种方法安装附加模块：

第一步、下载附加模块

下载 Ansible Module Extra 项目：git clone https://github.com/ansible/ansible-modules-extras.git

第二步、安装附加模块

方法一：全局有效。修改 /etc/ansible/ansible.cfg 配置文件，加入 library=/path/to/ansible-modules-extras/ 行。

方法二：当前目录。修改与 Playbook 同级目录的 ansible.cfg 配置文件，使其只对当前目录的 Playbook 生效。修改方法与「方法一」类似，但可以使用相对路径。

方法三：环境变量。export ANSIBLE_LIBRARY=/path/to/ansible-modules-extras/

模块使用方法

如何查看模块使用方法？

#!/bin/sh

ansible-doc "<module_name>"

# Core 模块可以在任何目录下执行，例如查看yum的用法：
ansible-doc yum

# Extra 模块必须在配置了 Extra 模块的目录下查看其用法。
ansible-doc archive

常用模块及文档

setup – Gathers facts about remote hosts

env – read the value of environment variables

debug – Print statements during execution

相关链接

Docs » User Guide » Working With Modules