【转载】Ansible - 基础应用

原作：https://www.cnblogs.com/keerya/p/7987886.html

---

ansible自动化运维工具实现了批量系统配置、批量程序部署、批量运行命令等功能。

 

使用 yum 安装

我们需要先安装一个 epel-release 包，然后再安装我们的 ansible 即可。

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

 

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/

ansible配置文件

配置文件/etc/ansible/ansible.cfg 常见的参数：

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日志的文件（默认不记录日志）

 

ansible主机清单

在配置文件中（/etc/ansible/hosts），我们提到了资源清单，这个清单就是我们的主机清单，里面保存的是一些 ansible 需要连接管理的主机列表。

[root@sp001 ~]# cat /etc/ansible/hosts
# 这是默认的 ansible 'hosts' 文件。
# 它应该位于 /etc/ansible/hosts
# - 注释以“#”字符开头
# - 空白行被忽略
# - 主机组由 [header] 元素分隔
# - 您可以输入主机名或 IP 地址
# - 主机名/ip 可以是多个组的成员

# Ex 1: 未分组的主机，在任何组头之前指定。
## green.example.com
## blue.example.com
## 192.168.100.1
## 192.168.100.10

# Ex 2: 属于 'webservers' 组的主机集合
## [webservers]
## alpha.example.org
## beta.example.org
## 192.168.1.100
## 192.168.1.110

# 如果你有多个主机遵循一个模式，你可以像这样指定它们：
## www[001:006].example.com

# Ex 3: 'dbservers' 组中的数据库服务器集合
## [dbservers]
## db01.intranet.mydomain.net
## db02.intranet.mydomain.net
## 10.25.1.56
## 10.25.1.57

# 这是另一个主机范围的例子，这次没有前导 0：
## db-[99:101]-node.example.com

 

 

ansible 常用命令

ansible-doc 命令

　　ansible-doc 命令常用于获取模块信息及其使用帮助，一般用法如下：

        ansible-doc -l                         #获取全部模块的信息
        ansible-doc -s MOD_NAME                #获取指定模块的使用帮助

ansible 命令详解

　　命令的具体格式如下：

　　ansible <host-pattern> [-f forks] [-m module_name] [-a args]

　　也可以通过ansible -h来查看帮助，下面我们列出一些比较常用的选项，并解释其含义：

-a MODULE_ARGS　　　　　#模块的参数，如果执行默认COMMAND的模块，即是命令参数，如： “date”，“pwd”等等

-k，--ask-pass　　　　  #ask for SSH password。登录密码，提示输入SSH密码而不是假设基于密钥的验证

--ask-su-pass　　 　　   #ask for su password。su切换密码

-K，--ask-sudo-pass　 #ask for sudo password。提示密码使用sudo，sudo表示提权操作

--ask-vault-pass　　  #ask for vault password。假设我们设定了加密的密码，则用该选项进行访问

-B SECONDS 　　　　　　#后台运行超时时间

-C 　　　　　　　　　　#模拟运行环境并进行预运行，可以进行查错测试

-c CONNECTION 　　     #连接类型使用

-f FORKS　　　　      #并行任务数，默认为5

-i INVENTORY　　   #指定主机清单的路径，默认为/etc/ansible/hosts

--list-hosts 　　    #查看有哪些主机组

-m MODULE_NAME　　#执行模块的名字，默认使用 command 模块，所以如果是只执行单一命令可以不用 -m参数

-o 　　　　　　　　 #压缩输出，尝试将所有结果在一行输出，一般针对收集工具使用

-S　　　　　　　　#用 su 命令

-s　　 　　　　　　#用 sudo 命令

-R SU_USER 　　　　#指定 su 的用户，默认为 root 用户

-U SUDO_USER 　　   #指定 sudo 到哪个用户，默认为 root 用户

-T TIMEOUT 　　　　#指定 ssh 默认超时时间，默认为10s，也可在配置文件中修改

-u REMOTE_USER 　　#远程用户，默认为 root 用户

-v 　　　　　　　　 #查看详细信息，同时支持-vvv，-vvvv可查看更详细信息

 

ansible 配置公私钥

　　上面我们已经提到过 ansible 是基于 ssh 协议实现的，所以其配置公私钥的方式与 ssh 协议的方式相同，具体操作步骤如下：

# 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

 

　　这样的话，就可以实现无密码登录，我们的实验过程也会顺畅很多。

# 注意，如果出现了以下报错：
-bash: ssh-copy-id: command not found

# 那么就证明我们需要安装一个包：
yum -y install openssh-clientsansible

 

　　配置秘钥登录，当我们集群关闭了密码登录时，可以指定秘钥文件路径。

#配置秘钥登录方式1
[root@server ~]$ cat /etc/ansible/hosts 
[suanpan] 
192.168.37.132 ansible_ssh_user=root ansible_ssh_pass='123456'
192.168.37.133 ansible_ssh_user=root ansible_ssh_key_file='/root/.ssh/id_rsa'  

#配置秘钥登录方式2
[root@server ~]$ cat /etc/ansible/ansible.cfg
……
private_key_file = /root/.ssh/id_rsa
……

 

ansible 常用模块

1）主机连通性测试

　　我们使用ansible web -m ping命令来进行主机连通性测试。效果如下：

