bigip_vcmp_guest – Управляет гостями vCMP на BIG-IP

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

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

Краткое описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
allowed_slots список добавлен в 2.7			Содержит те слоты, к которым гостю разрешено назначение. Когда хост определяет, к каким слотам должен быть назначен гость, будут рассмотрены только слоты из этого списка. Это хороший способ принудительно назначать гостей только к определенным слотам или, настроив разрозненные `allowed_slots` для двух гостей, убедиться, что эти гости никогда не будут назначены к одному слоту. По умолчанию этот список включает все доступные слоты в кластере. Это означает, что гостю по умолчанию можно назначить любой слот.
cores_per_slot целое число			Указывает количество ядер, которое система выделяет гостю. Каждое ядро представляет собой часть процессора и памяти. Следовательно, объем выделенной памяти на ядро напрямую связан с объемом процессора. Этот объем памяти варьируется в зависимости от типа аппаратной платформы. Число, которое вы можете указать, зависит от типа имеемого вами оборудования. В случае перезагрузки система сохраняет гостя в том же слоте, в котором он работал до перезагрузки.
delete_virtual_disk логическое значение		Варианты: нет ← да	Когда `state` равно `absent`, будет дополнительно удалён виртуальный диск, связанный с гостем vCMP. По умолчанию это значение `no`.
initial_hotfix строка добавлен в 2.9			Указывает файл образа hotfix ISO, который будет применён поверх базового образа.
initial_image строка			Указывает базовый файл образа ISO выпуска программного обеспечения для установки экземпляра гипервизора TMOS и любых лицензионных модулей BIG-IP на виртуальный диск гостя. При создании нового гостя этот параметр является обязательным.
mgmt_address строка			Указывает IP-адрес и подсеть или маску подсети, используемые для доступа к гостю при управлении модулем, работающим внутри гостя. Этот параметр требуется, если параметр `mgmt_network` имеет значение `bridged`. При создании нового гостя, если вы не указываете сеть или маску сети, по умолчанию используется `/24` (`255.255.255.0`).
mgmt_network строка		Варианты: bridged isolated host only	Указывает метод использования адреса управления в госте 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 целое число добавлен в 2.7			Указывает минимальное количество слотов, которые должны быть назначены гостю для развертывания. Это поле определяет количество слотов, которые должны быть назначены гостю. Если в конце любой попытки распределения гостю не назначено хотя бы столько слотов, попытка завершается неудачно, а произведённое изменение отменяется. Значение `min_number_of_slots` гостя не может быть больше, чем `number_of_slots`.
name строка / обязательно			Имя гостя vCMP для управления.
number_of_slots целое число добавлен в 2.7			Указывает количество слотов, которые система должна использовать для создания гостя. Это значение определяет, сколько ядер гостю выделяется из каждого назначенного слота. Возможные значения зависят от типа используемых в этом кластере узлов. Значение по умолчанию зависит от типа используемых в этом кластере узлов.
partition строка		По умолчанию: "Common"	Раздел устройства для управления ресурсами.
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`.

состояние строка		Варианты: настроен отключен развёрнут наличие ← отсутствует	Состояние гостевого vCMP-узла в системе. Каждое состояние подразумевает действия всех состояний, предшествующих ему. Когда `configured`, гарантирует, что гостевой vCMP-узел существует с заданными атрибутами. Кроме того, гарантирует, что гостевой vCMP-узел выключен. Когда `disabled`, ведет себя так же, как `configured`, имя этого состояния — просто удобное для пользователя более понятное обозначение. Когда `provisioned`, гарантирует, что гость создан и установлен. Это состояние не запустит гостя; для этого используйте `deployed`. Это состояние — шаг вперёд от `present`, так как `present` не устанавливает гостя, а только настраивает конфигурацию для его установки. Когда `present`, гарантирует надлежащую развёртывание гостя и запускает гостя, так что он находится в рабочем состоянии. Когда `absent`, удаляет vCMP из системы.
vlans список			VLANы, используемые гостем для связи с другими гостями, хостом и внешней сетью. Доступные 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, сохраняется на диске, обязательно включите по крайней мере одну задачу, которая использует модуль 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 список	изменилось	VLANы, назначенные гостевому vCMP-узлу, в полном формате пути. Пример: ['/Common/vlan1', '/Common/vlan2']

Статус

Для этого модуля гарантируются обратные изменения интерфейса в будущем. [stableinterface]
Этот модуль поддерживается партнёром Ansible. [certified]

Авторы

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.9/modules/bigip_vcmp_guest_module.html