Ansible 用 Roles 部署 LNMP 網(wǎng)頁應(yīng)用程式(下)

怎么用 Roles 撰寫強化版的 Playbooks？

在這份 Playbooks 與「Ansible 維護大型的 Playbooks」不同的是，凍仁除了把 variables, tasks, handlers 拆開寫以外，還加入 Roles 的部份。

取得范例檔

為避免版面過于混亂，凍仁已上傳范例檔，還請大家先至 GitHub 下載。

Git

1. 取得 demo code。

   $ git clone https://github.com/chusiang/automate-with-ansible.git
   

2. 進入 testlink 目錄。

   $ cd automate-with-ansible/lab/ch23/testlink
   

Zip

1. 若不想使用 Git，可改下載 zip 檔。

   $ wget https://github.com/chusiang/automate-with-ansible/archive/master.zip
   

2. 解壓縮。

   $ unzip automate-with-ansible-master.zip
   

3. 進入 testlink 目錄。

   $ cd automate-with-ansible-master/lab/ch23/testlink/
   

從 Galaxy 下載 Roles

通過凍仁定義好的 requirements.yml 下載多個 Roles，詳情請參考 Installing multiple roles from a file | Ansible Documentation 一文。

在 Python 的世界里，我們可借由 requirements.txt 批次下載 pip 套件，而在 Ansible 的世界里則是 requirements.yml。

$ ansible-galaxy install -f -p roles -r requirements.yml

使用 Vagrant 建立開發(fā)環(huán)境

由于這次的 Vagrantfile 有設(shè)置 provision (配置) ansible 的語法，故使用 vagrant up 時會一并執(zhí)行 playbook。詳情請參考「Ansible 用Vagrant練習(xí)Ansible」一文。

1. 觀看 Vagrantfile 內(nèi)容。

   $ cat Vagrantfile
   # -*- mode: ruby -*-
   
   Vagrant.configure("2") do |config|
    config.vm.box = "ubuntu/trusty64"
    config.vm.provider "virtualbox" do |vb|
      vb.memory = "1024"
    end
    config.vm.provision "ansible" do |ansible|
      ansible.playbook = "setup.yml"
      ansible.sudo = true
      #ansible.verbose = "vvv"
    end
   end
   
   # vi: set ft=ruby :
   

執(zhí)行 Playbooks

1. 啟用虛擬機并執(zhí)行 Playbook。

   $ vagrant up
   

   

2. 若過程中有問題，可使用 provision 重新執(zhí)行 Ansible。

   $ vagrant provision
   

