first_found – возврат первого найденного файла из списка

• Описание
• Параметры
• Примечания
• Примеры
• Возвращаемые значения
• Статус

Описание

• Этот поиск проверяет список файлов и путей и возвращает полный путь к первой найденной комбинации.
• Как и все поиски, при использовании относительных путей он сначала попробует использовать расположение текущей задачи, а затем поднимется по цепочке к расположению содержащей роли/игры/включения и т. д.
• Список файлов имеет приоритет над проверяемыми путями. Например, если в задаче в роли есть «file1» в относительном пути игры, он будет использован, а «file2» в относительном пути роли не будет.
• Для работы этого плагина требуется либо список файлов _terms , либо ключ files со списком файлов.

Параметры

Примечания

Примеры

- name: show first existing file or ignore if none do
  debug: msg={{lookup('first_found', findme, errors='ignore')}}
  vars:
    findme:
      - "/path/to/foo.txt"
      - "bar.txt"  # will be looked in files/ dir relative to role and/or play
      - "/path/to/biz.txt"

- name: |
        include tasks only if files exist.  Note the use of query() to return
        a blank list for the loop if no files are found.
  import_tasks: '{{ item }}'
  vars:
    params:
      files:
        - path/tasks.yaml
        - path/other_tasks.yaml
  loop: "{{ q('first_found', params, errors='ignore') }}"

- name: |
        copy first existing file found to /some/file,
        looking in relative directories from where the task is defined and
        including any play objects that contain it
  copy: src={{lookup('first_found', findme)}} dest=/some/file
  vars:
    findme:
      - foo
      - "{{inventory_hostname}}"
      - bar

- name: same copy but specific paths
  copy: src={{lookup('first_found', params)}} dest=/some/file
  vars:
    params:
      files:
        - foo
        - "{{inventory_hostname}}"
        - bar
      paths:
        - /tmp/production
        - /tmp/staging

- name: INTERFACES | Create Ansible header for /etc/network/interfaces
  template:
    src: "{{ lookup('first_found', findme)}}"
    dest: "/etc/foo.conf"
  vars:
    findme:
      - "{{ ansible_virtualization_type }}_foo.conf"
      - "default_foo.conf"

- name: read vars from first file found, use 'vars/' relative subdir
  include_vars: "{{lookup('first_found', params)}}"
  vars:
    params:
      files:
        - '{{ansible_os_distribution}}.yml'
        - '{{ansible_os_family}}.yml'
        - default.yml
      paths:
        - 'vars'

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

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

Статус

• Этот поиск не гарантирует обратную совместимость интерфейса. [превью]
• Этот поиск поддерживается сообществом Ansible. [сообщество]

Авторы

• Seth Vidal <skvidal@fedoraproject.org>