[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 模块

　　这个模块可以直接在远程主机上执行命令，并将结果返回本主机。举例如下：

[root@server ~]# ansible web -m command -a 'ss -ntl'
192.168.37.122 | SUCCESS | rc=0 >>
State      Recv-Q Send-Q Local Address:Port               Peer Address:Port              
LISTEN     0      128          *:111                      *:*                  
LISTEN     0      5      192.168.122.1:53                       *:*                  
LISTEN     0      128          *:22                       *:*                  
……

　　

　　命令模块接受命令名称，后面是空格分隔的列表参数。给定的命令将在所有选定的节点上执行。它不会通过shell进行处理，比如$HOME和操作如"<"，">"，"|"，";"，"&" 工作（需要使用 shell 模块实现这些功能）。下面来看一看该模块下常用的几个命令：

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

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

free_form　　  # 要执行的Linux指令，一般使用Ansible的 -a 参数代替

creates 　 　　# 一个文件名，当这个文件存在，则该命令不执行,可以 用来做判断

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

# 先切换到/data/ 目录，再执行“ls”命令
ansible web -m command -a 'chdir=/data/ ls'        

# 如果/data/aaa.jpg存在，则不执行“ls”命令
ansible web -m command -a 'creates=/data/aaa.jpg ls'   

#如果/data/aaa.jpg存在，则执行“cat /data/a”命令
ansible web -m command -a 'removes=/data/aaa.jpg cat /data/a'

3）shell 模块

　　shell模块可以在远程主机上调用shell解释器运行命令，支持shell的各种功能，例如管道等。

[root@server ~]# ansible web -m shell -a 'cat /etc/passwd |grep "keer"'
192.168.37.122 | SUCCESS | rc=0 >>
keer:x:10001:1000:keer:/home/keer:/bin/sh192.168.37.133 | SUCCESS | rc=0 >>
keer:x:10001:10001::/home/keer:/bin/sh

 

4）copy 模块

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

src　　　　    #被复制到远程主机的本地文件。可以是绝对路径，也可以是相对路径。如果路径是一个目录，则会递归复制，用法类似于"rsync"

content　　　#用于替换"src"，可以直接指定文件的值

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

backup　　　 #当文件内容发生改变后，在覆盖之前把源文件备份，备份文件包含时间信息 directory_mode　　　　#递归设定目录的权限，默认为系统默认权限

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

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

# 复制文件
ansible web -m copy -a 'src=~/hello dest=/data/hello' 

# 给定内容生成文件，并制定权限
ansible web -m copy -a 'content="I am keer\n" dest=/data/name mode=666'
 
# 关于覆盖
ansible web -m copy -a 'content="I am keerya\n" backup=yes dest=/data/name mode=666'

 

5）fetch 模块

　　该模块用于从远程某主机获取（复制）文件到本地。

dest：用来存放文件的目录

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

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

 

 

6）cron 模块

　　该模块适用于管理cron计划任务的。 　　

其使用的语法跟我们的crontab文件中的语法一致，同时，可以指定以下选项：

day= 　　　　#日应该运行的工作( 1-31, *, */2, )

hour= 　　　　# 小时 ( 0-23, *, */2, )

minute=　　　 #分钟( 0-59, *, */2, )

month=　　　　 # 月( 1-12, *, /2, )

weekday= 　　　　# 周 ( 0-6 for Sunday-Saturday,, )

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

name= 　　　　　#定时任务描述

reboot 　　　　　# 任务在重启时运行，不建议使用，建议使用special_time

special_time 　   #特殊的时间范围，参数：reboot（重启时），annually（每年），monthly（每月），weekly（每周），daily（每天），hourly（每小时）

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

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

　　举例如下：

# 添加计划任务
[root@server ~]# ansible web -m cron -a 'name="ntp update every 5 min" minute=*/5 job="/sbin/ntpdate 172.17.0.1 &> /dev/null"'

# 查看计划任务
[root@server ~]# ansible web -m shell -a 'crontab -l'
192.168.37.122 | SUCCESS | rc=0 >>
#Ansible: ntp update every 5 min
*/5 * * * * /sbin/ntpdate 172.17.0.1 &> /dev/null
192.168.37.133 | SUCCESS | rc=0 >>
#Ansible: ntp update every 5 min
*/5 * * * * /sbin/ntpdate 172.17.0.1 &> /dev/null

# 删除计划任务
[root@server ~]# ansible web -m cron -a 'name="df everyday" hour=15 job="df -lh >> /tmp/disk_total &> /dev/null" state=absent'

 

7）script 模块

　　该模块用于将本机的脚本在被管理端的机器上运行。 　　

该模块直接指定脚本的路径即可，我们通过例子来看一看到底如何使用的：

[root@server ~]# vim /tmp/date.sh
#!/bin/bash
date >> /tmp/date.log
[root@server ~]# chmod +x /tmp/date.sh 

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

[root@server ~]# ansible web -m shell -a 'cat /tmp/date.log'
192.168.37.122 | SUCCESS | rc=0 >>
Tue Dec  5 15:58:21 CST 2017
192.168.37.133 | SUCCESS | rc=0 >> 
Tue Dec  5 15:58:21 CST 2017