ansible 模块unarchive ansible module

ansible

安装

yum install -y ansible

配置

两种方法：

1. 秘钥
2. 直接在 /etc/ansible/hosts 填入对应服务器账号密码

[myself]
192.168.94.134 ansible_ssh_user="root" ansible_ssh_pass="zzh" ansible_su_pass="zzh"
[myhost]
192.168.94.135 ansible_ssh_user="root" ansible_ssh_pass="zzh" ansible_su_pass="zzh"

测试

[root@localhost ansible]# ansible all -m command -a "who"
192.168.94.135 | SUCCESS | rc=0 >>
root     pts/0        2018-09-17 13:39 (192.168.94.134)

192.168.94.134 | SUCCESS | rc=0 >>
root     tty1         2018-09-17 10:34
root     pts/0        2018-09-17 13:34 (192.168.94.1)
root     pts/1        2018-09-17 10:53 (192.168.94.1)
root     pts/6        2018-09-17 13:39 (192.168.94.134)

命令说明

命令格式:

ansible <pattern_goes_here> -m <module_name> -a <arguments>
#例如:
ansible all -m copy -a 'src=/etc/my.cnf dest=/etc/'
#几个重要参数的含义:
-i    #指定inventory文件(主机定义文件)          ？？？
all   #表示在host文件中定义的所有的主机,可以替换成响应的组名或IP地址
#针对于主机可以使用匹配规则(所有的匹配都基于配置文件中的主机)
  IP地址: ansible  192.168.239.132
  IP匹配: ansible  192.168.239.*
  IP匹配: ansible  *
  组匹配: ansible 组名:&hostname     <表示这个组跟其他组的一个主机>
  组匹配: ansible 组名:!hostname     <表示这个组但是出除去这个组的这个主机>
#类似的匹配还很多,几乎能想到的匹配都能支持,具体参照http://docs.ansible.com/intro_patterns.html
-m    #指定使用哪个模块,默认采用command模块
-a    #指定模块的参数,每个模块都有相应的模块参数
-u    #指定远端机器的用户

command模块与shell模块的区别

shell功能全面但执行效率低

command不支持：逻辑运算符、条件判断符号、重定向命令或管道

ansible srvs -m command -a 'echo "$HOSTNAME"'
ansible srvs -m shell -a 'echo "$HOSTNAME"'

使用command模块会报错

ansible srvs -m command -a 'cat /etc/issue > /tmp/issue.tmp'

使用shell模块则不会

ansible srvs -m shell -a 'cat /etc/issue > /tmp/issue.tmp'
ansible srvs -m command -a 'cat /tmp/issue.tmp'

文件传输模块：copy、fetch、template

copy模块：复制本机文件，传输至远程主机，并修改属主、属组和权限

注意：可以在参数中增加 backup=yes ，可以实现备份的功能

实现copy功能

ansible srvs -m copy -a 'src=/etc/yum.repos.d/CentOS-Base.repo dest=/etc/yum.repos.d/CentOS-Base.repo owner=root group=root mode=0644'
ansible srvs -m command -a 'yum clean all'
ansible srvs -m command -a 'yum repolist'

实现备份功能

ansible srvs -m copy -a 'src=/root/test.txt dest=/root/ backup=yes'

fetch模块：复制远程文件，传输至本机（仅支持传输文件，如果传输目录可以先归档或压缩为一个文件后传输）

在n2(从机)的/root目录下创建文件f1，在n3（另一个从机）的/root目录下创建文件f2，假设n2主机的/root目录下没有f2这个文件，假设n3主机的/root目录下没有f1这个文件，如果我们想从n2中传输f1这个文件至n1的/root目录下

注意：使用fetch模块传输至本地主机的文件，全部会保存在目录，文件实际保存路径为： /”dest参数指定的目录”/”源文件所在主机的IP地址”/”执行命令的用户名”/”传输的文件” #在n1主机执行命令 ansible srvs -m fetch -a 'src=/root/f1 dest=/root/ backup=yes' #f1文件的路径 ls 172.16.254.89/root/f1

cron模块

