Модуль f5networks.f5_modules.bigip_file_copy — управление файлами в хранилищах данных на BIG-IP

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install f5networks.f5_modules.

Чтобы использовать её в плейбуке, укажите: f5networks.f5_modules.bigip_file_copy.

Добавлено в f5networks.f5_modules 1.0.0

Обзор
Параметры
Примечания
Примеры

Обзор

Управляет файлами в различных хранилищах данных на BIG-IP.

Параметры

Параметр	Комментарии
datastore string	Задаёт хранилище данных, в которое нужно поместить файл. Существует несколько различных хранилищ данных, каждое из которых позволяет предоставлять файлы разными способами. Если `external-monitor`, указанный файл будет сохранён как файл внешнего монитора и станет доступен для использования во внешних мониторах. Если `ifile`, указанный файл будет сохранён как iFile. Если `lw4o6-table`, указанный файл будет сохранён как таблица привязок туннеля Lightweight 4 over 6 (lw4o6), содержащая IPv6-адрес lwB4, общедоступный IPv4-адрес и ограниченный набор портов. Варианты: `"external-monitor"` `"ifile"` ← (по умолчанию) `"lw4o6-table"`
force boolean	Принудительно перезаписывать файл. По умолчанию файлы перезаписываются, только если SHA файла отличается для указанного имени файла. Этот параметр можно использовать, чтобы принудительно перезаписать файл, даже если он уже существует и его SHA совпадает. Хранилище данных `lw4o6-table` не хранит контрольные суммы файлов. Поэтому для обновления любого из этих файлов необходимо указать этот аргумент. Варианты: `false` ← (по умолчанию) `true`
name string	Имя файла, под которым он должен находиться на BIG-IP. Если оно не указано, вместо него используется имя файла, заданное в параметре `source`.
partition string	Раздел устройства, в котором нужно управлять ресурсами. По умолчанию: `"Common"`
provider dictionary добавлено в f5networks.f5_modules 1.0.0	Объект dict, содержащий сведения о подключении.
auth_provider string	Настраивает поставщика аутентификации для получения токенов аутентификации с удалённого устройства. Этот параметр используется в основном при работе с устройствами BIG-IQ.
no_f5_teem boolean	Если `yes`, телеметрические данные TEEM не отправляются в F5. Этот параметр можно не указывать, задав переменную среды `F5_TELEMETRY_OFF`. Ранее использовавшаяся переменная `F5_TEEM` устарела, так как её имя вводило в заблуждение. Варианты: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd string / обязательный	Пароль учётной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную среды `F5_PASSWORD`.
server string / обязательный	Узел BIG-IP или узел BIG-IQ. Этот параметр можно не указывать, задав переменную среды `F5_SERVER`.
server_port integer	Порт сервера BIG-IP. Этот параметр можно не указывать, задав переменную среды `F5_SERVER_PORT`. По умолчанию: `443`
timeout integer	Задаёт время ожидания в секундах при взаимодействии с сетевым устройством — как при подключении, так и при отправке команд. Если время ожидания истечёт до завершения операции, модуль выдаст ошибку.
transport string	Настраивает транспортное соединение, используемое при подключении к удалённому устройству. Варианты: `"rest"` ← (по умолчанию)
user string / обязательный	Имя пользователя для подключения к BIG-IP или BIG-IQ. Этот пользователь должен иметь права администратора на устройстве. Этот параметр можно не указывать, задав переменную среды `F5_USER`.
validate_certs boolean	Если `no`, сертификаты SSL не проверяются. Используйте этот параметр только на контролируемых вами сайтах с самоподписанными сертификатами. Этот параметр можно не указывать, задав переменную среды `F5_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
source псевдонимы: src path	Задаёт путь к загружаемому файлу. Этот параметр обязателен, если `state` — `present`.
state string	Если `present`, обеспечивает наличие ресурса. Если `absent`, обеспечивает удаление ресурса. Варианты: `"present"` ← (по умолчанию) `"absent"`

Примечания

Примечание

Дополнительные сведения об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется BIG-IP версии >= 12.
Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы сохранить конфигурацию BIG-IP на диске, обязательно включите как минимум одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Инструкции по правильному использованию модуля для сохранения текущей конфигурации см. в документации модуля.

Примеры

- name: Upload a file as an iFile
  bigip_file_copy:
    name: foo
    source: /path/to/file.txt
    datastore: ifile
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

# Upload a directory of files
- name: Recursively upload web related files in /var/tmp/project
  find:
    paths: /var/tmp/project
    patterns: "^.*?\\.(?:html|?:css|?:js)$"
    use_regex: true
  register: f

- name: Upload a directory of files as a set of iFiles
  bigip_file_copy:
    source: "{{ item.path }}"
    datastore: ifile
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
    loop: f
  delegate_to: localhost
# End upload a directory of files

- name: Upload a file to use in an external monitor
  bigip_file_copy:
    source: /path/to/files/external.sh
    datastore: external-monitor
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

Авторы

Tim Rupp (@caphrim007)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/f5networks/f5_modules/bigip_file_copy_module.html