ansible常用模块汇总

ansible官网模块自助

ansible命令模块

模块详解

官方模块

ping模块

功能：检测

　测试连接可通性，没有参数。通的话返回pong
　ansible all -m ping 

setup模块

功能：获取主机信息（绿色，红色）

--tree :将所有主机的输出信息保存到/tmp/目录下，以/etc/ansible/hosts里的主机名为文件名
filter ：过滤关键字
ansible all -m setup -a 'filter=ansible_distribution_version' --tree /tmp/xx

#企业需求
1.根据不同主机'不同IP'创建对应IP的目录
2.根据不同主机不同'主机名'创建对应主机名的目录
3.自动化运维平台需要自动获取到主机的'IP地址，内存信息，磁盘信息，主机名'...等
4.如果安装数据库，分配内存为物理内存的80%，此时有3台不同物理内存的机器2G、4G、16G
写一个playbook的情况下，我需要获取到对应主机的内存并作出计算，写判断。

#查看主机所有详细信息（命令行和剧本中获取的格式不同）
[root@m01 ~]# ansible web01 -m setup
#获取ip
[root@m01 ~]# ansible web01 -m setup -a 'filter=ansible_default_ipv4'
#获取主机名
[root@m01 ~]# ansible web01 -m setup -a 'filter=ansible_fqdn'
#获取内存信息
[root@m01 ~]# ansible web01 -m setup -a 'filter=ansible_memory_mb'
#获取磁盘信息
[root@m01 ~]# ansible web01 -m setup -a 'filter=ansible_devices'

#其他信息参数
ansible_all_ipv4_addresses：'仅显示ipv4的信息'。
ansible_devices：仅显示磁盘设备信息。
ansible_distribution：'显示是什么系统'，例：centos,suse等。
ansible_distribution_major_version：显示是系统主版本。
ansible_distribution_version：仅显示系统版本。
ansible_machine：显示系统类型，例：32位，还是64位。
ansible_eth0：'仅显示eth0的信息'。
ansible_hostname：'仅显示主机名。
ansible_kernel：仅显示内核版本。
ansible_lvm：显示lvm相关信息。
ansible_memtotal_mb：'显示系统总内存'。
ansible_memfree_mb：显示可用系统内存。
ansible_memory_mb：详细显示内存情况。
ansible_swaptotal_mb：显示总的swap内存。
ansible_swapfree_mb：显示swap内存的可用内存。
ansible_mounts：'显示系统磁盘挂载情况'。
ansible_processor：'显示cpu个数(具体显示每个cpu的型号)''。
ansible_processor_vcpus：显示cpu个数(只显示总的个数)

#取ip
[root@m01 ~]# ansible web01 -m setup -a 'filter=ansible_default_ipv4'|awk -F '["]' '/"address"/{print $4}'
10.0.0.7
[root@m01 ~]# ansible web_group -m setup -a 'filter=ansible_default_ipv4'|awk -F '["]' '/"address"/{print $4}'
10.0.0.7
10.0.0.9
10.0.0.8

#取主机名
[root@m01 ~]# ansible web01 -m setup -a 'filter=ansible_fqdn'|awk -F '["]' '/fqdn/{print $4}'
web01

command模块

command模块

功能：远程执行简单的命令

 默认模块（可省略不指定）
 作用：执行系统命令（linux windows），不支持变量，"<"，">"，"|"，";"，"&"等符号
 
[root@m01 ~]# ansible web_group -a 'ls'
[root@m01 ~]# ansible web_group -a 'df -h'

cron模块

cron模块

功能：添加定时任务

#使用crontab之前最好同步时间（注意单引号和双引号的作用）（*有时候需要加''）
[root@m01 ~]# ansible '*' -m cron -a "name=同步时间 minute=*/5 job='/usr/sbin/ntpdate time1.aliyun.com &>/dev/null'"

ansible-doc cron
ansible db -m cron -a 'minute=""  hour="" day="" month="" weekday="" job="" name="（必须填写）" state='

　　　　1、定时设置指定值的写入即可，没有设置的要删除
　　　　2、name必须写（创建定时任务或者删除定时任务的 标志，不能修改注释）(这一点和yum仓库名一样)
　　　　3、state有两个状态：present（添加（默认值））or absent（移除）
　　　
#添加定时任务
	ansible db -m cron -a 'minute="*/10" job="/bin/echo hello" name="test cron job" state="present"'
查看定时任务	
ansible db -a "crontab -l"

#修改定时任务
	ansible db -m cron -a 'minute="*/5" job="/bin/echo hello" name="test cron job" state="present"'

#移除定时任务（根据name来删除）
	ansible db -m cron -a 'minute="*/10" job="/bin/echo hello" name="test cron job" state="absent"'
	ansible all -m cron -a "name=test state=absent"
查看定时任务	
ansible db -a "crontab -l"
# 注释相应定时任务，使定时任务失效
 	ansible web_group -m cron -a "name='ansible cron01' minute=0 hour=0 job='/bin/sh /server/scripts/test.sh' disabled=yes"

