分享交流
合作共赢!

Ansible安装及playbook的使用方法总结

一、Ansible简介

为什么引入playbook?我们完成一个任务,例如安装部署一个httpd服务,我们需要多个模块(一个模块也可以称之为task)提供功能来完成。而playbook就是组织多个task的容器,他的实质就是一个文件,有着特定的组织格式,它采用的语法格式是YAML(Yet Another Markup Language)。YAML语法能够简单的表示散列表,字典等数据结构。具体请参考YAML详细语法

YAML基本语法

列表:每一个列表成员前面都要有一个短横线和一个空格

fruits:
     - Apple
     - Orange
     - Strawberry
     - Mango

或者:
fruits: ['Apple', 'Orange', 'Strawberry', 'Mango']

字典:每一个成员由键值对组成,注意冒号后面要有空格

martin:
    name: Martin D'vloper
    job: Developer
    skill: Elite
或者
martin: {name: Martin D'vloper, job: Developer, skill: Elite}

列表和字典可以混合使用

-  martin:
    name: Martin D'vloper
    job: Developer
    skills:
      - python
      - perl
      - pascal
-  tabitha:
    name: Tabitha Bitumen
    job: Developer
    skills:
      - lisp
      - fortran
      - erlang

二、ansible的安装

1.yum安装:

RHEL(Centos)7版本:

rpm -Uvh http://mirrors.zju.edu.cn/epel/7/x86_64/e/epel-release-7-8.noarch.rpm
yum install ansible

建议先配置epel源,然后就可以通过YUM直接安装,参考琼杰笔记文档:Linux常用基础命令使用总结【九】——epel源和yum源配置

2.Apt(Ubuntu)安装方式:

apt-get install software-properties-common
apt-add-repository ppa:ansible/ansible
apt-get update
apt-get install ansible

3.homebrew (Mac OSX)安装方式

brew update
brew install Ansible

4.通过pip安装:

sodu easy_install pip
pip install ansible

如果是在OS X系统上安装,编译器可能会有警告或出错,需要设置CFLAGS、CPPFLAGS环境变量:

sudo CFLAGS=-Qunused-arguments CPPFLAGS=-Qunused-arguments pip install ansible

配置运行环境

Ansible环境

Ansible 配置文件是以.ini格式存储配置数据的,在Ansible中,几乎所有的配置项都可以通过Ansible的playbook或环境变量来重新赋值。在运行Ansible命令式,命令将会按照预先设定的顺序查找配置文件,如下所示:

1)ANSIBLE_CONFIG: 首先,Ansible命令会检查环境变量,及这个环境变量指向的配置文件。
2)./ansible.cfg: 其次,将会检查当前目录下的ansible.cfg配置文件
3)~/ansible.cfg: 再次,将会检查当前用户home目录下的.ansible.cfg配置文件

  1. /etc/ansible/ansible.cfg: 最后,将会检查再用软件包管理工具安装Ansible时自动产生的配置文件。

ansible.cfg常用配置参数

1.inventory 这个参数表示资源清单inventory文件的位置,资源清单就是被管理主机列表。如:inventory = /etc/ansible/hosts
2.forks 设置默认情况下Ansible最多能有多少个进程同时工作,默认设置最多5个进程并行处理。如: forks = 5
3.sudo_user 这是设置默认执行命令的用户,如: sudo_user = root
4.remote_port 这是制定连接被管节点的管理端口,默认是22。除非设置了特殊的SSH端口,不然这个参数一般是不需要修改的。如:reomte_ssh = 22
5.timeout 这是设置SSH连接的超时间隔,单位是秒。配置示例如下:timeout = 60

三. playbook基础组件

  • Hosts:运行执行任务(task)的目标主机
  • remote_user:在远程主机上执行任务的用户
  • tasks:任务列表
  • handlers:任务,与tasks不同的是只有在接受到通知时才会被触发
  • templates:使用模板语言的文本文件,使用jinja2语法。
  • variables:变量,变量替换{{ variable_name }}

整个playbook是以task为中心,表明要执行的任务。hosts和remote_user表明在哪些远程主机以何种身份执行。其他组件让其能够更加灵活。

