Ansible 中的 playbook 詳解
一、playbook
1.1 playbook是什麼
根本上說playbook和shell指令碼沒有任何的區別,playbook就像shell一樣,也是把一堆的命令組合起來,然後加入對應條件判斷等等,在shell指令碼中是一條一條的命令,而在playbook中是一個一個的task任務構成,每個task任務可以看做shell中的一條命令;shell指令碼一般只是在當前伺服器上執行,而playbook則是在不止一個伺服器上執行,因此playbook需要在其中指定執行該playbook的伺服器名。
1.2 playbook的語法結構
playbook使用yml標記語言,這是一種標記語言,這種標記語言在檔案的最開始需要使用三個“-”來說明檔案開始,然後使用縮排來說明程式碼塊的範圍。下面通過一個簡易的例項,來說明playbook的語法。
--- # 標記檔案的開始 - hosts: webservers # 指定該playbook在哪個伺服器上執行 vars: # 表示下面是定義的變數, http_port: 80 # 變數的形式,key: value,這裡http_port是變數名,80是值 max_clients: 200 remote_user: root # 指定遠端的使用者名稱,這裡縮排和vars保持了一致,說明變數的程式碼塊已經結束。 tasks: # 下面構成playbook的tasks,每個task都有 - name: 開始,name指定該任務的名稱。 - name: ensure apache is at the latest version # 指定該任務的名稱。 yum: pkg=httpd state=latest # yum說明要是用的模板名稱,後面指定對應的引數,這兩行結合起來就相當於一個shell命令。 - name: write the apache config file # 每個task之間可以使用空行來做區分。 template: src=/srv/httpd.j2 dest=/etc/httpd.conf
需要說明的是縮排的意義和python中縮排的意義是一樣,是來區分程式碼塊的。
一個簡單的例項:檢查MySQL的執行狀態
---
- hosts: all
remote_user: root
gather_facts: no # 不收集對應主機的資訊,這樣執行會快點。
tasks:
- name: check the mysql stauts
service: name=mysqld state=running
執行playbook:
$ ansible-playbook test.yml PLAY [all] ******************************************************************** TASK: [check the mysql stauts] ************************************************ ok: [10.0.102.200] ok: [10.0.102.162] ok: [10.0.102.212] PLAY RECAP ******************************************************************** 10.0.102.162 : ok=1 changed=0 unreachable=0 failed=0 10.0.102.200 : ok=1 changed=0 unreachable=0 failed=0 10.0.102.212 : ok=1 changed=0 unreachable=0 failed=0
1.3 限定主機範圍執行
雖然playbook中定義了執行的主機,但是有時候我們可能僅想在定義的主機中的部分機器上執行,這時候怎麼辦?修改playbook中的hosts的範圍,但是每次改變主機就修改一次,比較麻煩,我們可以使用--limit引數,指定該playbook在指定的主機上執行。有以下inventory檔案,我們想在dbservers上執行上面測試用的playbook內容。
[all]
10.0.102.212
10.0.102.200
10.0.102.162
[dbservers]
10.0.102.162
上面測試的playbook中hosts定義all,我們想僅在dbservers上執行。
$ ansible-playbook test.yml --limit dbservers
PLAY [all] ********************************************************************
TASK: [check the mysql stauts] ************************************************
ok: [10.0.102.162]
PLAY RECAP ********************************************************************
10.0.102.162 : ok=1 changed=0 unreachable=0 failed=0
檢視當前playbook在哪些主機上執行
$ ansible-playbook test.yml --list-hosts
playbook: test.yml
play # 1 (all): host count=3
10.0.102.162
10.0.102.212
10.0.102.200
1.4 ansible-palybook的小技巧
--inventory=path
,指定inventory檔案,預設是在/etc/ansible/hosts下面。--verbose
,顯示詳細的輸出,使用-vvvv顯示精確到每分鐘的輸出。--extra-vars=vars
:定義在playbook使用的變數。--forks
:指定併發的執行緒數,預設是5.--connection=type
:指定遠端連線主機的方式,預設是ssh,設定為local時,則只在本地執行playbook、--check
:檢測模式,playbook中定義的所有任務將在每臺主機上檢測,但是並不執行。
1.5 ansible-playbook中的handlers
在系統中,我們修改了伺服器的配置檔案,這時候就需要重啟操作服務,就可以使用到handlers。
handlers: # 定義兩個handlers
- name: restart memcached
service: name=memcached state=restarted
- name: restart apache
service: name=apache state=restarted
- name: template configuration file
template: src=template.j2 dest=/etc/foo.conf # 修改了配置檔案然後依次啟動memcached和apache服務。
notify: # 使用notify來宣告引用handlers。
- restart memcached
- restart apache
1.6 使用handlers的注意事項
- Handlers只有在其所在的任務被執行時,才會被執行;如果一個任務中定義了notify呼叫Handlers,但是由於條件判斷等原因,該任務未被執行,那麼Handlers同樣不會被執行。
- Handlers只會在每一個play的末尾執行一次;如果想在一個playbook中間執行Handlers,則需要使用meta模組來實現。例如:
-meta: flush_handlers
. - 如果一個play在執行到呼叫Handlers的語句之前失敗了,那麼這個Handlers將不會被執行。我們可以使用meta模組的
--force-handlers
選項來強制執行Handlers,即使Handlers所在的play中途執行失敗也能執行。
二、變數
這個變數我們來說明ansible中變數(不包含role中的變數)用法。
2.1 playbook中的變數
在執行playbook的時候使用--extra-vars
來指定變數
有如下playbook指令碼:
---
- hosts: all
remote_user: root
gather_facts: no
tasks:
- name: test playbook variables
command: echo {{ test_var }} # 打印出變數test_var的值。
執行playbook:
$ ansible-playbook test.yml --extra-vars "test_var=test" -v
# 加上-v選項,會顯示詳細的資訊
PLAY [all] ********************************************************************
TASK: [test playbook variables] ***********************************************
changed: [10.0.102.212] => {"changed": true, "cmd": ["echo", "test"], "delta": "0:00:00.006045", "end": "2019-02-15 23:04:49.789452", "rc": 0, "start": "2019-02-15 23:04:49.783407", "stderr": "", "stdout": "test"}
changed: [10.0.102.200] => {"changed": true, "cmd": ["echo", "test"], "delta": "0:00:00.005318", "end": "2019-02-15 23:04:52.976471", "rc": 0, "start": "2019-02-15 23:04:52.971153", "stderr": "", "stdout": "test"}
changed: [10.0.102.162] => {"changed": true, "cmd": ["echo", "test"], "delta": "0:00:00.005082", "end": "2019-02-15 23:04:52.424959", "rc": 0, "start": "2019-02-15 23:04:52.419877", "stderr": "", "stdout": "test"}
PLAY RECAP ********************************************************************
10.0.102.162 : ok=1 changed=1 unreachable=0 failed=0
10.0.102.200 : ok=1 changed=1 unreachable=0 failed=0
10.0.102.212 : ok=1 changed=1 unreachable=0 failed=0
上面詳細資訊的標準輸出為test,說明變數的值已經傳遞了。
2.2 playbook中使用vars程式碼塊定義變數
$ cat test.yml
---
- hosts: all
remote_user: root
gather_facts: no
vars: # 在這裡使用了vars程式碼塊來定義變數
test_var: Hello World
tasks:
- name: test playbook variables
command: echo {{ test_var }}
$ ansible-playbook test.yml -v
PLAY [all] ********************************************************************
TASK: [test playbook variables] ***********************************************
changed: [10.0.102.162] => {"changed": true, "cmd": ["echo", "Hello", "World"], "delta": "0:00:00.004940", "end": "2019-02-15 23:20:06.541672", "rc": 0, "start": "2019-02-15 23:20:06.536732", "stderr": "", "stdout": "Hello World"}
changed: [10.0.102.212] => {"changed": true, "cmd": ["echo", "Hello", "World"], "delta": "0:00:00.004843", "end": "2019-02-15 23:20:03.957950", "rc": 0, "start": "2019-02-15 23:20:03.953107", "stderr": "", "stdout": "Hello World"}
changed: [10.0.102.200] => {"changed": true, "cmd": ["echo", "Hello", "World"], "delta": "0:00:00.004219", "end": "2019-02-15 23:20:07.166900", "rc": 0, "start": "2019-02-15 23:20:07.162681", "stderr": "", "stdout": "Hello World"}
PLAY RECAP ********************************************************************
10.0.102.162 : ok=1 changed=1 unreachable=0 failed=0
10.0.102.200 : ok=1 changed=1 unreachable=0 failed=0
10.0.102.212 : ok=1 changed=1 unreachable=0 failed=0
2.3 使用獨立的檔案來定義playbook變數
playbook的內容:
---
- hosts: all
remote_user: root
gather_facts: no
vars_files: # 這裡使用了vars_files來引入變數檔案
- vars.yml
tasks:
- name: test playbook variables
command: echo {{ test_var }}
變數檔案的定義:
$ cat vars.yml
---
test_var: Hello World
執行的結果:
$ ansible-playbook test.yml -v
PLAY [all] ********************************************************************
TASK: [test playbook variables] ***********************************************
changed: [10.0.102.212] => {"changed": true, "cmd": ["echo", "Hello", "World"], "delta": "0:00:00.005198", "end": "2019-02-15 23:23:16.397557", "rc": 0, "start": "2019-02-15 23:23:16.392359", "stderr": "", "stdout": "Hello World"}
changed: [10.0.102.200] => {"changed": true, "cmd": ["echo", "Hello", "World"], "delta": "0:00:00.004359", "end": "2019-02-15 23:23:19.629804", "rc": 0, "start": "2019-02-15 23:23:19.625445", "stderr": "", "stdout": "Hello World"}
changed: [10.0.102.162] => {"changed": true, "cmd": ["echo", "Hello", "World"], "delta": "0:00:01.006185", "end": "2019-02-15 23:23:20.039320", "rc": 0, "start": "2019-02-15 23:23:19.033135", "stderr": "", "stdout": "Hello World"}
PLAY RECAP ********************************************************************
10.0.102.162 : ok=1 changed=1 unreachable=0 failed=0
10.0.102.200 : ok=1 changed=1 unreachable=0 failed=0
10.0.102.212 : ok=1 changed=1 unreachable=0 failed=0
2.4 inventory檔案中的變數
在ansible中,inventory檔案通常是指ansible的主機和組定義檔案hosts。在hosts檔案中,變數會被定義在主機名後面或組名的下方。
為特定的主機定義變數,變數名跟在對應主機的後邊。
inventory檔案如下:
$ cat /etc/ansible/hosts
[all]
10.0.102.212 test_var=212
10.0.102.200 test_var=200
10.0.102.162 test_var=162
# 為三個主機定義了同名的變數,但是變數值卻不一樣。
playbook的內容如下:
---
- hosts: all
remote_user: root
gather_facts: no
tasks:
- name: test playbook variables
command: echo {{ test_var }}
執行這個playbook,結果如下(對應的主機顯示了各自對應的變數值):
$ ansible-playbook test.yml -v
PLAY [all] ********************************************************************
TASK: [test playbook variables] ***********************************************
changed: [10.0.102.212] => {"changed": true, "cmd": ["echo", "212"], "delta": "0:00:00.004399", "end": "2019-02-15 23:31:20.648111", "rc": 0, "start": "2019-02-15 23:31:20.643712", "stderr": "", "stdout": "212"}
changed: [10.0.102.200] => {"changed": true, "cmd": ["echo", "200"], "delta": "0:00:00.005932", "end": "2019-02-15 23:31:23.873082", "rc": 0, "start": "2019-02-15 23:31:23.867150", "stderr": "", "stdout": "200"}
changed: [10.0.102.162] => {"changed": true, "cmd": ["echo", "162"], "delta": "0:00:00.006723", "end": "2019-02-15 23:31:23.287861", "rc": 0, "start": "2019-02-15 23:31:23.281138", "stderr": "", "stdout": "162"}
PLAY RECAP ********************************************************************
10.0.102.162 : ok=1 changed=1 unreachable=0 failed=0
10.0.102.200 : ok=1 changed=1 unreachable=0 failed=0
10.0.102.212 : ok=1 changed=1 unreachable=0 failed=0
給主機組定義變數,作用範圍為整個主機組。
$ cat /etc/ansible/hosts
[all]
10.0.102.212
10.0.102.200
10.0.102.162
[all:vars] #給主機組定義變數
test_var=Hello World
$ ansible-playbook test.yml -v
PLAY [all] ********************************************************************
TASK: [test playbook variables] ***********************************************
changed: [10.0.102.212] => {"changed": true, "cmd": ["echo", "Hello", "World"], "delta": "0:00:00.003923", "end": "2019-02-15 23:37:29.322158", "rc": 0, "start": "2019-02-15 23:37:29.318235", "stderr": "", "stdout": "Hello World"}
changed: [10.0.102.200] => {"changed": true, "cmd": ["echo", "Hello", "World"], "delta": "0:00:00.004161", "end": "2019-02-15 23:37:32.548947", "rc": 0, "start": "2019-02-15 23:37:32.544786", "stderr": "", "stdout": "Hello World"}
changed: [10.0.102.162] => {"changed": true, "cmd": ["echo", "Hello", "World"], "delta": "0:00:00.006090", "end": "2019-02-15 23:37:32.005067", "rc": 0, "start": "2019-02-15 23:37:31.998977", "stderr": "", "stdout": "Hello World"}
PLAY RECAP ********************************************************************
10.0.102.162 : ok=1 changed=1 unreachable=0 failed=0
10.0.102.200 : ok=1 changed=1 unreachable=0 failed=0
10.0.102.212 : ok=1 changed=1 unreachable=0 failed=0
回想一下,這種方法定義變數雖然簡單直觀,但是若是變數特別多的情況下,會怎麼樣?特別是給對應的主機定義變數,若是變數太多,則管理起來會很不方便的,因此引入了主機變數和組變數。
2.5 主機變數和組變數
inventory檔案仍然使用上面的檔案!
在執行ansbile命令時,ansible預設會從/etc/ansible/host_vars/
和/etc/amsible/group_vars/
兩個目錄下讀取變數定義,如果/etc/ansible
下面沒有這兩個目錄,可以直接手動建立,並且可以在這兩個目錄中建立與hosts
(這裡是指inventory
檔案)檔案中主機名或組名同名的檔案來定義變數。
先來看主機變數
$ tree /etc/ansible/
.
├── group_vars
├── hosts
└── host_vars # 定義與主機名同名的檔案
├── 10.0.102.162
├── 10.0.102.200
└── 10.0.102.212
2 directories, 4 files
# 檔案中的內容如下:
$ cat host_vars/10.0.102.162
---
test_var: 162
$ cat host_vars/10.0.102.200
---
test_var: 200
$ cat host_vars/10.0.102.212
---
test_var: 212
playbook的內容如下,執行結果如下:
$ cat test.yml
---
- hosts: all
remote_user: root
gather_facts: no
tasks:
- name: test playbook variables
command: echo {{ test_var }}
$ ansible-playbook test.yml -v
PLAY [all] ********************************************************************
TASK: [test playbook variables] ***********************************************
changed: [10.0.102.212] => {"changed": true, "cmd": ["echo", "212"], "delta": "0:00:00.003767", "end": "2019-02-15 23:55:58.595282", "rc": 0, "start": "2019-02-15 23:55:58.591515", "stderr": "", "stdout": "212"}
changed: [10.0.102.162] => {"changed": true, "cmd": ["echo", "162"], "delta": "0:00:00.006254", "end": "2019-02-15 23:56:01.235307", "rc": 0, "start": "2019-02-15 23:56:01.229053", "stderr": "", "stdout": "162"}
changed: [10.0.102.200] => {"changed": true, "cmd": ["echo", "200"], "delta": "0:00:01.004509", "end": "2019-02-15 23:56:02.775410", "rc": 0, "start": "2019-02-15 23:56:01.770901", "stderr": "", "stdout": "200"}
PLAY RECAP ********************************************************************
10.0.102.162 : ok=1 changed=1 unreachable=0 failed=0
10.0.102.200 : ok=1 changed=1 unreachable=0 failed=0
10.0.102.212 : ok=1 changed=1 unreachable=0 failed=0
再來說明一下主機組變數!
建立與組名同名的檔案:
$ tree
.
├── group_vars
│ └── all #建立與組名同名的檔案
├── hosts
└── host_vars
├── 10.0.102.162
├── 10.0.102.200
└── 10.0.102.212
2 directories, 5 files
$ cat group_vars/all
---
test_group_var: from group
執行結果如下:
$ cat test.yml
---
- hosts: all
remote_user: root
gather_facts: no
tasks:
- name: test the host variables
command: echo {{ test_var }}
- name: test host group variables #寫入測試組變數的task
command: echo {{ test_group_var }}
$ ansible-playbook test.yml -v
PLAY [all] ********************************************************************
TASK: [test the host variables] ***********************************************
changed: [10.0.102.212] => {"changed": true, "cmd": ["echo", "212"], "delta": "0:00:00.004613", "end": "2019-02-15 23:59:23.227722", "rc": 0, "start": "2019-02-15 23:59:23.223109", "stderr": "", "stdout": "212"}
changed: [10.0.102.200] => {"changed": true, "cmd": ["echo", "200"], "delta": "0:00:00.006490", "end": "2019-02-15 23:59:26.422682", "rc": 0, "start": "2019-02-15 23:59:26.416192", "stderr": "", "stdout": "200"}
changed: [10.0.102.162] => {"changed": true, "cmd": ["echo", "162"], "delta": "0:00:00.004709", "end": "2019-02-15 23:59:25.812786", "rc": 0, "start": "2019-02-15 23:59:25.808077", "stderr": "", "stdout": "162"}
TASK: [test host group variables] *********************************************
changed: [10.0.102.212] => {"changed": true, "cmd": ["echo", "from", "group"], "delta": "0:00:00.003759", "end": "2019-02-15 23:59:23.519180", "rc": 0, "start": "2019-02-15 23:59:23.515421", "stderr": "", "stdout": "from group"}
changed: [10.0.102.162] => {"changed": true, "cmd": ["echo", "from", "group"], "delta": "0:00:00.003748", "end": "2019-02-15 23:59:26.109337", "rc": 0, "start": "2019-02-15 23:59:26.105589", "stderr": "", "stdout": "from group"}
changed: [10.0.102.200] => {"changed": true, "cmd": ["echo", "from", "group"], "delta": "0:00:00.004339", "end": "2019-02-15 23:59:26.724525", "rc": 0, "start": "2019-02-15 23:59:26.720186", "stderr": "", "stdout": "from group"}
PLAY RECAP ********************************************************************
10.0.102.162 : ok=2 changed=2 unreachable=0 failed=0
10.0.102.200 : ok=2 changed=2 unreachable=0 failed=0
10.0.102.212 : ok=2 changed=2 unreachable=0 failed=0
2.6 巧用主機變數和組變數
有時候在執行ansbile任務時,可能需要從一臺遠端主機上獲取另一臺遠端主機的變數資訊,這時候可以使用hostvars變數,這個變數包含了指定主機上所定義的所有變數。
譬如,若是想獲取host1上變數admin_user的內容,在任意主機上直接上使用下面程式碼即可。
{{ hostvars['host1']['admin_user']}}
ansible提供了一些非常有用的內建變數,幾個常用的如下:
grorps
:包含了所有hosts檔案裡的主機組的一個列表。group_names
: 包含了當前主機所在的所有主機組名的一個列表。inventory_hostname
: 通過hosts檔案定義的主機名。(與ansible_home
意義不同)inventory_hostname_short
:變數inventory_hostname
的第一部分。譬如inventory_hostname
的值為books.ansible.com
,那麼inventory_hostname_short
的值就是books。play_hosts
: 將執行當前任務的所有主機
2.7 註冊變數
註冊變數,其實就是將操作結果,包括標準輸出和標準錯誤輸出,儲存到變數中,然後再根據這個變數的內容來決定下一步的操作,在這個過程中用來儲存操作結果的變數就叫註冊變數。
---
- hosts: all
remote_user: root
gather_facts: no
tasks:
- name: test the register variables
shell: uptime
register: results # 使用關鍵字register宣告註冊變數,上面uptime命令產生的結果,存入到results中。結果是字典形式。
- name: print the register result
debug: msg="{{ results.stdout }}" # 使用debug模組,打印出上面命令的輸出結果。
上面的playbook執行結果如下:
$ ansible-playbook test.yml
PLAY [all] ********************************************************************
TASK: [test the register variables] *******************************************
changed: [10.0.102.212]
changed: [10.0.102.200]
changed: [10.0.102.162]
TASK: [print the register result] *********************************************
ok: [10.0.102.212] => {
"msg": " 00:18:01 up 3 days, 2:56, 3 users, load average: 0.02, 0.03, 0.05" #msg的結果就是註冊變數的標準輸出
}
ok: [10.0.102.200] => {
"msg": " 00:18:04 up 4 days, 7:45, 3 users, load average: 0.03, 0.06, 0.05"
}
ok: [10.0.102.162] => {
"msg": " 00:18:04 up 4 days, 7:45, 3 users, load average: 0.01, 0.02, 0.05"
}
PLAY RECAP ********************************************************************
10.0.102.162 : ok=2 changed=1 unreachable=0 failed=0
10.0.102.200 : ok=2 changed=1 unreachable=0 failed=0
10.0.102.212 : ok=2 changed=1 unreachable=0 failed=0
一個註冊變數通常會有以下4個屬性:
changed
:任務是否對遠端主機造成的變更。delta
:任務執行所用的時間。stdout
:正常的輸出資訊。stderr
:錯誤資訊。
三、高階變數
對於普通變數,在ansible命令列設定的,在hosts檔案中定義的,或者在playbook中定義的等,這些都是普通變數,在引用時,可以使用使用{{ variable }}
的形式。ansible是用python語言寫的,因此也支援一種叫做列表的變數,形式如下:
---
- hosts: all
remote_user: root
gather_facts: no
vars:
var_list: # 注意形式,定義了var_list列表,取值方法和列表取值一樣,不推薦使用jinja2的方法取值。
- one
- two
- three
tasks:
- name: test the list variables
shell: echo {{ var_list[0] }} # 取列表中的第一個字,也就是one
register: results
- name: print the register result
debug: msg="{{ results.stdout }}"
執行結果如下:
$ ansible-playbook test.yml
PLAY [all] ********************************************************************
TASK: [test the list variables] ***********************************************
changed: [10.0.102.212]
changed: [10.0.102.200]
changed: [10.0.102.162]
TASK: [print the register result] *********************************************
ok: [10.0.102.212] => {
"msg": "one"
}
ok: [10.0.102.200] => {
"msg": "one"
}
ok: [10.0.102.162] => {
"msg": "one"
}
PLAY RECAP ********************************************************************
10.0.102.162 : ok=2 changed=1 unreachable=0 failed=0
10.0.102.200 : ok=2 changed=1 unreachable=0 failed=0
10.0.102.212 : ok=2 changed=1 unreachable=0 failed=0
3.1 fasts變數資訊
在上面的測試中,我們的playbook都執行了一條命令叫gater_facts:no
,加入了這條命令後,playbook指令碼的執行速度會快很多,這是因為預設情況下,ansible是會手機遠端伺服器的主機資訊,這些資訊包含了伺服器的一些基本設定。
GATHERING FACTS ***************************************************************
ok: [10.0.102.200]
ok: [10.0.102.212]
ok: [10.0.102.162]
收集的主機資訊可以使用setup模組檢視,一個主機的收集資訊如下:
ansible 10.0.102.162 -m setup
10.0.102.162 | success >> {
"ansible_facts": {
"ansible_all_ipv4_addresses": [
"10.0.102.162"
],
"ansible_all_ipv6_addresses": [
"fe80::1392:ecd3:5adf:c3ae"
],
"ansible_architecture": "x86_64",
"ansible_bios_date": "04/01/2014",
"ansible_bios_version": "1.9.1-5.el7.centos",
"ansible_cmdline": {
"BOOT_IMAGE": "/vmlinuz-3.10.0-514.el7.x86_64",
"LANG": "en_US.UTF-8",
"crashkernel": "auto",
"quiet": true,
"rd.lvm.lv": "cl/swap",
"rhgb": true,
"ro": true,
"root": "/dev/mapper/cl-root"
},
"ansible_date_time": {
"date": "2019-02-16",
"day": "16",
"epoch": "1550248590",
"hour": "00",
"iso8601": "2019-02-15T16:36:30Z",
"iso8601_micro": "2019-02-15T16:36:30.311222Z",
"minute": "36",
"month": "02",
"second": "30",
"time": "00:36:30",
"tz": "CST",
"tz_offset": "+0800",
"weekday": "Saturday",
"year": "2019"
},
"ansible_default_ipv4": {
"address": "10.0.102.162",
"alias": "eth0",
"gateway": "10.0.100.1",
"interface": "eth0",
"macaddress": "fa:0a:e3:54:a6:00",
"mtu": 1500,
"netmask": "255.255.252.0",
"network": "10.0.100.0",
"type": "ether"
},
"ansible_default_ipv6": {},
"ansible_devices": {
"sr0": {
"holders": [],
"host": "IDE interface: Intel Corporation 82371SB PIIX3 IDE [Natoma/Triton II]",
"model": "QEMU DVD-ROM",
"partitions": {},
"removable": "1",
"rotational": "1",
"scheduler_mode": "cfq",
"sectors": "2097151",
"sectorsize": "512",
"size": "1024.00 MB",
"support_discard": "0",
"vendor": "QEMU"
},
"vda": {
"holders": [],
"host": "SCSI storage controller: Red Hat, Inc Virtio block device",
"model": null,
"partitions": {
"vda1": {
"sectors": "2097152",
"sectorsize": 512,
"size": "1.00 GB",
"start": "2048"
},
"vda2": {
"sectors": "81786880",
"sectorsize": 512,
"size": "39.00 GB",
"start": "2099200"
}
},
"removable": "0",
"rotational": "1",
"scheduler_mode": "",
"sectors": "83886080",
"sectorsize": "512",
"size": "40.00 GB",
"support_discard": "0",
"vendor": "0x1af4"
}
},
"ansible_distribution": "CentOS",
"ansible_distribution_major_version": "7",
"ansible_distribution_release": "Core",
"ansible_distribution_version": "7.3.1611",
"ansible_domain": "",
"ansible_env": {
"HOME": "/root",
"LANG": "en_US.UTF-8",
"LC_CTYPE": "en_US.UTF-8",
"LESSOPEN": "||/usr/bin/lesspipe.sh %s",
"LOGNAME": "root",
"LS_COLORS": "rs=0:di=01;34:ln=01;36:mh=00:pi=40;33:so=01;35:do=01;35:bd=40;33;01:cd=40;33;01:or=40;31;01:mi=01;05;37;41:su=37;41:sg=30;43:ca=30;41:tw=30;42:ow=34;42:st=37;44:ex=01;32:*.tar=01;31:*.tgz=01;31:*.arc=01;31:*.arj=01;31:*.taz=01;31:*.lha=01;31:*.lz4=01;31:*.lzh=01;31:*.lzma=01;31:*.tlz=01;31:*.txz=01;31:*.tzo=01;31:*.t7z=01;31:*.zip=01;31:*.z=01;31:*.Z=01;31:*.dz=01;31:*.gz=01;31:*.lrz=01;31:*.lz=01;31:*.lzo=01;31:*.xz=01;31:*.bz2=01;31:*.bz=01;31:*.tbz=01;31:*.tbz2=01;31:*.tz=01;31:*.deb=01;31:*.rpm=01;31:*.jar=01;31:*.war=01;31:*.ear=01;31:*.sar=01;31:*.rar=01;31:*.alz=01;31:*.ace=01;31:*.zoo=01;31:*.cpio=01;31:*.7z=01;31:*.rz=01;31:*.cab=01;31:*.jpg=01;35:*.jpeg=01;35:*.gif=01;35:*.bmp=01;35:*.pbm=01;35:*.pgm=01;35:*.ppm=01;35:*.tga=01;35:*.xbm=01;35:*.xpm=01;35:*.tif=01;35:*.tiff=01;35:*.png=01;35:*.svg=01;35:*.svgz=01;35:*.mng=01;35:*.pcx=01;35:*.mov=01;35:*.mpg=01;35:*.mpeg=01;35:*.m2v=01;35:*.mkv=01;35:*.webm=01;35:*.ogm=01;35:*.mp4=01;35:*.m4v=01;35:*.mp4v=01;35:*.vob=01;35:*.qt=01;35:*.nuv=01;35:*.wmv=01;35:*.asf=01;35:*.rm=01;35:*.rmvb=01;35:*.flc=01;35:*.avi=01;35:*.fli=01;35:*.flv=01;35:*.gl=01;35:*.dl=01;35:*.xcf=01;35:*.xwd=01;35:*.yuv=01;35:*.cgm=01;35:*.emf=01;35:*.axv=01;35:*.anx=01;35:*.ogv=01;35:*.ogx=01;35:*.aac=01;36:*.au=01;36:*.flac=01;36:*.mid=01;36:*.midi=01;36:*.mka=01;36:*.mp3=01;36:*.mpc=01;36:*.ogg=01;36:*.ra=01;36:*.wav=01;36:*.axa=01;36:*.oga=01;36:*.spx=01;36:*.xspf=01;36:",
"MAIL": "/var/mail/root",
"PATH": "/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin",
"PWD": "/root",
"SELINUX_LEVEL_REQUESTED": "",
"SELINUX_ROLE_REQUESTED": "",
"SELINUX_USE_CURRENT_RANGE": "",
"SHELL": "/bin/bash",
"SHLVL": "2",
"SSH_CLIENT": "10.0.102.204 4242 22",
"SSH_CONNECTION": "10.0.102.204 4242 10.0.102.162 22",
"SSH_TTY": "/dev/pts/1",
"TERM": "xterm",
"USER": "root",
"XDG_RUNTIME_DIR": "/run/user/0",
"XDG_SESSION_ID": "168",
"_": "/usr/bin/python"
},
"ansible_eth0": {
"active": true,
"device": "eth0",
"ipv4": {
"address": "10.0.102.162",
"netmask": "255.255.252.0",
"network": "10.0.100.0"
},
"ipv6": [
{
"address": "fe80::1392:ecd3:5adf:c3ae",
"prefix": "64",
"scope": "link"
}
],
"macaddress": "fa:0a:e3:54:a6:00",
"module": "virtio_net",
"mtu": 1500,
"promisc": false,
"type": "ether"
},
"ansible_form_factor": "Other",
"ansible_fqdn": "docker4",
"ansible_hostname": "docker4",
"ansible_interfaces": [
"lo",
"eth0"
],
"ansible_kernel": "3.10.0-514.el7.x86_64",
"ansible_lo": {
"active": true,
"device": "lo",
"ipv4": {
"address": "127.0.0.1",
"netmask": "255.0.0.0",
"network": "127.0.0.0"
},
"ipv6": [
{
"address": "::1",
"prefix": "128",
"scope": "host"
}
],
"mtu": 65536,
"promisc": false,
"type": "loopback"
},
"ansible_machine": "x86_64",
"ansible_memfree_mb": 881,
"ansible_memtotal_mb": 1839,
"ansible_mounts": [
{
"device": "/dev/mapper/cl-root",
"fstype": "xfs",
"mount": "/",
"options": "rw,seclabel,relatime,attr2,inode64,noquota",
"size_available": 34615087104,
"size_total": 39700664320
},
{
"device": "/dev/vda1",
"fstype": "xfs",
"mount": "/boot",
"options": "rw,seclabel,relatime,attr2,inode64,noquota",
"size_available": 918556672,
"size_total": 1063256064
}
],
"ansible_nodename": "docker4",
"ansible_os_family": "RedHat",
"ansible_pkg_mgr": "yum",
"ansible_processor": [
"QEMU Virtual CPU version 2.5+",
"QEMU Virtual CPU version 2.5+"
],
"ansible_processor_cores": 2,
"ansible_processor_count": 1,
"ansible_processor_threads_per_core": 1,
"ansible_processor_vcpus": 2,
"ansible_product_name": "KVM",
"ansible_product_serial": "NA",
"ansible_product_uuid": "E5E1D5E6-1A4D-4E0D-98C3-B8AD422B10CC",
"ansible_product_version": "RHEL 7.3.0 PC (i440FX + PIIX, 1996)",
"ansible_python_version": "2.7.5",
"ansible_selinux": {
"config_mode": "enforcing",
"mode": "enforcing",
"policyvers": 28,
"status": "enabled",
"type": "targeted"
},
"ansible_ssh_host_key_ecdsa_public": "AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBEp5iF/lAqB9Q9FNKfnsi3mLJSVvvooVhRRcuGTBHEJs+TaM36oBaIr764IX1zdn2sWFLdYgmcuaAeiPu3fK+UU=",
"ansible_ssh_host_key_rsa_public": "AAAAB3NzaC1yc2EAAAADAQABAAABAQC6yHI2+V64EMW3jDISBrzKmWurP7uF4IqemJgowpqC3mVlFsPOSqerDoJN9hE34fViXcbLUj9wIi0kc3QzxxNwTefwJCdPSL17ns9eIEDKJqrHswts7OXYC1948bdyhyGnaW57BEfVUJ+Vt8OI1JSKkKsi3aCumaZDz9tNGCVYiqW4PMUQFaT/yEnPqKhSp8mDX/SL/unpVsctB0w37o38ZVApKPaNkHW25uiwroStLGqY4VgoZHTqHUdvqk4EZQOD0+JmBcYKVj2ABBl1sMiH8mmrc2W2Gi0gJx31Ky/t5SWQtXTdMRB3D7N9yRd1pPcnh0zebS/OPnX4G5UWX/aP",
"ansible_swapfree_mb": 0,
"ansible_swaptotal_mb": 0,
"ansible_system": "Linux",
"ansible_system_vendor": "Red Hat",
"ansible_user_id": "root",
"ansible_userspace_architecture": "x86_64",
"ansible_userspace_bits": "64",
"ansible_virtualization_role": "guest",
"ansible_virtualization_type": "kvm",
"module_setup": true
},
"changed": false
}
在實際應用中,運用的比較多的facts變數有ansible_os_family
,ansible_hostname
等,這些變數通常會被拿來作為when條件語句的判斷條件,來決定下一步的操作。一個簡單的例項:
---
- hosts: all
remote_user: root
tasks:
- name: test the list variables
shell: echo {{ ansible_os_family }}
register: results
- name: print the register result
debug: msg="{{ results.stdout }}"
執行結果如下:
ansible-playbook test.yml
PLAY [all] ********************************************************************
GATHERING FACTS ***************************************************************
ok: [10.0.102.162]
ok: [10.0.102.212]
ok: [10.0.102.200]
TASK: [test the list variables] ***********************************************
changed: [10.0.102.162]
changed: [10.0.102.212]
changed: [10.0.102.200]
TASK: [print the register result] *********************************************
ok: [10.0.102.212] => {
"msg": "RedHat" #對應變數的結果
}
ok: [10.0.102.200] => {
"msg": "RedHat"
}
ok: [10.0.102.162] => {
"msg": "RedHat"
}
PLAY RECAP ********************************************************************
10.0.102.162 : ok=3 changed=1 unreachable=0 failed=0
10.0.102.200 : ok=3 changed=1 unreachable=0 failed=0
10.0.102.212 : ok=3 changed=1 unreachable=0 failed=0
3.2 本地facts變數
我們可以自己定義facts變數,把這個變數寫入一個以.fact
結尾的檔案中,這個檔案可以是json檔案或ini檔案,或者是一個可以返回json程式碼的可執行檔案。然後將其放在遠端主機的/etc/ansible/facts.d
資料夾中,ansible在執行的任務時會自動到這個資料夾中讀取變數的資訊。
在遠端主機上做如下操作:
# 自定義fact資訊
$ mkdir -p /etc/ansible/facts.d && cd /etc/ansible/facts.d
$ cat test.fact
[test_fact]
admin=hongkong
然後再ansible主機上獲取自定義的資訊。
$ ansible 10.0.102.162 -m setup -a "filter=ansible_local"
10.0.102.162 | success >> {
"ansible_facts": {
"ansible_local": {
"test": {
"test_fact": {
"admin": "hongkong"
}
}
}
},
"changed": false
}
四、if/when/while流程控制語句
條件判斷在ansible任務中的使用頻率非常高。我們可以根據一些條件的不一樣執行不同的task。
4.1 when條件判斷
很多工只有在特定條件下才能執行,這就是when語句發揮作用的地方。
一個簡單的例項,關閉掉ip地址為10.0.102.162伺服器上的mysql服務,如下:
[root@test2 playbook]# cat test.yml
---
- hosts: all
remote_user: root
tasks:
- name: shut down the db server
service: name=mysqld state=stopped
when: ansible_eth0.ipv4.address == "10.0.102.162" # 這裡使用了when條件語句
執行的結果如下:
$ ansible-playbook test.yml
PLAY [all] ********************************************************************
GATHERING FACTS ***************************************************************
ok: [10.0.102.212]
ok: [10.0.102.200]
ok: [10.0.102.162]
TASK: [shut down the db server] ***********************************************
skipping: [10.0.102.200]
skipping: [10.0.102.212]
changed: [10.0.102.162] #162的服務狀態已經改變
PLAY RECAP ********************************************************************
10.0.102.162 : ok=2 changed=1 unreachable=0 failed=0
10.0.102.200 : ok=1 changed=0 unreachable=0 failed=0
10.0.102.212 : ok=1 changed=0 unreachable=0 failed=0
這個就是when條件語句的用法很簡單。需要注意when語句的作用於paly的作用時間,當when的條件滿足時,然後才會執行play中的任務。ansible還提供了另外兩個與when相關的語句changed_when
和failed_when
條件判斷。
五、任務間的流程控制
5.1 任務委託
預設情況下,ansible所有任務都是在我們指定的機器上面執行的,當在一個獨立的叢集環境配置時,這並沒有什麼問題。而在有些情況下,比如給某臺伺服器傳送通知或者向監控伺服器中新增被監控的主機,這個時候任務就需要在特定的主機上執行,而非一開始指定的所有主機,此時就需要ansible的委託任務。
使用delegate_to
關鍵字可以配置任務在指定的伺服器上執行,而其他任務還是在hosts關鍵字配置的所有機器上執行,當到了這個關鍵字所在的任務時,就使用委託的機器執行。
檢視MySQL是否在執行狀態,因此在檢查之前首先關掉162上的mysql服務。(為了方便檢視狀態)
---
- hosts: all
remote_user: root
tasks:
- name: stop the db server
service: name=mysqld state=stopped
delegate_to: 10.0.102.162 # 這裡使用了委託,僅關閉162這臺伺服器上,這個play僅在162這臺伺服器上執行。
- name: check mysql status
service: name=mysqld state=running
這裡委託是在指定的機器上執行,若是想在本地伺服器上執行,可以把ip地址換為127.0.0.1即可。也可以使用local_action
方法。
---
- hosts: all
remote_user: root
tasks:
- name: create the test file
local_action: shell touch test1111 # 在本地建立一個測試檔案
- name: check mysql status
service: name=mysqld state=running
結果如下:
$ ansible-playbook test.yml
PLAY [all] ********************************************************************
GATHERING FACTS ***************************************************************
ok: [10.0.102.212]
ok: [10.0.102.200]
ok: [10.0.102.162]
TASK: [create the test file] **************************************************
changed: [10.0.102.212 -> 127.0.0.1]
changed: [10.0.102.200 -> 127.0.0.1]
changed: [10.0.102.162 -> 127.0.0.1]
TASK: [check mysql status] ****************************************************
ok: [10.0.102.200]
ok: [10.0.102.212]
ok: [10.0.102.162]
PLAY RECAP ********************************************************************
10.0.102.162 : ok=3 changed=1 unreachable=0 failed=0
10.0.102.200 : ok=3 changed=1 unreachable=0 failed=0
10.0.102.212 : ok=3 changed=1 unreachable=0 failed=0
$ ls # 預設會在當前目錄建立對應的檔案
test1111 test.yml vars.yml
5.2 任務暫停
有些情況下,一些任務的執行需要等待一些狀態的恢復,比如某一臺主機或者應用剛剛重啟,我們需要等待它上面的某個埠開啟,此時我們就不得不將正在執行的任務暫停,直到其狀態滿足我們的需求。
下一個例項:
- name: wait for webserver to start
local_action:
module: wait_for
host: webserver1
port: 80
delay: 10
timeout: 300
state: startted
# 這個例項中,這個任務將會每10s檢查一次主機webserver1上面的80埠是否開啟,如果超過了300s則失敗
5.3 互動式提示
在少數情況下,ansible任務執行的過程中需要使用者輸入一些資料,這些資料要麼比較祕密不方便,或者資料是動態的,不同的使用者有不同的需求,比如輸入使用者自己的賬戶和密碼或者輸入不同的版本號會觸發不同的後續操作等。ansible的vars_prompt
關鍵字就是用來處理上述這種與使用者互動的情況的。下面是一個簡單的例項。
---
- hosts: all
remote_user: root
vars_prompt:
- name: share_user
prompt: "what is your network username?"
private: no
- name: share_pass
prompt: "what is your network password"
private: no
然後執行上面的playbook,因為我們只是測試,只需要在一臺機器上執行,因此加入了--limit
引數。
$ ansible-playbook test.yml --limit 10.0.102.162
what is your network username?: test # 需要手動互動輸入
what is your network password: 123456 # 手動輸入
PLAY [all] ********************************************************************
GATHERING FACTS ***************************************************************
ok: [10.0.102.162]
PLAY RECAP ********************************************************************
10.0.102.162 : ok=1 changed=0 unreachable=0 failed=0
手動輸入的變數值,在後面的play中仍然可以用{{ var_name }}
的形式呼叫。
關鍵字vars_prompt
幾個常用的選項總結如下:
private
:預設值為yes,表示使用者輸入的值在命令列不可見;將值設為no時,使用者輸入可見。default
:為變數設定預設值,以節省使用者輸入時間。confirm
:特別適合輸入密碼的情況,如果將其設定為yes,則會要求使用者輸入兩次,以增加輸入的安全性。
六、tags標籤
預設情況下,ansible在執行一個playbook時,會執行playbook中定義的所有任務。ansible的標籤功能可以給角色,檔案,單獨的任務甚至整個playbook打上標籤,然後利用這些標籤來指定要執行playbook中的個別任務,或不執行指定的任務,並且它的語法非常簡單。
通過一段程式碼來說明tags的用法:
---
# 可以給整個playbook的所有任務打一個標籤。
- hosts: all
tags: deploy
roles:
# 給角色打的標籤將會應用與角色下所有的任務。
- {role: tomcat, tags : ["tomcat", "app"]} # 一個物件新增多個tag的寫法之一
tasks:
- name: Notify on completion
local_action:
module: osx_say
msg: "{{inventory_hostname}} is finished"
voice: Zarvox
tags: # 一個物件新增多個tag寫法之二
- notifications
- say
- include: foo.yml
tags: foo
# 縮排可能不太對
將上述程式碼儲存,可以通過以下命令來只執行Notify on completion
任務。
$ ansible-playbook test.yml --tags "say"
如果想忽略掉某個任務,可以使用--skip-tags
關鍵字指定。
七、Block塊
ansible從2.0.0版本開始引入了塊功能。塊功能可以將任務進行分組,並且可以在塊級別上應用任務變數。同時,塊功能還可以使用類似於其他程式語言處理異常那樣的方法,來處理塊內部的任務異常。
---
- hosts: all
remote_user: root
tasks:
- block:
- yum: name=httpd state=present
- service: name=httpd state=started enabled=no
when: ansible_eth0.ipv4.address == "10.0.102.162"
- block:
- yum: name=nginx state=present
- service: name=nginx state=started enabled=no
when: ansible_eth0.ipv4.address == "10.0.102.200"
執行結果如下:
$ ansible-playbook -i hosts test.yml
PLAY [all] **************************************************************************************************************************************************************************************
TASK [Gathering Facts] **************************************************************************************************************************************************************************
ok: [10.0.102.162]
ok: [10.0.102.200]
TASK [yum] **************************************************************************************************************************************************************************************
skipping: [10.0.102.200] # 因為在inventory檔案中註釋了這一臺伺服器,因此這裡忽略了。
ok: [10.0.102.162]
TASK [service] **********************************************************************************************************************************************************************************
skipping: [10.0.102.200]
changed: [10.0.102.162]
TASK [yum] **************************************************************************************************************************************************************************************
skipping: [10.0.102.162]
ok: [10.0.102.200]
TASK [service] **********************************************************************************************************************************************************************************
skipping: [10.0.102.162]
changed: [10.0.102.200]
PLAY RECAP **************************************************************************************************************************************************************************************
10.0.102.162 : ok=3 changed=1 unreachable=0 failed=0
10.0.102.200 : ok=3 changed=1 unreachable=0 failed=0
上面的playbook和之前的並沒有什麼不同,只是假如了block之後,程式碼更容易檢視。
塊功能可以用來處理任務的異常。比如一個ansible任務時監控一個並不太重要的應用,這個應用的正常執行與否對後續的任務並不產生影響,這時候我們就可以通過塊功能來處理這個應用的報錯。如下程式碼:
tasks:
- block:
- name: shell script to connect the app ti a mointoring service.
script: mointoring-connect.sh
rescue:
- name:只有指令碼報錯時才執行
debug:msg="There was an error in the block"
always:
- name: 無論結果如何都執行
debug: msg="This always executes"
當塊中任意任務出錯時,rescue關鍵字對應的程式碼塊就會被執行,而always關鍵字對應的程式碼塊無論如何都會被執行。