ansible yml语法（playbook）

注意：yml语法很严格，不能多，漏空格，不能使用TAB

在不同的主机上，创建以主机名命名的目录

[root@m01 ~]# vim 2.yml 
- hosts: web_group
  tasks:
    - name: 233
      file:
        path: /root/{{ ansible_fqdn }}
        state: directory
        owner: root
        group: root
        mode: 0755
[root@m01 ~]# ansible-playbook 2.yml

[root@web01 ~]# ll
total 8
drwxr-xr-x  2 root root    6 Jun  1 00:41 web01

#查看ansiable-playbook命令
[root@m01 ~]# ll /usr/bin/ansible	#TAB
ansible               ansible-console-2.7 

copy模块

copy模块

拷贝, 修改文件或目录, 修改已经存在的目录的权限

使用content可以直接在远端创建文件，同时指定文件内容

使用backup=yes备份配置文件，可以实现配置文件的修改或回滚

该模块可以直接拷贝链接

[root@m01 ~]# ansible-doc copy	#查看copy模块用法
    src: 	#源文件或目录，要复制到远程主机的文件在本地的地址，可以是绝对路径，也可以是相对路径。如果路径是一个目录，它将递归复制。在这种情况下，如果路径使用"/"来结尾，则只复制目录里的内容，如果没有使用"/"来结尾，则包含目录在内的整个内容全部复制，类似于rsync（#）。（src为空目录是时候是不会拷贝的，一致显示绿色）
    content：用于替代"src",可以在命令行直接设定指定文件的值 
    dest: 			#目标目录
    owner: foo		#属主
    group: foo		#属组（不能使用gid指定）
    mode: '0644'	#权限，数字(3位|4位)，字母，UGO   
    backup: yes		#当出现同名的文件，直接覆盖，因为默认是no，指定yes后（文件内容不同会以当前时间戳备份该文件）
    force：如果目标主机包含该文件，但内容不同，如果设置为yes，则强制覆盖，如果为no，则只有当目标主机的目标位置不存在该文件时，才复制。默认为yes（force=no和state=backup可以二选一）
	remote_src：			
		yes			#受控端自己玩(可以做批量回滚)
		no			#默认
--------------------------------------------------  
#远程批量拷贝，相当于scp，rsync
目标目录下文件存在的话会报错，被控端主机用户不存在会报错（但是它把能做的都做了）
[root@m01 ~]# ansible 'web_group' -m copy -a 'src=/root/hosts dest=/root owner=www group=www mode=0644'
--------------------------------------------
[root@web01 /]# yum install -y httpd
[root@web01 ~]# systemctl start httpd
[root@web01 ~]# echo 233 > /var/www/html/index.html
#浏览器访问
------------------------------------------------------------
#远程拷贝文件，并且将原来的同名文件备份，如果文件名和文件内容,属主属组和权限都一样就不做拷贝了（绿）,backup=no可以省略,属主属组是root的时候可以不写（目的地文件1.同名 2.内容不同 才备份），当dest不存在时，源文件改名
[root@m01 /]# ansible 'web_group' -m copy -a 'src=/root/hosts dest=/root owner=www group=www mode=0644 backup=yes'

----------------------------------------------------------------

#简单的文件直接可以直接使用content在命令行copy，不需要copy文件（记得在末尾加
）
[root@m01 ~]# ansible 'nfs_group' -m copy -a 'content="/data 172.16.1.0/24(rw,sync,all_squash,anonuid=666,anongid=666)
" dest=/etc/exports'

--------------------------------------------------------------------------
#远端的源拷贝到远端指定的位置
[root@m01 ~]# ansible 'web_group' -m copy -a 'src=/etc/passwd dest=/tmp remote_src=yes'
#配置文件回滚
[root@m01 ~]# ansible web01 -m copy -a 'src=/root/passwd.1811.2020-06-09@18:16:13~ dest=/root/passwd remote_src=yes'

file模块

file模块

功能：创建文件或目录，修改已经存在的目录的权限，创建软硬连接

  file:
    path: /etc/foo.conf		#指定创建的目录或文件
    state：
    	touch			#创建文件
    	directory		#创建目录
    	absent			#删除目录或文件
    	link			#做软链接
    owner: foo			#属主
    group: foo			#属组
    mode: '0644'		#权限
    recurse				#递归

1 force：需要在两种情况下强制创建软链接，一种是源文件不存在但之后会建立的情况下；另一种是目标软链接已存在,需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no 
2 group：定义文件/目录的属组 
3 mode：定义文件/目录的权限（ 1.一次创建多个目录的时候才会递归授权， 									 2.recurse=yes也会递归授权）
4 owner：定义文件/目录的属主
5 path：必选项，定义文件/目录的路径（不存在的话可以直接创建）#
6 recurse：'递归'的设置文件的属性，只对'目录'有效（指定recurce的话，可以修改已经存在的文件或者目录的权限，默认关闭）（需要配合mode owner group一起使用）