下面详细介绍某些组件

1. variable

变量定义在资产(inventory)中:

主机变量:
192.168.200.136 http_port=808 maxRequestsPerChild=808
192.168.200.137 http_port=8080 maxRequestsPerChild=909

主机组变量:
[websers]
192.168.200.136
192.168.200.137

[websers:vars]  
ntp_server=ntp.exampl.com
proxy=proxy.exampl.com

变量定义在playbook中

- hosts: webservers
  vars:
    http_port: 80

使用facts变量:

facts变量是由setup模块获取远程主机的信息。
用法:
ansible 192.168.200.136 -m setup

在roles中定义变量

后面介绍

ansible-playbook 命令中传入参数

使用 -e选项传入参数

ansible-playbook 192.168.200.136 -e "httpd_port=808" httpd04.yml

变量的引用

{{ var_name }}

2. templates

它是一个模块功能,与copy不同的是他的文本文件采用了jinga2语法,

jinga2基本语法如下,

字面量:
  字符串:使用单引号或双引号
  数字:整型,浮点数
  列表:{item1,item2,...}
  字典:{key1:value1,key2:value2,...}
  布尔型:true/false
算术运算:
  +,-,*,/,//,%,**
比较运算:
  ==,!=,>,>=,<,<=
逻辑运算:
  and,or,not

注意:template只能在palybook中使用。

3. tasks

执行的模块命令

格式:
  action:模块参数(此种方式只在较新的版本中出现)
  module:参数(已键值对的形式出现)

每一个task都有一个名称,用于标记此任务。任务示例:
  name: install httpd
  yum: name=httpd state=present

注意:shell和command没有参数,可在后面直接跟命令
  shell: ss -tnl | grep :80

(1)某任务的运行状态为changed后,可通过相应的notify通知相应的handlers
(2)任务可以通过tags打标签,然后通过palybook命令-t选项调用.

四. playbook调用方式

用法:
ansible-playbook <filename.yml> ... [options]

  <filename.yml>:yaml格式的playbook文件路径,必须指明
  [options]: 选项
    -C, --check:并不在远程主机上执行,只是测试。
    -i PATH, --inventory=PATH:资产的文件路径
    --flush-cache:清楚fact缓存
    --list-hosts:列出匹配的远程主机,并不执行任何动作
    -t, TAGS, --tags=TAGS:运行指定的标签任务
    --skip-tags:跳过指定的notify,后面详细介绍。

五. palybook示例文件解析

1. 安装部署httpd服务-version1

资产文件

~] cat /etc/ansible/Hosts

[webservers]
192.168.200.136 httpd_port=808
192.168.200.137 httpd_port=8088
[test]
192.168.200.13[6:7]

httpd配置文件

~] grep ^Listen /etc/httpd/conf/httpd.conf

Listen 808

palybook文件

~] cat /root/httpd01.yml

- hosts: webservers
  remote_user: root
  tasks:
  - name: install httpd
    yum: name=httpd state=present
  - name: install configure file
    copy: src=httpd.conf dest=/etc/httpd/conf/
  - name: start httpd service
    service: name=httpd state=started

测试playbook

Ansible之playbook的使用

运行playbook

Ansible之playbook的使用

再次执行playbook

~]# yum install libselinux-python

Ansible之playbook的使用

从上图可以看出,192.168.200.136执行成功,而192.168.200.137启动服务时配置文件错误,这是因为拷贝过去的配置文件是centos7上的,而137这台主机是centos6,它安装的是httpd-2.2配置文件不兼容。此问题后面解决。

查看服务启动时的端口

Ansible之playbook的使用

2. 安装部署httpd服务-version2

copy命令拷贝配置文件时,无法对配置文件进行修改,不够灵活。接下来我们使用template拷贝文件,并使用主机变量设置httpd端口号

资产文件

~]# cat /etc/ansible/hosts

[webservers]
192.168.200.136  httpd_port=8088
[test]
192.168.200.13[6:7]

配置文件

~]# grep ^Listen httpd.conf.j2

Listen {{ httpd_port }}

palybook文件

~]# cat httpd02.yml

