1. ansible命令集

ansible: 定义并运行简单任务。

ansible-config: 查看、编辑、管理ansible配置。

ansible-doc: 文档查看工具。

ansible-galaxy:共享和下载roles的工具。

ansible-inventory:查看inventory的信息。

ansible-playbook:执行playbook。

ansible-pull: 从仓库中拉去playbook。

ansible-vault: 文件加密工具。

ansible-console: repl控制台执行ansible任务。

2. ansible模块

ansible给我们提供了很多的常用模块, 我估计你自己想用的模块, 基本都可以找到, 我们在写功能的时候, 首先来查一下, 已经有很大大佬给我们写了很多模块了, 足够你使用了.

针对下面的模块, 我建议大家还是扫一眼, 万一以后用到呢, 其实找到下面的模块, 你知道它已经有了, 就没必要自己去写了.针对能用到的, 我都进行加粗处理了,大家扫一眼, 了解一下.

ansible 2.2.0.0ansible-doc -l

add_host 将主机（以及组）添加到ansible-playbook内存库存中

apk 管理apk包

apt 管理apt-packages

assemble 从片段组装配置文件

capabilities 管理Linux功能

command 在远程节点上执行命令

composer Dependency Manager for PHP

consul 在consul集群中添加，修改和删除服务。

consul_acl 操纵领事密钥和规则

consul_kv 处理consul集群的键/值存储中的条目。

consul_session 操纵consul会话将

copy 文件复制到远程位置

cron 管理cron.d和crontab条目。

cronvar 用crontabs管理变量

crypttab 加密的Linux块设备

debug 打印语句

docker 管理docker容器

docker_container 管理docker容器

docker_image 管理docker镜像。

docker_image_facts 检查docker镜像

docker_login 登录Docker注册表。

docker_network 管理Docker网络

docker_service 管理docker服务和容器。

docker_swarm_service 管理Docker网络

easy_install 安装Python库

facter 在远程系统上运行发现程序'facter'

fail 使用自定义消息时失败

fetch 从远程节点获取文件

file 设置文件的属性

filesystem 使块设备上的文件系统

find 根据特定条件返回文件列表

firewalld 使用firewalld

gem 管理Ruby gems将

get_url 文件从HTTP，HTTPS或FTP下载到节点

git 从git checkouts部署软件（或文件）

git_config 读取和写入git配置

github_hooks 管理github服务挂钩。

github_key 管理GitHub访问密钥。

github_release 与GitHub版本互动

gitlab_group 创建/更新/删除Gitlab组

gitlab_project 创建/更新/删除Gitlab项目

gitlab_user 创建/更新/删除Gitlab用户

gluster_volume 管理GlusterFS卷

group 添加或删除

group_by 组根据事实创建Ansible组

homebrew Homebrew的包管理器

homebrew_cask 安装/卸载自制垃圾桶。

homebrew_tap 点击Homebrew存储库。

honeybadger_deployment 通知Honeybadger.io有关应用程序部署的信息

hostname 管理主机名

htpasswd 管理用户文件以进行基本身份验证

include 包括播放或任务列表。

include_role 加载并执行角色

include_vars 在任务中动态加载文件中的变量。

influxdb_database 管理InfluxDB数据库

influxdb_retention_policy 管理InfluxDB保留策略

iptables 修改系统iptables

jenkins_job 管理jenkins作业

jenkins_plugin 添加或删除Jenkins插件

jira 在JIRA实例中创建和修改问题在

mail 发送电子邮件

mssql_db 从远程主机添加或删除MSSQL数据库。

mysql_db 从远程主机添加或删除MySQL数据库。

mysql_replication 管理MySQL复制

mysql_user 在MySQL数据库中添加或删除用户。

mysql_variables 管理MySQL全局变量

npm 管理node.js软件包

pacemaker_docker_ocf 管理Docker网络

pacemaker_service 管理Docker网络

pacemaker_vip 管理Docker网络

package 通用OS包

patch 使用GNU修补程序工具应用修补程序文件。

pause 暂停playbook执行

ping 尝试连接到主机，验证可用的python并在成功时返回“pong”。

pip 管理Python库依赖项。

redis 各种redis命令，slave和flush

selinux 更改

service 管理服务。

set_fact 从任务中设置主机事实

setup 收集有关远程主机的事实

shell 在节点中执行命令。

slurp 从远程节点中刷新文件

snmp_facts 使用SNMP检索设备的事实。