7 src：要被链接的源文件的路径，只应用于state=link的情况
8 dest：被链接到的路径，只应用于state=link的情况 

9 state：  
	directory：如果目录不存在，创建目录 
	file：只能修改文件或目录的时间 （配合modification_time access_time）
	link：创建软链接 
	hard：创建硬链接 
	touch：如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则更新其最后修改时间 (不能在不存在的目录下创建文件，这一点和touch命令一样)
absent：删除目录、文件或者取消链接文件

#远程批量创建目录
	不指定属主属组，默认是root(当前用户)，不指定mode，那么权限为默认
[root@lb01 /code]# ansible 'web_group' -m file -a 'path=/backup state=directory owner=adm group=adm mode=0000'
#创建目录，同时递归授权（不能针对文件）
[root@m01 ~]# ansible 'web01' -m file -a 'path=/1/2/3  state=directory mode=000 recurse=yes'
#当state=touch mode=000同时指定，创建的都是目录，只指定touch才会创建文件 3
[root@m01 ~]# ansible web01 -m file -a 'path=/1/2/3 state=touch mode=000'

#远程批量创建文件（上级目录必须存在）
[root@lb01 /code]# ansible 'web_group' -m file -a 'path=/backup state=touch owner=adm group=adm mode=0000'
--------------------------------------------------------------------
#远程批量删除目录或文件
[root@lb01 ~]# ansible 'web_group' -m file -a 'path=/backup state=absent'
-----------------------------------------------------------------------
#远程创建软链接,(不指定权限的话，属主属组为root，链接文件权限是777)
[root@lb01 /code]# ansible 'web_group' -m file -a 'src=/backup/a.txt dest=/b.txt state=link owner=adm group=adm mode=0000'

#远程创建硬链接（可通过ll -i 查看inode号，判断是否为硬链接关系）
[root@lb01 /code]# ansible 'web_group' -m file -a 'src=/backup/a.txt dest=/b.txt state=hard owner=adm group=adm mode=0000'

yum模块

yum模块

功能：远程下载

name			#包名，用等于号表示（指定要安装的软件包的名称）
	file://		#指定本地安装路径，=yum localinstall -y
	http://		#指定yum仓库
	
state					#指定动作,用等于号表示
	present				#安装软件包(默认)（=install）
	absent				#删除软件包（=remove）
	latest				#安装最新版本的软件包或，升级
	
	disable_gpg_check	#默认值为 no，表示不禁用验证，设置为 yes 表示禁用验证，即不验证包，直接安装。
	enablerepo			#临时启用源（无论此源是否开启）
	disablerepo			#临时禁用某个源，这样设置后，在安装软件包时则不会从对应的源中选择安装包。

	download_only=true              #只下载不安装 yum install [d]
-------------------------------------------------------------
#下载安装，使用被控端的源安装软件包
[root@m01 ~]# ansible 'web_group' -m yum -a 'name=vsftpd'
[root@m01 ~]# ansible 'web_group' -m yum -a 'name=vsftpd state=present'

#下载安装，指定源的rpm包，相当于wget+localinstall，可以指定包名和协议
[root@m01 ~]# ansible 'web_group' -m yum -a 'name=https://mirrors.aliyun.com/zabbix/zabbix/5.0/rhel/7/x86_64/zabbix-agent-5.0.0-1.el7.x86_64.rpm state=present'

#安装，前提是客户端指定目录下有这个rpm包（相当于yum localinstall）
[root@m01 ~]# ansible 'web_group' -m yum -a 'name=/root/zabbix-agent-5.0.0-1.el7.x86_64.rpm state=present'
--------------------------------------------------------------
#卸载
[root@m01 ~]# ansible 'web_group' -m yum -a 'name=zabbix-agent-5.0.0-1.el7.x86_64 state=absent'
[root@m01 ~]# ansible 'web_group' -m yum -a 'name=zabbix state=absent'
-----------------------------------------------------------------------
#扩展
[root@localhost ~]# ansible all -m yum -a "name=httpd state=latest disable_gpg_check=yes enablerepo=epel"

#升级所有软件包，排除httpd
[root@Ansible ~]# ansible all -m yum -a "state=latest name='*' exclude='httpd'"

shell模块

shell模块

功能：执行复杂的命令

尤其是用到复杂命令时（如带管道符等等),但是shell模块不能做mysql的主从复制,但是nginx编译安装的时候只能使用shell模块(一般不用shell模块，因为还要指定模块...)
#企业中一般不让使用shell模块

#使用ansible批量操作集群的主机
[root@m01 ~]# ansible 'web_group' -m shell -a 'free -m'
[root@m01 ~]# ansible 'web_group' -m conmand -a 'free -m'
[root@m01 ~]# ansible web01 -m shell -a "ps -ef|grep httpd"

命令的最后也可以加 -f number ，表示使用的并发进程数目，默认是5个
ansible webserver -a 'netstat -ulntp' -f 15

