ansible入門四（Ansible playbook基礎組件介紹）

本節內容：

• ansible playbook介紹
• ansible playbook基礎組件
• playbook中使用變量

 

1、ansible playbook介紹

playbook是由一個或多個「play」組成的列表(劇本是由多出戲組成的)。play的主要功能在於將事先歸併爲一組的主機裝扮成事先經過ansible中的task定義好的角色。從根本上來說，所謂task無非是調用ansible的一個module。將多個play組織在一個playbook中，便可以讓它們聯同起來按事先編排的機制同唱一臺大戲。下面是一個簡單示例。

- hosts: webnodes
  vars:
  http_port: 80
  max_clients: 256
  remote_user: root
  tasks:          
  - name: ensure apache is at the latest version
    yum: name=httpd state=latest
  - name: ensure apache is running
    service: name=httpd state=started
    handlers:
    - name: restart apache
      service: name=httpd state=restarted

其中，tasks是一個一個任務。

 

2、ansible playbook基礎組件

Playbooks結構：

• Tasks：任務，即調用模塊完成的某操做。
• Variables：變量
• Templates：模板
• Handlers：處理器，指的是在某條件知足時可以觸發完成的功能，或者說是由某事件觸發執行的操做
• Roles：角色。

 

1. Hosts和Users

playbook中的每個play的目的都是爲了讓某個或某些主機以某個指定的用戶身份執行任務。hosts用於指定要執行指定任務的主機，其能夠是一個或多個由冒號分隔主機組；remote_user則用於指定遠程主機上的執行任務的用戶。如上面示例中的

- hosts: webnodes
  remote_user: root

不過，remote_user也可用於各task中。也能夠經過指定其經過sudo的方式在遠程主機上執行任務，其可用於play全局或某任務；此外，甚至能夠在sudo時使用sudo_user指定sudo時切換的用戶。

- hosts: webnodes
  remote_user: mageedu
  tasks:
  - name: test connection
    ping:
    remote_user: mageedu
    sudo: yes

好比寫一個最簡單的playbook，裏面寫了兩個play，一個play是在nginx組的主機上都建立一個nginx組，nginx用戶，另外一個play是複製一個文件到mysql組的主機上：

[root@node1 ~]# vim nginx.yml
- hosts: nginx                                                                                                                                
  remote_user: root
  tasks:
  - name: create nginx group
    group: name=nginx system=yes gid=208
  - name: create nginx user
    user: name=nginx uid=208 group=nginx system=yes
- hosts: mysql
  remote_user: root
  tasks:
  - name: copy file to mysql hosts
    copy: src=/etc/inittab dest=/tmp/inittab.ans

 

查看ansible-playbook的使用方法：

[root@node1 ~]# man ansible-playbook

運行playbook：

[root@node1 ~]# ansible-playbook nginx.yml

 

2. 任務列表(Tasks)和action

play的主體部分是task list。task list中的各任務按次序逐個在hosts中指定的全部主機上執行，即在全部主機上完成第一個任務後再開始第二個。在運行自下而下某playbook時，若是中途發生錯誤，全部已執行任務均可能回滾，所以，在更正playbook後從新執行一次便可。(由於具備冪等性)

task的目的是使用指定的參數執行模塊，而在模塊參數中可使用變量。模塊執行是冪等的，這意味着屢次執行是安全的，由於其結果均一致。

每一個task都應該有其name，用於playbook的執行結果輸出，建議其內容儘量清晰地描述任務執行步驟。若是未提供name，則action的結果將用於輸出。

定義task的可使用「action: module options」(這個在較新版本上才能執行)或「module: options」的格式，推薦使用後者以實現向後兼容。若是action一行的內容過多，也可使用在行首使用幾個空白字符進行換行。

tasks:
- name: make sure apache is running
  service: name=httpd state=running

 

在衆多模塊中，只有command和shell模塊僅須要給定一個列表而無需使用「key=value」格式，例如：

tasks:
- name: disable selinux
  command: /sbin/setenforce 0

 

