ansible（一）

概述

ansible是一款无需在被管理主机上安装客户端，基于SSH对多台目标主机进行同时操作的轻量级的管理软件，借助各个内部的功能模块，实现了批量系统配置、批量程序部署、批量运行命令等功能。本篇就介绍一些关于ansible的基础配置相关的内容，具体包括：

    1、ansible的简介

    2、ansible的基础应用

    3、ansible常用模块介绍

    4、ansible的playbook基础应用介绍

    5、playbook中的handlers(触发器)的介绍

    6、playbook中的tags(标签)的介绍

    7、playbook中的variables(变量)的介绍

    8、playbook中的templates(模板)的介绍

    9、playbook中的条件判断机制的介绍

    10、playbook中的循环(迭代)机制的介绍

    11、ansible的roles(角色)功能的介绍

    12、ansible实战一：利用ansible配置主备模型的keepalived+nginx

    13、ansible实战二：实战一的基础上在nginx后端提供httpd+php+php-mysql

    14、ansible实战三：在此前实验基础上配置mysql服务

第一章 ansible的简介

1、ansible的软件结构

blob.png

        Host Inventory：主机清单，也就是被管理的主机列表

        Playbooks：ansible的剧本，可想象为将多个任务放置在一起，一块执行

        Core Modules：ansible的核心模块

        Custom Modules：自定义模块

        Connection Plugins：连接插件，用于与被管控主机之间基于SSH建立连接关系

        Plugins：其他插件，包括记录日志等

2、ansible的特性

        <1>模块化：调用特定的模块，完成特定任务

        <2>基于python语言实现，由Paramiko(完成基于ssh的连接)，PyYAML(对YAML文件的支持)，
'jinja2(python的模板库)三个关键的模块

        <3>部署简单：是没有客户端的

        <4>支持自定义模块，使用任意编程语言

        <5>支持强大的playbook

        <6>具有幂等性：一个操作在一个主机上执行一遍和执行N遍的结果是一样的

第二章 ansible的基础应用

1、ansible管理端的安装

在EPEL源中，有包含ansible的软件包安装只需要配置好EPEL的yum源，yum安装即可

blob.png

安装生成的文件

blob.png

2、ansible被管控主机的定义

 对希望被管控的主机的定义需要实现在ansible管理端的针对被管理主机的配置文件(/etc/ansible/

hosts)中进行定义

blob.png blob.png

3、配置管理节点可以基于ssh秘钥登录被管理节点

blob.png blob.png

4、ansible命令的用法介绍

 ansible HOST-PATTERN [-f FORKS] [-m MOD_NAME] [-a MOD_ARGS]

     HOST_PATTERN：指明对哪些被管控主机进行操作

      -f FORKS：表示一批处理几台主机，也就是当被管控主机很多时，ansible不是对所有主机同时发起
管理操作，而是一批处理几台，然后再换一批，直到所有主机被处理完成，如果不指定，则默认是5台

     -m MOD_NAME：指明调用哪个模块执行操作，各个模块所能实现的功能不同，如果不指定，默认是用-m command模块

     -a MOD_ARGS：指明使用该模块的执行操作时的参数

blob.png

第三章 ansible常用模块介绍

1、获取常用模块的列表和对应模块的使用帮助信息

    可用ansible-doc -l  来查看所有可用的模块列表

    可用ansible-doc -s MOD_NAME  来查看对应模块的帮助信息

blob.png

2、command模块

        在远程主机执行命令,不支持管道，重定向等shell的特性

        常用参数有：

        chdir=   表示指明命令在远程主机上哪个目录下运行，也就是在命令执行前切换到哪个目录下

        creates=   在命令运行时创建一个文件，如果文件已存在，则不会执行创建任务

        removes=   在命令运行时移除一个文件，如果文件不存在，则不会执行移除任务

        executeble=   指明运行命令的shell程序

blob.png blob.png

3、shell模块

        在远程主机执行命令，相当于调用远程主机的shell进程，然后在该shell下打开一个子shell运行命令

        支持shell特性，如管道，重定向等

        注意：command和shell模块的核心参数直接为命令本身，而其他模块的核心参数一般是"key=value"格式

        常见参数有：

