1.ansible常用模块介绍

001.Command 模块
功能:在远程主机执行命令,此为默认模块,可忽略 -m 选项
注意:此命令不支持 $VARNAME < > | ; & 等,而那些可用shell模块实现
注意:此模块不具有幂等性
示例:

ansible websrvs -m command -a 'service vsftpd start'
ansible websrvs -m command -a 'echo magedu |passwd --stdin wang'  
ansible websrvs -m command -a 'rm -rf /data/'
ansible websrvs -m command -a 'echo hello > /data/hello.log'
ansible websrvs -m command -a "echo $HOSTNAME"

002.Shell 模块
功能:和command相似,用shell执行命令,支持各种符号,比如:*,$, >
注意:此模块不具有幂等性
示例:

ansible websrvs -m shell -a "echo $HOSTNAME"
ansible websrvs -m shell -a 'echo $HOSTNAME'
ansible websrvs -m shell -a 'echo centos | passwd --stdin wang'
ansible websrvs -m shell -a 'ls -l /etc/shadow'
ansible websrvs -m shell -a 'echo hello > /data/hello.log'
ansible websrvs -m shell -a 'cat /data/hello.log'

003.Script 模块
功能:在远程主机上运行ansible服务器上的脚本(无需执行权限)
注意:此模块不具有幂等性
示例:

ansible websrvs -m script -a /data/test.sh

004.Copy 模块
功能:从ansible服务器主控端复制文件到远程主机
注意: src=file 如果是没指明路径,则为当前目录或当前目录下的files目录下的file文件
示例:

ansible websrvs -m copy -a "src=/root/test1.sh dest=/tmp/test2.sh  owner=wang mode=600 backup=yes"
ansible websrvs -m copy -a "src=/etc dest=/backup"
ansible websrvs -m copy -a "src=/etc/ dest=/backup"

005.Get_url 模块
功能: 用于将文件从http、https或ftp下载到被管理机节点上
示例:

ansible websrvs -m get_url -a 
'url=http://nginx.org/download/nginx-1.18.0.tar.gz 
dest=/usr/local/src/nginx.tar.gz 
checksum="md5:b2d33d24d89b8b1f87ff5d251aa27eb8"'

006.Fetch 模块
功能:从远程主机提取文件至ansible的主控端,copy相反,目前不支持目录
示例:

ansible websrvs -m fetch -a 'src=/root/test.sh dest=/data/scripts'
ansible  all -m fetch -a 'src=/etc/redhat-release dest=/data/os'

007.File 模块
功能:设置文件属性,创建软链接等
示例:

#创建空文件
ansible all -m file -a 'path=/data/test.txt state=touch'
#创建目录
ansible all -m file -a "path=/data/mysql state=directory owner=mysql 
group=mysql"
#创建软链接
ansible all -m file -a 'src=/data/testfile path|dest|name=/data/testfile-link state=link'
#递归修改目录及子目录的属性
ansible all -m file -a "path=/data/mysql state=directory owner=mysql group=mysql recurse=yes"

008.stat 模块
功能:检查文件或文件系统的状态
注意:对于Windows目标,请改用win_stat模块
示例:

ansible 127.0.0.1 -m stat -a 'path=/etc/passwd'

009.unarchive 模块
功能:解包解压缩
实现有两种用法:
1、将ansible主机上的压缩包传到远程主机后解压缩至特定目录,设置copy=yes,此为默认值,可省略
2、将远程主机上的某个压缩包解压缩到指定路径下,设置copy=no
常见参数:
copy:默认为yes,当copy=yes,拷贝的文件是从ansible主机复制到远程主机上,如果设置为copy=no,
会在远程主机上寻找src源文件
remote_src:和copy功能一样且互斥,yes表示在远程主机,不在ansible主机,no表示文件在ansible
主机上
src:源路径,可以是ansible主机上的路径,也可以是远程主机(被管理端或者第三方主机)上的路径,如果
是远程主机上的路径,则需要设置copy=no
dest:远程主机上的目标路径
mode:设置解压缩后的文件权限
示例:

ansible all -m unarchive -a 'src=/data/foo.tgz dest=/var/lib/foo owner=wang group=bin'
ansible all -m unarchive -a 'src=/tmp/foo.zip dest=/data copy=no mode=0777'
ansible all -m unarchive -a 'src=https://example.com/example.zip dest=/data copy=no'

010.Archive 模块
功能:打包压缩保存在被管理节点
示例:

ansible websrvs -m archive -a 'path=/var/log/ dest=/data/log.tar.bz2 format=bz2 owner=wang mode=0600'