/usr/bin/ansible 默认使用当前ansible 服务器登陆的用户来进行管理，如果你不喜欢这样，也可以使用 -u username 的方式来指定用户
[root@docker ~]# ansible webserver -a "ls" -u zhangsan -f 9

script模块

功能：作用：将本地脚本复制到远程主机，并执行。（不需要给脚本添加执行权限）

#编辑脚本(只需要放在m01就好)
vim /root/dir.sh
mkdir syy

#执行
absible 'web01' -m script -a '/root/dir.sh'

synchronize模块

功能：基于rsync命令工具同步目录和文件

由于synchronize模块会调用rsync命令，因此首先要记得提前安装好rsync软件包

	1 archive: 归档，相当于同时开启recursive(递归)、links、perms、times、owner、group、-D选项都为yes ，默认该项为开启（#保证源文件和目标文件属性一致）
 	2 checksum: 是否检测sum值，默认关闭
 	3 compress:是否开启压缩（默认开启）
 	4 copy_links：同步的时候是否复制链接，默认为no ，注意后面还有一个links参数
 		links：同步链接文件
 	5 delete: 删除不存在的文件，delete=yes 使两边的内容一样（即以推送方为主），默认no
 	6 dest：目录路径（绝对路径或者相对路径）
 	7 dest_port：目标主机上的端口 ，默认是22，走的ssh协议
 	8 dirs：传送目录不进行递归，默认为no，即进行目录递归（#一般不用指定）
	9 rsync_opts：通过传递数组来指定其他rsync选项。	#
		--exclude=*.txt  #排除
	10 set_remote_user：主要用于ansible默认使用的用户与rsync使用的'用户不同的情况
	11 mode: push(默认)或pull 模块，push模的话，'一般用于从本机向远程主机上传文件，pull 模式用于从远程主机上取文件'
	12 src： 要同步到目的地的源主机上的路径; 路径可以是绝对的或相对的。如果路径使用”/”来结尾，则只复制目录里的内容，如果没有使用”/”来结尾，则包含目录在内的整个内容全部复制 
ansible 172.25.70.2 -m synchronize -a ' '
#同步目录（前提是远程服务器上有rsync这个命令）
src=some/relative/path dest=/some/absolute/path rsync_path="sudo rsync"
#排除(#由于这个是rsync命令的参数，所以必须和rsync_opts一起使用)
src=/tmp/helloworld dest=/var/www/helloword rsync_opts=--exclude=.log 

mount模块

功能：挂载

mount模块控制/etc/fstab中的活动和配置挂载点

文件系统的类型：C7（xfs）,C6(ext4), C5(ext3)

	1 fstype：必选项，挂载文件的类型 (nfs文件共享 fstype=nfs)
	2 name：必选项，'哪个文件挂载' (可以使用path指定)
	3 opts：传递给mount命令的参数(rw,ro)
	4 src：必选项，'挂载到哪的目录' （nfs）
	5 state：必选项 
		present：把指定的挂载写入到fastab中，不会立即挂载，（绿色）
		mounted	 ：即写入文件，又直接挂载（自动创建挂载点并挂载之）（#推荐）
		absent：删除挂载点 （会清理fastab中的开机挂载）（#推荐）
		unmounted：卸载（不会清理fastab中的开机挂载）
--------------------------------------------------------------------		
1.#服务端和客户端安装nfs
[root@m01 ~]# ansible web_group  -a 'yum -y install nfs-utils'
[root@m01 ~]# ansible nfs_group  -a 'yum -y install nfs-utils'

2.#编辑nfs配置文件
[root@m01 ~]# ansible 'nfs_group' -m copy -a 'content="/data 172.16.1.0/24(rw,sync,all_squash,anonuid=666,anongid=666)
" dest=/etc/exports'

3.创建
[root@m01 ~]# ansible nfs_group -a 'mkdir /data'
[root@m01 ~]# ansible nfs_group -m systemd -a 'name=nfs state=started'

4.启动并设置开机自启
[root@m01 ~]# ansible web_group -m systemd -a 'name=nfs state=started'
[root@m01 ~]# ansible web_group -m systemd -a 'name=nfs enabled=yes'
[root@m01 ~]# ansible nfs_group -m systemd -a 'name=nfs enabled=yes'

5.挂载
[root@m01 ~]# ansible web01 -m mount -a ''
path=/mnt src=172.16.1.31:/data fstype=nfs state=mounted

name=/mnt/dvd src=/dev/sr0 fstype=iso9660 opts=ro state=present
name=/srv/disk src='LABEL=SOME_LABEL' state=present
name=/home src='UUID=b3e48f45-f933-4c8e-a700-22a159ec9077' opts=noatime state=present
ansible test -a 'dd if=/dev/zero of=/disk.img bs=4k count=1024'
ansible test -a 'losetup /dev/loop0 /disk.img'
ansible test -m filesystem 'fstype=ext4 force=yes opts=-F dev=/dev/loop0'
ansible test -m mount 'name=/mnt src=/dev/loop0 fstype=ext4 state=mounted opts=rw'	