- hosts: 192.168.200.136
  remote_user: root
  tasks:
  - name: install httpd
    yum: name=httpd state=present
  - name: install configure file
    template: src=httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf
  - name: start httpd service
    service: name=httpd state=started

运行playbook

Ansible之playbook的使用

Ansible之playbook的使用

由图可以看出,playbook中只将文件拷贝过去了,并没有重启服务,所以我们可以看到端口监听的依然是808而不是8088。此时我们需要在配置文件修改时触发一个任务,这就是handlers的用法,重新修改playbook文件。

重新修改YAML文件

~]# cat httpd02.yml

- hosts: 192.168.200.136
  remote_user: root
  tasks:
  - name: install httpd
    yum: name=httpd state=present
  - name: install configure file
    notify: restart httpd service
    template: src=httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf
  - name: start httpd service
    service: name=httpd state=started
  handlers:
  - name: restart httpd servcie
    service: name=httpd state=restarted

notify表明此task改变时,它会触发一个事件,此事件会调用name为restart httpd service的handlers task。

再次运行playbook

Ansible之playbook的使用

可以看到,此playbook执行了两个任务,一个是拷贝文件,一个是重启服务。也可以看到此时监听的端口不在是808而是8088

我们修改配置文件并重启服务,这是一个非常常见的操作。由上面我们看到,尽管我们只需执行两个task但我们把所有的任务都执行一遍,这会降低效率,我们可以使用tags来指定执行那个任务。

3. 指定执行任务

资产文件

注意,修改了端口号

~] cat /etc/ansibele/hosts

[webservers]
192.168.200.136  httpd_port=8080   
[test]
192.168.200.13[6:7]

修改playbook文件

~]# cat httpd03.yml

- hosts: 192.168.200.136
  remote_user: root
  tasks:
  - name: install httpd
    yum: name=httpd state=present
  - name: install configure file
    notify: restart httpd service
    tags: reinstall configure file
    template: src=httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf
  - name: start httpd service
    service: name=httpd state=started
  handlers:
  - name: restart httpd service
    service: name=httpd state=restarted

执行playbook

由图可以看到,playbook只执行了拷贝文件,以及拷贝文件触发的重启服务事件。也可以看到服务开启的是8080端口。

六. ansible特性–判断和循环

在前面有一个问题没有解决就是centos6和centos7配置文件不兼容的问题,我们需要对其进行判断,不同的版本拷贝同的文件。

我们将lamp放在一台主机上时,我们需要安装多个程序包,写成一个一个的task显得效率不高,写的臃肿。我们可以使用循环来进行安装。

1 判断

以解决上面遗留的问题为例,如何让centos6的主机拷贝centos6的文件,让centos7的主机拷贝centos7的文件。
也可以使用变量来实现,此处不做演示

资产文件

~]# cat /etc/ansible/hosts

[webservers]
192.168.200.136  httpd_port=8088
192.168.200.137 httpd_port=8080
[test]
192.168.200.13[6:7]

playbook文件

Ansible之playbook的使用

其中的ansible_distribution_major_version是ansible收集的facts

测试playbook文件

Ansible之playbook的使用

跳过notify,让其不执行重启服务的操作,在执行playbook时使用 –skip-tags选项

值得注意的是,虽然没有执行重启,但拷贝配置文件也没有执行。

Ansible之playbook的使用

执行playbook

Ansible之playbook的使用

注意:他的语法格式类似jinja2。

2. 循环

playbook文件

Ansible之playbook的使用

执行playbook文件并查看

Ansible之playbook的使用

判断和循环的详细请点击这里

参考琼杰笔记相关文章:

Ansible文件操作的常用模块使用方法总结

赞(1) 打赏
未经允许不得转载:琼杰笔记 » Ansible安装及playbook的使用方法总结

评论 抢沙发

评论前必须登录!

 

分享交流,合作共赢!

联系我们加入QQ群

觉得文章有用就打赏一下文章作者

非常感谢你的打赏,我们将继续给力更多优质内容,让我们一起创建更加美好的网络世界!

支付宝扫一扫打赏

微信扫一扫打赏

登录

找回密码

注册