synchronize 使用rsync可以快速轻松地在手册中同步文件路径。

sysctl 管理sysctl.conf中的条目。

systemd 管理服务。

template 将文件模板到远程服务器。

timezone 配置时区设置

twilio 通过Twilio向手机发送短信。

typetalk 发送消息到typetalk

user 管理用户帐户

wait_for 在继续之前等待条件。

yum 使用'yum'包管理器管理包

yum_repository 添加和删除YUM存储库

zabbix_group Zabbix主机组创建/删除

zabbix_host Zabbix主机创建/更新/删除

zabbix_hostmacro Zabbix主机宏创建/更新/删除

zabbix_maintenance 创建Zabbix维护窗口

zabbix_screen Zabbix屏幕创建/更新/删除

docker 管理docker容器上启用加速模式

windows相关

win_acl 为系统用户或组设置文件/目录权限。

win_acl_inheritance 更改ACL继承

win_chocolatey 使用chocolatey安装软件包

win_command 在远程Windows节点上执行命令将

win_copy 文件复制到Windows主机上的远程位置。

win_dotnet_ngen 在.NET更新后运行ngen以重新编译DLL

win_environment 在Windows主机上修改环境变量。

win_feature 在Windows Server上安装和卸载Windows功能

win_file 创建，触摸或删除文件或目录。

win_file_version 获取DLL或EXE文件构建版本

win_firewall_rule Windows防火墙自动化

win_get_url 从给定URL获取文件

win_group 添加和删除本地组

win_iis_virtualdirectory 在IIS中配置虚拟目录。

win_iis_webapplication 配置IIS Web应用程序。

win_iis_webapppool 配置IIS Web应用程序池。

win_iis_webbinding 配置IIS网站。

win_iis_website 配置IIS网站。

win_lineinfile 确保特定行位于文件中，或使用反向引用的正则表达式替换现有行。

win_msi 安装和卸载Windows MSI文件

win_nssm NSSM - 非吸吮服务管理器

win_owner 集所有者

win_package 从本地文件系统或URL安装/卸载可安装程序包

win_ping 经典ping模块的Windows版本。

win_reboot 重启Windows机器

win_regedit 添加，编辑或删除注册表项和值

win_regmerge 将注册表文件的内容合并到Windows注册表中

win_robocopy 使用Robocopy同步两个目录的内容。

win_scheduled_task 管理计划任务

win_service 管理Windows服务

win_share 管理Windows共享

win_shell 在目标主机上执行shell命令。

win_stat 返回有关Windows文件的信息将文件

win_template 模板发送到远程服务器。

win_timezone 设置Windows机器时区

win_unzip 在Windows节点上解压缩压缩文件和存档

win_updates 下载并安装Windows更新

win_uri 与webservices交互。

win_user 管理本地Windows用户帐户

win_webpicmd 使用Web Platform Installer安装程序包命令行

3. ansible自定义module

Ansible提供了许多模块实用程序，它们提供了在开发自己的模块时可以使用的辅助功能。basic.py模块为程序提供访问Ansible库的主要入口点，所有Ansible模块必须至少从basic.py导入: from ansible.module_utils.basic import *

AnsibleModule 提供和很多通用的函数来处理返回值, 分析参数并允许你检查输入:

成功返回
module.exit_json(changed=True, something_else=12345)
失败退出
module.fail_json(msg="Something fatal happened")

Ansible组成：

tree /etc/ansible/

/etc/ansible/

├── ansible.cfg # ansible的配置文件

├── hosts # ansible的主仓库用来存储需要管理的远程主机的相关信息

└── roles

首先先创建一个存放ansible自定义模板的路径：

mkdir /usr/share/ansible 自定义可以根据自己的环境进行选择或创建

然后在ansible配置文件/etc/ansible/ansible.cfg开放自定义模板路径的配置：

Library=/usr/share/ansible

1. 不带参数

无参数ansible自定模块实例：an_demo.py

from ansible.module_utils.basic import *

module = AnsibleModule(argument_spec = dict())

result = dict(echo=‘pong’)

module.exit_json(**result)

2. 带参数

带参ansible自定义模块实例：an_param_demo.py

from ansible.module_utils.basic import *
module =AnsibleModule(argument_spec = dict(arg = dict(required = True)))
param = module.params[‘arg’]
if param == ‘1’:    
 result = dict(echo = ‘success’)    
 module.exit_json(**result)
else:    
 result = dict(echo = ‘failed’，msg= 0)    
 module.fail_json(**result)