增加计划任务

设置每天的3:15，执行磁盘空间查看命令，并将命令结果保存至指定位置

ansible srvs -m cron -a 'name="disk check loger" minute=15 hour=3 job="df -hT >> /tpm/df.log"'
#验证结果
ansible srvs -m command -a 'crontab -l'
ansible srvs -m command -a 'cat /tmp/df.log'

移除指定计划任务

ansible srvs -m cron -a 'name="disk check loger" state=absent'
#验证
ansible srvs -m command -a 'crontab -l'

yum模块

安装epel源

ansible srvs -m yum -a 'name=epel-release state=latest'

安装应用

ansible srvs -m yum -a 'name=nginx state=latest'

ansible srvs -m yum -a 'name=ntpdate state=latest'
ansible srvs -m command -a 'ntpdate 172.16.0.1'

管理各种服务：service模块

ansible srvs -m service -a 'name=nginx state=started'  
service模块中的state支持的选择有：started, stopped, restarted, reloaded
ansible srvs -m service -a 'name=nginx state=restarted'

setup 模块

自动从远程主机上获取可用与playbook中的变量

获取所有可用变量
ansible srvs -m setup

对变量进行过滤，仅获取符合匹配要求的变量
查询与系统版本相关的变量

“ansible_distribution”: “CentOS”

“ansible_distribution_major_version”: “7”

#方法1
ansible srvs -m setup -a 'filter=*distribut*'
#方法2
ansible srvs -m setup | grep -i distribut

debug 模块

可以通过debug模块调用变量显示想要的信息

tasks:
  - name: show hosts information
    tags: info
    debug: msg="{{ ansible_distribution }}-{{ ansible_distribution_major_vers
ion }}-{{ ansible_distribution_release }}"

验证结果

ansible-playbook /root/ansible/httpd-manager-j2.yml --tags=info
#结果为
ok: [172.16.254.89] => {
    "msg": "CentOS-7-Core"
}

script 模块

准备测试脚本

vim /root/test.sh
#!/bin/bash
#
touch /tmp/test.log
echo `date` >> /tmp/test.log
ls -l /tmp/test.log
cat /tmp/test.log

在所有主机执行脚本

ansible srvs -m script -a '/root/test.sh'

ansible-vault 命令

加密 .yml 文件

#准备一个.yml文件
ansible-vault encrypt test.yml
#输入密码并确认

此时无法使用普通方法查看test.yml文件

查看加密的.yml文件

ansible-vault view test.yml
#输入密码

解密.yml文件

ansible-vault decrypt test.yml
#输入密码

此时可以使用普通方法查看.yml文件内容

ansible-galaxy 命令

文件下载至/etc/ansible/roles目录下

注意：下载其他人共享的roles，在执行前应审核一遍文件内容，防止危险操作

安装并使用其他人共享的roles文件

ansible-galaxy install devops.nginx
ls /etc/ansible/roles/devops.nginx

想删除下载的roles文件，将install替换为delete即可

ansible-console 命令

ansible的交互式命令工具ansible-console进入

ansible-console 的命令提示符
root@all (4)[f:5]$ cd srvs
root@srvs (4)[f:5]$ forks 4
root@srvs (4)[f:4]$ list
172.16.253.184
172.16.254.89
172.16.253.47
172.16.253.30

其中：

root ：当前执行用户
@ ：分隔符
all ：分组的组名
(4) ：当前分组内的主机数量
[f:4] ：并发线程数

ansible-console 的使用 ansible-console工具可自动补全选项，使用格式为：

模块名 选项1=value 选项2=value

???
service name=nginx state=started
yum name=tree state=latest
command tree -L 1 /

ansible-playbook命令及YAML语法

YAML语法

YAML ：YAML ain’t a Markup Language ，以数据为中心、而不是以标记语言为重点的一种语言

