Ansible常用模塊的介紹和使用

這篇文章為大家分享Ansible常用模塊的介紹和使用。文章涵蓋inventory主機(jī)清單、YAML語言介紹、實(shí)現(xiàn)playbook劇本等內(nèi)容，希望大家通過這篇文章能有所收獲。

inventory主機(jī)清單

ansible默認(rèn)的主機(jī)清單是/etc/ansible/hosts文件，主機(jī)清單可以手動設(shè)置，也可以通過Dynamic Inventory動態(tài)生成，一般主機(jī)名使用FQDN

vim /etc/ansible/hosts
[webserver]                          #方括號設(shè)置組名
www1.example.org              #定義被監(jiān)控主機(jī)，這邊可以是主機(jī)名也可以是IP地址，主機(jī)名需要修改/etc/hosts文件
www2.example.org:2222     #冒號后定義遠(yuǎn)程連接端口，默認(rèn)是ssh的22端口

如果是名稱類似的主機(jī)，可以使用列表的方式標(biāo)識各個主機(jī)

[webserver]
www[01:50].example.org ansible_ssh_user=root ansible_ssh_pass=123456

[dbbservers]
db-[a:f].example.org

inventory變量

• 主機(jī)變量

[webserver]
www1.magedu.com http_port=80 maxRequestsChild=808
www2.magedu.com http_port=8080 maxRequestsChild=909

• 組變量

[servers:vars]
ntp_server=ntp.example.org
nfs_server=nfs.example.org

• 組嵌套

[apache]
http1.example.org
http2.example.org

[nginx]
ngx1.example.org
ngx2.example.org

[webservers:children]
apache
nginx

• inventory變量參數(shù)

YAML標(biāo)記語言

YAML：另一種標(biāo)記語言。是用來寫配置文件的語言，非常簡潔和強(qiáng)大。
YAML語法和其他語言類似，也可以表達(dá)散列表、標(biāo)量等數(shù)據(jù)結(jié)構(gòu)。
結(jié)構(gòu)通過空格來展示；序列里配置項(xiàng)通過-來代表；Map里鍵值用:來分隔;YAML的擴(kuò)展名為yaml

• 基本語法規(guī)則

  1.大小寫敏感
  2.使用縮進(jìn)表示層級關(guān)系
  3.縮進(jìn)時不允許使用Tab鍵，只允許使用空格。
  4.縮進(jìn)的空格數(shù)目不重要，只要相同層級的元素左側(cè)對齊即可

• YAML支持的數(shù)據(jù)結(jié)構(gòu)

  1.對象：鍵值對的集合，又稱為映射（mapping）/ 哈希（hashes） / 字典（dictionary）
  例如：name:Example Developer
      鍵     值
  2.數(shù)組：一組按次序排列的值，又稱為序列（sequence） / 列表（list）
  例如：-Apple
     -Orange
  3.純量：單個的、不可再分的值
  例如：number：12.30
     sure：true

yaml實(shí)例：

name:zhangsan
age:20
name:lisi
age:22
people：

-name:zhangsan
      age:20
      -name:lisi
      age:22

Ansible劇本-playbook

Playbook是一種完全不同的運(yùn)用ansible的方式，類似與saltstack的state狀態(tài)文件。ad-hoc無法持久使用，playbook可以持久使用。
playbook是由一個或多個play組成的列表，play的主要功能在于將事先歸并為一組的主機(jī)裝扮成事先通過ansible中的task定義好的角色。從根本上來講，所謂的task無非是調(diào)用ansible的一個module。將多個play組織在一個playbook中，即可以讓它們聯(lián)合起來按事先編排的機(jī)制完成某一任務(wù)。通過task調(diào)用ansible的模板將多個play組織在一個playbook中運(yùn)行。

Playbook核心元素

Playbook語法

