bigip_file_copy – Управление файлами в хранилищах на BIG-IP

Новая в версии 2.8.

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

Обзор

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

Параметры

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

Примечания

Примечание

Для получения дополнительной информации об использовании Ansible для управления устройствами F5 Networks см. https://www.ansible.com/integrations/networks/f5.
Требуется версия ПО BIG-IP >= 12.
Модули F5 манипулируют только текущей конфигурацией продукта F5. Чтобы убедиться, что конфигурация, специфичная для BIG-IP, сохраняется на диске, обязательно включите хотя бы одну задачу, которая использует модуль 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)$"
  register: f

- name: Upload a directory of files as a set of iFiles
  bigip_file_copy:
    source: "{{ f.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

Статус

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

Авторы

Tim Rupp (@caphrim007)

Подсказка

Если вы заметили какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

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