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 bool		Варианты: нет ← да	Когда `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		По умолчанию: "Общее"	Раздел устройства для управления ресурсами.
password обязательно			Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_PASSWORD` установлена. псевдонимы: pass, pwd
provider (добавлено в 2.5)			Объект словаря, содержащий данные подключения.
	password обязательно		Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_PASSWORD` установлена. псевдонимы: pass, pwd
	server обязательно		Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER` установлена.
	server_port	По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER_PORT` установлена.
	user обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Вы можете опустить этот параметр, если переменная среды `F5_USER` установлена.
	validate_certs bool	Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Используйте это только на сайтах, контролируемых вами лично, использующих самозаверенные сертификаты. Вы можете опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` установлена.
	timeout	По умолчанию: 10	Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку.
	ssh_keyfile		Указывает SSH-ключевой файл для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задаче, вместо него используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	transport обязательно	Варианты: rest cli ←	Настраивает транспортное соединение для использования при подключении к удаленному устройству.
server обязательно			Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER` установлена.
server_port (добавлено в 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 bool (добавлено в 2.0)		Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Используйте это только на сайтах, контролируемых вами лично, использующих самозаверенные сертификаты. Вы можете опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` установлена.
vlans			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 список	changed	VLANы, назначенные гостевой виртуальной машине vCMP, в полном формате пути. Пример: ['/Common/vlan1', '/Common/vlan2']

Статус

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

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в Руководстве по поддержке и обслуживанию модулей.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

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