1、playbook使用yaml語法格式，后綴可以是yaml,也可以是yml。
在單一的一個playbook文件中，可以連續(xù)三個連子號(---)區(qū)分多個play。還有選擇性的連續(xù)三個點(diǎn)好(...)用來表示play的結(jié)尾，也可省略。
2、當(dāng)行開始正常寫playbook的內(nèi)容，一般都會寫上描述該playbook的功能。
3、使用#號注釋代碼。
4、縮進(jìn)必須統(tǒng)一，不能空格和tab混用?？s進(jìn)的級別也必須是一致的，同樣的縮進(jìn)代表同樣的級別，程序判別配置的級別是通過縮進(jìn)結(jié)合換行實(shí)現(xiàn)的。
5、YAML文件內(nèi)容和Linux系統(tǒng)大小寫判斷方式保持一致，是區(qū)分大小寫的，k/v的值均需大小寫敏感
6、k/v的值可同行寫也可以換行寫。同行使用:分隔。v可以是個字符串，也可以是一個列表
7、一個完整的代碼塊功能需要最少元素包括 name: task

實(shí)例演示:

vim a.yaml

- hosts: webserver                  #定義的主機(jī)組，即應(yīng)用的主機(jī)
  vars:                             #定義變量
    http_port: 80
    max_clients: 200
  user: root
  tasks:                               #執(zhí)行的任務(wù)
  - 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
    notify:
    - restart apache
  - name: ensure apache is running
    service: name=httpd state=started
  handlers:                         #處理器
    - name: restart apache
      service: name=httpd state=restarted

• 執(zhí)行一個playbook的格式

ansible-playbook [yaml文件名]

實(shí)例演示：

#執(zhí)行劇本
ansible-playbook ping.yaml

參數(shù):

-k(–ask-pass)           用來交互輸入ssh密碼
-K(-ask-become-pass)    用來交互輸入sudo密碼
-u                      指定用戶

補(bǔ)充命令:

#檢查yaml文件的語法是否正確
ansible-playbook nginx.yaml --syntax-check

#檢查tasks任務(wù)
ansible-playbook nginx.yaml --list-task

#檢查生效的主機(jī)
ansible-playbook nginx.yaml --list-hosts

#指定從某個task開始運(yùn)行
ansible-playbook nginx.yaml --start-at-task='Copy Nginx.conf'

hosts和users介紹

實(shí)例演示:

vim a.yaml

- hosts: webserver               #指定主機(jī)組，可以是一個或多個組。
  remote_user: root              #指定遠(yuǎn)程主機(jī)執(zhí)行的用戶名

#執(zhí)行劇本
ansible-playbook a.yaml 

• 在原有基礎(chǔ)上為每個任務(wù)定義遠(yuǎn)程執(zhí)行用戶

!vim

- hosts: mysql
  remote_user: root             
  tasks:
    - name: test connection
      ping:
      remote_user: mysql          #指定遠(yuǎn)程主機(jī)執(zhí)行tasks的運(yùn)行用戶為mysql

#執(zhí)行playbook劇本
ansible-playbook ping.yml -k 

#驗(yàn)證語法
ansible-playbook a.yml --syntax-check

#執(zhí)行劇本
ansible-playbook a.yml 

• 指定遠(yuǎn)程主機(jī)sudo切換用戶

!vim

- hosts: mysql
  remote_user: root            
  become: yes                  #2.6版本以后的參數(shù)，之前是sudo，意思為切換用戶運(yùn)行
  become_user: mysql          #指定sudo用戶為mysql

#執(zhí)行playbook劇本
ansible-playbook ping.yml -K

#執(zhí)行劇本
ansible-playbook a.yml 

tasks列表和action

1.Play的主體部分是task列表，task列表中的各任務(wù)按次序逐個在hosts中指定的主機(jī)上執(zhí)行，即在所有主機(jī)上完成第一個任務(wù)后再開始第二個任務(wù)。
在運(yùn)行playbook時（從上到下執(zhí)行），如果一個host執(zhí)行task失敗，整個tasks都會回滾，請修正playbook 中的錯誤，然后重新執(zhí)行即可。
Task的目的是使用指定的參數(shù)執(zhí)行模塊，而在模塊參數(shù)中可以使用變量，模塊執(zhí)行時冪等的，這意味著多次執(zhí)行是安全的，因?yàn)槠浣Y(jié)果一致。
2.每一個task必須有一個名稱name，這樣在運(yùn)行playbook時，從其輸出的任務(wù)執(zhí)行信息中可以很好的辨別出是屬于哪一個task的。如果沒有定義name，‘a(chǎn)ction’的值將會用作輸出信息中標(biāo)記特定的task。
3.定義一個task，常見的格式:”module: options” 例如：yum: name=httpd
4.ansible的自帶模塊中，command模塊和shell模塊無需使用key=value格式

實(shí)例演示:

