Модуль f5networks.f5_modules.bigip_vcmp_guest — Управление гостями vCMP на BIG-IP

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.31.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

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

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

Новое в f5networks.f5_modules 1.0.0

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

Обзор

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

Параметры

Параметр	Комментарии
allowed_slots список / элементы=строка	Содержит слоты, к которым гостю разрешено назначение. Когда хост определяет, какие слоты должны быть назначены этому гостю, учитываются только слоты в этом списке. Это хороший способ заставить гостей быть назначенными только к определенным слотам или, настроив непересекающиеся `allowed_slots` для двух гостей, гарантировать, что эти гости никогда не будут назначены к одному и тому же слоту. По умолчанию этот список включает все доступные слоты в кластере. Это означает, что гостю по умолчанию может быть назначен любой слот.
cores_per_slot целое число	Указывает количество ядер, которое система выделяет гостю. Каждое ядро представляет часть ЦП и памяти. Поэтому количество выделенной памяти на ядро напрямую связано с количеством ЦП. Это количество памяти варьируется в зависимости от типа аппаратной платформы. Количество, которое можно указать, зависит от типа имеемого оборудования. В случае перезагрузки система сохраняет гостя в том же слоте, в котором он работал до перезагрузки.
delete_virtual_disk булево	Когда `state` равно `absent`, система дополнительно удаляет виртуальный диск, связанный с гостем vCMP. По умолчанию это значение равно `false`. Варианты: `false` ← (по умолчанию) `true`
initial_hotfix строка	Указывает файл образа 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`, не оказывает немедленного влияния. Варианты: `"bridged"` `"isolated"` `"host only"`
mgmt_route строка	Указывает адрес шлюза для `mgmt_address`. Если это значение не указано при создании нового гостя, оно устанавливается в `none`. Значение `none` можно использовать при обновлении для удаления этого значения.
min_number_of_slots целое число	Указывает минимальное количество слотов, которые должны быть назначены гостю для развертывания. Это поле определяет количество слотов, которым должен быть назначен гость. В конце любой попытки назначения, если гостю не назначено не менее этого количества слотов, попытка завершается неудачей, и изменение, которое ее инициировало, отменяется. Значение `min_number_of_slots` гостя не может быть больше, чем его значение `number_of_slots`.
name строка / обязательно	Имя гостя vCMP для управления.
number_of_slots целое число	Указывает количество слотов, которые система должна использовать при создании гостя. Это значение определяет, сколько ядер выделяется гостю из каждого слота, которому он назначен. Возможные значения зависят от типа используемых узлов в этом кластере. Значение по умолчанию зависит от типа используемых узлов в этом кластере.
partition строка	Раздел устройства для управления ресурсами. По умолчанию: `"Common"`
provider словарь добавлен в f5networks.f5_modules 1.0.0	Объект словаря, содержащий данные подключения.
auth_provider строка	Настраивает поставщика аутентификации для получения маркеров аутентификации с удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.

no_f5_teem boolean	Если `yes`, данные телеметрии TEEM не отправляются на F5. Вы можете опустить этот параметр, установив переменную среды `F5_TELEMETRY_OFF`. Ранее использовавшаяся переменная `F5_TEEM` устарела, так как её имя вызывало путаницу. Варианты: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd строка / обязательно	Пароль для учетной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`.
server строка / обязательно	Хост BIG-IP или хост BIG-IQ. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
server_port целое число	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`. По умолчанию: `443`
timeout целое число	Устанавливает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истекает до завершения операции, модуль вернёт ошибку.
transport строка	Настраивает транспортное соединение для подключения к удалённому устройству. Варианты: `"rest"` ← (по умолчанию)
user строка / обязательно	Имя пользователя для подключения к BIG-IP или BIG-IQ. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
validate_certs boolean	Если `no`, сертификаты SSL не будут проверены. Используйте только на управляемых вами сайтах с самозаверенными сертификатами. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
state строка	Состояние гостя vCMP в системе. Каждое состояние подразумевает действия всех предыдущих состояний. Когда `configured`, гарантирует, что гость vCMP существует с указанными атрибутами. Кроме того, гарантирует, что гость vCMP выключен. Когда `disabled`, ведет себя так же, как `configured`, просто имеет более понятное имя. Когда `provisioned`, гарантирует создание и установку гостя. Это состояние не запускает гостя; используйте `deployed` для этой цели. Это состояние идёт на шаг дальше `present`, так как `present` не устанавливает гостя; оно лишь настраивает конфигурацию для его установки. Когда `present`, гарантирует правильное предоставление гостя и запускает гостя, чтобы он находился в рабочем состоянии. Когда `absent`, удаляет vCMP из системы. Варианты: `"configured"` `"disabled"` `"provisioned"` `"present"` ← (по умолчанию) `"absent"`
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: true
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  register: result

Значения возврата

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

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

Авторы

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

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/f5networks/f5_modules/bigip_vcmp_guest_module.html