chdir=   表示指明命令在远程主机上哪个目录下运行

 creates=   在命令运行时创建一个文件，如果文件已存在，则不会执行创建任务

 removes=  在命令运行时移除一个文件，如果文件不存在，则不会执行移除任务

executeble=   指明运行命令的shell程序

blob.png

4、copy模块

        拷贝ansible管理端的文件到远程主机的指定位置

        常见参数有：

        dest=   指明拷贝文件的目标目录位置，使用绝对路径，如果源是目录，则目标也要是目录,如果目标
文件已存在，会覆盖原有内容

        src=   指明本地路径下的某个文件，可以使用相对路径和绝对路径，支持直接指定目录，如果源是
目录，则目标也要是目录

        mode=   指明复制时，目标文件的权限

        owner=   指明复制时，目标文件的属主

        group=   指明复制时，目标文件的属组

        content=  指明复制到目标主机上的内容，不能与src一起使用，相当于复制content指明的数据，到
目标文件中

blob.png blob.png blob.png blob.png

5、cron模块

        管理计划任务的模块

        常见参数有：

        minute=  指明计划任务的分钟，支持格式：0-59，*，*/2等，与正常cron任务定义的一样的语法,
省略时，默认为*，也就是每分钟都执行

        hour=  指明计划任务的小时，支持的语法：0-23，*，*/2等，省略时，默认为*，也就是每小时
都执行
        day=  指明计划任务的天，支持的语法：1-31，*，*/2等，省略时，默认为*，也就是每天都执行
       month=  指明计划任务的月，支持的语法为：1-12，*，*/2等，省略时，默认为*，也就是每月
都执行
        weekday=  指明计划任务的星期几，支持的语法为：0-6，*等，省略时，默认为*，也就是每星
期几都执行
        reboot  指明计划任务执行的时间为每次重启之后
        name=   给该计划任务取个名称,必须要给明。每个任务的名称不能一样。删除任务时，只需要
给明任务的名称即可
        job=  执行的任务是什么，当state=present时才有意义
        state=present|absent   表示这个任务是创建还是删除，present表示创建，absent表示删除，
默认是present

blob.png blob.png

6、fetch模块

    从远程主机拉取文件到本地

    一般情况下，只会从一个远程节点拉取数据

    常见参数有：

    dest=  从远程主机上拉取的文件存放在本地的位置，一般只能是目录

    src=   指明远程主机上要拉取的文件，只能是文件，不能是目录

blob.png

7、file模块

    用于设定远程主机上的文件属性

    常见参数有：

    path=   指明对哪个文件修改其属性

    src=   指明path=指明的文件是软链接文件，其对应的源文件是谁，必须要在state=link时才有用

    state=directory|link|absent   表示创建的文件是目录还是软链接

    owner=   指明文件的属主

    group=   指明文件的属组

    mode=   指明文件的权限

    创建软链接的用法：

        src=  path=  state=link

    修改文件属性的用法：

        path=  owner=  mode=  group=

    创建目录的用法：

        path=  state=directory

    删除文件：

        path= state=absent

blob.png blob.png blob.png blob.png image.png blob.png blob.png blob.png

8、hostname模块

    管理远程主机上的主机名

    常用参数有

    name=  指明主机名

blob.png

9、yum模块

        基于yum机制，对远程主机管理程序包

        常用参数有：

        name=   指明程序包的名称，可以带上版本号，不指明版本，就是默认最新版本。

        state=present|latest|absent   指明对程序包执行的操作，present表示安装程序包，latest表示安装
最新版本的程序包，absent表示卸载程序包

        disablerepo=    在用yum安装时，临时禁用某个仓库，仓库的ID

        enablerepo=    在用yum安装时，临时启用某个仓库,仓库的ID

        conf_file=   指明yum运行时采用哪个配置文件，而不是使用默认的配置文件

        diable_gpg_check=yes|no  是否启用gpg-check  

blob.png blob.png blob.png blob.png blob.png

10、service模块

    用来管理远程主机上的服务的模块

    常见参数有：

    name=   被管理的服务名称

    state=started|stopped|restarted   表示启动或关闭或重启

    enabled=yes|no  表示要不要设定该服务开机自启动

    runlevel=   如果设定了enabled开机自动启动，则要定义在哪些运行级别下自动启动

blob.png blob.png blob.png