6.取消挂载
[root@m01 ~]# ansible web_group -m mount -a 'path=/mnt src=172.16.1.31:/data fstype=nfs state=unmounted'

7.清理/etc/fstab文件

#UUID就是磁盘的身份证号，不会重复（一般使用UUID的方式挂载）
[root@web ~]# blkid /dev/sda1	查看UUID（xfs文件系统）
/dev/sda1: UUID="12722517-ff26-416b-b535-073a95a7a00e" TYPE="xfs" 
[root@web ~]# cat /etc/fstab 
UUID=5bf16417-9cb6-40eb-80b9-8cc2f715f79f / (根目录的UUID)                      xfs     defaults        0 0
UUID=12722517-ff26-416b-b535-073a95a7a00e /boot (/bbot目录的UUID)                   xfs     defaults        0 0

#把本地的磁盘挂载到远程主机上
[root@Ansible ~]# ansible all -m mount -a "name=/mnt src=/dev/sda3 fstype=xfs state=mounted opts=rw"

#格式化磁盘：
ansible all -m filesystem -a "fstype=ext4 dev=/dev/sdb1"

get_url模块

功能：下载

[root@m01 ~]# ansible-doc get_url								
    url: http://example.com/path/file.conf	#自定下载文件的URL
    dest: /etc/foo.conf						#指定下载的目录
    mode: '0440'						#指定下载后的权限
    owner
    group
    force_basic_auth: yes		#文件名相同直接覆盖（默认）
	checksum				#默认关闭
		md5					#md5校验
		sha256				#sha校验
          
      
#远程连接并下载（串行，速度慢）
[root@m01 ~]# ansible 'web_group' -m get_url -a 'url=http://test.driverzeng.com/Nginx_Code/wordpress-4.9.4-zh_CN.tar.gz dest=/root mode=000'

#校验MD5并下载（小心等于号，阿里云不使用md5sum校验，）
[root@m01 ~]# ansible 'web_group' -m get_url -a 'url=http://test.driverzeng.com/Nginx_Code/wordpress-4.9.4-zh_CN.tar.gz dest=/root mode=000 checksum= md5:b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c'

yum_repository模块

功能：添加，删除，修改yum源

[root@m01 ~]#  ansible-doc yum_repository
  yum_repository:			
    name: epel		#不能省略，指定仓库文件名和仓库名，自动添加.repo
    description: 	#相当于仓库内的name注释
    baseurl: https://download.fedoraproject.org/pub/epel/$releasever/$basearch/
    
    file:		#指定仓库文件名（优先级高）,不指定的话仓库文件名和仓库名一样，不能同时在同一个仓库文件内添加多个仓库名不同的仓库，同时指定的话file=仓库文件名，name=仓库名
        
    gpgcheck	#是否开启校验
        yes
        no
    enabled		#是否启用yum仓库
        yes
        no
  	state   
      	present		#创建yum仓库（默认）  
    	absent		#删除yum仓库
--------------------------------------------------------
#批量添加yum仓库，不能一次在某一主机添加多个仓库文件和仓库，功能有限
[root@m01 ~]# ansible 'web_group' -m yum_repository -a 'name=syy_add_epel description=EEE baseurl=http://nginx.org/packages/centos/$releasever/$basearch/ gpgcheck=no enabled=yes file=zdy'

#在客户端已存在的仓库文件内添加仓库（1.指定仓库文件。2.指定仓库名，存在即修改，不存在即添加）
[root@m01 ~]# ansible 'web_group' -m yum_repository -a 'name=syy2_add_epel description=EEE baseurl=http://nginx.org/packages/centos/$releasever/$basearch/ gpgcheck=no enabled=yes file=zdy'
--------------------------------------------------------------
#批量删除yum仓库，只能一个一个删除仓库文件（也就是说不能只指定name来批量删除），file优先级高，可以只指定name，也可以同时指定（视情况而定）
（仓库文件名和仓库名要对应，最好都写上）
[root@m01 ~]# ansible 'web_group' -m yum_repository -a 'name=syy_add_epel file=zdy state=absent'
--------------------------------------------------------------
#修改
不能修改仓库文件名，也不能修改仓库名，可以修改URL，gpg,enabled
[root@m01 ~]# ansible 'web_group' -m yum_repository -a 'name=syy_add_epelllll description=EEE baseurl=http://nginx.org/packages/centos/$releasever/$basearch/ gpgcheck=no enabled=yes file=1'

也可以修改gpgcheck和enable
[root@m01 ~]# ansible 'web_group' -m yum_repository -a 'name=syy_add_epel description=EEE baseurl=http://nginx.org/packages/centos/$releasever/$basearch/ gpgcheck=no enabled=no file=1'

#使用playbook执行yml脚本，可以实现更精确的操作

ansible服务模块--systemd模块

功能：远程启停，重载服务，

