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

Новое в версии 2.7.

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

Описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
force boolean		Варианты: no ← yes	Когда `yes`, будет загружать файл каждый раз и заменять файл на устройстве. Когда `no`, файл будет загружен только в том случае, если он еще не существует. В целом следует использовать значение `yes` только в тех случаях, когда есть основания полагать, что образ был поврежден во время загрузки.
image string			Образ для загрузки на удаленное устройство. Это может быть абсолютный или относительный путь на контроллере Ansible. Имена изображений, будь то базовые ISO или ISO обновлений, обязательно должны быть уникальными.
password string / обязательно			Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, задав переменную окружения `F5_PASSWORD`. псевдонимы: pass, pwd
provider dictionary добавлено в 2.5			Объект типа dict, содержащий данные подключения.
	password string / обязательно		Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, задав переменную окружения `F5_PASSWORD`. псевдонимы: pass, pwd
	server string / обязательно		Хост BIG-IP. Этот параметр можно опустить, задав переменную окружения `F5_SERVER`.
	server_port integer	Значение по умолчанию: 443	Порт сервера BIG-IP. Этот параметр можно опустить, задав переменную окружения `F5_SERVER_PORT`.
	ssh_keyfile путь		Указывает файл SSH-ключа для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Этот параметр можно опустить, задав переменную окружения `ANSIBLE_NET_SSH_KEYFILE`.
	timeout integer	Значение по умолчанию: 10	Устанавливает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечет до завершения операции, модуль вернет ошибку.
	transport string	Варианты: cli rest ←	Настраивает транспортное соединение, используемое при подключении к удаленному устройству.
	user string / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Этот параметр можно опустить, задав переменную окружения `F5_USER`.
	validate_certs boolean	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на сайтах, которыми вы управляете самостоятельно, и которые используют самоподписанные сертификаты. Этот параметр можно опустить, задав переменную окружения `F5_VALIDATE_CERTS`.
server string / обязательно			Хост BIG-IP. Этот параметр можно опустить, задав переменную окружения `F5_SERVER`.
server_port integer добавлено в 2.2		Значение по умолчанию: 443	Порт сервера BIG-IP. Этот параметр можно опустить, задав переменную окружения `F5_SERVER_PORT`.
state string		Варианты: absent present ←	Когда `present`, гарантирует загрузку образа. Когда `absent`, гарантирует удаление образа.
user string / обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Этот параметр можно опустить, задав переменную окружения `F5_USER`.
validate_certs boolean добавлено в 2.0		Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на сайтах, которыми вы управляете самостоятельно, и которые используют самоподписанные сертификаты. Этот параметр можно опустить, задав переменную окружения `F5_VALIDATE_CERTS`.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется версия программного обеспечения BIG-IP >= 12.
Модули F5 только манипулируют текущей конфигурацией продукта F5. Для сохранения специфической для BIG-IP конфигурации на диске необходимо включить по крайней мере одну задачу, использующую модуль 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 строка	changed	Версия сборки программного обеспечения, содержащегося в образе. Пример: 0.0.3
checksum строка	changed	MD5 контрольная сумма ISO. Пример: 8cdbd094195fab4b2b47ff4285577b70
file_size целое число	changed	Размер загруженного образа в МБ. Пример: 1948
image_type строка	changed	Тип образа — релиз или исправление. Пример: release
version строка	changed	Версия программного обеспечения, содержащегося в образе. Пример: 13.1.0.8

Статус

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

Авторы

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.8/modules/bigip_software_image_module.html