011.Hostname 模块
功能:管理主机名

ansible node1 -m hostname -a "name=websrv"
ansible 10.0.0.18 -m hostname -a 'name=node18.magedu.com'

012.Cron 模块
功能:计划任务
支持时间:minute,hour,day,month,weekday
示例:

#创建任务
ansible 10.0.0.8 -m cron -a 'hour=2 minute=30 weekday=1-5 name="backup mysql" job=/root/mysql_backup.sh'
ansible websrvs  -m cron -a "minute=*/5 job='/usr/sbin/ntpdate ntp.aliyun.com &>/dev/null' name=Synctime"
#禁用计划任务
ansible websrvs  -m cron -a "minute=*/5 job='/usr/sbin/ntpdate 172.20.0.1 &> /dev/null' name=Synctime disabled=yes"
#启用计划任务
ansible websrvs  -m cron -a "minute=*/5 job='/usr/sbin/ntpdate 172.20.0.1 &> /dev/null' name=Synctime disabled=no"
#删除任务
ansible websrvs -m cron -a "name='backup mysql' state=absent"
ansible websrvs -m cron -a 'state=absent name=Synctime'

013. Yum 和 Apt 模块
功能:
yum 管理软件包,只支持RHEL,CentOS,fedora,不支持Ubuntu其它版本
apt 模块管理 Debian 相关版本的软件包
示例:

ansible websrvs -m yum -a 'name=httpd state=present' #安装
ansible websrvs -m yum -a 'name=nginx state=present enablerepo=epel' #启用epel源


进行安装

ansible websrvs -m yum -a 'name=* state=lastest exclude=kernel*,foo*' #升级除
kernel和foo开头以外的所有包
ansible websrvs -m yum -a 'name=httpd state=absent'  #删除
ansible websrvs -m yum -a 'name=sl,cowsay'ansible 10.0.0.100 -m apt -a 
'name=bb,sl,cowsay,cmatrix,oneko,hollywood,boxes,libaa-bin,x11-apps'
ansible websrvs -m apt -a 'name=rsync,psmisc state=absent'014.yum_repository 模块
yum仓库管理
- name: Add multiple repositories into the same file (1/2)
 yum_repository:
  name: epel
  description: EPEL YUM repo
  file: external_repos
  baseurl: https://download.fedoraproject.org/pub/epel/$releasever/$basearch/
  gpgcheck: no
- name: Add multiple repositories into the same file (2/2)
 yum_repository:
  name: rpmforge
  description: RPMforge YUM repo
  file: external_repos
  baseurl: http://apt.sw.be/redhat/el7/en/$basearch/rpmforge
  mirrorlist: http://mirrorlist.repoforge.org/el7/mirrors-rpmforge
  enabled: no

- name: Remove repository from a specific repo file
  yum_repository:
   name: epel
   file: external_repos
   state: absent015.Service 模块
功能:管理服务


示例:

ansible all -m service -a 'name=httpd state=started enabled=yes'
ansible all -m service -a 'name=httpd state=stopped'
ansible all -m service -a 'name=httpd state=reloaded'
ansible all -m shell -a "sed -i 's/^Listen 80/Listen 8080/' 
/etc/httpd/conf/httpd.conf"
ansible all -m service -a 'name=httpd state=restarted'

016.User 模块
功能:管理用户
示例:

#创建用户
ansible all -m user -a 'name=user1 comment="test user" uid=2048 home=/app/user1 group=root
ansible all -m user -a 'name=nginx comment=nginx uid=88 group=nginx 
groups="root,daemon" shell=/sbin/nologin system=yes create_home=no 
home=/data/nginx non_unique=yes'
#remove=yes表示删除用户及家目录等数据,默认remove=no
ansible all -m user -a 'name=nginx state=absent remove=yes'
#生成123456加密的密码
ansible localhost -m debug -a "msg={{ '123456'| 
password_hash('sha512','salt')}}"
localhost | SUCCESS => {
  "msg": "$6$salt$MktMKPZJ6t59GfxcJU20DwcwQzfMvOlHFVZiOVD71w."
}#用上面创建的密码创建用户
ansible websrvs -m user -a 'name=test 
password="$6$salt$MktMKPZJ6t59GfxcJU20DwcwQzfMvOlHFVZiOVD71w."'
#创建用户test,并生成4096bit的私钥
ansible websrvs -m user -a 'name=test generate_ssh_key=yes ssh_key_bits=4096 
ssh_key_file=.ssh/id_rsa'

