Ansible 自动化运维工具之inventory和常用模块介绍

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Ansible 自动化运维工具之inventory和常用模块介绍相关的知识,希望对你有一定的参考价值。

一、inventory介绍

前面我们介绍过ansible的hosts文件是存放被管理主机的,被管理主机比较少的情况下,直接在hosts中定义即可,但是以后很定会管理多台主机,而ansible可管理的主机集合就叫做inventory。在ansible中,描述你主机的默认方法是将它们列在一个文本文件中,这个文件叫inventory文件。

一个简单的inventory文件可能只包含一组主机名的列表,如下:

ftp.testansible.com
samba.testansible.com
mail.testansible.com

1、inventory的行为参数

有时候我们需要在ansible inventory文件中描述我们的主机,我们需要定义主机名,以及ansible的ssh客户端可以连接到的端口(22,2222,22300)等,那么ansible将这些变量命名为inventory的行为参数,如下:

名称                           默认值                                描述
ansible_ssh_host               主机的名字                            SSH目的主机名或IP
ansible_ssh_port               22                                    SSH目的端口
ansible_ssh_user               root                                  SSH登录使用的用户名
ansible_ssh_pass               none                                  SSH认证所使用的密码
ansible_connection             smart                                 ansible使用何种连接模式连接到主机
ansible_ssh_private_key_file   none                                  SSH认证所使用的私钥
ansible_shell_type             sh                                    命令所使用的shell
ansible_python_interpreter     /usr/bin/python                       主机上的python解释器

ansible默认的inventory文件是/etc/ansible/hosts

可以自定义动态的inventory文件,(--inventory-file等同于-i path)如下

#ansible --inventory-file=/root/iptables/iptableshosts iptables -m script -a ‘/root/iptables/check_iptables.sh‘

如果有多台服务器的话,想并发运行,可以使用-f参数,默认是并发5

#ansible --inventory-file=/root/iptables/iptableshosts iptables -f 6 -m script -a ‘/root/iptables/check_iptables.sh‘

2、主机和主机组定义方式:

直接定义一台或者2台server

#vim /etc/ansible/hosts 
192.168.100.10          
192.168.100.11

定义一个组,可以是ip也可以是解析好的域名

[web]
192.168.100.10
192.168.100.11
[httpd]
192.168.100.12
192.168.100.13

嵌套定义组

[apache]
http1.test.com
http2.test.com
[nginx]
nginx1.test.com
nginx2.test.com
[webservers:children]
apache
nginx

3、主机变量和组变量

主机变量:针对单主机的特性化要求,通过内置变量实现,如下:

[webservers]
web1.test.com http_port=80 ansible_ssh_port=12345

群组变量

语法:[<group name>:vars] 在inventory中指定群组变量,如下:

[all:vars]
ntp_server=ntp.centos.com

[production]
test1
test2
test3
[production:vars]
db_primary_port=22

[groupservers]
web1.test.com
web2.test.com
[groupservers:vars]
ntp_server=ntp.test.com
admin_user=tom

4、嵌套组和组变量

[apache]
http1.test.com
http2.test.com

[nginx]
nginx1.test.com
nginx2.test.com

[webservers:children]
apache
nginx

[webservers:vars]
ntp_server=ntp.test.com

5、变量分离

变量除了可以和inventory一起存储在INI配置文件中,也可以独立出来。

当我们要为非常多的主机和主机组分别设置不同的变量时,用如上的方式就显得比较笨拙了,就需要用到group_vars和host_vars 变量了。Ansible在运行任何yml文件之前,都会去搜索与Hosts文件同一个目录下的两个用于定义变量的目录group_vars和host_vars,所以,我们可以在这两个目录下放一些使用YAML语法编辑的定义变量的文件,并以对应的主机名和主机组名来命名这些文件,这样在运行ansible时

ansible会自动去这两个目录下读取针对不同主机和主机组的变量定义

比如对主机组group设置变量:

File: /etc/ansible/group_vars/group
admin_user: tom

对主机host1设置变量