• 實(shí)例1

vim a.yml 

- hosts: webserver
  remote_user: root
  tasks:
   - name: disable selinux
     command: '/sbin/setenforce 0'
   - name: make sure apache is running
     service: name=httpd state=started
#play中只要執(zhí)行命令的返回值不為0，就會報(bào)錯，tasks停止

#檢查語法
ansible-playbook a.yml --syntax-check

#執(zhí)行劇本
ansible-playbook a.yml 

#檢查結(jié)果
rpm -q httpd

修改如下內(nèi)容:

!vim

- hosts: webserver
  remote_user: root
  tasks:
   - name: disable selinux
     command: '/sbin/setenforce 0'
     ignore_errors: True             #忽略錯誤，強(qiáng)制返回成功
   - name: make sure apache is running
     service: name=httpd state=started

#檢查語法
ansible-playbook a.yml --syntax-check

#執(zhí)行劇本
ansible-playbook a.yml 

• 實(shí)例2

vim b.yml 

- hosts: webserver
  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
     copy: src=/etc/inittab dest=/opt/inittab.back

#檢查語法
ansible-playbook b.yml --syntax-check

#執(zhí)行劇本
ansible-playbook b.yml

Handlers介紹

Handlers也是一些task的列表，和一般的task并沒有什么區(qū)別。
是由通知者進(jìn)行的notify，如果沒有被notify，則Handlers不會執(zhí)行，假如被notify了，則Handlers被執(zhí)行
不管有多少個通知者進(jìn)行了notify，等到play中的所有task執(zhí)行完成之后，handlers也只會被執(zhí)行一次

實(shí)例演示:

vim c.yml

- 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:
      -restart httpd
   - name: start httpd service
     service: enabled=true name=httpd state=started
  handlers:
   - name: restart httpd
     service: name=httpd state=restarted

#檢查語法
ansible-playbook c.yml --syntax-check

#執(zhí)行劇本
ansible-playbook c.yml

亦可引入一些變量:

!vim

- 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
     service: name={{service}} state=restarted

#檢查語法
ansible-playbook c.yml --syntax-check

#執(zhí)行劇本
ansible-playbook c.yml

playbook使用變量的方法

1.通過ansible命令傳遞

實(shí)例演示:

#編輯如下yml
vim a.yml

- hosts: mysql
  remote_user: root
  vars:
  - user:
  tasks:
  - name: add new user
    user: name={{user}}

#執(zhí)行劇本
ansible-playbook a.yml -e "user=testvar"

#執(zhí)行命令查看文件
ansible mysql -m command -a 'tail /etc/passwd'

2.直接在yaml中定義變量---如上handlers示例

3.直接引用一些變量

實(shí)例演示:

• 引用ansible的固定變量

vim test.yml

- hosts: mysql
  remote_user: root
  tasks:
   - name: copy file
     copy: content="{{ansible_all_ipv4_addresses}}," dest=/opt/vars.txt

#執(zhí)行劇本
ansible-playbook test.yml

#在122主機(jī)上查看vars.txt文件內(nèi)容
cat /opt/vars.txt

• 引用主機(jī)變量

vim /etc/ansible/hosts

#在mysql組的主機(jī)后面添加如下內(nèi)容
[mysql]
192.168.142.122 testvar="42.122"    #定義testvar變量的值為42.122

vim test.yml      #添加{{testvar}}主機(jī)變量

- hosts: mysql
  remote_user: root
  tasks:
   - name: copy file
     copy: content="{{ansible_all_ipv4_addresses}},{{testvar}}" dest=/opt/vars.txt

#執(zhí)行劇本
ansible-playbook test.yml

#在122主機(jī)上查看vars.txt文件內(nèi)容
cat /opt/vars.txt

條件測試

如果需要根據(jù)變量、facts（setup）或此前任務(wù)的執(zhí)行結(jié)果來作為某task執(zhí)行與否的前提時要用到條件測試，在Playbook中條件測試使用when子句。
在task后添加when子句即可使用條件測試：when子句支持正則表達(dá)式或語法。

實(shí)例演示:

vim when.yml

- hosts: mysql
  remote_user: root
  tasks:
    - name: "shutdown CentOS"
      command: /sbin/shutdown -h now
      when: ansible_distribution == "CentOS"

