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

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

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

Описание

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

Требования

Ниже перечислены требования к хосту, на котором выполняется данный модуль.

f5-sdk >= 3.0.16

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
allowed_slots - добавлено в 2.7			Содержит слоты, к которым гость может быть назначен. Когда хост определяет, к каким слотам должен быть назначен этот гость, будут рассмотрены только слоты из этого списка. Это хороший способ принудительно назначать гостей только к определенным слотам или, настроив непересекающиеся `allowed_slots` для двух гостей, гарантировать, что эти гости никогда не будут назначены к одному и тому же слоту. По умолчанию этот список включает все доступные слоты в кластере. Это означает, что гость по умолчанию может быть назначен к любому слоту.
cores_per_slot -			Указывает количество ядер, которые система выделяет гостю. Каждое ядро представляет собой часть процессора и памяти. Поэтому количество памяти, выделенное на ядро, напрямую связано с количеством процессорного времени. Это количество памяти варьируется в зависимости от типа аппаратной платформы. Число, которое вы можете указать, зависит от типа используемого вами оборудования. В случае перезагрузки система сохраняет гостя в том же слоте, в котором он работал до перезагрузки.
delete_virtual_disk boolean		Варианты: нет ← да	Когда `state` равно `absent`, дополнительно удаляется виртуальный диск, связанный с гостем vCMP. По умолчанию это значение равно `no`.
initial_image -			Указывает базовый ISO-образ выпуска программного обеспечения для установки гипервизора TMOS и любых лицензионных модулей BIG-IP на виртуальный диск гостя. При создании нового гостя этот параметр обязателен.
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 - добавлено в 2.7			Указывает минимальное количество слотов, к которым гость должен быть назначен для развертывания. Это поле определяет количество слотов, к которым должен быть назначен гость. Если в конце любой попытки назначения гость не назначен хотя бы к этому количеству слотов, попытка завершается неудачей, и изменение, которое её инициировало, отменяется. Значение `min_number_of_slots` гостя не может быть больше, чем его `number_of_slots`.
name - / обязательно			Имя гостя vCMP для управления.
number_of_slots - добавлено в 2.7			Указывает количество слотов, которые система должна использовать для создания гостя. Это значение определяет, сколько ядер гостю выделяется с каждого слота, к которому он назначен. Возможные значения зависят от типа используемых в этом кластере планок. Значение по умолчанию зависит от типа используемых в этом кластере планок.
partition -		По умолчанию: "Общее"	Раздел устройства для управления ресурсами.
password - / обязательно			Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
provider - добавлено в 2.5		По умолчанию: null	Объект словаря, содержащий данные подключения.
	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 -	По умолчанию: 10	Указывает таймаут в секундах для взаимодействия с сетевым устройством при подключении или отправке команд. Если таймаут истекает до завершения операции, модуль выдаст ошибку.
	transport - / обязательно	Варианты: rest cli ←	Настраивает транспортное соединение для использования при подключении к удаленному устройству.
	user - / обязательно		Имя пользователя для подключения к BIG-IP. У этого пользователя должны быть административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs boolean	Варианты: нет да ←	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах, использующих самозаверяемые сертификаты. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
server - / обязательно			Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.

server_port - added in 2.2	Значение по умолчанию: 443	Порт сервера BIG-IP. Этот параметр можно опустить, задав переменную окружения `F5_SERVER_PORT`.
state -	Варианты: configured disabled provisioned present ← absent	Состояние гостевой машины vCMP на системе. Каждое состояние подразумевает действия всех предыдущих состояний. При значении `configured`, гарантируется, что гостевая машина vCMP существует с заданными атрибутами. Кроме того, гарантируется, что гостевая машина vCMP выключена. При значении `disabled`, поведение аналогично `configured`, но название этого состояния более понятно для пользователя. При значении `provisioned`, гарантируется, что гостевая машина создана и установлена. Это состояние не запустит гостевую машину; для этого используйте `deployed`. Это состояние на один шаг дальше, чем `present`, так как `present` не установит гостевую машину; оно только подготовит конфигурацию для её установки. При значении `present`, гарантируется, что гостевая машина должным образом подготовлена и запустится в рабочем состоянии. При значении `absent`, гостевая машина vCMP удаляется из системы.
user - / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Этот параметр можно опустить, задав переменную окружения `F5_USER`.
validate_certs boolean added in 2.0	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах, использующих самозаверяемые сертификаты. Этот параметр можно опустить, задав переменную окружения `F5_VALIDATE_CERTS`.
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.
Требуется пакет f5-sdk Python на хосте. Это так же просто, как pip install f5-sdk.
Требуется версия ПО BIG-IP >= 12.
Модули F5 изменяют только рабочую конфигурацию продукта F5. Чтобы убедиться, что конфигурация, специфичная для BIG-IP, сохраняется на диске, обязательно включите хотя бы одну задачу, использующую модуль bigip_config для сохранения рабочей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения вашей рабочей конфигурации.

Примеры

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

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

- name: Remove vCMP guest and disk
  bigip_vcmp_guest:
    name: guest1
    state: absent
    delete_virtual_disk: yes
  register: result

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

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

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

Статус

Этот модуль гарантированно не будет содержать изменений интерфейса, несовместимых со старыми версиями. [stableinterface]
Этот модуль поддерживается партнером 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.7/modules/bigip_vcmp_guest_module.html