File: /etc/ansible/host_vars/host1
admin_user: john

除此之外,我们还可以在group_vars和host_vars两个文件夹下定义all文件来一次性地为所有的主机组和主机定义变量。如何巧妙使用主机变量和组变量有些时候,我们在运行ansible任务时,可能需要从一台远程主机上面获取另一台远程主机的变量信息,这时一个神奇的变量hostvars可以帮我们实现这一个需求。变量hostvars包含了指定主机上面所定义的所有变量。

比如我们想获取host1上面的变量admin_user的内容,在任意主机上直接使用如下代码即可:

{{ hostvars[‘host1‘][‘admin_user‘] }}

Ansible提供了一些非常有用的内置变量,这里我们列举几个常用的:

a、groups: 包含了所有Hosts文件里面主机组的一个列表

b、group_names: 包含了当前主机所在的所有主机组名的一个列表

c、inventory_hostname: 通过Hosts文件定义主机的主机名和ansible_home不一定相同

d、play_hosts: 将会执行当前任务的所有主机

6、yml文件中使用变量的一个例子:

---
- hosts: all
  user: root
  vars:
    GETURL:"http://192.168.24.14/sa"
    TARFILE:"sa"
    TMPPATCH:"/tmp"
    SHFILE:"os.sh" 
  tasks:
    - name: Download {{TARFILE}}.tar.gz package
      get_url: url="{{GETURL}}/{{TARFILE}}.tar.gz" dest={{TMPPATCH}} sha256sum=b6f482b3c26422299f06524086d1f087e1d93f2748be18542945bca4c2df1569
      tags:
        -downsa 
    - name: tarzxvf {{TARFILE}}.tar.gz file
      shell: tar zxvf "{{TMPPATCH}}/{{TARFILE}}.tar.gz" -C {{TMPPATCH}}
      tags:
        -tarxsa
    - name: Run{{SHFILE}} script
      shell: "{{TMPPATCH}}/{{TARFILE}}/{{SHFILE}}"
      tags:
        -runsa

二、ansible常用模块介绍:

ansible的每个模块用法可以使用#ansible-doc MOD 来查看,如下范例:

#ansible-doc copy
less 436
Copyright (C) 1984-2009 Mark Nudelman
less comes with NO WARRANTY, to the extent permitted by law.
For information about the terms of redistribution,
see the file named README in the less distribution.
Homepage: http://www.greenwoodsoftware.com/less
> COPY

  The [copy] module copies a file on the local box to remote locations. Use the [fetch] module to copy files from remote locations to the local box. If you need
  variable interpolation in copied files, use the [template] module.

Options (= is mandatory):

- backup
……………………还有很多可以显示,此处省略

查看所支持的模块,可以使用ansible-doc -l 查看,如下:

#ansible-doc -l
less 436
Copyright (C) 1984-2009 Mark Nudelman

less comes with NO WARRANTY, to the extent permitted by law.
For information about the terms of redistribution,
see the file named README in the less distribution.
Homepage: http://www.greenwoodsoftware.com/less
a10_server                    Manage A10 Networks AX/SoftAX/Thunder/vThunder devices                                                                                                                       
a10_service_group             Manage A10 Networks AX/SoftAX/Thunder/vThunder devices                                                                                                                       
a10_virtual_server            Manage A10 Networks AX/SoftAX/Thunder/vThunder devices                                                                                                                       
acl                           Sets and retrieves file ACL information.                                                                                                                                     
add_host                      add a host (and alternatively a group) to the ansible-playbook in-memory inventory                                                                                           
airbrake_deployment           Notify airbrake about app deployments                                                                                                                                        
alternatives                  Manages alternative programs for common commands                                                                                                                             
apache2_module                enables/disables a module of the Apache2 webserver                                                                                                                           
apt                           Manages apt-packages     
……………………还有很多模块可以显示,这里省略

1、远程命令模块

command、script 、shell 

Examples:

# Example from Ansible Playbooks

- script: /some/local/script.sh --some-arguments 1234

例如:

