Ansible自动化运维工具（常用模块与命令）

ansible基于Python开发，实现了批量系统配置，批量程序部署，批量运行命令等功能

ansible特点

• 部署简单，只需在主控端部署Ansible环境，被控端无需做任何操作；
• 默认使用ssh协议对设备进行管理；
• 有大量常规运维操作模块，可实现日常绝大部分操作
• 配置简单，功能强大，扩展性强
• 支持API及自定义模块，可通过Python轻松扩展；
• 通过Playbooks来定制强大的配置，状态管理
• 轻量级，无需再客户端安装agent，更新时，只需在操作机上进行一次更新即可
• 提供一个功能强大，操作性强的Web管理界面和REST API接口---AWX平台

ansible架构图

Ansible：Ansible核心程序。

HostInventory：记录由Ansible管理的主机信息，包括端口、密码、ip等。

Playbooks：“剧本”YAML格式文件，多个任务定义在一个文件中，定义主机需要调用哪些模块来完成的功能。

CoreModules：核心模块，主要操作是通过调用核心模块来完成管理任务。

CustomModules：自定义模块，完成核心模块无法完成的功能，支持多种语言。 ConnectionPlugins：连接插件，Ansible和Host通信使用

 一、ansible配置（yum安装）

1.yum安装

yum install epel-release -y
yum install ansible –y

2.ansible程序结构

安装目录如下(yum安装)： 　 
配置文件目录：/etc/ansible/ 　　
执行文件目录：/usr/bin/ 　　
Lib库依赖目录：/usr/lib/pythonX.X/site-packages/ansible/ 　　
Help文档目录：/usr/share/doc/ansible-X.X.X/ 　　
Man文档目录：/usr/share/man/man1/

3. absible配置文件

inventory = /etc/ansible/hosts #这个参数表示资源清单inventory文件的位置
library = /usr/share/ansible   #指向存放Ansible模块的目录，支持多个目录方式，只要用冒号（：）隔开就可以
forks = 5       #并发连接数，默认为5
sudo_user = root        #设置默认执行命令的用户
remote_port = 22        #指定连接被管节点的管理端口，默认为22端口，建议修改，能够更加安全
host_key_checking = False #设置是否检查SSH主机的密钥，值为True/False。关闭后第一次连接不会提示配置实例
timeout = 60        #设置SSH连接的超时时间，单位为秒
log_path = /var/log/ansible.log     #指定一个存储ansible日志的文件（默认不记录日志）

4.ansible主机清单

1、 直接指明主机地址或主机名：
    # green.example.com
    # blue.example.com
    # 192.168.100.1
    # 192.168.100.10
2、 定义一个主机组[组名]把地址或主机名加进去
    [mysql_test]
    192.168.253.159
    192.168.253.160
    192.168.253.153
    192.168.153.[199:202]
   
3. [web]
    web1
    web2
    [web:vars]
    ansible_ssh_root="root"
    ansible_ssh_pass="1"
    
 4. [web]
    web1
    web2
    [db]
    db1
    db2
    [host:children]
    web
    db
    
    ansibel host --list-hosts　　

通常写入如下文件 （提前做好其他服务器在此机器的本地域名解析）

[root@server ~]# vim /etc/ansible/hosts

二、ansible常用命令

格式： ansible  主机清单中的主机组  -f 开启线程数  -m 模块  -a 模块需要的参数

 ansible配置公私钥

#1.生成私钥
[root@server ~]# ssh-keygen 
#2.向主机分发私钥
[root@server ~]# ssh-copy-id root@192.168.37.122
[root@server ~]# ssh-copy-id root@192.168.37.133
如果出现错误，那么便需要再安装一个包
[root@server ~]# yum -y install openssh-clients

三、ansible常用模块

1.主机连通性测试

[root@server ~]# ansible web -m ping
192.168.37.122 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}
192.168.37.133 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}

2.command模块

**可以直接在远程主机上执行命令，并将结果返回本主机**

chdir ：执行命令之前，先切换到该目录

executable ： 切换shell来执行命令，需要使用命令的绝对路径

free_from ： 执行的linux指令，一般使用Ansible的-a参数代替

create ： 一个文件名，当这个文件存在，则该命令不执行

removes ： 一个文件名，这个文件不存在，则该命令不执行

