2、Ansible基础二

[cce@doorta ~]# cat /etc/ansible/hosts
[centos:children]
db
app

[centos:vars]
ansible_ssh_user=root
ansible_ssh_pass=caichangen
ansible_ssh_port=22

[db]
172.16.1.1

[app]
172.16.1.2

[cce@doorta ~]# ansible centos -m ping -o
172.16.1.2 | SUCCESS => {"ansible_facts": {"discovered_interpreter_python": "/usr/bin/python"},"changed": false,"ping": "pong"}
172.16.1.1 | SUCCESS => {"ansible_facts": {"discovered_interpreter_python": "/usr/bin/python"},"changed": false,"ping": "pong"}

chdir：在执行指令之前，先切换到指定目录；
creates：指定文件存在时，取消执行指令；
removes：指定文件不存在时，取消执行指令；

[cce@doorta ~]# ansible db -m command -a 'chdir=/tmp pwd' -o
172.16.1.1 | CHANGED | rc=0 | (stdout) /tmp

chdir：在执行指令之前，先切换到指定目录；
creates：指定文件存在时，取消执行指令；
removes：指定文件不存在时，取消执行指令；

[cce@doorta ~]# ansible db -m shell -a 'chdir=/tmp removes=/tmp/1 pwd' -o
172.16.1.1 | SUCCESS | rc=0 | (stdout) skipped, since /tmp/1 does not exist  # /tmp/1文件不存在，所以取消执行指令了

name：指定用户名；
password：指定用户密码；
create_home：是否创建家目录，取值yes/no；
home：指定用户的家目录位置；
group：指定基本组；
groups：指定附加组；
shell：指定用户登录shell环境；
uid：指定用户UID；
state：指定用户状态，present为创建，absent为删除；
move_home：假如此用户已经存在，取值yes为覆盖家目录，取值no为创建为此用户创建另外一个家目录，两个家目录通过uid区分；
generate_ssh_key：创建用户的同时是否为此用户创建ssh密钥文件，取值yes/no；
remove：删除用户时是否删除用户目录，取值yes/no；

# 创建一个UID为1024，且基本组为root的用户
[cce@doorta ~]# ansible all -m user -a 'user=test uid=1024 group=root create_home=yes state=present' -o
# 删除名为test的用户，并删除家目录
[cce@doorta ~]# ansible all -m user -a 'user=test state=absent remove=yes' -o

gid：指定组的id号；
name：指定组名；
state：指定创建组还是删除组，取值present为创建，absent为删除；
system：指定该组是否为系统组，取值yes/no；

# 创建组
[cce@doorta ~]# ansible all -m group -a 'gid=1000 name=test state=present system=no' -o
# 删除组
[cce@doorta ~]# ansible all -m group -a 'gid=1000 name=test state=absent system=no' -o

conf_file：指定YUM源配置文件路径；
disable_gpg_check：关闭YUM的gpg_check配置；
name：指定需要安装的软件名称，也可以传递一个URL或者一个本地的RPM包的路径 ；
state：指定是安装软件包还是更新或者卸载软件包，取值present为安装软件包，取值latest为更新软件包，取值absent为删除软件包；

# 安装软件包
[cce@doorta ~]# ansible all -m yum -a 'name=nginx' -o 
# 卸载软件包
[cce@doorta ~]# ansible all -m yum -a 'name=nginx state=absent' -o 

arguments：给命令行提供一些选项；
enabled：是否开机启动，取值yes/no；
name：操作的服务名称；
pattern：定义一个模式，如果通过status指令来查看服务的状态时，没有响应，就会通过ps指令在进程中根据该模式进行查找，如果匹配到，则认为该服务依然在运行；
runlevel：指定开机启动的运行级别；
daemon_reload：重载systemd；
state：对当前服务执行启动，停止、重启、重新加载等操作，可以取值started、stopped、restarted、reloaded；

# 启动服务，并开启开机自启
[cce@doorta ~]# ansible all -m systemd -a 'name=nginx state=started enabled=yes'
# 停止服务，并关闭开机自启
[cce@doorta ~]# ansible all -m systemd -a 'name=nginx state=stopped enabled=no'

creates：指定一个文件名，当该文件存在时，则解压指令不执行；
src：压缩包的路径，具体是在被控端主机还是控制端主机，取决于copy的值；
dest：控制端主机的路径，即文件解压的父目录，该目录必须存在；
copy：默认为yes，表示将ansible控制端主机的src路径的文件，拷贝到远程主机，并解压到远程主机的dest目录，值为no表示将被控端主机上路径为src的文件解压到被控端主机的dest目录；
owner：指定解压后的文件的属主；
group：指定解压后的文件的属组；
mode：指定解压后的文件的权限；

