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

fetch模塊的功能

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

• 從遠(yuǎn)程主機(jī)抓取日志文件進(jìn)行分析。
• 從遠(yuǎn)程主機(jī)下載配置文件進(jìn)行備份。
• 抓取診斷數(shù)據(jù)或錯誤信息供后續(xù)處理。

fetch模塊的常用參數(shù)

fetch模塊的基本用法

(1) 從遠(yuǎn)程主機(jī)抓取文件

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

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

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

執(zhí)行完上述的命令后，輸出如下圖的結(jié)果：

(2) 抓取多個文件

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

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

然后你只需要運(yùn)行下面的命令：

ansible-playbook download.yml

執(zhí)行完上述命令后，輸出如下結(jié)果：

(3) 保留原有目錄結(jié)構(gòu)

默認(rèn)情況下，fetch模塊會將遠(yuǎn)程文件下載到目標(biāo)路徑下，是保留原有的目錄結(jié)構(gòu)。如果需要不保留遠(yuǎn)程主機(jī)的目錄結(jié)構(gòu)，可以使用flat: yes參數(shù)。

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

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

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

如果遠(yuǎn)程文件不存在，fetch模塊會報(bào)錯?？梢酝ㄟ^fail_on_missing: no來防止錯誤拋出，控制任務(wù)繼續(xù)執(zhí)行。

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

(5) 使用checksum驗(yàn)證文件

在抓取文件時，可以啟用validate_checksum來驗(yàn)證文件的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/"

此命令會將遠(yuǎn)程主機(jī)上的/home/user/data/目錄及其內(nèi)容遞歸下載到本地控制主機(jī)的/tmp/data_backup/目錄中，保留目錄結(jié)構(gòu)。

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

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

- name:從遠(yuǎn)程主機(jī)抓取文件并保存結(jié)果
hosts:node1
tasks:
-name:從遠(yuǎn)程主機(jī)抓取文件并保存結(jié)果
    ansible.builtin.fetch:
      src:/var/log/syslog
      dest:/tmp/log/
    register:fetched_file

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

總結(jié)

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