一、ansible介紹
Ansible Playbooks 提供了一個可重復、可重用、簡單的配置管理和多機部署系統，非常適合部署復雜的應用程序。Ansible Playbook 是自動化任務的藍圖，這些任務是復雜的 IT 操作，在有限或沒有人為參與的情況下執行。Ansible Playbook 在一組、組或分類的主機上執行，它們共同構成一個 Ansible 清單。
Ansible Playbook 本質上是框架，是預先編寫的代碼，開發人員可以使用 ad-hoc 或作為起始模板。Ansible Playbooks 經常用于自動化IT 基礎設施（例如操作系統和Kubernetes平臺）、網絡、安全系統和開發人員角色（例如 Git）。
Ansible Playbooks 可幫助 IT 人員對應用程序、服務、服務器節點或其他設備進行編程，而無需從頭開始創建所有內容的手動開銷。Ansible Playbook 以及其中的條件、變量和任務可以無限期地保存、共享或重復使用。
- playbook 是由一個或多個play組成的列表。
- play的主要功能在于將直線歸并為一組的主機裝扮實現通過ansible中的task定義好的角色。從根本來講，所謂的task無非是調用ansible的一個module。將多個play組織在一個playbook內，即可以讓它們聯動起來按實現編排的機制唱一臺大戲。
- playbook采用YAML語言編寫。
二、ansible playbook 如何工作？
Ansible 模塊執行任務。可以組合一個或多個 Ansible 任務來進行游戲。可以組合兩個或多個劇本來創建 Ansible Playbook。Ansible Playbook 是針對主機自動執行的任務列表。主機組構成您的 Ansible 清單。
Ansible Playbook 中的每個模塊都執行特定的任務。每個模塊都包含元數據，這些元數據確定執行任務的時間和地點，以及執行任務的用戶。還有數以千計的其他 Ansible 模塊可以執行各種 IT 任務。
三、什么是 yaml？
YAML是一個可讀性高的用來表達資料序列的格式，它實際上是一種標記語言。不論是在運維工作中還是開發工作中，yaml語言都是一個很普遍被使用的，比如：Kubernetes 中的部署清單文件、GitLab CICD、Python使用yaml格式做配置文件、json 格式的數據需要被轉成 yaml 格式的數據等等。這里不對yaml語法做更多的介紹，詳情可以自行和百度、谷歌合作了解。
四、yaml 語言的特性
- YAML的可讀性好。
- YAML和腳本語言的交互性好。
- YAML使用實現語言的數據類型。
- YAML有一個一致的信息模型。
- YAML易于實現。
- YAML可以基于流來處理。
- YAML表達能力強，擴展性好。
五、ansible-playbook的核心組成部分
- Hosts：執行的遠程主機列表。
- Tasks：任務集。
- Variables：內置變量或自定義變量在playbook中調用。
- Templates：模板，可替換模板中的變量并實現一些簡單的邏輯的文件。
- Handlers 和 notify：兩者結合使用，由特定條件觸發的操作，滿足條件方才執行，否則不執行。
- Tags：標簽，用于制定某條任務執行，用戶選擇運行playbook中的部分代碼，ansible具有冪等性，因此會自動跳過沒有辯護的部分，即便如此，有的代碼為測試其確實沒有發生變化的時間依然會非常的長，此時確信其沒有變化，就可以通過tags跳過這些代碼片段。
（1）ansible-playbook 的項目 目錄結構
[root@ayunw ansible-project]# ll
total 28
-rw-r--r--. 1 root root 122 Jul 8 10:14 00_setup.yml
-rw-r--r--. 1 root root 84 Jul 7 14:42 01_publish_ssh_key.yml
-rw-r--r--. 1 root root 78 Jul 8 14:11 02_common.yml
-rw-r--r--. 1 root root 85 Jul 8 10:34 03_install_docker.yml
drwxr-xr-x. 3 root root 124 Jul 11 09:15 files
drwxr-xr-x. 2 root root 80 Jul 8 15:26 inventory
-rw-r--r--. 1 root root 778 Jul 7 15:16 README.md
drwxr-xr-x. 5 root root 57 Jul 7 18:30 roles
[root@ayunw ansible-project]# tree roles/ -L 3
roles/
├── docker
│ ├── defaults
│ │ └── main.yml
│ ├── handlers
│ │ └── main.yml
│ ├── meta
│ │ └── main.yml
│ ├── tasks
│ │ └── main.yml
│ ├── templates
│ │ ├── daemon.json.j2
│ │ └── docker-ce.repo.j2
│ └── vars
│ └── main.yml
以上是項目是docker批量安裝。這個目錄格式是我這邊安裝項目的目錄規范。但并不是說每個目錄下的main.yml?文件都存在內容，其實很多時候我們可能用不到default/main.yml和meta/main.yml。
（2）Hosts 遠程主機列表
playbook中的每一個play的目的都是為了讓特定主機以某個指定的用戶身份執行任務。hosts用于指定要執行指定任務的主機，須事先定義在主機清單中。比如我們之前說的默認在/etc/ansible/hosts文件中：
[root@ayunw ansible-example]# cat /etc/ansible/hosts
[websrvs]
10.10.108.[30:33]
[dbsrvs]
10.10.108.30
[appsrvs]
10.10.108.[30:33]
（3）remote_user 遠程用戶
可用于Host和Task中，也可以通過指定其通過sudo的方式在遠程主機上執行任務，其可用于play全局或某任務。此外，還可以在sudo時使用sudo_user指定sudo時切換的用戶。
[root@ayunw ansible-example]# cat demo-playbook.yml
- hosts: dbsrvs
remote_user: root
tasks:
- name: pingtest
ping:
remote_user: ayunw
sudo: yes # 默認sudo為root
sudo_user: root # sudo 為root
（4）Tasks 任務集
簡單來說，Tasks 任務集其實就是使用多個ansible支持的模塊組合起來的一組任務。可以理解為 ansible-playbook 中，一個name指定的就是一個task任務。各個task按次序逐個在hosts中指定的所有主機上執行，即在所有主機上完成第一個task后，再開始第二個task。但是也可以使用異步模式。這個后面文章會說；
task的目的是使用指定的參數執行模塊，而在模塊參數中可以使用變量。模塊執行是冪等的，這意味著多次執行是安全的，因為其結果均一致。
每個task都應該有其name，用于playbook的執行結果輸出，建議起一個見名知意的名稱。
task的兩種格式：
一種是key=value?的形式，另一種是key: value的形式。
注意： 后者冒號后面有一個空格。
[root@ayunw ansible-project]# cat install_httpd.yml
---
- hosts: dbsrvs
remote_user: root
tasks:
- name: install httpd #描述信息
yum: name=httpd #調用yum模塊安裝httpd服務
- name: start httpd #同樣是描述信息
service: name=httpd state=started enabled=yes #調用service模塊啟動httpd服務并設置開機自啟
[root@ayunw ansible-project]# cat copy_files.yml
---
- hosts: dbsrvs
remote_user: root
tasks:
- name: install httpd
yum: name=httpd
- name: start httpd
service:
name: httpd
state: started
enabled: yes
以上示例中，我加了空行，存在空行和帶有 ??#?? 注釋的行不會影響 yaml 文件執行，看上去更加美觀，而不是所有 task 擠在一起，看上去一團糟。
（5）Variables 變量
通常我們會將變量信息放在roles/vars/main.yml中，格式如下：
[root@ayunw ansible-project]# cat roles/docker/vars/main.yml
EMQXNAME: emq_perf
DEPEND_PKG:
- yum-utils
- device-mapper-persistent-data
- lvm2
- bridge-utils
DOCKER_PKG:
- containerd.io-1.6.6
- docker-ce-20.10.17
- docker-ce-cli-20.10.17
（6）Templates 模板
Templates 模板主要使用Jinjia2?模板語言，以 .j2結尾，里面其實就是一個配置文件，比如：
[root@ayunw ansible-project]# cat roles/docker/templates/daemon.json.j2
{
"exec-opts": ["native.cgroupdriver=systemd"],
"log-driver": "json-file",
"log-level": "warn",
"log-opts": {
"max-size": "1g",
"max-file": "4"
},
"data-root": "/data/docker",
"storage-driver": "overlay2"
}
（7）handler 和 notify
這兩個通常結合使用，比如某一個服務配置變更后，需要重啟，那么就需要在配置變更后設置一個 notify，然后 handlers 就會在playbook退出之前執行重啟服務的操作。如果定義了handler重啟服務，而沒有定義notify，那么所有task任務執行完成后，也會觸發一次服務重啟操作。
兩個典型的示例：
示例來源于： https://docs.ansible.com/ansible/latest/user_guide/playbooks_handlers.html
示例一：?
---
- name: Verify apache installation
hosts: webservers
vars:
http_port: 80
max_clients: 200
remote_user: root
tasks:
- name: Ensure apache is at the latest version
ansible.builtin.yum:
name: httpd
state: latest
- name: Write the apache config file
ansible.builtin.template:
src: /srv/httpd.j2
dest: /etc/httpd.conf
notify:
- Restart apache
- name: Ensure apache is running
ansible.builtin.service:
name: httpd
state: started
handlers:
- name: Restart apache
ansible.builtin.service:
name: httpd
state: restarted
示例二：
tasks:
- name: Template configuration file
ansible.builtin.template:
src: template.j2
dest: /etc/foo.conf
notify:
- Restart apache
- Restart memcached
handlers:
- name: Restart memcached
ansible.builtin.service:
name: memcached
state: restarted
- name: Restart apache
ansible.builtin.service:
name: apache
state: restarted
（8）Tags 標簽
我們可以在ansible-playbook的每一個task任務上打上 tag 標簽，可以用于區分某一種類型的任務。如果你想要單獨執行這個獨有的tag標簽的任務，就可以在使用ansible-playbook命令加上 -t 參數來指定 tag 執行劇本。如：
ansible-playbook -t ayunw install_docker.yml
?六、ansible-playbook 命令
命令格式：ansible-playbook <filename.yml>...[options]
常見的 options 選項：
-C --check # 只檢測可能會發生的改變，但不真正執行操作
--list-hosts # 列出運行任務的主機
--limit # 針對主機列表中的主機執行
-v -vv -vvv # 提示過程
示例：
ansible-playbook -C install_httpd.yaml
一個簡單示例：
[root@ayunw ansible-project]# cat copy_files.yml
---
- hosts: dbsrvs
tasks:
- name: copy multi files
copy: src={{ item }} dest="/etc/yum.repos.d/" owner=root group=root mode=0644
with_items:
- "files/CentOS-Base.repo"
- "files/epel.repo"
# 更推薦的方式：
[root@ayunw ansible-project]# cat copy_files.yml
---
- hosts: dbsrvs
tasks:
- name: copy multi files
copy:
src: "{{ item }}"
dest: "/etc/yum.repos.d/"
owner: root
group: root
mode: 0644
with_items:
- "files/CentOS-Base.repo"
- "files/epel.repo"
執行劇本：
[root@ayunw ansible-project]# ansible-playbook -C cf.yml
PLAY [dbsrvs] *******************************************************************************************************************************************************************
TASK [Gathering Facts] **********************************************************************************************************************************************************
ok: [10.10.108.30]
TASK [copy multi files] *********************************************************************************************************************************************************
ok: [10.10.108.30] => (item=files/CentOS-Base.repo)
ok: [10.10.108.30] => (item=files/epel.repo)
PLAY RECAP **********************************************************************************************************************************************************************
10.10.108.30 : ok=2 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
[root@ayunw ansible-project]# ansible-playbook copy_files.yml
以上內容就是針對ansible-playbook劇本的一個介紹和簡單的使用。當然它的功能遠不止于此。還有更多更高級的用法。