# 将文件传到远端主机，并解压到指定目录
[cce@doorta ~]# ansible all -m unarchive -a 'copy=yes src=/Users/cce/tar.tar.gz dest=/tmp/cce'
# 直接将远端主机的某个文件。解压到指定目录
[cce@doorta ~]# ansible all -m unarchive -a 'copy=no src=/tmp/tar.tar.gz dest=/tmp/cce'

path：控制端主机的路径，即需要压缩的目录绝对路径；
dest：压缩后文件名称获取全路径；
remove：压缩完成之后，是否删除源文件，取值yes/no，默认为no；
format：指定打包压缩的类型，如bz2、gz、tar、xz、zip；
owner：指定解压后的文件的属主；
group：指定解压后的文件的属组；
mode：指定解压后的文件的权限；

# 压缩远端主机指定的文件进行压缩，并存储到指定的路径下
[cce@doorta ~]# ansible all -m archive -a 'path=/tmp/yum.log remove=no dest=/tmp/cce.tar.gz format=tar'

url：指定下载文件的URL；
url_username：用于HTTP Basic认证的用户名；
url_password：用于HTTP Basic认证的密码；
validate_certs：表示是否校验SSL证书是否过期，默认取值为yes；
dest：指定下载文件存放的路径；
owner：指定下载文件的属主；
group：指定下载文件的属组；
mode：指定下载文件的权限；
timeout：设置下载超时时间；

# 下载文件到/tmp目录
[cce@doorta ~]# ansible all -m get_url -a 'url=http://old.doorta.com/software/frpc.ini dest=/tmp owner=root mode=644 group=root'

src：指定被控主机内要拉取的文件绝对路径；
dest：指定拉取文件到本地的哪个目录；

# 拉取远端主机文件到本地指定目录下
[cce@doorta ~]# ansible all -m fetch -a 'src=/etc/rc.local dest=/tmp flat=no'

src：用于指定需要copy的文件或目录，如果路径是一个目录，它将递归复制，同时如果路径使用"/"来结尾，则只复制目录里的内容，如果没有使用"/"来结尾，则包含目录在内的整个内容全部复制，一个复制目录里面的内容，一个直接复制目录；
dest：要将文件复制到远程主机的哪个目录，绝对路径；
content：当不使用src指定拷贝的文件时，可以使用content直接指定文件内容，src与content两个参数必有其一，否则会报错；
force：当远程主机的目标路径中已经存在同名文件，并且与ansible主机中的文件内容不同时，是否强制覆盖，可选值有yes和no，默认值为yes，表示覆盖，如果设置为no，则不会执行覆盖拷贝操作，远程主机中的文件保持不变；
backup：当远程主机的目标路径中已经存在同名文件，并且与ansible主机中的文件内容不同时，是否对远程主机的文件进行备份，可选值有yes和no，当设置为yes时，会先备份远程主机中的文件，然后再将ansible主机中的文件拷贝到远程主机；
owner：指定文件拷贝到远程主机后的属主，但是远程主机上必须有对应的用户，否则会报错；
group：指定文件拷贝到远程主机后的属组，但是远程主机上必须有对应的组，否则会报错；
mode：指定文件拷贝到远程主机后的权限，如果你想将权限设置为”rw-r--r--“，则可以使用mode=0644表示，如果你想要在user对应的权限位上添加执行权限，则可以使用mode=u+x表示；
others：所有的file模块里的选项都可以在这里使用；

# 分发配置文件到远端主机的指定目录，如果远端主机存在同名文件，则先备份
[cce@doorta ~]# ansible all -m copy -a 'src=/etc/fstab.hd dest=/root backup=yes'

chdir：此参数的作用就是指定一个目录，在执行对应的命令之前，会先进入到chdir参数指定的目录中；
creates：当指定的文件存在时，就不执行对应命令；
removes：当指定的文件不存在时，就不执行对应命令；
        script模块的使用非常的简单，它一般来讲，无需任何参数，直接给定本地脚本路径即可，如下示例；

# 在被控主机上执行本地脚本
[cce@doorta ~]# ansible all -m script -a '/etc/uptime.sh'

path：指定需要操作远端主机的文件绝对路径；
block：指定需要在远端主机文件中插入的文本内容；
marker：用于指定标记符，即一个开始标记一个结束标记，默认开始标记为# BEGIN ANSIBLE MANAGED BLOCK，结束标记为# END ANSIBLE MANAGED BLOCK；
state：有两个可选值，present和absent，如果远端主机的文件中已经存在对应标记的文本，取值present会更新对应段落，取值absent，则从该文件中删除对应标记的段落；
insertafter：默认值为EOF，即在文件的末尾插入文本；
insertbefore：默认值为BOF，即在文件的开头插入文本；
backup：是否在修改远端主机的文件之前对该文件进行备份；
create：当远端主机操作的文件不存在时，是否创建，取值yes/no；