#執(zhí)行劇本,執(zhí)行后會發(fā)現(xiàn)192.168.142.122主機(jī)已經(jīng)被關(guān)機(jī)
ansible-playbook when.yml 

• 多條件判斷

vim when.yml

- hosts: mysql
  remote_user: root
  tasks:
    - name: "shut down CentOS 6 systems"
      command: /sbin/shutdown -r now
      when:
        - ansible_distribution == "CentOS"
        - ansible_distribution_major_version == "6"

#執(zhí)行劇本
ansible-playbook when.yml 

• 組條件判斷

vim 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")

#執(zhí)行劇本
ansible-playbook when.yml 

• 自定義變量進(jìn)行條件測試

vim 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")

#執(zhí)行劇本
ansible-playbook when.yml 

迭代

當(dāng)有需要重復(fù)性執(zhí)行的任務(wù)時，可以使用迭代機(jī)制。其使用格式為將需要迭代的內(nèi)容定義為item變量引用，并通過with_items語句指明迭代的元素列表即可。

實(shí)例演示:

vim  d.yml

- hosts: webserver
  remote_user: root
  tasks:
    - name: "Install Packages"
      yum: name={{ item }} state=latest
      with_items:
        - httpd
        - mysql-server
        - php

#檢查語法
ansible-playbook d.yml --syntax-check

#執(zhí)行劇本
ansible-playbook d.yml

#在所有主機(jī)上查看是否有指定添加的用戶
tail -5 /etc/passwd

亦可自行定義:

vim e.yml

- 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'}

#檢查語法
ansible-playbook e.yml --syntax-check

#執(zhí)行劇本
ansible-playbook e.yml

#在所有主機(jī)上查看是否有指定添加的用戶
tail -5 /etc/passwd

Templates模塊

#創(chuàng)建工作目錄
mkdir templates

#復(fù)制配置文件
cp /etc/httpd/conf/httpd.conf templates/httpd.conf.02

#修改httpd.conf.02文件
vim templates/httpd.conf.02
Listen {{http_port}}
ServerName {{ansible_fqdn}}
MaxClients {{maxClients}}

#修改ansible/hosts文件
vim /etc/ansible/hosts
[webserver]
192.168.142.121 http_port=80 maxClients=100
192.168.142.122 http_port=8080 maxClients=200

#編寫劇本
vim apache.yml

- 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
     template: src=/root/templates/httpd.conf.2 dest=/etc/httpd/conf/httpd.conf
     notify:
      - restart httpd
   - name: start httpd service
     service: enabled=true name={{service}} state=started
  handlers:
   - name: restart httpd
     service: name={{service}} state=restarted

#檢查語法
ansible-playbook e.yml --syntax-check

#執(zhí)行劇本
ansible-playbook apache.yml

#在兩臺被管理服務(wù)器上查看
grep -i listen /etc/httpd/conf/httpd.conf
grep -i maxClient /etc/httpd/conf/httpd.conf
grep -i servername /etc/httpd/conf/httpd.conf

tags模塊

在一個playbook中，我們一般會定義很多個task，如果我們只想執(zhí)行其中的某一個task或多個task時就可以使用tags標(biāo)簽功能了。
格式如下：

vim 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

#檢查語法
ansible-playbook e.yml --syntax-check

#執(zhí)行劇本
ansible-playbook hosts.yml --tags="only"
ansible-playbook hosts.ym

事實(shí)上，不光可以為單個或多個task指定同一個tags。playbook還提供了一個特殊的tags為always。作用就是當(dāng)使用always當(dāng)tags的task時，無論執(zhí)行哪一個tags時，定義有always的tags都會執(zhí)行。

實(shí)例演示:

vim 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
      tags:
      - always

#檢查語法
ansible-playbook e.yml --syntax-check

#為了不影響此次操作刪除遠(yuǎn)程主機(jī)中/opt/hosts文件
rm -rf /opt/hosts 

#執(zhí)行劇本
ansible-playbook hosts.yml --tags="only"

#分別在兩臺被管理服務(wù)器上去查看文件創(chuàng)建情況
ls /opt/

看完上述內(nèi)容，你們對Ansible常用模塊有進(jìn)一步的了解嗎？如果還想學(xué)到更多技能或想了解更多相關(guān)內(nèi)容，歡迎關(guān)注億速云行業(yè)資訊頻道，感謝各位的閱讀！