f5networks.f5_modules.bigip_vcmp_guest – Управляет гостевыми vCMP-узлами на BIG-IP

Примечание

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

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

Для использования в плейбуке укажите: f5networks.f5_modules.bigip_vcmp_guest.

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

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

Обзор

Управляет гостевыми узлами vCMP (Virtual Clustered Multiprocessing) на BIG-IP. Эта функциональность доступна только на аппаратном обеспечении и должна быть включена путём конфигурации vcmp с помощью модуля bigip_provision.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
allowed_slots список / элементы=строка			Содержит те слоты, к которым гость может быть назначен. Когда хост определяет, к каким слотам должен быть назначен этот гость, учитываются только слоты из этого списка. Это хороший способ принудительно назначить гостей только определённым слотам или, настроив непересекающиеся `allowed_slots` для двух гостей, гарантировать, что эти гости никогда не будут назначены одному слоту. По умолчанию этот список включает каждый доступный слот в кластере. Это означает, что гость может быть назначен к любому слоту по умолчанию.
cores_per_slot целое число			Указывает количество ядер, которые система выделяет гостю. Каждое ядро представляет собой часть ЦП и памяти. Поэтому количество памяти, выделяемое на ядро, напрямую связано с количеством ЦП. Это количество памяти варьируется в зависимости от типа аппаратной платформы. Количество, которое можно указать, зависит от типа имеемого вами оборудования. В случае перезагрузки система сохраняет гостя в том же слоте, в котором он работал до перезагрузки.
delete_virtual_disk булево		Варианты: нет ← да	Когда `state` равно `absent`, система дополнительно удаляет виртуальный диск, связанный с гостем vCMP. По умолчанию это значение равно `no`.
initial_hotfix строка			Указывает файл образа ISO исправления, который применяется поверх базового образа.
initial_image строка			Указывает базовый файл образа ISO версии программного обеспечения для установки экземпляра гипервизора TMOS и любых лицензионных модулей BIG-IP на виртуальный диск гостя. При создании нового гостя этот параметр является обязательным. Убедитесь, что этот образ присутствует на хосте VCMP, а не только на госте VCMP. Кроме того, ссылка на этот образ должна быть той, что присутствует на хосте, а не на госте.
mgmt_address строка			Указывает IP-адрес и подсеть или маску подсети, которые используются для доступа к гостю при управлении модулем, работающим внутри гостя. Этот параметр обязателен, если параметр `mgmt_network` равен `bridged`. При создании нового гостя, если вы не указываете сеть или маску сети, используется значение по умолчанию `/24` (`255.255.255.0`).
mgmt_network строка		Варианты: мостовой изолированный только для хоста	Указывает метод, с помощью которого используется адрес управления в госте vCMP. Если `bridged`, указывает, что гость может взаимодействовать с управляющей сетью хоста vCMP. Если `isolated`, указывает, что гость изолирован от управляющей сети хоста vCMP. В этом случае единственный способ взаимодействия гостя с хостом vCMP — через порт консоли или через собственный IP-адрес на госте, который разрешает трафик через порт 22. Если `host only`, предотвращает установку образов и исправлений, отличных от предоставленных гипервизором. Если настройка гостя равна `isolated` или `host only`, `mgmt_address` не применяется. При изменении режима, изменение `bridged` на `isolated` заставляет хост vCMP удалить все интерфейсы управления гостя из его мостовой управляющей сети. Это немедленно отключает виртуальные машины гостя от физической управляющей сети. Изменение `isolated` на `bridged` заставляет хост vCMP динамически добавлять интерфейсы управления гостя в мостовую управляющую сеть. Это немедленно подключает все виртуальные машины гостя к физической управляющей сети. Изменение этого свойства, когда гость находится в состоянии `configured` или `provisioned`, не оказывает немедленного эффекта.
mgmt_route строка			Указывает адрес шлюза для `mgmt_address`. Если это значение не указано при создании нового гостя, оно устанавливается в `none`. Значение `none` можно использовать во время обновления для удаления этого значения.
min_number_of_slots целое число			Указывает минимальное количество слотов, которые должны быть назначены гостю для развертывания. Это поле определяет количество слотов, к которым должен быть назначен гость. В конце любой попытки распределения, если гость не назначен хотя бы к такому количеству слотов, попытка завершается ошибкой, и изменение, которое её инициировало, отменяется. Значение `min_number_of_slots` гостя не может быть больше, чем его значение `number_of_slots`.
name строка / обязательно			Имя гостя vCMP для управления.
number_of_slots целое число			Указывает количество слотов, которые система должна использовать при создании гостя. Это значение определяет, сколько ядер гостю выделяется из каждого назначенного слота. Возможные значения зависят от типа используемых блейд в этом кластере. Значение по умолчанию зависит от типа используемых блейд в этом кластере.
partition строка		Значение по умолчанию: "Общий"	Раздел устройства для управления ресурсами.
provider словарь добавлен в 1.0.0 f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	auth_provider строка		Настраивает поставщика аутентификации для получения токенов аутентификации от удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ.
	no_f5_teem булево	Варианты: нет да	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, установив переменную среды `F5_TEEM`.
	password строка / обязательно		Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
	server строка / обязательно		Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
	server_port целое число	Значение по умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
	timeout целое число		Указывает тайм-аут в секундах для взаимодействия с сетевым устройством для подключения или отправки команд. Если тайм-аут истечёт до завершения операции, модуль выдаст ошибку.
	transport строка	Варианты: rest ←	Настраивает транспортное соединение для использования при подключении к удалённому устройству.
	user строка / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs булево	Варианты: нет да ←	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверяющимися сертификатами. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
