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

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

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

Обзор

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

Требования

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

f5-sdk >= 3.0.9

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
cores_per_slot			Указывает количество ядер, выделяемых системой гостю. Каждое ядро представляет собой часть процессора и памяти. Поэтому количество памяти, выделяемой на ядро, напрямую связано с количеством процессора. Это количество памяти варьируется в зависимости от типа аппаратной платформы. Количество, которое вы можете указать, зависит от типа используемого вами оборудования. В случае перезагрузки система сохраняет гостя в том же слоте, в котором он работал до перезагрузки.
delete_virtual_disk		По умолчанию: нет	Когда `state` равно `absent`, дополнительно удаляется виртуальный диск, связанный с гостем vCMP. По умолчанию это значение равно `no`.
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` может быть использовано при обновлении для удаления этого значения.
name обязательно			Имя управляемого гостя vCMP.
partition		По умолчанию: Common	Раздел устройства для управления ресурсами.
password обязательно			Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_PASSWORD` установлена. псевдонимы: pass, pwd
provider (добавлено в 2.5)		По умолчанию: Нет	Объект словаря, содержащий данные подключения.
	ssh_keyfile		Указывает файл ключа SSH для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Если значение не указано в задаче, будет использоваться значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout	По умолчанию: 10	Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечет до завершения операции, модуль выдаст ошибку.
	server обязательно		Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER` установлена.
	user обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, если переменная среды `F5_USER` установлена.
	server_port	По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER_PORT` установлена.
	password обязательно		Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_PASSWORD` установлена. псевдонимы: pass, pwd
	validate_certs	Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Используйте это только на сайтах, контролируемых лично, которые используют самозаверяющие сертификаты. Вы можете опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` установлена.
	transport обязательно	Варианты: rest cli ←	Настраивает транспортное подключение для использования при подключении к удаленному устройству.
server обязательно			Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER` установлена.
server_port (добавлено в 2.2)		По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER_PORT` установлена.
state		Варианты: настроен выключен готов настоящий ← отсутствует	Состояние гостя vCMP в системе. Каждое состояние подразумевает действия всех состояний перед ним. Когда `configured`, гарантирует, что гость vCMP существует с предоставленными атрибутами. Кроме того, гарантирует, что гость vCMP выключен. Когда `disabled`, ведет себя так же, как `configured`, имя этого состояния просто удобнее для пользователя. Когда `provisioned`, обеспечит создание и установку гостя. Это состояние не запустит гостя; для этого используйте `deployed`. Это состояние на один шаг дальше, чем `present`, так как `present` не установит гостя; только настраивает конфигурацию для его установки. Когда `present`, гарантирует правильную подготовку гостя и запускает его, чтобы он находился в рабочем состоянии. Когда `absent`, удаляет vCMP из системы.
user обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, если переменная среды `F5_USER` установлена.
validate_certs (добавлено в 2.0)		Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Используйте это только на сайтах, контролируемых лично, которые используют самозаверяющие сертификаты. Вы можете опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` установлена.
vlans			VLANы, которые использует гость для взаимодействия с другими гостями, хостом и внешней сетью. Доступные VLANы в списке — это VLANы, которые в настоящее время настроены на хосте vCMP. Порядок этих VLANов не важен; на самом деле он игнорируется. Этот модуль автоматически упорядочит VLANы для вас. Поэтому, если вы намеренно измените их порядок в последующих задачах, вы обнаружите, что этот модуль не зарегистрирует изменения.

Примечания

Примечание

Модуль может занимать много времени при развертывании гостевых виртуальных машин vCMP. Это внутреннее ограничение системы vCMP, поскольку она запускает реальные виртуальные машины на устройстве BIG-IP. Это время запуска очень похоже на время запуска виртуальных машин на любой другой платформе виртуализации; публичной или частной.
При запуске BIG-IP виртуальные машины запускаются последовательно, а не параллельно. Это означает, что для хоста vCMP с множеством гостевых виртуальных машин нередко требуется длительное время (более 60 минут) для перезагрузки и подключения всех гостевых виртуальных машин. Шина BIG-IP будет доступна до того, как все гостевые виртуальные машины vCMP станут доступны.
netaddr
Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется пакет f5-sdk Python на хосте. Это так же просто, как pip install f5-sdk.

Примеры

- 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 список	изменилось	VLANы, назначенные гостевой виртуальной машине vCMP, в полном формате пути. Пример: ['/Common/vlan1', '/Common/vlan2']

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Автор

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