#ansible host1 -m command -a "free -m"   #可以简写为ansible host1 -a "free -m"
#ansible host1 -m script -a "/home/test.sh 12 34"
#ansible host1 -m shell -a "/home/test.sh"

比如在服务端执行:

#ansible web -m shell -a "/root/test.sh 3 4 "
10.0.90.25 | success | rc=0 >>
7
20151119-171933
10.0.90.24 | success | rc=0 >>
7
20151119-171933
注:test.sh 在客户端服务器/root目录,内容是前两个位置变量相加,并打印出当前时间。

一个简单的创建目录的例子,创建/usr/local/src/data/log 目录,如下:

#cat test1.sh 
#!/bin/bash
if [ -z $1 ] || [ -z $2 ];then
   echo "Wrong,Please input two args"
   echo "Usage `basename $0` arguments arguments"
   exit 6
fi
mkdir -pv /usr/local/src/$1/$2
#cat createdir.yml 
---
- hosts: "{{ host }}"
  user: "{{ user }}"
  gather_facts: True
  tasks:
    - name: Create Dir in client server
      script: /etc/ansible/test1.sh data log
执行:
#ansible-playbook createdir.yml -e "host=web user=root"

ansible-playbook可以跟很多参数,可以使用--help查看

#ansible-playbook --help
Usage: ansible-playbook playbook.yml

Options:
  --ask-become-pass     ask for privilege escalation password
  -k, --ask-pass        ask for connection password
  --ask-su-pass         ask for su password (deprecated, use become)
  -K, --ask-sudo-pass   ask for sudo password (deprecated, use become)
  --ask-vault-pass      ask for vault password
  -b, --become          run operations with become (nopasswd implied)
  --become-method=BECOME_METHOD
                        privilege escalation method to use (default=sudo),
                        valid choices: [ sudo | su | pbrun | pfexec | runas |
                        doas ]
 ……………………    还有很多,此处省略。
 这里介绍一些常用的
--inventory=PATH (-i PATH):  指定inventory文件,默认文件是/etc/ansible/hosts
--verbose(-v):               显示详细输出,也可以使用-vvvv显示精确到每分钟的输出
--extra-vars=VARS(-e VARS):  定义在playbook使用的变量,格式为:"key=value,key=value"
--forks=NUM ( -f NUM):       指定并发执行的任务数,默认为5,根据服务器性能,调大这个值可提高ansible执行效率
--connection=TYPE ( -c TYPE):指定连接远程主机的方式,默认为ssh,设为local时,刚只在本地执行playbook,建议不做修改
--check:                     检测模式,playbook中定义的所有任务将在每台远程主机上进行检测,但并不直正执行

2、copy模快

实现服务端向目标主机拷贝文件,类似于scp功能:-m copy   -a "command"

例如:

#ansible host1 -m copy -a "src=/root/php-5.5.24-1.ele.el6.x86_64.rpm dest=/usr/local/src owner=root group=root mode=0755"
查看客户端文件是否存在
#ansible host1 -m shell -a "ls -l /usr/local/src"
172.16.29.193 | success | rc=0 >>
total 10264
-rw-r--r--. 1 root root 10507544 May 30 02:40 php-5.5.24-1.ele.el6.x86_64.rpm

3、stat模块:

获取远程文件状态信息,包括atime,ctime,mtime,md5,uid,gid等信息

# ansible 10.0.90.25 -m stat -a "path=/etc/sysctl.conf"
10.0.90.25 | SUCCESS => {
    "changed": false, 
    "stat": {
        "atime": 1459270210.5650001, 
        "checksum": "a27c7ce2e6002c37f3cb537ad997c6da7fd76480", 
        "ctime": 1441217442.5749998, 
        "dev": 2051, 
        "exists": true, 
        "gid": 0, 
        "gr_name": "root", 
        "inode": 1181554, 
        "isblk": false, 
        "ischr": false, 
        "isdir": false, 
        "isfifo": false, 
        "isgid": false, 
        "islnk": false, 
        "isreg": true, 
        "issock": false, 
        "isuid": false, 
        "md5": "c97839af771c8447b9fc23090b4e8d0f", 
        "mode": "0644", 
        "mtime": 1413471211.0, 
        "nlink": 1, 
        "path": "/etc/sysctl.conf", 
        "pw_name": "root", 
        "rgrp": true, 
        "roth": true, 
        "rusr": true, 
        "size": 1150, 
        "uid": 0, 
        "wgrp": false, 
        "woth": false, 
        "wusr": true, 
        "xgrp": false, 
        "xoth": false, 
        "xusr": false
    }
}