state строка		Варианты: настроен отключен обеспечен наличие ← отсутствует	Состояние гостя vCMP в системе. Каждое состояние подразумевает действия всех предыдущих состояний. Когда `configured`, гарантирует существование гостя vCMP с указанными атрибутами. Кроме того, гарантирует, что гость vCMP выключен. Когда `disabled`, ведет себя так же, как `configured`, просто более удобное название. Когда `provisioned`, гарантирует создание и установку гостя. Это состояние не запускает гостя; используйте `deployed` для этой цели. Это состояние на один шаг дальше, чем `present`, так как `present` не устанавливает гостя; только настраивает конфигурацию для его установки. Когда `present`, гарантирует, что гость должным образом обеспечен и запускает гостя, чтобы он был в рабочем состоянии. Когда `absent`, удаляет гостя vCMP из системы.
vlans список / элементы=строка			VLANы, которые гость использует для связи с другими гостями, хостом и с внешней сетью. Доступные VLANы в списке — это те, которые в настоящее время настроены на хосте vCMP. Порядок этих VLANов не важен и игнорируется. Этот модуль автоматически упорядочивает VLANы. Поэтому, если вы намеренно переупорядочите их в последующих задачах, этот модуль не регистрирует изменения.

Примечания

Примечание

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

Примеры

- name: Create a vCMP guest
  bigip_vcmp_guest:
    name: foo
    mgmt_network: bridge
    mgmt_address: 10.20.30.40/24
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Create a vCMP guest with specific VLANs
  bigip_vcmp_guest:
    name: foo
    mgmt_network: bridge
    mgmt_address: 10.20.30.40/24
    vlans:
      - vlan1
      - vlan2
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Remove vCMP guest and disk
  bigip_vcmp_guest:
    name: guest1
    state: absent
    delete_virtual_disk: yes
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  register: result

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

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

Ключ	Возвращаемое значение	Описание
vlans список / элементы=строка	changed	VLANы, назначенные гостевой системе vCMP, в полном формате пути. Пример: ['/Common/vlan1', '/Common/vlan2']

Авторы

Tim Rupp (@caphrim007)
Wojciech Wypior (@wojtek0806)

© 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_vcmp_guest_module.html