11、uri模块

    如果远端是web服务器，可以利用ansible直接请求某个网页

    常见参数有：

    url=  指明请求的url的路径，如：http://10.1.32.68/test.jpg

    user=  如果请求的url需要认证，则认证的用户名是什么

    password=  如果请求的url需要认证，则认证的密码是什么

    method=  指明请求的方法，如GET、POST…

    body=   指明报文中实体部分的内容，一般是POST方法或PUT方法时用到

    HEADER_   自定义请求报文中的添加的首部

12、user模块

    管理远程主机上的用户的账号

    常见参数有：

    name=   指明要管理的账号名称

    state=present|absent   指明是创建账号还是删除账号，present表示创建，absent表示删除

    system=yes|no   指明是否为系统账号

    uid=   指明用户UID

    group=   指明用户的基本组

    groups=   指明用户的附加组

    shell=   指明默认的shell

    home=   指明用户的家目录

    move_home=yes|no   当home设定了家目录，如果要创建的家目录已存在，是否将已存在的家目录进行移动

    password=   指明用户的密码，最好使用加密好的字符串

    comment=   指明用户的注释信息

    remove=yes|no   当state=absent时，也就是删除用户时，是否要删除用户的而家目录

blob.png blob.png blob.png

13、group模块

    用来添加或删除远端主机的用户组

    常见参数有：

    name=   被管理的组名

    state=present|absent   是添加还是删除,不指名默认为添加

    gid=   指明GID

    system=yes|no   是否为系统组

blob.png blob.png

14、script模块

将管理端的某个脚本，移动到远端主机(不需要指明传递到远端主机的哪个路径下，系统会自动移动，然
后执行)，然后执行

一般是自动移动到远端主机的/root/.ansible/tmp目录下，然后自动给予其权限，然后再开个子shell然后
运行脚本，运行完成后删除脚本

blob.png blob.png blob.png

15、setup模块

可收集远程主机的facts变量的信息，相当于收集了目标主机的相关信息(如内核版本、操作系统信息、
cpu、…)，保存在ansible的内置变量中，之后我们有需要用到时，直接调用变量即可

blob.png

16、template模块的使用

    基于模板方式，生成一个模板文件，复制到远程主机，让远程主机基于模板，生成符合远程主机自身的文件

    注意：此模块不能在命令行使用，只能用在playbook中

    常见的参数有：

    src=  指明管理端本地的模板文件的目录

    dest=   指明将模板文件拷贝到远程主机的哪个目录下

    owner=  指明拷贝到远程主机的文件的属主

    group=  指明拷贝到远程主机的文件的属组

    mode=   指明拷贝到远程主机的文件的权限

12.png blob.png

第四章 ansible的playbook基础应用介绍

当需要执行的任务有多个时，需要一条一条编辑ansible命令，然后执行，而且当需要重复执行时，又
要重新编辑执行，这样效率不高，因此ansible就可以利用playbook来完成将任务写到一个YAML格式
的文件中，然后利用ansible-playbook进行调用该文件，从而实现了多条语句，可重复执行的效果，类
似shell脚本的效果，ansible的playbook要借助YAML文件来实现，YAML文件扩展名通常为.yaml或.yml

1、YAML文件的语法

YAML语法和其他高阶语言类似，并可以简单表达清单，散列表、标量等数据结构。其结构通过
空格来展示，序列里的项用“-”来代表，Map你的键值用“；”分隔

    YAML文件中列表的表示：列表中的所有元素均使用"-" 开头，例如：

        – apple

        – orange

        – mango

    YAML文件中字典的表示：字典通过key与value进行标识，如：

        name: nwc

        job: manager

        sex: M

        也可以将key:value放置于{}中进行表示，如

        {name: nwc,job: manager,sex: M}

2、playbook的核心元素

       Hosts：运行在哪些主机之上

       Users：远程主机上，运行此任务的身份，不指名默认为root

       Tasks：任务，也就是定义的具体任务，由模块定义的操作的列表

       Variables：变量

       Templates：模板，包含了模板语法编写的模板的文本文件

       Handlers：处理器，类似Tasks，只是在特定的条件下才会触发的任务

某任务的状态在运行后为changed时，可通过"notify"通知给相应的handlers进行触发执行