1. 首行以 “—” 开始，且需顶格书写
2. 次行开始写playbook的正文，建议写明playbook的功能等描述信息
3. 注释符为"#"
4. 格式非常严格，严格控制缩进统一，不能和空格或Tab混用
5. 缩进级别必须一致，缩进级别相同代表同级别，级别的判断是通过缩进结合换行实现的
6. YAML文件内容和Linux系统大小写的判断方式保持一致，是区分大小写的，k/v的值均对大小写敏感
7. k/v的值可同行写，也可换行写，同行书写使用分隔符":"，换行写分隔符 " - "
8. 一个完整的代码块所必需包含的元素：name、task 一个name只能包括一个task

test.yml 示例

vim /root/test.yml
#文件内容

---
- hosts: myself
  remote_user: root
  tasks:
  - name: adduser test
    user: name=test shell=/bin/bash home=/home/test

playbook 核心元素

hosts ：指定运行任务的目标主机
tasks ：任务列表
variables ：变量
templates ：模板
handlers ：动作执行探测器，探测到指定条件，触发执行动作
roles ：按照固定目录结构组成的playbook

playbook中tags、notify、handlers的使用

playbook实例 ：httpd-manager.yml

---

- hosts: srvs
  remote_user: root
  tasks:
  - name: install httpd
    tags: install
    yum: name=httpd state=latest

  - name: start httpd.service
    tags: start
    service: name=httpd state=started

  - name: start httpd.service
    tags: restart
    service: name=httpd state=restarted

  - name: stop httpd.service
    tags: stop
    service: name=httpd state=stopped

  - name: config httpd
    tags: config
    copy: src=/root/ansible/httpd.conf dest=/etc/httpd/conf/ backup=yes
    when: ansible_distribution_major_version == "7"
    notify: restart httpd

  handlers:
  - name: restart httpd
    service: name=httpd state=restarted

实现功能：

单独调用其中一个功能

ansible-playbook httpd-server-deploy.yml --tags=start

同时调用多个功能

ansible-playbook httpd-server-deploy.yml --tags="stop,config"

针对某一单个成员执行某一功能

ansible-playbook httpd-server-deploy.yml --tags="start,stop" -l 172.16.253.30

playbook中变量的使用

定义变量

在/etc/ansible/hosts文件中定义变量，可针对某台主机定义变量，也可以对整个分组定义变量 组变量和主机变量的生效优先级为：如果针对主机定义了变量（无论是否定义了组变量），主机变量生效；如果未定义主机变量，仅定义了组变量，组变量生效。

vim /etc/ansible/hosts

#组变量
[srvs:vars]
webport=80

#主机变量
[srvs]
172.16.253.184 webport=10080 hostname=node1
172.16.254.89  webport=10180 hostname=node2
172.16.253.47  webport=10280 hostname=node3
172.16.253.30  webport=10380 hostname=node4

调用变量

调用变量的两种方式的生效优先级：在命令行下直接定义的变量优先级高于在hosts文件中定义的变量（主机变量或分组变量）

1. 可以在命令行模式直接使用”ansible-playbook test.yml -e “webport=2000”
2. 调用在hosts文件中定义好的变量

引用变量注意：使用双大括号 “{{ VAR-NAME }}” ，且括号前后要有空格

eg. 修改主机名

ansible srvs -m hostname -a 'name=“name-{{ hostname }}-port-{{ webport }}"'
ansible srvs -m command -a 'hostname'
#执行结果
172.16.253.30 | SUCCESS | rc=0 >>
name-node4-port-10380

172.16.253.184 | SUCCESS | rc=0 >>
name-node1-port-10080

172.16.253.47 | SUCCESS | rc=0 >>
name-node3-port-10280

172.16.254.89 | SUCCESS | rc=0 >>
name-node2-port-10180

ansible-playbook 之强大的 template

jianja2语法格式：

支持算术运算：+ ， - ， * ， / ， **
支持比较操作符：== ， >= , != , <= , > , <
支持逻辑运算符： and ， or ， not
支持流表达式：for ， if ， while

使用template在配置文件中调用变量

设置template配置文件

#设置jianja2文件
cp /root/ansible/httpd.conf /root/ansible/httpd.conf.j2
vim /root/ansible/httpd.conf.j2
#修改Listen一项的值为 "{{ webport }}"
Liten {{ webport }}