[root@m01 ~]# ansible-doc systemd
  systemd:				#模块
    state: started 		#启动
    name: httpd				#指定服务名称
    state: stopped		#停止
    state: restarted	#重启
    state: reloaded		#重载配置文件
    enabled=yes		#设置开机自启
    daemon_reload		# 读取配置文件，每次修改了文件，最好都运行一次，确保应用了（systemd）
    masked：			#是否将服务设置为masked状态，被mask的服务是无法启动的(systemd),（yes|no）默认为no
----------------------------------------------------------------
#远程停止服务
[root@m01 ~]# ansible 'web_group' -m systemd -a 'name=nginx state=stopped '

#远程启动服务（并设置开机自启动）
[root@m01 ~]# ansible 'web_group' -m systemd -a 'name=nginx state=started enabled=yes '
-------------------------------------------------------------
# 先将服务停止
[root@Ansible ~]# ansible web -m systemd -a "name=httpd state=stopped"
#设置masked
[root@Ansible ~]# ansible web -m systemd -a "name=httpd masked=yes"
# 服务已无法启动
[root@Ansible ~]# ansible web -m systemd -a "name=httpd state=started"
# 撤销mask
[root@Ansible ~]# ansible web -m systemd -a "name=httpd masked=no"
# 可以启动成功
[root@Ansible ~]# ansible web -m systemd -a "name=httpd state=started"

service模块

service模块

远程启停，重载服务

service模块(可以跨平台，跨系统) 与systemd模块作用类似，使用命令类似

	1 arguments：给命令行提供一些选项 	#
	2 enabled：是否开机启动 yes|no（默认是no）
	3 name：必选项，服务名称 
	4 pattern：定义一个模式，如果通过status指令来查看服务的状态时，没有响应，就会通过ps指令在进程中根据该模式进行查找，如果匹配到，则认为该服务依然在运行		#
	5 runlevel：运行级别		#
	6 sleep：如果执行了restarted，在则stop和start之间沉睡几秒钟
	7 state：对当前服务执行启动，停止、重启、重新加载等操作（started,stopped,restarted,reloaded）
	
#保持服务启动并设置为开机自启
 ansible web_group -m service -a 'enabled=yes name=httpd state=started'

ansible用户组管理模块

group模块

功能：创建用户组

[root@m01 ~]# ansible-doc group
    name: somegroup		#指定组名
    state: present 		#创建（默认，课省略）
    state: absent 		#删除
	gid					#指定创建的组的gid
	
#远程创建组
[root@m01 ~]# ansible 'web_group' -m group -a 'name=dd gid=233 state=present'

#远程删除组
[root@m01 ~]# ansible 'web_group' -m group -a 'name=dd gid=233 state=absent'

ansible用户管理模块

user模块

使用yml语法修改用户密码

多种加密方式获取加密密码

功能：管理远程主机上的用户，比如创建用户、修改用户、删除用户、为用户创建密钥对等操作

　　user模块是请求的是useradd, userdel, usermod三个指令，goup模块请求的是groupadd, groupdel, groupmod 三个指令。

groups：			#修改附加组为
    	append=no			#默认，覆盖（相当于usermod -G）
    	append=yes			#追加（相当于usermod -aG）
uid：			指定用的uid
group:			#指定主组
password：		#明文密码进行哈希后的字符串，你可以在 python 的命令提示符下输入如下命令，生成明文密码对应的加密字符串 "import crypt; crypt.crypt('666666')"
update_password:
    always:		只有当密码不相同时才会生效，即修改密码(默认)		#
    on_create:	只为新用户设置密码
name：			指定用户名
system：			是否为系统用户 yes|no（默认是no）
remove：			当state=absent时，remove=yes则表示连同家目录,邮件目录一起删除，等价于userdel -r（默认是no）
state：
    absent				#删除用户
    	remove=no		#默认，删除用户时，不会删除用户的家目录等信息
    	remove=yes		#删除用户的同时，会删除用户的家目录，邮件目录
    present				#创建用户（默认）
shell：			指定用户的shell环境(默认是/bin/bash)
expires:		设置用户的过期时间，值是一个时间戳（转化命令：date -d 2018-12-31 +%s，命令行设置 expires=）
comment:		#创建用户的时候添加一段注释
generate_ssh_key: yes		#创建公钥（默认）
ssh_key_bits: 2048			#指定公钥长度
ssh_key_file: .ssh/id_rsa	#创建私钥(创建用户的家目录下)
create_home=false				#是否创建家目录（默认创建true）
------------------------------------------------------------------------
#创建用户,修改用户
ansible 'web_group' -m user -a ' '
	name=ll
	name=hh comment="zhushi" uid=1040 group=adm		#该组必须存在
	name=hh shell=/bin/bash groups=adm,lp append=yes
	name=hh state=absent remove=yes
	name=hh expires=1422403387
	name=hh generate_ssh_key=yes ssh_key_bits=2048 ssh_key_file=.ssh/id_rsa
	name="testops" password="$6$0lwTSmqKOkL.ktgl$OnBexXC7haBf0FRHVMIZM2edDeFWBbpKJ2r9cxVwNvY.vh3IIUzwFz8n7jFglc0CrtQSY12ziDonVL6e71Og2."
