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

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.31.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 строка	Указывает хранилище, в котором необходимо разместить файл. Существует несколько различных хранилищ, и каждое из них позволяет по-разному экспонировать файлы. Когда `external-monitor`, указанный файл будет сохранён как файл внешнего монитора и будет доступен для использования во внешних мониторах. Когда `ifile`, указанный файл будет сохранён как iFile. Когда `lw4o6-table`, указанный файл будет сохранён как таблица связей тоннеля Lightweight 4 over 6 (lw4o6), которая включает IPv6-адрес для lwB4, публичный IPv4-адрес и ограниченный набор портов. Варианты: `"external-monitor"` `"ifile"` ← (по умолчанию) `"lw4o6-table"`
force логическое значение	Принудительно перезаписать файл. По умолчанию файлы перезаписываются только если SHA файла отличается для данного имени файла. Этот параметр можно использовать для принудительного перезаписи файла, даже если он уже существует и его SHA совпадает. Хранилище `lw4o6-table` не сохраняет контрольные суммы своих файлов. Поэтому вам необходимо предоставить этот аргумент для обновления любых из этих файлов. Варианты: `false` ← (по умолчанию) `true`
name строка	Имя файла, как оно должно храниться на BIG-IP. Если это не указано, то используется имя файла, указанное в параметре `source`.
partition строка	Раздел устройства для управления ресурсами. По умолчанию: `"Common"`
provider словарь добавлен в f5networks.f5_modules 1.0.0	Объект словаря, содержащий детали подключения.
auth_provider строка	Настраивает поставщика авторизации для получения маркеров аутентификации от удалённого устройства. Этот параметр используется при работе с устройствами BIG-IQ.
no_f5_teem логическое значение	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, задав переменную окружения `F5_TELEMETRY_OFF`. Ранее используемая переменная `F5_TEEM` устарела, так как её имя было неоднозначным. Варианты: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd строка / обязательный	Пароль для учётной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Вы можете опустить этот параметр, задав переменную окружения `F5_PASSWORD`.
server строка / обязательный	Хост BIG-IP или хост BIG-IQ. Вы можете опустить этот параметр, задав переменную окружения `F5_SERVER`.
server_port целое число	Порт сервера BIG-IP. Вы можете опустить этот параметр, задав переменную окружения `F5_SERVER_PORT`. По умолчанию: `443`
timeout целое число	Указывает таймаут в секундах для взаимодействия с сетевым устройством для подключения или отправки команд. Если таймаут истекает до завершения операции, модуль вернёт ошибку.
transport строка	Настраивает транспортное соединение для использования при подключении к удалённому устройству. Варианты: `"rest"` ← (по умолчанию)
user строка / обязательный	Имя пользователя для подключения к BIG-IP или BIG-IQ. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, задав переменную окружения `F5_USER`.
validate_certs логическое значение	Если `no`, сертификаты SSL не проверяются. Используйте это только на сайтах под собственным контролем, использующих самозаверяющие сертификаты. Вы можете опустить этот параметр, задав переменную окружения `F5_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
source псевдонимы: src путь	Указывает путь к файлу для загрузки. Этот параметр обязателен, если `state` равен `present`.
state строка	Если `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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/f5networks/f5_modules/bigip_file_copy_module.html