#重新设置yml文件
cp /root/ansible/httpd-manager.yml /root/ansible/httpd-manager-j2.yml
vim /root/ansible/httpd-manager-j2.yml
#修改config配置块中的copy指令为template指令，其他部分不变，示例如下：

  - name: config httpd
    tags: config
    template: src=/root/ansible/httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf
    when: ansible_distribution_major_version == "7"
    notify: restart httpd

执行playbook

ansible-playbook /root/ansible/httpd-manager-j2.yml --tags=config
#执行结果：对分组中不同的主机采用不同的端口
ansible srvs -m shell -a 'ss -tnlp | grep httpd'

template还支持算术运算

将所有端口加1

vim /root/ansible/httpd.conf.j2
#修改以下内容
Listen {{ webport+1 }}

通过template在配置文件中使用for循环和if语句

定义基于不同域名的多个虚拟主机

#查找主机名变量
ansible srvs -m setup | grep hostname

#修改httpd.conf.j2文件
Listen {{ webport }}

<VirtualHost *.{{ webport }}>
        ServerName {{ ansible_hostname }}.achudk.com
        DocumentRoot /var/www/html
        <Directory "/var/www">
                Require all granted
        </Directory>
</VirtualHost>

#验证结果
ansible-playbook /root/ansible/httpd-manager-j2.yml --tags=config
curl curl 172.16.254.89:10180

使用for循环生成多个基于不同域名且不同端口的虚拟主机，并使用if判断条件

#修改httpd.conf.j2文件
vim httpd.conf.j2
{% for vport in vports %}
        <VirtualHost *.{{ vport }}>
                ServerName {{ ansible_hostname }}.achudk.com
                DocumentRoot /var/www/html
                <Directory "/var/www">
                        Require all granted
                </Directory>
                {% if errorlog is not defined %}
                ErrorLog "{{ errorlog | default('/web/httpd/log/vh1/error_log') }}"
                {% endif %}
        </VirtualHost>
{% endfor %}


#修改httpd-manager-j2.yml文件,在起始处增加vars指令，余下内容不变，如下：
vim httpd-manager-j2.yml
#正文如下
---

- hosts: srvs
  remote_user: root
  vars:
  - vport:
    - 80
    - 443
    - 8080
  - errorlog:
    - "/web/httpd/log/vh1/error_log"

#验证结果
ansible-playbook /root/ansible/httpd-manager-j2.yml --tags=config

when条件判断

#当系统为CentOS7时，才启用该配置片段
  - name: config httpd
    tags: config
    template: src=/root/ansible/httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf
    when: ansible_distribution == "CentOS"
    when: ansible_distribution_major_version == "7"
    notify: restart httpd

when指令的多条件联合判断 多个条件之间使用 “and” 连接

tasks:

• name: show hosts information tags: info debug: msg={{ ansible_distribution }},msg={{ ansible_distribution_major_v ersion }} when: ansible_distribution == "CentOS" and ansible_distribution_major_ver sion == "6"

最终实例

将所学内容综合起来使用，形成具有管理功能的yml文件

---

- hosts: myself
  remote_user: root
  vars:
  - vports:
    - 80
    - 443
    - 8080
  - errorlog:
    - "/web/httpd/log/vh1/error_log"

  tasks: 
  - name: show hosts information
    tags: info
    debug: msg="{{ ansible_distribution }}-{{ ansible_distribution_major_version }}-{{ ansible_distribution_release }}"


  - name: install httpd
    tags: install
    yum: name=httpd state=latest


  - name: start httpd.service
    tags: start
    service: name=httpd state=started

  - name: start httpd.service
    tags: restart
    service: name=httpd state=restarted

  - name: stop httpd.service
    tags: stop
    service: name=httpd state=stopped

  - name: config httpd
    tags: config
    template: src=/root/ansible/httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf
    when: ansible_distribution == "CentOS" and ansible_distribution_major_ver
sion == "7"  
    notify: restart httpd

  handlers:
  - name: restart httpd
    service: name=httpd state=restarted