--------------------------------------------------------------	
#生成密钥时，只会生成公钥文件和私钥文件，和直接使用ssh-keygen指令效果相同，不会生成authorized_keys文件。复制id_rsa.pub粘贴为authorized_keys文件即可使用
	name=test generate_ssh_key=yes ssh_key_bits=2048 ssh_key_file=~/.ssh/id_rsa
-----------------------------------------------------------------------
	
#指定password参数时，不能使用后面这一串密码会被直接传送到被管理主机的/etc/shadow文件中，所以需要先将密码字符串进行加密处理。然后将得到的字符串放到password中即可。
1.加密
[root@ansible-manager ~]# python
>>> import crypt;crypt.crypt('666666')
'$6$ziT/sb5KRtUaxoq7$ulfHVLqVgXfmfFUYY7FppzqBQMUYd.2GLDyQwmKv4dYAd0zpgtt5JDheoO/OvvTvY53x9UShX.PtHykJEvsmG0'
2.创建用户指定密码 或 修改用户密码
------------------------------------------------------------------
#删除用户
注意该用户下不能有任何进程，否则会报错(但是能删除的都删除了)
ansible 'web_group' -m user -a ' '
	name=ll state=absent remove=yes

fetch

fetch模块

[root@m01 ~]# ansible web01 -m fetch -a "src=/root/lol.txt dest=/root"

压缩解压unarchive模块

官方文档

功能：解压缩

1、解压ansible管理机上的压缩文件到远程主机：
ansible all -m unarchive -a "src=/tmp/install/zabbix-3.0.4.tar.gz dest=/tmp/ mode=0755 copy=yes"

2、解压远程主机上的文件到目录：
ansible all -m unarchive -a "src=/tmp/install/zabbix-3.0.4.tar.gz dest=/tmp/ mode=0755 copy=no"

copy：默认为yes，当copy=yes，那么拷贝的文件是从ansible主机复制到远程主机上的，如果设置为copy=no，那么会在远程主机上寻找src源文件

src：源路径，可以是ansible主机上的路径，也可以是远程主机上的路径，如果是远程主机上的路径，则需要设置copy=no
dest：远程主机上的目标路径

selinux

功能：管理selinux

C6想要使用这种方式关闭selinux的话，需要安装 libselinux-python（改过要重启生效）

不能使用systemd service模块来管理selinux systemd

state：
	enforcing		#永久开启
	permissive		#临时开启（默认）
	disabled		#禁用
	

#修改配置文件关闭selinux(永久关闭)，必须重启
[root@m01 ~]# ansible web_group -m selinux -a 'state=disabled' -i ./hosts

#临时关闭
[root@m01 ~]# ansible web_group -m shell -a 'setenforce 0' -i ./hosts

#查看
[root@m01 ~]# ansible web_group -m shell -a 'getenforce' -i ./hosts

	如果修改了/etc/selinux/config文件的话，需要重启，如果你只是临时修改的话，不需要重启
	使用setenforce 可以临时改变selinux的状态，不需要重启系统。但是系统重启后，配置失效，因为系统重启后，是根据/var/selinux/config的配置内容进行功能设置的

firewalld

功能：管理firewalld

打开才能关闭

service                 #指定开放或关闭的服务名称（http https）
port                    #指定开放或关闭的端口（-）
permanent               #是否添加永久生效(permanent=no即为临时生效)		#
immediate               #临时生效
state                   
    enabled				#永久开启
    disabled			#永久关闭

zone                    #指定配置某个区域
rich_rule               #配置辅规则
masquerade              #开启地址伪装
source                  #指定来源IP

#service指定服务(需要提前开启防火墙)
[root@m01 ~]# ansible web_group -m firewalld -a 'service=http permanent=yes state=enabled' -i ./hosts
[root@m01 ~]# ansible web_group -m firewalld -a "service=https permanent=yes state=enabled" -i ./hosts

#service指定端口（某些服务系统自动开启）
[root@m01 ~]# ansible web_group -m firewalld -a "port=8080-8090/tcp  permanent=yes state=enabled" -i ./hosts

lineinfile

功能：lineinfile模块用于确保一个特定的行在一个文件中，或使用一个正则表达式替换现有的行

如果想要改变文件中相似的多行，可以使用replace模块。如果想要插入、更新、删除一个行块，可以使用blockinfile模块

（1）文本替换
将/etc/selinux/config文件中所有匹配^SELINUX=正则表达式的行中的最后一行使用SELINUX=disabled替换
如果regexp不匹配文件中的任何一行，则将line所指定的行插入到文件的末尾
[root@Ansible ~]# ansible web -m lineinfile -a "path=/etc/selinux/config regexp='^SELINUX=' line='SELINUX=disabled'"

（2）删除行
将/tmp/test.sh文件中所有匹配^pwd的行删除
[root@Ansible ~]# ansible web -m lineinfile -a "path=/tmp/test.sh regexp='^pwd' state=absent"