[root@server ~]# ansible web -m command -a 'chdir=/data/ ls'  #先切换到/data/ 目录，再执行“ls”命令
[root@server ~]# ansible web -m command -a 'creates=/data/aaa.jpg ls'  #如果/data/aaa.jpg存在，则不执行“ls”命令
[root@server ~]# ansible web -m command -a 'removes=/data/aaa.jpg cat /data/a' #如果/data/aaa.jpg存在，则执行“cat /data/a”命令

3.shell模块（万金油模块）

**可以在主机上调用shell解释器运行命令，支持shell各种功能**

[root@server ~]# ansible web -m shell -a 'cat /etc/passwd |grep "keer"'

4.copy模块

**用于将文件复制到远程主机，同时支持给定内容生成文件和修改权限等**

src ： 被复制到远程主机的本地文件，可以是绝对路径，也可以是相对路径，路径为目录则递归复制

content ： 用于替换src，可以指定文件的值

dest ：必选项，将源文件复制到的远程主机的绝对路径

backup ： 当文件内容发生改变后，在覆盖之前把源文件备份，备份文件包含时间信息

directory_mode ：递归设定目录的权限，默认为系统默认权限

force ： 当目标主机包含该文件，但内容不同时，设为yes，表示强制覆盖；设为no，表示目标位置不存在该文件才复制。默认为yes

others ： 所有的file模块中的选项可以在这使用

1.复制文件
[root@server ~]# ansible web -m copy -a 'src=~/hello dest=/data/hello' 
2.给定内容生成文件，并指定权限
[root@server ~]# ansible web -m copy -a 'content="I am keer\n" dest=/data/name mode=666'
3.关于覆盖
[root@server ~]# ansible web -m copy -a 'content="I am keerya\n" backup=yes dest=/data/name mode=666'

 5.file模块

**主要用于设定文件的属性，比如创建文件，创建链接文件，删除文件等**

force ： 需要在两种情况下强制创建软链接，一种是源文件不存在，但之后会建立的情况下；另一种是目标软链接已存在，需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no

group ： 定义文件/目录的属组。后面可以加上

mode ： 定义文件/目录的权限

owner ： 定义文件/目录的属主。后面必须跟上

path ： 定义文件/目录的路径

recurse ： 递归设置文件的属性，只对目录有效，后面跟上

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

dest ： 被链接到的路径， 只应用于state=link的情况

state ： 状态，选项为：

                directort：如果目录不存在，就创建目录 link：创建软链接 hard：创建硬链接

                touch ： 如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则                                  更新其最后修改时间 absent：删除目录、文件或者取消链接文件

1.创建目录
[root@server ~]# ansible web -m file -a 'path=/data/app state=directory'
2.创建链接文件
[root@server ~]# ansible web -m file -a 'path=/data/bbb src=/data/aaa state=link'
3.删除文件
[root@server ~]# ansible web -m file -a 'path=/data/a state=absent'

 6.fetch模块

**用于从远程某主机获取（复制）文件到本地

dest ：用来存放文件的目录

src ： 在远程拉取的文件，并且必须是一个file，不能是目录

[root@server ~]# ansible web -m fetch -a 'src=/data/hello dest=/data' 

 7.cron模块

**适用于管理cron计划任务的，语法于crontab文件中语法一致**

分，时，日，月，周

job= 指明运行的命令是什么

name= 定时任务描述

reboot ： 任务在重启是运行，不建议使用，建议使用special_time

special_time ： 参数：reboot（重启时），annually（每年），monthly（每月），weekly（每周），daily（每天），hourly（每小时）

state ：指定状态，present表示添加定时任务，也是默认设置，absent表示删除定时任务

user ： 以哪个用户的身份执行

1.添加计划任务
[root@server ~]# ansible web -m cron -a 'name="ntp update every 5 min" minute=*/5 job="/sbin/ntpdate 127.0.0.1 &> /dev/null"'
2.删除计划任务：在添加计划任务后面加 state=absent
3.查看现有的计划任务
[root@server ~]# ansible web -m shell -a 'crontab -l'

 8.yum模块

**主要用于软件的安装**

name=  所安装的包的名称

stat=   present--->安装， latest--->安装最新的, absent---> 卸载软件。

update_cache ：强制更新yum的缓存

conf_file ： 指定远程yum安装时所依赖的配置文件（安装本地已有的包）

disable_gpg_check ：是否禁止GPG checking，只用于presentor latest。

disablerepo ： 临时禁止使用yum库。 只用于安装或更新时

enablerepo ： 临时使用的yum库。只用于安装或更新时。

[root@server ~]# ansible web -m yum -a 'name=nginx state=present'

 9.service模块