# 在远端主机指定的文件新增内容
[cce@doorta ~]# ansible all -m blockinfile -a 'path=/etc/fstab block="cce" state=present'
# 在远端主机指定的文件删除内容
[cce@doorta ~]# ansible all -m blockinfile -a 'path=/etc/fstab block="cce" state=absent' 

path：指定需要操作的远端主机的文件绝对路径；
line：指定用来替换或者删除的内容；
regexp：表示使用正则表达式来匹配对应的行，匹配成功则将内容进行替换或者删除，如果有多行匹配，对于替换只会替换匹配到的最后一行，对于删除将会直接删除所有匹配项；
state：表示是执行替换操作，还是删除操作，取值present则替换匹配到的文本，取值absent则删除匹配的文本；
create：当要操作的文件并不存在时，是否创建对应的文件，默认为false；
backup：是否在修改文件之前对文件进行备份，默认为false；
insertafter：借助insertafter可以将文本插入到指定的行后，insertafter参数的值可以设置为EOF或者正则表达式，默认为EOF，如果将insertafter的值设置为正则表达式，表示将文本插入到匹配到正则的行后，如果正则没有匹配到任何行，则插入到文件末尾，当使用backrefs参数时，此参数将会被忽略；
insertbefore：将文本插入到指定行之前，insertbefore的值可以设置为BOF或者正则表达式，BOF表示插入到文档开头，默认为BOF，如果将insertbefore设置为正则表达式，表示将文本插入到匹配到正则的行之前，如果正则没有匹配到任何行，则插入到文件末尾，当使用backrefs参数时，此参数被忽略；
backrefs：默认情况下，当根据正则替换文本时，即使regexp参数中的正则存在分组，再line参数中也不能对正则中的分组行进行引用，除非将backrefs参数的值设置为yes，backrefs=yes表示开启后向引用，这样，line参数中就能对regexp参数中的分组进行后向引用了。backrefs=yes除了能开启后向引用功能，还有另一个作用，默认情况下，当使用正则表达式替换对应行时，同时设置了backrefs=yes，那么当正则没有匹配到任何的行时，则不会对文件进行任何操作，相当于保持文件不变。

# 将远端主机正则为"^SELINUX\="的行替换为SELINUX=disabled
[cce@doorta ~]# ansible all -m lineinfile -a 'path=/etc/selinux/config line='SELINUX=disabled' regexp="^SELINUX\=" state=present'
# 在远端主机正则为"^SELINUX\="的行前面新增一行数据
[cce@doorta ~]# ansible all -m lineinfile -a 'path=/etc/selinux/config line='SELINUX=disabled' state=present insertbefore="^SELINUX\="' 
# 删除远端主机正则为".*disabled"匹配到的行
[cce@doorta ~]# ansible all -m lineinfile -a 'path=/etc/selinux/config regexp=".*disabled$" state=absent'
# 在远端主机首部添加文本
[cce@doorta ~]# ansible all -m lineinfile -a 'path=/etc/selinux/config line="cce" insertbefore=BOF  state=present'
# 在远端主机尾部添加文本
[cce@doorta ~]# ansible all -m lineinfile -a 'path=/etc/selinux/config line="cce" insertbefore=BOF  state=absent'
# 使用正则分组，将regexp中的分组匹配到到数据放在line参数中引用
[cce@doorta ~]# ansible all -m lineinfile -a 'path=/etc/selinux/config line="\1disabled" regexp="^(SELINUX=).*" state=present backrefs=yes'

ansible_all_ipv4_addresses：仅显示ipv4的信息；
ansible_devices：仅显示磁盘设备信息；
ansible_distribution：显示是操作系统类型；
ansible_distribution_major_version：显示是系统主版本；
ansible_distribution_version：仅显示系统版本；
ansible_machine：显示CPU架构，是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个数(只显示总的个数；
ansible_python_version：显示python版本；

# 收集远端主机CPU架构
[cce@doorta /usr/local/Project/linux]# ansible all -m setup -a 'filter=ansible_machine' -o
172.16.1.2 | SUCCESS => {"ansible_facts": {"ansible_machine": "x86_64","discovered_interpreter_python": "/usr/bin/python"},"changed": false}
172.16.1.1 | SUCCESS => {"ansible_facts": {"ansible_machine": "x86_64","discovered_interpreter_python": "/usr/bin/python"},"changed": false}