（3）替换行并设置文件权限
[root@Ansible ~]# ansible web -m lineinfile -a "path=/etc/hosts regexp='^127.0.0.1' line='127.0.0.1 localhost' owner=root group=root mode=0644"

stat模块

功能：stat模块获取远程文件状态信息，包括atime、ctime、mtime、md5、uid、gid等

（1）显示文件的所有信息
[root@Ansible ~]# ansible web -m stat -a "path=/etc/sysctl.conf"

（2）显示MD5值
[root@Ansible ~]# ansible web -m stat -a "path=/etc/sysctl.conf get_md5=yes"

mysql_user模块

mysql_user

功能：主控端对被控端mysql服务器 添加删除用户，授权远程用户登录，访问

mysql_user模块参数
login_host=“localhost” 指定本地root用户登录本机mysql
login_password=“123.com” root用户的登录密码		#登录密码
login_user=“root” 为root用户或者mysql用户			#登录用户
login_port=“3306” 数据库端口号
name="" 指定grant授权用户			#建立使用者的名字或是已存在的使用者
password="" grant授权用户密码		#给新用户设置密码，或者修改密码
priv="" 库名.SQL语句权限,GRANT    #资料库.资料表:权限1,权限2（要用"）
host="" 授权远程登录的IP地址，一般为 网段.% 或者直接 %
state=“present” 创建授权用户
state=“absent” 删除授权用户

ahdoc模式写法创建授权用户，验证模块正确时使用

[root@localhost ansible]# ansible mysql -m mysql_user -a "login_host=% login_password=123.com login_user=root login_port=3306 name=ty_user password=1 priv=".:ALL,GRANT" host='%' state=present"

playbook剧本写法创建授权用户，执行自动化部署时使用
- hosts: mysql_group
  remote_user: root
  tasks:
    - name: grant mysql user
      mysql_user:
      	login_host: "localhost"
      	login_user: "root"
     	login_password: "123.com"
     	login_port: "3306"
      	name: "ty"
      	password: "123.com"
      	host: "%"
      	priv: "*.*:ALL,GRANT"
      	state: "present"

mysql_db模块

mysql_db

功能：用于建立、删除、导入和导出数据库

#建立数据库
  hosts: mysql_group
  tasks:
  - name: create a database
    mysql_db:
      login_host: "127.0.0.1"
      login_user: "root"
      login_password: "mysql@123"
      login_port: "3306"
      name: "mezz"
      encoding: "utf8"
      state: "present"
      
#删除数据库
  hosts: mysql_group
  tasks:
  - name: delete a database
    mysql_db:
      login_host: "127.0.0.1"
      login_user: "root"
      login_password: "mysql@123"
      login_port: "3306"
      name: "mezz"
      state: "absent"
      
#导出数据库
  hosts: mysql_group
  tasks:
  - name: dump a database
    mysql_db:
      login_host: "127.0.0.1"
      login_user: "root"
      login_password: "mysql@123"
      login_port: "3306"
      name: "mezz"
      target: "/tmp/mezz.gz"
      state: "dump"
      
#导入数据库
  hosts: mysql_group
  tasks:
  - name: import a database
    mysql_db:
      login_host: "127.0.0.1"
      login_user: "root"
      login_password: "mysql@123"
      login_port: "3306"
      name: "mezz"
      target: "/tmp/mezz.gz"
      state: "import"

template模块

该模块只能在playbook中运行，不能使用命令行

功能：该模块和copy模块作用基本一样，都是把某个文件复制到远端主机上，但是区别在于template模块可以获取变量的值，而copy则是原封不动的把文件内容复制过去

改变量的调用依赖于facts，关闭fascs的话，该模块作用将于copy模块相同

问题：由于每台服务器cpu数量不一样，没办法来灵活配置Nginx最大进程数

– backup： 如果原目标文件存在，则先备份目标文件 
– src：在ansible控制器上的Jinja2格式化模板的路径。 这可以是相对或绝对的路径。 
– dest：将模板渲染到远程机器上的位置。 
force：是否强制覆盖，默认为yes 
– owner：目标文件属主 
– group：目标文件属组 
– mode：目标文件的权限模式

# Example from Ansible Playbooks
- template:
    src: /mytemplates/foo.j2
    dest: /etc/file.conf
    owner: bin
    group: wheel
    mode: 0644

pam_limits模块

功能：修改文件描述符

#为用户joe添加或修改nofile软限制
- pam_limits:
    domain: joe
    limit_type: soft
    limit_item: nofile
    value: 64000

# 为用户smith添加或修改硬限制。保持或设置最大值。
- pam_limits:
    domain: smith
    limit_type: hard
    limit_item: fsize
    value: 1000000
    use_max: yes

#为用户james添加或修改memlock，包括软硬限制和注释。
- pam_limits:
    domain: james
    limit_type: '-'
    limit_item: memlock
    value: unlimited
    comment: unlimited memory lock for james