Ansible---Playbook基本案例

时间  2019-11-07
标签 ansible playbook 基本 案例 繁體版
原文   原文链接

PlayBook介绍

  • playbook是由一个或者多个play组成的列表，主要功能是将task定义好的角色归并为一组进行统一管理。
  • playbooks自己组成部分有以下几份：
一、tasks：任务，即调用模块完成的操做
二、variables：变量
三、templates：模板
四、handlers：处理器，当条件知足时执行操做，一般前面使用notify声明。
五、roles：角色，分门别类管理playbook的一种方式，后面将详细介绍roles的用法。

playbook--yaml文件格式内容

  • 编写yaml文件，注意不一样层级之间严格的格式要求。

vim /opt/test.yamlphp

- hosts: webserver              //定义的主机组，即应用的主机
  vars:                        //定义变量
    http_port: 80              //此处自定义变量中变量写在yaml文件，也可写在ansible/hosts文件中应用主机后
    max_clients: 200
  remote_user: root      //远程用户为root
  tasks:                               //执行的任务
  - name: ensure apache is at the latest version   //下面即将执行的步骤名称
    yum: pkg=httpd state=latest
  - name: write the apache config file   //下面即将执行的步骤名称
    template: src=/srv/httpd.j2 dest=/etc/httpd.conf    //模板文件，src为路径为控制端，dest为被控制端
    notify:          //声明须要执行的操做
    - restart apache  //操做名称
  - name: ensure apache is running
    service: name=httpd state=started
  handlers:                       //处理器，处理名称须要对应notify的名称，才能自动执行
    - name: restart apache
      service: name=httpd state=restarted

playbook基本命令格式

ansible-playbook test.yaml --syntax-check    #检查yaml文件的语法是否正确
ansible-playbook test.yaml --list-task       #检查tasks任务
ansible-playbook test.yaml --list-hosts      #检查生效的主机
ansible-playbook test.yaml --start-at-task='Copy Nginx.conf'     #指定从某个task开始运行

hosts和users介绍

---                             #表示该文件是YAML文件，非必须
- hosts: webserver               #指定主机组，能够是一个或多个组。
  remote_user: root                #指定远程主机执行的用户名

还能够为每一个任务定义远程执行用户：
---
- hosts: mysql
  remote_user: root             
  tasks:
    - name: test connection
      ping:
      remote_user: mysql          #指定远程主机执行tasks的运行用户为mysql
  • 执行playbook：

ansible-playbook ping.yaml mysql

  • 指定远程主机sudo切换用户：
---
- hosts: mysql
  remote_user: root            
  become: yes                  #2.6版本之后的参数，以前是sudo，意思为切换用户运行
  become_user: mysql          #指定sudo用户为mysql

tasks列表和action

  • 1.Play的主体部分是task列表，task列表中的各任务按次序逐个在hosts中指定的主机上执行，即在全部主机上完成第一个任务后再开始第二个任务。
    在运行playbook时（从上到下执行），若是一个host执行task失败，整个tasks都会回滚，请修正playbook 中的错误，而后从新执行便可。
    Task的目的是使用指定的参数执行模块，而在模块参数中可使用变量，模块执行时幂等的，这意味着屡次执行是安全的，由于其结果一致。
  • 2.每个task必须有一个名称name，这样在运行playbook时，从其输出的任务执行信息中能够很好的辨别出是属于哪个task的。若是没有定义name，‘action’的值将会用做输出信息中标记特定的task,也就是会报错。
  • 3.定义一个task，常见的格式:”module: options” 例如：yum: name=httpd
  • 4.ansible的自带模块中，command模块和shell模块无需使用key=value格式

Handslers介绍

  • Handlers也是一些task的列表，和通常的task并无什么区别。是由通知者进行的notify，若是没有被notify，则Handlers不会执行，假如被notify了，则Handlers被执行，无论有多少个通知者进行了notify，等到play中的全部task执行完成以后，handlers也只会被执行一次。web

  • 示例：
- hosts: webserver
  remote_user: root
  tasks:
   - name: install httpd package
     yum: name=httpd state=latest
   - name: install configuration file for httpd
     copy: src=/opt/httpd.conf dest=/etc/httpd/conf/httpd.conf
     notify:            //声明后面Handlers的名称
      -restart httpd    //注意该名称为notify的子集，须要靠空格隔开
   - name: start httpd service
     service: enabled=true name=httpd state=started
  handlers:
   - name: restart httpd
     service: name=httpd state=restarted

也能够引入变量
    ---
- hosts: webserver
  remote_user: root
  vars:               //引入变量
  - package: httpd    //变量名称
  - service: httpd
  tasks:
   - name: install httpd package
     yum: name={{package}} state=latest    //引入变量方式
   - name: install configuration file for httpd
     copy: src=/opt/httpd.conf dest=/etc/httpd/conf/httpd.conf
     notify:
      -restart httpd
   - name: start httpd service
     service: enabled=true name={{service}} state=started
  handlers:
   - name: restart httpd     //handlers执行的操做必须是notify中声明的操做名称，若此处执行的操做名称notify中没有声明，那么handlers不会执行
     service: name={{service}} state=restarted

  • 在引入变量过程当中，若针对一个组里不一样主机须要引入的变量值不相同时，好比IP地址等，则须要在hosts文件中，在不一样主机后面跟上变量名称与值，yaml文件中执行操做时引入变量名称便可。sql

  • 引用主机变量