#ansible web -m setup   ##显示所有的ansible默认变量信息

4、get_url 模块

实现在远程主机下载指定URL到本地,支持sha256sum文件校验

例如:

#ansible host1 -m get_url -a "url=http://www.baidu.com dest=/tmp/index.html mode=0440 force=yes"
172.16.29.193 | success >> {
    "changed": true,
    "checksum": "8bc43056c39fbb882cf5d7b0391d70b6e84096c6",
    "dest": "/tmp/index.html",
    "gid": 0,
    "group": "root",
    "md5sum": "324aa881293b385d2c0b355cf752cff9",
    "mode": "0440",
    "msg": "OK (unknown bytes)",
    "owner": "root",
    "secontext": "unconfined_u:object_r:user_tmp_t:s0",
    "sha256sum": "",
    "size": 93299,
    "src": "/tmp/tmp3WI5fE",
    "state": "file",
    "uid": 0,
    "url": "http://www.baidu.com"
}

5、yum 模块

linux 平台软件包管理操作,常见的有yum,apt

例如:

#ansible host1 -m yum -a "name=vsftpd state=latest"     
Ubuntu系列:
#ansible host1 -m apt -a "pkg=vsftpd state=latest"
yum 模块的一些用法:
- name: install the latest version of Apache
  yum: name=httpd state=latest
- name: remove the Apache package
  yum: name=httpd state=absent
- name: install the latest version of Apache from the testing repo
  yum: name=httpd enablerepo=testing state=present
- name: install one specific version of Apache
  yum: name=httpd-2.2.29-1.4.amzn1 state=present
- name: upgrade all packages
  yum: name=* state=latest
- name: install the nginx rpm from a remote repo
  yum: name=http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm state=present
- name: install nginx rpm from a local file
  yum: name=/usr/local/src/nginx-release-centos-6-0.el6.ngx.noarch.rpm state=present
- name: install the ‘Development tools‘ package group
  yum: name="@Development tools" state=present
- name: install the ‘Gnome desktop‘ environment group
  yum: name="@^gnome-desktop-environment" state=present

6、cron 模块

远程主机crontab 配置,如下:

#ansible host1 -m cron -a "name=‘crontab test‘ minute=0 hour=5,2 job=‘ls -alh > /dev/null‘"
172.16.29.193 | success >> {
    "changed": true,
    "jobs": [
        "crontab test"
    ]
}
效果如下:
#Ansible: crontab test
0 5,2 * * * ls -alh > /dev/null

一个简单的yml例子添加cron:

#cat add_cron.yml
---
-  hosts: web_crontab
   remote_user: root
   gather_facts: True
   tasks:
   - name: add ntp server cron job
     cron: name="local network ntpserver" minute="*/12" hour="*" job="/usr/sbin/ntpdate 10.0.18.1 > /root/ntp.log"
执行:
#ansible-playbook add_cron.yml

移除一个cron任务:

#cat del_cron.yml 
---
- hosts: web
  remote_user: root
  gather_facts: false
  tasks:
   - name: del an old crontab job
     cron: name="local network ntpserver" state=absent
执行:
#ansible-playbook del_cron.yml

小案例: 假如有一个db备份脚本,需要推到所有db服务器上,并加入crontab,每隔1分钟执行一次,需要定义playbook结构的yml文件

#tree cronjob/
cronjob/
└── tasks
    ├── crontest.yml
    └── main.yml