Roles：角色，将Hosts剥离出去，由Tasks、Variables、Templates、Handlers所组成的一种特定的结构的集合

3、playbook的基础组件

        hosts：运行指定任务的而目标主机，多个主机用:冒号分隔

        remote_user：在远程主机上执行任务的用户;可以全局指定，也可以单个任务指定

        sudo_user：表示以sudo方式运行任务时，切换为哪个用户身份运行

        tasks：

任务列表，ansible运行任务的方式为，将第一个任务在所有主机上运行完成，然后再将第二个任务在
所有主机上运行…，当某个任务在某个主机上运行出现故障，会造成任务终止，再次执行任务只需
直接执行即可

定义任务列表，实际就是指明使用的模块和对应的模块参数来完成的任务的列表，其格式有两种：

                (1)action:MODULE  ARGUMENTS

                (2)MODULE:ARGUMENTS

            注意：shell和command模块后面直接跟命令，而不是key=value的参数列表

image.png

4、playbook文件的执行

        playbook文件定义的任务要向执行，需要利用ansible-playbook命令进行调用

        ansible-playbook命令用法：

        <1> 检测语法

            ansible-playbook –syntax-check /PATH/TO/PLAYBOOK.yaml

        <2> 测试运行

            ansible-playbook -C|–check /PATH/TO/PLAYBOOK.yaml

            只检测执行指定的YAML文件可能会发生改变，但不真正执行操作，相当于测试运行

                –list-hosts  检测YAML文件可能影响到的主机列表

                –list-tasks   列出YAML文件的任务列表

                –list-tags    列出YAML文件中的标签

        <3> 运行

            ansible-playbook /PATH/TO/PLAYBOOK.yml

            可用选项：

            不加任何选项表示完整运行整个playbook文件

            -t TAGS,–tags=TAGS  表示只执行那个标签的任务

            –skip-tags=SKIP_TAGS  表示除了指明的标签的任务，其他任务都执行

            –start-at-task=START_AT   从指明的任务开始往下运行

        <4> 通常情况下剧本的执行过程

            先要利用 ansible-playbook -C|–check /PATH/TO/PLAYBOOK.yaml进行测试，测试没问题后

            再利用 ansible-playbook /PATH/TO/PLAYBOOK.yml正式执行

blob.png blob.png

第五章 playbook中的handlers(触发器)的介绍

1、handlers的作用

用于当关注资源发生变化时采取一定的操作，可理解为：当之前定义在tasks中的任务，如果执行成功
后，我们希望在此基础上触发某个别的任务，这时就需要定义handlers。

要想handlers生效，首先需要在tasks的任务中定义一个notify，表示执行成功后，通知执行哪个handler
，然后再定义handlers中，定义handler任务，handler任务的name要与notify中定义通知给哪个handler
的名称一致

2、handlers触发器的使用示例：

blob.png blob.png blob.png

第六章 playbook中的tags(标签)的介绍

1、tags标签的作用

当我们定义了一个playbook文件，文件有很多任务要执行，如果我们只是希望执行其中的某一个任务，
可以在编写该任务时，为该任务加上标签，然后利用ansible-playbook调用时，指明只执行那个tags标
签的任务(ansible-playbook -t TAG_NANE YAML文件)

 可以将多个任务提供一样的标签，这样，就可以实现指定运行某标签的任务时，同时运行多个任务；
也支持一个任务定义多个标签

可以在用ansible-playbook利用-t指明执行的标签的任务时，支持用逗号,隔开的多个标签，则也是
多个标签的任务都执行

2、tags标签的示例

blob.png
blob.png
blob.png
blob.png

第七章 playbook中的variables(变量)的介绍

在playbook中可在各个任意地方使用变量，引用变量的格式为：{{ VAR_NAME }}，变量名与大括号之间有空格

定义变量的方式分别为：

1、facts类型的变量：

    可直接调用，是ansible收集的关于被管理主机的相关信息，其被保存在ansible的一些变量中，如果

要查看某个被管理主机有哪些facts变量可用，则可以执行：

    ansible 10.1.32.72 -m setup

    可列出10.1.32.72主机上可用的所有的facts变量及其值

blob.png
blob.png
blob.png

2、ansible-playbook命令的命令行中的自定义变量：

    ansible-playbook -e VARS=VALUE

    如果要指定多个变量，则用多个-e引导即可