vim /etc/ansible/hostsshell

[webserver]
192.168.144.110 httpd_port="192.168.144.110:80" server_name="www.yun01.com:80"
192.168.144.111 httpd_port="192.168.144.111:80" server_name="www.yun02.com:80"

Templates用法

  • Jinja是基于Python的模板引擎。template类是jinja的另外一个重要组件，能够看作是编译过的模板文件，用来生产目标文件，传递Python的变量给模板去替换模板中的标记。apache

  • 制做模板文件

cp /etc/httpd/conf/httpd.conf /opt/httpd.conf.j2 复制模板，注意文件格式为j2结尾
vim /opt/httpd.conf.j2vim

  • 引入变量至模板文件中，后面为自定义变量复制，涉及到不一样主机不一样变量值得须要在hosts文件中主机后设定，相同变量值可直接在yaml文件中设定。
Listen {{httpd_port}}          //为须要修改的部分设定变量
...

ServerName {{server_name}}
  • 在Apache配置文件中，如上修改部分为每台主机独立变量值，须要在hosts文件中指定。

vim /etc/ansible/hosts安全

[webserver]
192.168.144.110 httpd_port="192.168.144.110:80" server_name="www.yun01.com:80"
192.168.144.111 httpd_port="192.168.144.111:80" server_name="www.yun02.com:80"
  • 编写playbook执行yaml文件

vim /opt/httpd.yaml服务器

- hosts: webserver    //针对webserver组执行
  vars:
    package: httpd   //变量名称
    server: httpd
  tasks:
    - name: install httpd
      yum: name={{package}} state=latest
    - name: write the apache config file
      template: src=/opt/httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf      //注意模板文件位置
      notify:
        restart httpd
    - name: start httpd
      service: name={{server}} enabled=true state=started
  handlers:
    - name: restart httpd
      service: name={{server}} state=restarted

条件测试

  • 若是须要根据变量、facts（setup）或此前任务的执行结果来做为某task执行与否的前提时要用到条件测试，在Playbook中条件测试使用when子句。
  • 在task后添加when子句便可使用条件测试：when子句支持jinjia2表达式或语法，例如：
vi when.yml
---
- hosts: mysql
  remote_user: root
  tasks:
    - name: "shutdown CentOS"
      command: /sbin/shutdown -h now
      when: ansible_distribution == "CentOS"
  • 多条件判断
vi when.yml
---
- hosts: mysql
  remote_user: root
  tasks:
    - name: "shut down CentOS 7 systems"
      command: /sbin/shutdown -r now
      when:
        - ansible_distribution == "CentOS"
        - ansible_distribution_major_version == "7"
  • 组条件判断
vi when.yml
---
- hosts: mysql
  remote_user: root
  tasks:
    - name: "shut down CentOS 6 and Debian 7 systems"
      command: /sbin/shutdown -t now
      when: (ansible_distribution == "CentOS" and ansible_distribution_major_version == "6") or
            (ansible_distribution == "Debian" and ansible_distribution_major_version == "7")
  • 自定义变量进行条件测试
vi when.yml
---
- hosts: all
  vars:
    exist: "True"
  tasks:
  - name: creaet file
    command:  touch /tmp/test.txt
    when: exist | match("True")

  - name: delete file
    command:  rm -rf /tmp/test.txt
    when: exist | match("False")

迭代

  • 当有须要重复性执行的任务时，可使用迭代机制。其使用格式为将须要迭代的内容定义为item变量引用，并经过with_items语句指明迭代的元素列表便可。例如：
---
- hosts: webserver
  remote_user: root
  tasks:
    - name: "Install Packages"
      yum: name={{ item }} state=latest
      with_items:
        - httpd
        - mysql-server
        - php
  • 也能够本身定义
---
- hosts: webserver
  remote_user: root
  tasks:
    - name: "Add users"
      user: name={{ item.name }} state=present groups={{ item.groups }}
      with_items:
        - { name:'test1', groups:'wheel'}
        - { name:'test2', groups:'root'}

TAG模块

  • 在一个playbook中，咱们通常会定义不少个task，若是咱们只想执行其中的某一个task或多个task时就可使用tags标签功能了，格式以下：
vi hosts.yml
---
- hosts: webserver
  remote_user: root
  tasks:
    - name: Copy hosts file
      copy: src=/etc/hosts dest=/etc/hosts
      tags:
      - only
    - name: touch file
      file: path=/opt/hosts state=touch

执行命令：ide

ansible-playbook hosts.yml --tags="only"
ansible-playbook hosts.yml

  • 事实上，不光能够为单个或多个task指定同一个tags。playbook还提供了一个特殊的tags为always。做用就是当使用always当tags的task时，不管执行哪个tags时，定义有always的tags都会执行。
vi hosts.yml
---
- hosts: webserver
  remote_user: root
  tasks:
    - name: Copy hosts file
      copy: src=/etc/hosts dest=/etc/hosts
      tags:
      - only
    - name: copy test file
      copy: src=/etc/test.txt dest=/opt/test.txt
    - name: touch file
      file: path=/opt/hosts state=touch
      tags:
      - always

执行命令：

ansible-playbook hosts.yml --tags="only"

  • 注：此处我执行标记only，那么只会执行copy hosts file与touch file，而不会执行没有标记的test file
  • 如果执行：ansible-playbook hosts.yml，则全部tasks所有会执行。
  • 分别去两台被管理服务器上去查看文件建立状况
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程