?目錄

主要用途

參數(shù)總結(jié)

基本語(yǔ)法示例

使用示例

示例1：下載文件

示例2：使用校驗(yàn)和驗(yàn)證文件

示例3：使用 HTTP 基本認(rèn)證

示例4：通過代理服務(wù)器下載文件

示例5：設(shè)置文件權(quán)限、所有者和組

示例6：強(qiáng)制重新下載文件

示例7：設(shè)置下載超時(shí)時(shí)間

綜合示例

示例8：下載文件并設(shè)置各種參數(shù)

Playbook示例

基礎(chǔ)用法

示例1：下載文件

高級(jí)用法

示例2：使用校驗(yàn)和驗(yàn)證文件

示例3：使用 HTTP 基本認(rèn)證

示例4：通過代理服務(wù)器下載文件

示例5：設(shè)置文件權(quán)限、所有者和組

特殊用法

示例6：強(qiáng)制重新下載文件

示例7：設(shè)置下載超時(shí)時(shí)間

集合示例

---

get_url?模塊是 Ansible 中的一個(gè)內(nèi)置模塊，用于從指定的 URL 下載文件到目標(biāo)主機(jī)。它可以處理通過 HTTP、HTTPS、FTP 等協(xié)議下載文件，并支持多種功能如基本的身份認(rèn)證、代理設(shè)置、校驗(yàn)和驗(yàn)證等。Ansible 的?get_url?模塊本身并不直接支持?jǐn)帱c(diǎn)續(xù)傳功能，但是可使用shell或command模塊結(jié)合?wget?或?curl。以下是關(guān)于?get_url?模塊的詳細(xì)介紹和使用示例。

?

主要用途

1. 下載文件：從指定的 URL 下載文件到目標(biāo)主機(jī)。
2. 支持身份驗(yàn)證：可以處理需要基本 HTTP 認(rèn)證的網(wǎng)站。
3. 校驗(yàn)和驗(yàn)證：下載后可以對(duì)文件進(jìn)行校驗(yàn)和驗(yàn)證，以確保文件的完整性。
4. 使用代理：支持通過代理服務(wù)器下載文件。

?

參數(shù)總結(jié)

1. url:

   • 描述：要下載文件的 URL。
   • 類型：字符串
   • 必需：是

2. dest:

   • 描述：下載文件的目標(biāo)路徑（必須為絕對(duì)路徑）。
   • 類型：字符串
   • 必需：是

3. backup:

   • 描述：如果為 yes，在目標(biāo)文件存在且內(nèi)容發(fā)生更改時(shí)，將創(chuàng)建備份。
   • 類型：布爾值
   • 默認(rèn)值：no

4. checksum:

   • 描述：指定下載文件的 SHA256 校驗(yàn)和，以確保文件的完整性。如果校驗(yàn)和不匹配，將發(fā)生錯(cuò)誤。
   • 類型：字符串

5. force:

   • 描述：如果為 yes，則總是下載文件，即使文件已存在。
   • 類型：布爾值
   • 默認(rèn)值：no

6. timeout:

   • 描述：設(shè)置下載的超時(shí)時(shí)間（秒）。
   • 類型：整數(shù)
   • 默認(rèn)值：10

7. headers:

   • 描述：傳遞給 HTTP 服務(wù)器的自定義頭信息。
   • 類型：字典

8. http_agent:

   • 描述：用于 HTTP 請(qǐng)求的用戶代理字符串。
   • 類型：字符串

9. username:

   • 描述：用于基本身份驗(yàn)證的用戶名。
   • 類型：字符串

10. password:

    • 描述：用于基本身份驗(yàn)證的密碼。
    • 類型：字符串

11. url_password:

    • 描述：用于 URL 訪問的密碼（用于處理 URL 中包含的密碼）。
    • 類型：字符串

12. url_username:

    • 描述：用于 URL 訪問的用戶名（用于處理 URL 中包含的用戶名）。
    • 類型：字符串

13. use_proxy:

    • 描述：是否使用代理。
    • 類型：布爾值
    • 默認(rèn)值：yes

14. validate_certs:

    • 描述：使用 HTTPS 時(shí)是否驗(yàn)證 SSL 證書。
    • 類型：布爾值
    • 默認(rèn)值：yes

15. client_cert:

    • 描述：用于身份驗(yàn)證的客戶端證書文件路徑。
    • 類型：字符串

16. client_key:

    • 描述：用于身份驗(yàn)證的客戶端密鑰文件路徑。
    • 類型：字符串

17. sha256sum:

    • 描述：下載文件的 SHA256 校驗(yàn)和，以確保文件的完整性（checksum 參數(shù)的別名）。
    • 類型：字符串

?

?

基本語(yǔ)法示例

Ansible 命令行直接使用?get_url?模塊的基本語(yǔ)法如下：

ansible <host-pattern> -m get_url -a "url=<URL> dest=<目的路徑> [其他參數(shù)]"

使用示例

示例1：下載文件

從指定 URL 下載文件到遠(yuǎn)程主機(jī)的指定路徑：

ansible all -m get_url -a "url=http://example.com/sample.txt dest=/tmp/sample.txt"

示例2：使用校驗(yàn)和驗(yàn)證文件

通過校驗(yàn)和驗(yàn)證下載后的文件：