blob.png

3、在定义主机的hosts中(也就是/etc/ansible/hosts文件中)定义变量

    <1>实现向不同的主机传递不同的变量

        如：vim /etc/ansible/hosts

        [webserver]

        10.1.32.72 hname=web1 aaa=111 bbb=test

        10.1.32.73 hname=web2 aaa=222

        表示针对10.1.32.72这台主机，hname这个变量的值为8080，aaa变量的值为111，bbb变量的值为test

        针对10.1.32.73这台主机，hname这个变量的值为8090，aaa变量的值为222

blob.png
blob.png
blob.png

    <2>实现向某个组内的主机，传递相同的变量

        如：vim /etc/ansible/hosts

        [webserver:vars]

        http_port=8080

        表示向webserver组内的主机定义相同的变量http_port,其值都为8080

blob.png
blob.png
blob.png

<3>hosts文件中在每个主机后面可以用ansible_ssh_user和ansible_ssh_pass来指明ansible连接
该主机时，不是采用我们之前自己手动执行的利用ssh秘钥登录，而是直接将用户名密码写入到
/etc/ansible/hosts文件中，每次连接都是基于用户名密码的登录

            如：vim /etc/ansible/hosts

            [dbserver]

            10.1.32.68 ansible_ssh_user=root ansible_ssh_pass=123456

            10.1.32.73 

            注意，此类参数不能传递给playbook，也就是无法进行调用，只是用来ansible连接远程主机时的定义

            除了上面的两个参数，还有：

                ansible_ssh_host  连接的远程主机

                ansible_ssh_port  连接的远程主机的端口

                ansible_sudo_pass   以sudo方式运行任务时的sudo用户的密码

4、在playbook的yaml文件中定义变量

    如:有个YAML文件为/root/test.yaml，内容为

    – hosts: webserver

      remote_user: root

      vars:

      – pkname: httpd

      – yname: php

     tasks:

     – name: install packages

       yum: name={{ pkname }} state=present

     – name: install packages2

       yum: name={{ yname }} state=present

blob.png blob.png

第八章 playbook中的templates(模板)的介绍

1、templates模板文件的说明

 templates是模板文本文件，但是此文本文件内部嵌套有脚本(脚本是使用模板编程语言编写)，主要用来
提供文件模板，让被管理主机根据模板中定义的脚本，生成符合远程主机环境的文件，也就是相当于提
供一个模板文件，拷贝到被管理主机上，被管理主机根据自身的情况，生成符合自身实际的文件，模
板文件中的语法，是语句模板编程语言所定义的，在ansible中，是jinja2的语法格式(因为ansible是
python语言开发，而python嵌入文本中的语言是jinja2)

2、jinja2常用的语法

    数据类型(字面量)：

        字符串：使用单引号或双引号引用起来的都被认为是字符串

        数字：整数、浮点数，不能用引号

        列表：[item1,item2,…]

        元组：(item1,item2,…)

        字典：{key1:value1,key2:value2,…}

            字典的key一般是字符串，所以要用引号引起来

        布尔型：true/false

    算数运算：

        +、-、*、/、//(除完以后只保留商)、%(取模，除完以后只留余数)、**(次方)

    比较操作：

        ==、!=、>、>=、<、<=

    逻辑运算：

        and、or、not

    变量引用：与YAML语法一样

        {{ VAR_NAME }}

    迭代(循环)、条件判断

3、template模块

当模板文件生成后，就可以借助template模块，将模板文件拷贝到被管控主机上，生成符合远端主
机环境的文件，注意不能用copy模块进行拷贝，因为copy模块拷贝时，模板文件中定义的一些jinja2
的语法结构会被当做纯文本信息进行拷贝，而用template模块进行拷贝时，则会识别jinja2的语
法，将对应的语法替换为符合远端主机的具体的值，生成符合远端主机环境的文件

        template模块的参数有：

            src=  指明管理端本地的模板文件的目录

            dest=   指明将模板文件拷贝到远程主机的哪个目录下

            owner=  指明拷贝到远程主机的文件的属主

            group=  指明拷贝到远程主机的文件的属组

            mode=   指明拷贝到远程主机的文件的权限

4、template模板使用配置示例

blob.png blob.png