yml文件如下:
#cat test-cron.yml
---
- name: cron jobs test
  hosts: "{{ host }}"
  remote_user: "{{ user }}"
  gather_facts: True
  roles:
    - cronjob
tasks目录中的crontest.yml 
#cat crontest.yml
#copy cron job to client server
 - copy: src=/tmp/test_time.sh dest=/usr/local/src/test_time.sh owner=root group=root mode=0755
#add cron job
 - cron: name="test time jobs" minute="*/1" hour="*" job="/usr/local/src/test_time.sh >> /tmp/time.log"
tasks目录中的main.yml
#cat main.yml
 - include: crontest.yml 
执行:
ansible-playbook test-cron.yml --extra-vars "host=172.16.29.193 user=root"   --单台执行
客户端crontab效果如下:
#Ansible: test time jobs
*/1 * * * * /usr/local/src/test_time.sh >> /tmp/time.log

以上有点复杂,整合进一个简单的yml文件:

#cat test-cron.yml
---
- hosts: host1
  remote_user: root
  gather_facts: True
  tasks:
   - name: copy cron job file to client server
     copy: src=/tmp/test_time.sh dest=/usr/local/src/test_time.sh owner=root group=root mode=0755
   - name: add cron job
     cron: name="test time jobs" minute="*/2" hour="*" job="/usr/local/src/test_time.sh >> /tmp/time.log"    
执行:
#ansible-playbook test-cron.yml
效果:
#Ansible: test time jobs
*/2 * * * * /usr/local/src/test_time.sh >> /tmp/time.log

启用10个并行进程数执行playbook:

#ansible-playbook host1  nginx.yml -f 10

7、file模块

##设置文件的属性,一个很常用的模块

相关选项如下:

force:需要在两种情况下强制创建软链接,一种是源文件不存在,但之后会建立的情况下;另一种是目标软链接已存在,需要先取消之前的软链,然后创建新的软链,有两个选项:yes|no
group:定义文件/目录的属组
mode: 定义文件/目录的权限
owner:定义文件/目录的属主
path: 必选项,定义文件/目录的路径
recurse:递归设置文件的属性,只对目录有效
src:被链接的源文件路径,只应用于state=link的情况
dest:被链接到的路径,只应用于state=link的情况
state:
    directory:如果目录不存在,就创建目录
    file:即使文件不存在,也不会被创建
    link:创建软链接
    hard:创建硬链接
    touch:如果文件不存在,则会创建一个新的文件,如果文件或目录已存在,则更新其最后修改时间
    absent:删除目录、文件或者取消链接文件

比如:

- file: src=/tmp/test1 dest=/home/test2 state=link
- file: path=/root/test.txt state=touch
- file: path=/root/tomcat state=directory owner=root group=root mode=0755

8、mount 模块:远程主机分区挂载

#ansible host1 -m mount -a "name=/mnt/data src=/dev/sd0 fstype=ext3 opts=ro state=present"

9、service 模块:远程主机系统服务管理

#ansible host1 -m service -a "name=httpd stete=restarted"

10、sysctl 模块:远程linux主机sysctl配置

sysctl: name=kernel.panic value=3 sysctl_file=/etc/sysctl.conf checks=before reload=yes
以下是定义在yml格式文件中的例子:
- sysctl: name=net.ipv4.tcp_rmem ‘value=4096        87380   16777216‘ state=present
- sysctl: name=net.ipv4.tcp_wmem ‘value=4096        65536   16777216‘ state=present
- sysctl: name=net.ipv6.conf.lo.disable_ipv6 value=1 state=present

不足之处,请多多之处!

本文出自 “知识体系” 博客,请务必保留此出处http://linuxg.blog.51cto.com/4410110/1775135

以上是关于Ansible 自动化运维工具之inventory和常用模块介绍的主要内容,如果未能解决你的问题,请参考以下文章

Ansible自动化运维之配置清单Inventory

Ansible 自动化运维工具

自动化运维工具Ansible

Ansible自动化运维工具Ansible的变量定义和引用

Ansible自动化运维工具Ansible的基本配置详解

ansible 自动化运维工具 10 (习题测试)