Ansible File：從多個方面詳解

一、Ansible File 是什麼？

Ansible File 是 Ansible 中的一種特殊的實體，它通常指的是 Ansible Playbook 或者 Ansible Task 的文件。

Ansible Playbook 是 Ansible 中用於定義一組任務或者一組相關任務集合的 YAML 文件。一個 Playbook 可以包含多個 Task，每個 Task 可以包含多個 Modules；

Ansible Task 是 Playbook 的一部分，它通常是由一個 YAML 文件定義的。每個 Task 都描述了一個操作，這些操作通常是在遠程主機上執行的；

二、Ansible File 如何使用？

使用 Ansible File 通常需要按照以下幾個步驟進行：

1. 定義 Inventory

Inventory 是 Ansible 中管理多個主機或者主機組的配置文件。可以使用以下幾個方法來定義 Inventory：

# 創建一個 inventory 文件
$ vim inventory

# 在文件中定義主機列表
[web]
192.168.0.101
192.168.0.102
192.168.0.103

2. 定義 Playbook 或者 Task 文件

創建一個 Playbook 文件的基本格式如下：

# 創建一個 playbook 文件
$ vim playbook.yml

# 定義 Playbook 的基本結構
---
- name: playbook_name
  hosts: group_name  # 定義 Inventory 中的主機組
  gather_facts: true  # 是否收集主機信息
  tasks:
    - name: task_name   # Task 的名字
      module: module_name  # 執行的模塊
      args:    # 模塊參數
        key: value
      register: result  # 將執行結果保存在變數中

3. 執行 Playbook 或者 Task

執行 Playbook 或者 Task 有以下兩種方式：

• 通過 ansible-playbook 命令來執行 Playbook：

# 執行 playbook
$ ansible-playbook -i inventory playbook.yml

• 通過 ansible 命令來直接執行 Task：

# 執行 task
$ ansible -i inventory -m module_name -a "key=value" group_name

三、Ansible File 的例子

下面是一個簡單的 Ansible Playbook 文件 example.yml，它的作用是在四台遠程主機上安裝 nginx 並啟動服務：

- name: Install and start nginx
  hosts: web
  become: yes
  tasks:
  - name: Install nginx
    apt:
      name: nginx
      state: present
  - name: Start nginx
    service:
      name: nginx
      state: started

四、Ansible File 的常見問題

1. Ansible File 如何避免重複運行？

Ansible 通過記錄每個 Task 執行的狀態來避免重複運行。如果一個 Task 的狀態已經是 ok 或者 changed，則不會重新執行。可以使用以下方法來查看 Ansible Task 的狀態：

# 使用 ansible-playbook 命令查看 Playbook 的狀態
$ ansible-playbook -i inventory playbook.yml --check

# 使用 --list-tasks 選項查看 Playbook 的所有 Task
$ ansible-playbook -i inventory playbook.yml --list-tasks

# 使用 --start-at-task 選項從指定的 Task 開始執行
$ ansible-playbook -i inventory playbook.yml --start-at-task="task_name"

2. 如何指定 Ansible Playbook 的運行順序？

Ansible Playbook 是按照 Task 的定義順序依次執行的。如果需要指定 Playbook 的運行順序，可以使用以下方法：

• 添加 tags 屬性並使用 –tags 或 –skip-tags 選項選擇需要運行的 Task。
• 使用 import_tasks 和 include_tasks 導入其他 Task。

以下是使用 tags 屬性的例子：

- name: Install and configure Apache
  hosts: web
  tasks:
  - name: Install Apache
    apt:
      name: apache2
  - name: Configure Apache
    template:
      src: templates/my.apache.conf.j2
      dest: /etc/apache2/conf.d/my.conf
    tags:
      - config
  - name: Restart Apache
    service:
      name: apache2
      state: restarted
    tags:
      - restart

使用 –tags 和 –skip-tags 選項可以指定需要或者不需要運行的 Task：

# 只運行 tags 為 config 的 Task
$ ansible-playbook -i inventory playbook.yml --tags=config

# 跳過 tags 為 restart 的 Task
$ ansible-playbook -i inventory playbook.yml --skip-tags=restart

3. 如何在 Ansible 中使用變數？

變數在 Ansible 中用於存儲需要在 Playbook 或者 Task 中使用的值。可以使用以下幾種方式定義變數：

• 定義全局變數：在 ansible.cfg 文件中定義的變數是全局可用的。
• 定義 Inventory 變數：在 Inventory 文件中為特定的主機或者主機組定義變數。
• 定義 Playbook 變數：在 Playbook 文件中為特定的 Playbook 或者 Task 定義變數，這些變數只在當前 Playbook 或者 Task 中可用。
• 定義 Task 變數：在 Task 文件中為特定的 Task 定義變數，這些變數只在當前 Task 中可用。

示例代碼：

定義 Playbook 變數：

- name: Install and configure Apache
  hosts: web
  vars:
    apache_port: 80
  tasks:
  - name: Install Apache
    apt:
      name: apache2
  - name: Configure Apache
    template:
      src: templates/my.apache.conf.j2
      dest: /etc/apache2/conf.d/my.conf
    vars:
      apache_port: 8080
  - name: Restart Apache
    service:
      name: apache2
      state: restarted

定義 Task 變數：

- name: Install and configure Nginx
  hosts: web
  tasks:
  - name: Install Nginx
    apt:
      name: nginx
  - name: Configure Nginx
    template:
      src: templates/my.nginx.conf.j2
      dest: /etc/nginx/sites-enabled/my.conf
    vars:
      nginx_port: 80
      nginx_root: /var/www/mysite
  - name: Restart Nginx
    service:
      name: nginx
      state: restarted

五、總結

Ansible File 是 Ansible 中非常重要的一部分。它主要用於定義和執行任務，以達到自動化部署和配置的目的。通過本文的介紹，相信讀者對 Ansible File 的使用方法以及一些常見問題有了更深入的了解。