ansible all -m get_url -a "url=http://example.com/sample.txt dest=/tmp/sample.txt checksum=md5:5d41402abc4b2a76b9719d911017c592"

示例3：使用 HTTP 基本認(rèn)證

下載一個(gè)需要認(rèn)證的文件：

ansible all -m get_url -a "url=http://example.com/private.txt dest=/tmp/private.txt url_username=myuser url_password=mypassword"

示例4：通過代理服務(wù)器下載文件

通過代理服務(wù)器下載文件：

ansible all -m get_url -a "url=http://example.com/sample.txt dest=/tmp/sample.txt use_proxy=yes http_proxy=http://proxy.example.com:8080"

示例5：設(shè)置文件權(quán)限、所有者和組

下載文件并設(shè)置權(quán)限、所有者和組：

ansible all -m get_url -a "url=http://example.com/sample.txt dest=/tmp/sample.txt mode=0644 owner=myuser group=mygroup"

示例6：強(qiáng)制重新下載文件

即使文件已經(jīng)存在，也強(qiáng)制重新下載：

ansible all -m get_url -a "url=http://example.com/sample.txt dest=/tmp/sample.txt force=yes"

示例7：設(shè)置下載超時(shí)時(shí)間

設(shè)置下載操作的超時(shí)時(shí)間為 30 秒：

ansible all -m get_url -a "url=http://example.com/sample.txt dest=/tmp/sample.txt timeout=30"

綜合示例

示例8：下載文件并設(shè)置各種參數(shù)

ansible all -m get_url -a "url=http://example.com/sample.txt dest=/tmp/sample.txt mode=0644 owner=myuser group=mygroup force=yes timeout=30 checksum=md5:5d41402abc4b2a76b9719d911017c592"

?

?

Playbook示例

基礎(chǔ)用法

示例1：下載文件

從指定 URL 下載文件到遠(yuǎn)程主機(jī)的指定路徑：

---
- name: Download a file from URLhosts: alltasks:- name: Download a fileget_url:url: http://example.com/sample.txtdest: /tmp/sample.txt

高級(jí)用法

示例2：使用校驗(yàn)和驗(yàn)證文件

通過校驗(yàn)和驗(yàn)證下載后的文件，以確保其完整性：

---
- name: Download a file with checksum verificationhosts: alltasks:- name: Download with checksumget_url:url: http://example.com/sample.txtdest: /tmp/sample.txtchecksum: "md5:5d41402abc4b2a76b9719d911017c592"

示例3：使用 HTTP 基本認(rèn)證

下載需要認(rèn)證的文件，可以提供用戶名和密碼：

---
- name: Download a file with HTTP authenticationhosts: alltasks:- name: Download with basic authget_url:url: http://example.com/private.txtdest: /tmp/private.txturl_username: myuserurl_password: mypassword

示例4：通過代理服務(wù)器下載文件

通過代理服務(wù)器下載文件：

---
- name: Download a file using a proxyhosts: alltasks:- name: Download with proxyget_url:url: http://example.com/sample.txtdest: /tmp/sample.txtuse_proxy: yeshttp_proxy: http://proxy.example.com:8080

示例5：設(shè)置文件權(quán)限、所有者和組

下載文件并設(shè)置權(quán)限、所有者和組：

---
- name: Download a file and set permissionshosts: alltasks:- name: Download and set file attributesget_url:url: http://example.com/sample.txtdest: /tmp/sample.txtmode: '0644'owner: myusergroup: mygroup

特殊用法

示例6：強(qiáng)制重新下載文件

即使文件已經(jīng)存在，強(qiáng)制重新下載：

---
- name: Force re-download a filehosts: alltasks:- name: Force downloadget_url:url: http://example.com/sample.txtdest: /tmp/sample.txtforce: yes

示例7：設(shè)置下載超時(shí)時(shí)間

設(shè)置下載操作的超時(shí)時(shí)間，以避免長(zhǎng)時(shí)間掛起：

---
- name: Download a file with a timeouthosts: alltasks:- name: Download with timeoutget_url:url: http://example.com/sample.txtdest: /tmp/sample.txttimeout: 30

集合示例

結(jié)合多個(gè)參數(shù)達(dá)到復(fù)雜需求：

---
- name: Comprehensive example of get_url usagehosts: alltasks:- name: Download a public fileget_url:url: http://example.com/public.txtdest: /tmp/public.txt- name: Download a file with checksum verificationget_url:url: http://example.com/sample.txtdest: /tmp/sample.txtchecksum: "md5:5d41402abc4b2a76b9719d911017c592"- name: Download a file with HTTP authenticationget_url:url: http://example.com/private.txtdest: /tmp/private.txturl_username: myuserurl_password: mypassword- name: Download a file using a proxyget_url:url: http://example.com/sample-proxy.txtdest: /tmp/sample-proxy.txtuse_proxy: yeshttp_proxy: http://proxy.example.com:8080- name: Download a file and set permissionsget_url:url: http://example.com/sample-permissions.txtdest: /tmp/sample-permissions.txtmode: '0644'owner: myusergroup: mygroup- name: Force re-download a fileget_url:url: http://example.com/sample-force.txtdest: /tmp/sample-force.txtforce: yes- name: Download a file with a timeoutget_url:url: http://example.com/sample-timeout.txtdest: /tmp/sample-timeout.txttimeout: 30