fetch - Загрузка файла с удаленных узлов

Описание
Параметры
Примеры
Примечания
- Статус
- Информация о поддержке

Описание

Этот модуль работает как copy, но в обратном порядке. Он используется для загрузки файлов с удаленных машин и сохранения их локально в дереве файлов, организованном по имени хоста.
Этот модуль также поддерживается для целей Windows.

Параметры

параметр	обязательно	значение по умолчанию	возможные значения	комментарии
dest	да			Директория для сохранения файла. Например, если директория dest равна `/backup`, а файл src с именем `/etc/profile` на хосте `host.example.com`, будет сохранён в `/backup/host.example.com/etc/profile`.
fail_on_missing	нет	нет	да нет	Если установлено в 'да', задача завершится с ошибкой, если удалённый файл не может быть прочитан по какой-либо причине.
flat	нет			Позволяет переопределить стандартное поведение добавления имени хоста/пути/имени файла в назначение. Если dest заканчивается на '/', будет использоваться имя файла исходного файла, аналогично модулю copy. Очевидно, это удобно только в случае уникальных имён файлов.
src	да			Файл на удалённой системе для загрузки. Это должен быть файл, а не директория. Рекурсивное скачивание может быть добавлено в будущих версиях.
validate_checksum (добавлено в 1.4)	нет	да	да нет	Проверка соответствия контрольных сумм исходного и конечного файлов после загрузки. псевдонимы: validate_md5

Примеры

# Store file into /tmp/fetched/host.example.com/tmp/somefile
- fetch:
    src: /tmp/somefile
    dest: /tmp/fetched

# Specifying a path directly
- fetch:
    src: /tmp/somefile
    dest: /tmp/prefix-{{ inventory_hostname }}
    flat: yes

# Specifying a destination path
- fetch:
    src: /tmp/uniquefile
    dest: /tmp/special/
    flat: yes

# Storing in a path relative to the playbook
- fetch:
    src: /tmp/uniquefile
    dest: special/prefix-{{ inventory_hostname }}
    flat: yes

Примечания

Примечание

При запуске fetch с become, модуль slurp также будет использован для загрузки содержимого файла для определения удалённой контрольной суммы. Это фактически удваивает размер передачи и, в зависимости от размера файла, может потребить всю доступную память на удалённых или локальных хостах, вызывая MemoryError. По этой причине рекомендуется запускать этот модуль без become по возможности.
Этот модуль также поддерживается для целей Windows.

Статус

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

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

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

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/fetch_module.html