在自動化運維的過程中，我們經常需要從遠程主機下載文件到本地，以便進行分析或備份。Ansible的fetch模塊正是為了滿足這一需求而設計的，它可以幫助我們輕松地從遠程主機獲取文件，并將其保存到本地指定的位置。在這篇文章中，我們將詳細探討如何使用fetch模塊，以及它在實際工作中的常見應用場景。

fetch模塊的功能

fetch模塊的主要功能是從目標主機（被管理主機）中抓取指定的文件或目錄，并將其下載到控制主機的指定路徑下。常見的應用場景包括：

• 從遠程主機抓取日志文件進行分析。
• 從遠程主機下載配置文件進行備份。
• 抓取診斷數據或錯誤信息供后續處理。

fetch模塊的常用參數

fetch模塊的基本用法

(1) 從遠程主機抓取文件

最簡單的用法是從遠程主機上抓取一個文件并保存到本地控制主機上。

ansible node1 -m fetch \
-a "src=/var/log/auth.log dest=/tmp/"

在這個例子中，我們從 node1 組中的主機上指定要下載的文件路徑（通過 src 參數），然后指定這些文件在本地控制主機上的保存位置（通過 dest 參數）。文件將會被下載并保存到你指定的目錄中。

執行完上述的命令后，輸出如下圖的結果：

(2) 抓取多個文件

如果需要抓取多個文件，建議采用playbook的方式，并利用with_items循環來輕松實現對多個文件的處理。這種方式既靈活又高效。

- name:從遠程主機抓取多個日志文件
hosts:node1
tasks:
-name:從遠程主機抓取多個日志文件
    ansible.builtin.fetch:
      src:"{{ item }}"
      dest:/tmp/logs/
    with_items:
      -/var/log/mail.log
      -/var/log/syslog.2.gz

然后你只需要運行下面的命令：

ansible-playbook download.yml

執行完上述命令后，輸出如下結果：

(3) 保留原有目錄結構

默認情況下，fetch模塊會將遠程文件下載到目標路徑下，是保留原有的目錄結構。如果需要不保留遠程主機的目錄結構，可以使用flat: yes參數。

ansible node1 -m fetch \
-a "src=/var/log/syslog dest=/tmp/ flat=yes"

此時，文件syslog將不被保留原有的目錄結構，并下載到/tmp/syslog。如下圖所示：

(4) 文件不存在時的錯誤處理

如果遠程文件不存在，fetch模塊會報錯。可以通過fail_on_missing: no來防止錯誤拋出，控制任務繼續執行。

ansible node1 -m fetch \
-a "src=/var/log/nonexistent.log dest=/tmp/logs/ fail_on_missing=no"

(5) 使用checksum驗證文件

在抓取文件時，可以啟用validate_checksum來驗證文件的checksum，確保文件的完整性。

ansible node1 -m fetch \
-a "src=/var/log/syslog dest=/tmp/logs/ validate_checksum=yes"

fetch模塊的高級用法

(1) 下載目錄

fetch模塊不僅支持下載單個文件，還支持下載整個目錄。

ansible node1 -m fetch \
-a "src=/home/user/data/ dest=/tmp/data_backup/"

此命令會將遠程主機上的/home/user/data/目錄及其內容遞歸下載到本地控制主機的/tmp/data_backup/目錄中，保留目錄結構。

(2) 使用register和debug輸出文件信息

可以使用register來保存抓取的文件信息，并通過debug模塊查看抓取的文件路徑等詳細信息。

- name:從遠程主機抓取文件并保存結果
hosts:node1
tasks:
-name:從遠程主機抓取文件并保存結果
    ansible.builtin.fetch:
      src:/var/log/syslog
      dest:/tmp/log/
    register:fetched_file

-name:輸出抓取的文件信息
    ansible.builtin.debug:
      var:fetched_file

總結

Ansible的fetch模塊為我們提供了簡單高效的遠程文件下載解決方案。無論是抓取單個文件、多個文件，還是整個目錄，它都能輕松完成任務。通過結合使用flat、fail_on_missing等參數，我們可以靈活應對各種場景。掌握fetch模塊，將極大提高我們的自動化運維效率。