3. 執(zhí)行完畢后，開啟瀏覽器 (Browsers) 并進入 TestLink 網(wǎng)站 (http://192.168.33.10)，其帳號密碼皆為 admin。

   

TestLink Playbooks 架構(gòu)解說

$ tree -L 2
.
├── README.md
├── Vagrantfile
├── defaults
│   └── main.yml            # main vars.
├── handlers
│   └── main.yml            # main handler.
├── requirements.yml        # for Roles.
├── roles
│   ├── chusiang.php7
│   ├── geerlingguy.mysql
│   └── williamyeh.nginx
├── setup.yml               # main playbook.
├── tasks
│   ├── check.yml
│   ├── main.yml            # main task.
│   ├── setting_nginx.yml
│   ├── setting_php-fpm.yml
│   ├── setting_testlink.yml
│   └── setup_testlink.yml
└── templates
    ├── config_db.inc.php.j2
    ├── nginx-testlink.conf.j2
    ├── php7-cli.ini.j2
    └── php7-fpm.ini.j2

8 directories, 16 files

1. README.md：可先從這里取得較詳細的資訊。

2. requirements.yml：這里定義了相應(yīng)的 Roles。

   $ cat requirements.yml
   # Nginx 1.10
   - src: williamyeh.nginx
    path: roles/
   
   # PHP 7
   - src: chusiang.php7
    path: roles/
   
   # MySQL 5.6
   - src: geerlingguy.mysql
    path: roles/
   

3. setup.yml：前面提到 Vagrant provision 進入點是這里，故我們可從這個 playbook 了解主要架構(gòu)。

   $ cat setup.yml
   01 #!/usr/bin/env ansible-playbook
   02
   03 ---
   04 - name: play 'setup testlink'
   05   hosts: all
   06   become: true
   07 
   08   vars_files:
   09     - defaults/main.yml
   10 
   11   roles:
   12     - williamyeh.nginx
   13     - chusiang.php7
   14     - {
   15         role: geerlingguy.mysql,
   16         mysql_packages: ['mysql-server-5.6', 'mysql-client-5.6','python-mysqldb'],
   17       }
   18
   19   tasks:
   20     - name: include main task
   21       include: tasks/main.yml
   22
   23     - name: include check task
   24       include: tasks/check.yml
   25
   26   handlers:
   27     - include: handlers/main.yml
   28
   29 # vim:ft=ansible:
   

   • 在第 6 行里，用了 become: yes 來取得 root 權(quán)限。
   • 在第 8, 9 行里，載入了定義好的 defaults/main.yml 變數(shù)檔案，這里宣告了所有會用到的變數(shù)。
   • 在第 11-17 行里，載入了 Nginx, MySQL 和 PHP 的 Roles。
   • 在第 20, 21 行里，載入了主要的 tasks。
   • 在第 23, 24 行里，載入了檢查用的 tasks。
   • 在第 26, 27 行里，載入了主要的 handler。

4. defaults/main.yml：覆蓋 Roles 預(yù)設(shè)變數(shù)和 TestLink 會用到的相關(guān)變數(shù)皆宣告于此。

5. tasks/

   1. main.yml：tasks 的主要進入點，并借由它載入預(yù)設(shè)執(zhí)行的 tasks。

      $ cat tasks/main.yml
      ---
      # tasks file for testlink
      
      - name: setup testlink
        include: setup_testlink.yml
      
      - name: setting php-fpm
        include: setting_php-fpm.yml
      
      - name: setting nginx
        include: setting_nginx.yml
      
      - name: setting testlink
        include: setting_testlink.yml
      
      # vim:ft=ansible:
      

   2. setup_testlink.yml：所有關(guān)于安裝 TestLink 會用到 tasks。

   3. setting_php-fpm.yml：設(shè)定 PHP 的 tasks。
   4. setting_nginx.yml：設(shè)定 Nginx 的 tasks。
   5. setting_testlink.yml：設(shè)定 TestLink 的 tasks。
   6. check.yml：檢查狀態(tài)用的 tasks。
6. templates/
   1. config_db.inc.php.j2：TestLink 的 Database 設(shè)定檔模板。
   2. nginx-testlink.conf.j2：Nginx 設(shè)定檔模板。
   3. php7-cli.ini.j2：php7-cli 設(shè)定檔模板。
   4. php7-fpm.ini.j2：php7-fpm 設(shè)定檔模板。

7. handlers/main.yml：主要的 handler，主要用來重新啟動 php-fpm 和 nginx。

   $ cat handlers/main.yml
   ---
   # handlers file for testlink
   
   - name: restart php-fpm
    service: name=php7.0-fpm enabled=yes state=restarted
   
   - name: restart nginx
    service: name=nginx enabled=yes state=restarted
   

以上，當(dāng)我們整合好 Roles 后，只需撰寫部署 TestLink 的 Playbooks 即可。仔細算一算這份范例的 Tasks 行數(shù)加起來還不到 220 行呢！

$ wc -l setup.yml tasks/*
      29 setup.yml
      42 tasks/check.yml
      16 tasks/main.yml
      25 tasks/setting_nginx.yml
      18 tasks/setting_php-fpm.yml
      11 tasks/setting_testlink.yml
      78 tasks/setup_testlink.yml
     219 total

后話

原先凍仁想從實作環(huán)境、建立 Playbooks、下載 Roles ... 等手把手一步步帶領(lǐng)著大家，但事后發(fā)現(xiàn)成效不佳，無法逐一說明，所以才會改用重點式介紹。

若您實作后無法正常執(zhí)行，可于下方留言給凍仁，或至 GitHub 開 issues。

相關(guān)連結(jié)

• Ansible 用 Roles 部署 LNMP 網(wǎng)頁應(yīng)用程式(上)