**用于服务程序的管理**

arguments ： 命令行提供额外的参数

enabled ： 设置开机启动

name ： 服务名称

runlevel ： 开机启动的级别，一般不用指定

sleep ： 在重启服务的过程中，是否等待。如在服务关闭以后等待2秒再启动。(定义在剧本中。)

state ： 有四种状态，分别为：started--->启动服务， stopped--->停止服务，

restarted -->重启服务  reloaded --->重载配置

1.开启服务并设计自启动
[root@server ~]# ansible web -m service -a 'name=nginx state=started enabled=true' 
2.关闭服务
[root@server ~]# ansible web -m service -a 'name=nginx state=stopped'

 10.user模块

**用来管理用户账号**

comment ： 用户的描述信息

createhome ： 是否创建家目录

force ： 在使用state=absent时，行为与userdel -force一致

group ： 指定基本组

groups ： 指定附加组，如果指定为(groups=)表示删除所有组

home ： 指定用户家目录

move_home ：如果设置为home=时, 试图将用户主目录移动到指定的目录

name ： 指定用户名

non_unique ：该选项允许改变非唯一的用户ID值

password ： 指定用户密码,对密码加密可以使用python的crypt和passlib

remove ：在使用state=absent时, 行为是与userdel –remove一致

shell ： 指定默认shell

state ： 设置账号状态，不指定为创建，指定值为absent表示删除

system ： 当创建一个用户，设置这个用户是系统用户。这个设置不能更改现有用户

uid ： 指定用户uid

1.添加一个用户并指定其uid
[root@server ~]# ansible web -m user -a 'name=mm uid=11111'
2.删除用户
root@server ~]# ansible web -m user -a 'name=mm state=absent'

 11.group模块

**用来添加或删除组**

gid=    设置组的GID号

name=   指定组的名称

state=   指定组的状态，默认为创建，设置值为absent为删除 system=  设置值为yes，表示创建为系统组

1.创建组
[root@server ~]# ansible web -m group -a 'name=cc gid=12222'
2.删除组
[root@server ~]# ansible web -m group -a 'name=cc state=absent'

 12.script模块

**用于将本机的脚本在被管理端的机器上运行，该模块直接指定脚本的路径（脚本必须给执行权限）**

[root@server ~]# ansible web -m script -a '/tmp/df.sh'

13.setup模块

**主要用于收集信息，通过调用facts组件实现**

facts组件是Ansible用于采集被管机器设备信息的一个功能，我们可以使用setup模块查机器的所有facts信息，可以使用filter来查看指定信息。整个facts信息被包装在一个JSON格式的数据结构中，ansible_facts是最上层的值。 facts就是变量，内建变量 。每个主机的各种信息，cpu颗数、内存大小等。会存在facts中的某个变量中。调用后返回很多对应主机的信息，在后面的操作中可以根据不同的信息来做不同的操作。如redhat系列用yum安装，而debian系列用apt来安装软件。

1.查看信息
[root@server ~]# ansible web -m setup -a 'filter="*mem*"'   #查看内存
2.保存信息
[root@server tmp]# ansible web -m setup -a 'filter="*mem*"' --tree /tmp/facts

14.get_url模块

**将文件或者软件从http，https，ftp下载到本地节点上**

dest ： 指定将文件下载的绝对路径，----必须

url ： 文件的下载地址（网址）----必须

url_username: 用于http基本认证的用户名
url_password： 用于http基本认证的密码
validate_certs： 如果否，SSL证书将不会验证。这只应在使用自签名证书的个人控制站点上使用
owner： 指定属主
group： 指定属组
mode： 指定权限

[root@server ~]# ansible -i /etc/ansible/hosts  zabbix -m get_url -a "url=ftp://10.3.131.50/soft/wechat.py dest=/tmp"

 15.stat模块

**检查文件或文件系统状态**（windows目标，改为win _stat模块）

path ： 文件/对象的完整路径----必须

 16.unarchive模块

**从本机上复制存档后，将其解包**

说明：该unarchive模块将解压缩一个存档。默认情况下，它将在解包之前将源文件从本地系统复制到目标。设置remote_src=yes为解包目标上已经存在的档案。对于Windows目标，请改用win_unzip模块。

dest ：远程绝对路径，档案应该被解压缩

extc ：列出需要排除的目录和文件

src ： 指定源

creates ： 一个文件名，当它已经存在时，这个步骤将不会被运行