get_url — Загрузка файлов из HTTP, HTTPS или FTP на узел

• Описание
• Параметры
• Примеры
• Возвращаемые значения
• Примечания
  • Статус
  • Информация о поддержке

Описание

• Загружает файлы из HTTP, HTTPS или FTP на удаленный сервер. Удаленный сервер должен иметь прямой доступ к удаленному ресурсу.
• По умолчанию, если на целевом узле установлена переменная среды <protocol>_proxy, запросы будут отправляться через этот прокси-сервер. Это поведение можно переопределить, задав переменную для этой задачи (см. настройка окружения), или используя параметр use_proxy.
• HTTP-редиректы могут перенаправлять с HTTP на HTTPS, поэтому убедитесь, что настройки прокси-сервера для обоих протоколов корректны.
• Начиная с Ansible 2.4, при запуске с --check, он выполнит запрос HEAD для проверки URL, но не загрузит весь файл и не проверит его на соответствие хешам.
• Для целевых систем Windows используйте модуль win_get_url вместо этого.

Параметры

Примеры

- name: Download foo.conf
  get_url:
    url: http://example.com/path/file.conf
    dest: /etc/foo.conf
    mode: 0440

- name: Download file and force basic auth
  get_url:
    url: http://example.com/path/file.conf
    dest: /etc/foo.conf
    force_basic_auth: yes

- name: Download file with custom HTTP headers
  get_url:
    url: http://example.com/path/file.conf
    dest: /etc/foo.conf
    headers: 'key:value,key:value'

- name: Download file with check (sha256)
  get_url:
    url: http://example.com/path/file.conf
    dest: /etc/foo.conf
    checksum: sha256:b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c

- name: Download file with check (md5)
  get_url:
    url: http://example.com/path/file.conf
    dest: /etc/foo.conf
    checksum: md5:66dffb5228a211e61d6d7ef4a86f5758

- name: Download file from a file path
  get_url:
    url: file:///tmp/afile.txt
    dest: /tmp/afilecopy.txt

Возвращаемые значения

Общие возвращаемые значения описаны здесь Возвращаемые значения. Следующие поля уникальны для этого модуля:

Примечания

Статус

Этот модуль помечен как stableinterface, что означает, что разработчики данного модуля гарантируют отсутствие несовместимых изменений интерфейса.

Информация о поддержке

Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>

Для получения помощи в разработке модулей, если вам это интересно, обратитесь к Информация о сообществе и участие в разработке, Тестирование Ansible и Разработка модулей.