017.Group 模块
功能:管理组
示例:
#创建组
ansible websrvs -m group -a 'name=nginx gid=88 system=yes'
#删除组
ansible websrvs -m group -a 'name=nginx state=absent'

018. Lineinfile 模块
ansible在使用sed进行替换时,经常会遇到需要转义的问题,而且ansible在遇到特殊符号进行替换时,
存在问题,无法正常进行替换 。其实在ansible自身提供了两个模块:lineinfile模块和replace模块,可
以方便的进行替换
一般在ansible当中去修改某个文件的单行进行替换的时候需要使用lineinfile模块
regexp参数 :使用正则表达式匹配对应的行,当替换文本时,如果有多行文本都能被匹配,则只有最
后面被匹配到的那行文本才会被替换,当删除文本时,如果有多行文本都能被匹配,这么这些行都会被
删除。
如果想进行多行匹配进行替换需要使用replace模块
功能:相当于sed,可以修改文件内容
示例:

ansible websrvs -m lineinfile -a "path=/etc/httpd/conf/httpd.conf 
regexp='^Listen' line='Listen 80'"
ansible all -m  lineinfile -a "path=/etc/selinux/config regexp='^SELINUX=' 
line='SELINUX=disabled'"
ansible all -m lineinfile -a 'dest=/etc/fstab state=absent regexp="^#"'

019.Replace 模块
该模块有点类似于sed命令,主要也是基于正则进行匹配和替换,建议使用
示例:

ansible all -m replace -a "path=/etc/fstab regexp='^(UUID.*)' replace='#\1'" 
ansible all -m replace -a "path=/etc/fstab regexp='^#(UUID.*)' replace='\1'"

020. SELinux 模块
该模块管理 SELInux 策略
示例:

[root@ansible ~]#ansible 10.0.0.8 -m selinux -a 'state=disabled'

021.reboot 模块
示例:

ansible websrvs -m reboot

022.mount 挂载和卸载
功能: 挂载和卸载文件系统

#临时挂载
mount websrvs -m mount -a 'src="UUID=b3e48f45-f933-4c8e-a700-22a159ec9077" 
path=/home fstype=xfs opts=noatime state=present'
#临时取消挂载
mount websrvs -m mount -a 'path=/home fstype=xfs opts=noatime state=unmounted'
#永久挂载
ansible websrvs -m mount -a 'src=10.0.0.8:/data/wordpress path=/var/www/html/wpcontent/uploads opts="_netdev" state=mounted'
#永久卸载
ansible websrvs -m mount -a 'src=10.0.0.8:/data/wordpress path=/var/www/html/wpcontent/uploads state=absent'

023.Setup 模块
功能: setup 模块来收集主机的系统信息,这些 facts 信息可以直接以变量的形式使用,但是如果主机
较多,会影响执行速度
可以使用 gather_facts: no 来禁止 Ansible 收集 facts 信息
示例:

ansible all -m setup
ansible all -m setup -a "filter=ansible_nodename"
ansible all -m setup -a "filter=ansible_hostname"
ansible all -m setup -a "filter=ansible_domain"
ansible all -m setup -a "filter=ansible_memtotal_mb"
ansible all -m setup -a "filter=ansible_memory_mb"
ansible all -m setup -a "filter=ansible_memfree_mb"
ansible all -m setup -a "filter=ansible_os_family"
ansible all -m setup -a "filter=ansible_distribution_major_version"
ansible all -m setup -a "filter=ansible_distribution_version"
ansible all -m setup -a "filter=ansible_processor_vcpus"
ansible all -m setup -a "filter=ansible_all_ipv4_addresses"
ansible all -m setup -a "filter=ansible_architecture"
ansible all -m setup -a "filter=ansible_uptime_seconds"
ansible all -m setup -a "filter=ansible_processor*"
ansible all -m setup -a 'filter=ansible_env'

范例:取IP地址

#取所有IP
ansible 10.0.0.101 -m setup -a 'filter=ansible_all_ipv4_addresses'
#取默认IP
ansible all -m setup -a 'filter="ansible_default_ipv4"'

024. debug 模块
此模块可以用于输出信息,并且通过 msg 定制输出的信息内容
注意: msg后面的变量有时需要加 " " 引起来
示例:
debug 模块默认输出Hello world

ansible 10.0.0.18 -m debug
[root@centos8 ~]#cat debug.yaml 
---
- hosts: websrvs

 tasks: 
  - name: output variables
   debug:
    msg: Host "{{ ansible_nodename }}" Ip "{{ ansible_default_ipv4.address 
}}"
[root@centos8 ~]#ansible-playbook debug.yaml