f5networks.f5_modules.bigip_software_image – Управление образами программного обеспечения на BIG-IP

Примечание

Этот плагин является частью коллекции f5networks.f5_modules (версия 1.6.0).

Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules

Для использования в playbook, укажите: f5networks.f5_modules.bigip_software_image

В версии 1.0.0: модуля f5networks.f5_modules

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

Обзор

Управление образами программного обеспечения на BIG-IP. Эти образы могут включать как базовые образы, так и образы исправлений.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
force boolean		Варианты: no ← yes	При `yes`, загружает файл каждый раз и заменяет файл на устройстве. При `no`, файл загружается только если он еще не существует. В целом следует использовать `yes` только в случаях, когда есть основания полагать, что образ был поврежден во время загрузки.
image string / обязательно			Образ для установки на удаленное устройство. Может быть абсолютным или относительным путем на контроллере Ansible. Имена образов, будь то базовые ISO или ISO исправлений, должны быть уникальными.
provider dictionary добавлено в версии 1.0.0 f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	auth_provider string		Настраивает поставщика аутентификации для получения маркеров аутентификации с удаленного устройства. Этот параметр используется в основном при работе с устройствами BIG-IQ.
	no_f5_teem boolean	Варианты: no yes	Если `yes`, данные телеметрии TEEM не отправляются в F5. Можно опустить этот параметр, установив переменную среды `F5_TEEM`.
	password string / обязательно		Пароль учетной записи пользователя для подключения к BIG-IP. Можно опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
	server string / обязательно		Хост BIG-IP. Можно опустить этот параметр, установив переменную среды `F5_SERVER`.
	server_port integer	По умолчанию: 443	Порт сервера BIG-IP. Можно опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
	timeout integer		Устанавливает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечет до завершения операции, модуль выдаст ошибку.
	transport string	Варианты: rest ←	Настраивает транспортное соединение для подключения к удаленному устройству.
	user string / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Можно опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs boolean	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самоподписанными сертификатами. Можно опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
state string		Варианты: absent present ←	При `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 relative image to the BIG-IP
  bigip_software_image:
    image: BIGIP-13.0.0.0.0.1645.iso
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Upload absolute image to the BIG-IP
  bigip_software_image:
    image: /path/to/images/BIGIP-13.0.0.0.0.1645.iso
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Upload image in a role to the BIG-IP
  bigip_software_image:
    image: "{{ role_path }}/files/BIGIP-13.0.0.0.0.1645.iso"
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ	Возвращено	Описание
build string	changed	Версия сборки программного обеспечения, содержащегося в изображении. Пример: 0.0.3
checksum string	changed	MD5 контрольная сумма ISO. Пример: 8cdbd094195fab4b2b47ff4285577b70
file_size integer	changed	Размер загруженного образа в МБ. Пример: 1948
image_type string	changed	Является ли образ релизным или образ исправлений. Пример: release
version string	changed	Версия программного обеспечения, содержащегося в изображении. Пример: 13.1.0.8

Авторы

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.10/collections/f5networks/f5_modules/bigip_software_image_module.html