若是命令或腳本的退出碼不爲零，可能會阻止playbook繼續往下執行可使用以下方式替代：

tasks:
- name: run this command and ignore the result
  shell: /usr/bin/somecommand || /bin/true

也就是說這個命令失敗也是要繼續往下走的，就是失敗了但不要影響下面的操做。或者使用ignore_errors來忽略錯誤信息：

tasks:
- name: run this command and ignore the result
  shell: /usr/bin/somecommand
  ignore_errors: True

 

3. handlers

用於當關注的資源發生變化時採起必定的操做。

「notify」這個action可用於在每一個play的最後被觸發，這樣能夠避免屢次有改變發生時每次都執行指定的操做，取而代之，僅在全部的變化發生完成後一次性地執行指定操做。在notify中列出的操做稱爲handler，也即notify中調用handler中定義的操做。

- name: template configuration file
  template: src=template.j2 dest=/etc/foo.conf
  notify:
  - restart memcached
  - restart apache    

handler是task列表，這些task與前述的task並無本質上的不一樣。

handlers:
- name: restart memcached
  service:  name=memcached state=restarted
- name: restart apache
  service: name=apache state=restarted

 

【舉例】：好比有個配置apache的playbook，而後利用這個來講明handlers。

1.先建立一個apache.yml，裏面定義play安裝啓動apache

[root@node1 ~]# vim apache.yml
- hosts: mysql
  remote_user: root
  tasks:
  - name: install httpd package
    yum: name=httpd state=latest
  - name: install configuration file for httpd
    copy: src=/root/conf/httpd.conf dest=/etc/httpd/conf/httpd.conf 
  - name: start httpd service 
    service: enabled=true name=httpd state=started
[root@node1 ~]# ansible-playbook apache.yml

2.假如說某個時刻httpd.conf發生改變了，好比說再也不監聽在80，而是監聽在8080端口，其餘沒變。修改/root/conf/httpd.conf，把端口改爲8080，再執行這個playbook：

[root@node1 ~]# ansible-playbook apache.yml

到mysql組所在的主機172.16.7.153上查看端口，發現監聽端口仍然是80：

[root@node3 ~]# ss -tnlp

3.一個程序的配置文件發生了改變，那麼程序應該重讀配置文件纔對。然而默認狀況下，你屢次唱同一個劇本，若是那個task此前執行過，爲了保證冪等性，它是不會再被執行。handlers就是爲了解決這種問題而生的。Handlers也是任務，但它不是上來就執行的，只有某個條件知足時纔會執行。因此咱們去修改apache.yml：

- hosts: mysql
  remote_user: root
  tasks:
  - name: install httpd package
    yum: name=httpd state=latest
  - name: install configuration file for httpd
    copy: src=/root/conf/httpd.conf dest=/etc/httpd/conf/httpd.conf 
    notify:
    - restart httpd
    - name: start httpd service 
      service: enabled=true name=httpd state=started
   handlers:
   - name: restart httpd
     service: name=httpd state=restarted

修改/root/conf/httpd.conf，把端口改爲8090，再執行這個playbook：

[root@node1 ~]# ansible-playbook apache.yml

到mysql組所在的主機172.16.7.153上查看端口，發現監聽端口改變了，變成了8090：

 

3、playbook中使用變量

- hosts: mysql
  remote_user: root
  vars:
  - package: httpd
  tasks:
  - name: install httpd package
    yum: name={{ package }} state=latest                                                                                                      
  - name: install configuration file for httpd
    copy: src=/root/conf/httpd.conf dest=/etc/httpd/conf/httpd.conf 
    notify:
    - restart httpd
  - name: start httpd service 
    service: enabled=true name=httpd state=started
  handlers:
  - name: restart httpd
    service: name=httpd state=restarted

【注意】：playbook中能使用的變量不只僅是這裏定義的變量，而是可使用ansible中定義的全部變量。例如：

[root@node1 ~]# ansible 172.16.7.152 -m setup

 

另外，在inventory中定義的變量也能夠在playbook中調用。例如：

[root@node1 ~]# vim /etc/ansible/hosts