ansible.builtin.fileglob – список файлов, соответствующих шаблону
Примечание
Этот модуль входит в состав ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля fileglob, даже не указывая ключевое слово collections:. Несмотря на это, рекомендуется использовать полное имя класса (FQCN) для удобной ссылки на документацию модуля и для избежания конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
Добавлено в версии 1.4: of ansible.builtin
Описание
- Сопоставляет все файлы в одном каталоге без рекурсии, которые соответствуют шаблону. Использует библиотеку Python «glob».
Параметры
| Параметр | Варианты/Значения по умолчанию | Настройка | Комментарии |
|---|---|---|---|
| _terms строка / обязательно | путь(и) к файлам для чтения |
Примечания
Примечание
- Шаблоны поддерживаются только для файлов, а не для каталогов/путей.
- Сопоставление выполняется с файлами локальной системы на контроллере Ansible. Чтобы итерировать список файлов на удалённом узле, используйте модуль ansible.builtin.find.
- Возвращает строковый список путей, разделённых запятыми, или пустой список, если файлы не найдены. Для получения «истинного списка» передайте
wantlist=Trueв поиск.
Примеры
- name: Display paths of all .txt files in dir
debug: msg={{ lookup('fileglob', '/my/path/*.txt') }}
- name: Copy each file over that matches the given pattern
copy:
src: "{{ item }}"
dest: "/etc/fooapp/"
owner: "root"
mode: 0600
with_fileglob:
- "/playbooks/files/fooapp/*"
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого поиска:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| _list список / элементы=путь | успех | список файлов |
Авторы
- Michael DeHaan
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/fileglob_lookup.html