ansible module
ansible ad-hoc模式常用模块
ansible-doc常用命令
ansible-doc -h #ansible-doc命令使用帮助
-j #以json格式显示所有模块信息
-l #列出所有的模块,可加 wc -l统计
-s #查看模块常用参数
1、命令相关的模块
1.1、command 默认模块,执行命令,shell中的"<", ">", "|", ";", "&","$"等特殊字符不能在command模块中使用,如需使用则用shell模块
ansible-doc -s command #查看模块参数
ansible 192.168.10.186 -a 'ls' #在主机上执行ls命令,默认是在当用户家目录/root
ansible 192.168.10.186 -a 'chdir=/tmp pwd' #切到工作目录,再执行后面命令,编译时可使用
ansible 192.168.10.186 -a 'creates=/tmp ls /etc/passwd' #如果创建的文件或目录已存在,则不执行后面的命令
ansible 192.168.10.186 -a 'creates=/tmp1 ls /etc/passwd' #tmp1文件不存在,则执行后面的ls命令
#removes, 和creates相反,如果removes的文件存在,才执行后面的操作
ansible 192.168.10.186 -a 'removes=/tmp ls /etc/passwd' #tmp文件存在,则执行后面的ls命令
ansible 192.168.10.186 -a 'removes=/tmp1 ls /etc/passwd' #tmp1文件不存在,则不执行后面ls命令
1.2、shell, 专门用来执行shell命令的模块,chdir,creates,removes等参数
ansible-doc -s shell #查看模块参数
ansible 192.168.10.186 -m shell -a 'mkdir /root/tmp'
ansible 192.168.10.186 -m shell -a 'ls /root/'
ansible 192.168.10.186 -m shell -a 'cd /root/tmp && touch 1.txt && ls' #每次执行都会更新文件的时间戳
ansible 192.168.10.186 -m shell -a 'creates=/root/tmp/1.txt cd /root/tmp && touch 1.txt && ls' #判断如果存在文件,就不执行后面的创建,保留文件的时间戳
1.3、script, 用于在被管理的机器上执行shell脚本的模块,脚本无需在被管理机器上面存在
ansible-doc -s script #查看模块参数
cat test.sh #服务端创建脚本
#!/bin/bash
echo `hostname`
ansible all -m script -a '/root/test.sh' #在所有被管理机器上执行该脚本
2、文件相关的模块
2.1、file, 用于对文件的处理,创建,删除,权限控制等
ansible-doc -s file #查看模块相关参数
path #要管理的文件路径
recurse #递归
state: directory #创建目录,如目标不存在则创建目录及其子目录
touch #创建文件,如果文件存在,则修改文件属性
absent #删除文件或目录
mode #设置文件或目录权限
owner #设置文件或目录属主信息
group #设置文件或目录属组信息
link #创建软连接,需要和src配合使用
hard #创建硬连接,需要和src配合使用
ansible 192.168.10.186 -m file -a 'path=/root/test1 state=directory' #创建目录
ansible 192.168.10.186 -m file -a 'path=/root/test1/1.txt state=touch' #创建文件
ansible 192.168.10.186 -m file -a 'src=/root/test1 path=/root/test10 state=link' #创建软链接(src表示源文件,path表示目标文件)
ansible 192.168.10.186 -m file -a 'path=/root/test10 state=absent' #删除文件
ansible 192.168.10.186 -m file -a 'path=/root/test1/2.txt state=touch mode=775 owner=root group=jenkins' #创建文件时同时设置权限属主属组信息
2.2、copy, 用于管理端复制文件到远程被管理主机,并可以设置权限,属主组等
ansible-doc -s copy #查看模块参数
src #需要copy的文件的源路径
dest #需要copy的文件的目标路径
backup #对copy的文件进行备份
content #直接在远程主机被管理文件中添加内容,会覆盖源文件内容
mode #对copy到远端文件设置权限
owner #对copy到远端文件设置属主
group #对copy到远端文件设置属组
ansible 192.168.10.186 -m copy -a 'dest=/root/test1/aa.sh src=/root/test.sh backup=yes'
#复制文件到远程主机并改名,并备份远程文件,(安装时间信息备份文件,当更新文件内容后,重新copy时用到)
ansible 192.168.10.186 -m copy -a 'dest=/root/test1/aa.sh content="#!/bin/bash \n echo `uptime`"'
#直接在远程主机aa.sh中添加内容
ansible 192.168.10.186 -m copy -a 'dest=/root/test1/passwd src=/etc/passwd mode=700 owner=jenkins group=postfix'
#复制文件到远程主机,并设置权限和属主组信息
2.3、fetch, 用于从被管理主机上面拉取文件,拉取下来的内容会保留目录结构,一般用于收集被管理机器的日志文件等
ansible-doc -s fetch
src #指定需要从远端机器拉取的文件路径
dest #指定从远端机器拉取下来后文件的存放路径
ansible 192.168.10.186 -m fetch -a 'dest=/root/test1 src=/var/log/messages' #从被管理机器上拉取messages日志文件,默认会以管理节点的ip创建目录
tree test1
test1
└── 192.168.10.186
└── var
└── log
├── cron
└── messages
3、用户相关的模块
3.1、user,用于对系统用户的管理,用户的创建,删除,家目录,属组等设置
ansible-doc -s user
name #指定用户的名字
home #指定用户的家目录
uid #指定用户的uid
group #指定用户的用户组
groups #指定用户的附加组
password #指定用户的密码
shell #指定用户的登录shell
create_home #是否创建用户家目录,默认是yes
remove #删除用户时,指定是否删除家目录
state: absent #删除用户
ansible 192.168.10.186 -m user -a 'name=test1 shell=/bin/nologin uid=1003 group=root create_home=no'
#创建用户指定uid及组,不创建家目录并且不允许登录
ansible 192.168.10.186 -m shell -a 'id test1 && tail -l /etc/passwd'
#创建用户指定uid及组,不创建家目录并且不允许登录
ansible 192.168.10.186 -m shell -a 'id test1 && tail -l /etc/passwd'
#查看创建的用户信息
ansible 192.168.10.186 -m user -a 'name=test1 state=absent
#删除用户,加上remove=yes 则删除家目录
3.2、group, 当创建用户时需要指定组,如不存在则可以通过group先创建组
ansible-doc -s group #查看模块参数
name #指定组的名字
gid #指定组的id
state: absent#删除组 present#创建组(默认此状态)
ansible 192.168.10.186 -m group -a 'name=test2 gid=1005'
#创建组,指定id
ansible 192.168.10.186 -m group -a 'name=test2 state=absent'
#删除组
4、软件包相关模块
4.1、yum, 对软件包管理,下载,安装,卸载,升级等操作
ansible-doc -s yum #查看模块参数
name #指定要操作的软件包名字
download_dir #指定下载软件包存放路径,需跟download_only一起使用
download_only #只下载软件包,不安装
list: installed #列出所有已安装的软件包
updates #列出所有可更新的软件包
repos #列出所有的yum仓库
state: installed,present #安装软件包
removed,absent #卸载软件包
latest #安装最新软件包
ansible 192.168.10.186 -m yum -a 'list=installed'
#列出所有已安装的软件包
ansible 192.168.10.186 -m yum -a 'list=updates' |more
#列出所有可更新的软件包
ansible 192.168.10.186 -m yum -a 'list=repos' |more
#列出所有的yum仓库
ansible 192.168.10.186 -m yum -a 'name=httpd download_only=yes download_dir=/tmp'
#下载软件包到指定目录
ansible 192.168.10.186 -m yum -a 'name=httpd state=installed'
#安装软件包
ansible 192.168.10.186 -m yum -a 'name=httpd state=removed'
#卸载软件包
ansible 192.168.10.186 -m yum -a 'name="@Development Tools" state=installed'
#安装包组,类似 yum groupinstall 'Development Tools'
4.2、pip, 用于安装python中的包
ansible-doc -s pip #查看模块参数
ansible 192.168.10.186 -m yum -a 'name=epel-release state=installed'
#先安装扩展源EPEL
ansible 192.168.10.186 -m yum -a 'name=python-pip state=installed'
#下载安装pip
ansible 192.168.10.186 -m pip -a 'name=flask'
#安装flask
4.3、service, 服务模块,对服务进行管理,启动,关闭,开机自启等
ansible-doc -s service #查看模块参数
name #指定需要管理的服务名
enabled #指定是否开机自启动
state: started #启动服务
stopped #停止服务
restarted #重启服务
reloaded #重载服务
ansible 192.168.10.186 -m service -a 'name=crond state=started enabled=yes'
#启动服务,设定开机自启
5、计划任务相关模块
5.1、cron, 用于指定计划任务,和crontab -e一样
ansible-doc -s cron #查看模块参数
job #指定需要执行的任务
minute #分钟
hour #小时
day #天
month #月
weekday #周
name #对计划任务进行描述
state: absent #删除计划任务
ansible 192.168.10.186 -m cron -a "name='第一个测试的计划任务' minute=* hour=* day=* month=* weekday=* job='/bin/bash /root/test1/aa.sh'"
#创建计划任务,添加描述(如不需描述可去除name字段)
ansible 192.168.10.186 -m shell -a 'crontab -l'
#查看远程主机计划任务列表
ansible 192.168.10.186 -m cron -a "name='第一个测试的计划任务' job='/bin/sh /root/test1/aa.sh' state=absent"
#删除计划任务
6、系统相关信息模块
6.1、setup, 用于获取系统信息的模块
ansible-doc -s setup #查看模块参数
ansible 192.168.10.186 -m setup #查看远程主机系统所有信息
ansible 192.168.10.186 -m setup -a 'filter=ansible_all_ipv4_addresses'
#对系统信息进行过滤
# 常用的过滤选项
ansible_all_ipv4_addresses 所有的ipv4地址
ansible_all_ipv6_addresses 所有的ipv6地址
ansible_architecture 系统的架构
ansible_date_time 系统时间
ansible_default_ipv4 系统的默认ipv4地址
ansible_distribution 系统名称
ansible_distribution_file_variety 系统的家族
ansible_distribution_major_version 系统的版本
ansible_domain 系统所在的域
ansible_fqdn 系统的主机名
ansible_hostname 系统的主机名,简写
ansible_os_family 系统的家族
ansible_processor_cores cpu的核数
ansible_processor_count cpu的颗数
ansible_processor_vcpus cpu的个数
