iT邦幫忙

2017 iT 邦幫忙鐵人賽
DAY 6
0

現代 IT 人一定要知道的 Ansible 自動化組態技巧

06. 怎麼操作 Ansible?

相信大家手邊都有可以練習 Ansible 的環境了,這次凍仁就來談談怎麼操作 Ansible!

automate_with_ansible_basic-16.jpg

一般來說,我們可以用 Ad-Hoc command 和 Playbook 兩種方式來操作 Ansible。

automate_with_ansible_basic-17.jpg

前者是透過一次次簡短的指令來操作 Ansible,而後者則是先把任務寫好,然後再一次執行。兩者的關係就好比我們在 Linux Shell 裡打指令和先寫個 Shell Script 再執行一樣。

Ad-Hoc Commands 是什麼?

Ad hoc 這個單字是來自拉丁文常用短語中的一個短語,通常用來形容為一個特定的問題或任務而專門設定的解決方案 [^1]。Ad-Hoc Commands 可以翻譯為簡短地指令,在這裡凍仁會用指令操作模式來形容它,以常見的 pingecho 操作為例。

  • ping.

    $ ansible all -m ping
    server1 | SUCCESS => {
        "changed": false,
        "ping": "pong"
    }
    
  • echo.

    $ ansible all -m command -a "echo Hello World"
    server1 | SUCCESS | rc=0 >>
    Hello World
    

從以上的例子中可以看到 Ad-Hoc commands 一次只能處理一件事情,這即是它與 Playbooks 最大的差異。

詳情請參考官方的 Introduction To Ad-Hoc Commands | Ansible Documentation 文件。

Playbooks 是什麼?

Playbook 就字面上的意思為劇本。我們可以透過事先寫好的劇本 (Playbooks) 來讓各個 Managed Node 進行指定的動作 (Plays)任務 (Tasks) 。 [^2]

簡而言之,Playbooks 是 Ansible 的腳本 (Script),而且還是個比傳統 Shell Script 還強大數百倍的腳本!如果今天只能記住一件事,請記住 Ansible 最好用、最厲害的就是它的 Playbook!

automate_with_ansible_basic-18.jpg
圖片來源:http://goo.gl/GKJvXn

在一份 Playbook 中,可以有多個 Play、多個 Task 和多個 Module。

  • Play:通常為某個特定的目的,例如:
    • Setup a official website with Drupal Drupal (藉由 Drupal 建置官網)
    • Restart the API service (重開 API 服務)
  • Task:是要實行 Play 這個目地所需做的每個步驟,例如:
    • Install the Nginx (安裝 Nginx)
    • Kill the djnago process (停用 django 的行程)
  • Module:Ansible 所提供的各種操作方法,例如:
    • apt: name=vim state=present (使用 apt 套件安裝 vim)
    • command: /sbin/shutdown -r now (使用 shutdown 的指令重新開機)

automate_with_ansible_basic-19.gif

詳情請參考官方的 Playbooks | Ansible Documentation 文件。

Hello World Playbook

  • 來寫一下我們的第一個 playbook!請建立一個 hello_world.yml 的檔案,並將 --- 開始的內容都寫進去。

    $ vi hello_world.yml
    ---
    
    - name: say 'hello world'
      hosts: all
      tasks:
    
        - name: echo 'hello world'
          command: echo 'hello world'
          register: result
    
        - name: print stdout
          debug:
            msg: "{{ result.stdout }}"
    
  • 執行 playbook:在這個範例中,我們執行了 1 個 Play、3 個 Task 和 2 個 Module。

    $ ansible-playbook hello_world.yml
    
    PLAY [say 'hello world'] *******************************************
    
    TASK [setup] *******************************************************
    ok: [server1]
    
    TASK [echo 'hello world'] ******************************************
    changed: [server1]
    
    TASK [print stdout] ************************************************
    ok: [server1] => {
        "msg": "hello world"
    }
    
    PLAY RECAP *********************************************************
    server1        : ok=3    changed=1    unreachable=0    failed=0
    

沒有 Ansible 時,我們是怎麼操作的?

凍仁在此附上 Linux Shell [^3] 上的傳統作法,來比對兩者的操作。

Shell (command line, cli, console)

  • ping.

    $ ping -c 1 8.8.8.8
    PING 8.8.8.8 (8.8.8.8): 56 data bytes
    64 bytes from 8.8.8.8: icmp_seq=0 ttl=44 time=10.022 ms
    
    --- 8.8.8.8 ping statistics ---
    1 packets transmitted, 1 packets received, 0.0% packet loss
    round-trip min/avg/max/stddev = 10.022/10.022/10.022/0.000 ms
    
  • echo.

    $ echo Hello World
    Hello World
    

Shell Script

  • 建立 hello_world.sh 檔案。

    #!/bin/bash
    echo 'Hello World'
    
  • 執行。

    $ bash hello_world.sh
    Hello World
    

大家或許會問,會寫 script 就夠用了,為什麼還要會寫 playbook 呢?凍仁在此列了幾個理由給大家參考:

  1. 若有現成的 script,我們可以用 shell module 來執行它,這部份雖不衝突,但使用 shell module 會造成每次跑 playbook 都會重複執行,不像其它 module 執行過就不會再執行了。
  2. 用 Ansible 的 module 可以把很多雜亂的指令給標準化,例如不同的 Linux 發行版本在安裝套件時需代各種不同的參數。
  3. 在現有的 cloud native 的架構下,傳統的 Shell Script 已不符使用,一般而言 Shell Script 只能對一台機器 (instance) 進行操作。

相信大家都知道要怎麼操作 Ansible 了,好好享受 Ansible 帶給我們的樂趣吧!

相關連結

[^1]: 詳情請參考維基百科上的 Ad hoc 解釋。

[^2]: 關於組態管理工具的隱喻,可參考 William Yeh 前輩所撰寫的電腦界的隱喻:組態管理 | 軟體架構・絮語一文。

[^3]: Linux Shell,是我們一般在 GNU/Linux 上操作的模式,而常見的 Shell 有 Bash, Zsh ... 等,在 Windows 上則有命令提示字元 (CMD),但它對使用者而言沒有 Shell 友善。


上一篇
05. 怎麼用 Docker 練習 Ansible?
下一篇
07. 怎麼用 Jupyter 操控 Ansible?(localhost)
系列文
現代 IT 人一定要知道的 Ansible 自動化組態技巧31

1 則留言

0
凍仁翔
iT邦新手 4 級 ‧ 6 月前

先前的 hello_world.yml 少了 register: result 這一行,所以才會有找不到 result 變數的 error message。

感謝邦友 Min Hua 的 feedback。:D

我要留言

立即登入留言