Spec-Zone.ru › Ansible

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

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.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

list / elements=string

Слоты, на которые разрешено назначать гостя.

При выборе слотов для назначения гостя хост учитывает только слоты из этого списка.

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

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

cores_per_slot

integer

Задаёт количество ядер, выделяемых системой гостю.

Каждое ядро представляет собой часть ресурсов ЦП и памяти. Поэтому объём памяти, выделяемой на одно ядро, напрямую зависит от объёма ресурсов ЦП. Этот объём памяти различается в зависимости от типа аппаратной платформы.

Допустимое значение зависит от типа используемого оборудования.

В случае перезагрузки система оставляет гостя в том же слоте, в котором он работал до перезагрузки.

delete_virtual_disk

boolean

Если state равно absent, система также удаляет виртуальный диск, связанный с гостем vCMP. По умолчанию используется значение false.

Варианты:

  • false ← (по умолчанию)
  • true

initial_hotfix

string

Задаёт файл ISO-образа исправления, применяемого поверх базового образа.

initial_image

string

Задаёт файл ISO-образа базового выпуска программного обеспечения для установки экземпляра гипервизора TMOS и всех лицензированных модулей BIG-IP на виртуальный диск гостя. При создании гостя этот параметр обязателен. Убедитесь, что этот образ находится на хосте VCMP, а не только на госте VCMP. Кроме того, ссылка на файл образа должна указывать на файл на хосте, а не на госте.

mgmt_address

string

Задаёт IP-адрес и подсеть или маску подсети, которые используются для доступа к гостю при управлении модулем, работающим внутри него. Этот параметр обязателен, если параметр mgmt_network имеет значение bridged.

При создании гостя, если сеть или маска сети не указаны, используется значение по умолчанию /24 (255.255.255.0).

mgmt_network

string

Задаёт способ использования адреса управления в госте 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

string

Задаёт адрес шлюза для mgmt_address.

Если при создании гостя это значение не указано, используется значение none.

Для удаления этого значения при обновлении можно использовать значение none.

min_number_of_slots

integer

Задаёт минимальное количество слотов, на которые необходимо назначить гостя для его развёртывания.

Это поле определяет количество слотов, на которые необходимо назначить гостя.

Если по завершении попытки выделения ресурсов гость назначен менее чем на указанное количество слотов, попытка завершается неудачей, а инициировавшее её изменение отменяется.

Значение min_number_of_slots для гостя не может превышать значение number_of_slots.

name

string / обязательно

Имя управляемого гостя vCMP.

number_of_slots

integer

Задаёт количество слотов, используемых системой при создании гостя.

Это значение определяет, сколько ядер из каждого назначенного гостю слота выделяется гостю.

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

Значение по умолчанию зависит от типа блейдов, используемых в этом кластере.

partition

string

Раздел устройства, в котором будут управляться ресурсы.

По умолчанию: "Common"

provider

dictionary

добавлено в f5networks.f5_modules 1.0.0

Словарь с параметрами подключения.

auth_provider

string

Настраивает поставщика аутентификации для получения токенов аутентификации с удалённого устройства.

Этот параметр используется главным образом при работе с устройствами BIG-IQ.

no_f5_teem

boolean

Если задано значение yes, данные телеметрии TEEM не отправляются в F5.

Этот параметр можно не указывать, задав переменную окружения F5_TELEMETRY_OFF.

Ранее использовавшаяся переменная F5_TEEM устарела, так как её имя было неоднозначным.

Варианты:

  • false ← (по умолчанию)
  • true

password

псевдонимы: pass, pwd

string / обязательно

Пароль учётной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную окружения F5_PASSWORD.

server

string / обязательно

Хост BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную окружения F5_SERVER.

server_port

integer

Порт сервера BIG-IP.

Этот параметр можно не указывать, задав переменную окружения F5_SERVER_PORT.

По умолчанию: 443

timeout

integer

Задаёт время ожидания в секундах при подключении к сетевому устройству или отправке ему команд. Если время ожидания истечёт до завершения операции, модуль сообщит об ошибке.

transport

string

Настраивает транспортное подключение для соединения с удалённым устройством.

Варианты:

  • "rest" ← (по умолчанию)

user

string / обязательно

Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть административные привилегии на устройстве.

Этот параметр можно не указывать, задав переменную окружения F5_USER.

validate_certs

boolean

Если задано значение no, сертификаты SSL не проверяются. Используйте этот параметр только на подконтрольных вам сайтах с самоподписанными сертификатами.

Этот параметр можно не указывать, задав переменную окружения F5_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

state

string

Состояние гостя vCMP в системе. Каждое состояние включает в себя действия всех предыдущих состояний.

При значении configured гарантируется, что гость vCMP существует с указанными атрибутами. Кроме того, гость vCMP выключается.

При значении disabled выполняются те же действия, что и при значении configured; это просто более понятное пользователю название.

При значении provisioned гарантируется, что гость создан и установлен. Это состояние не запускает гостя; для этого используйте deployed. Это состояние на шаг дальше, чем present, поскольку present не устанавливает гостя, а только подготавливает конфигурацию для его установки.

При значении present гарантируется, что гостю выделены необходимые ресурсы, и он запускается, переходя в рабочее состояние.

При значении absent vCMP удаляется из системы.

Варианты:

  • "configured"
  • "disabled"
  • "provisioned"
  • "present" ← (по умолчанию)
  • "absent"

vlans

list / elements=string

Сети 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

list / elements=string

Сети VLAN, назначенные гостю vCMP, в формате полного пути.

Возвращается: changed

Пример: ["/Common/vlan1", "/Common/vlan2"]

Авторы

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

Ссылки на коллекцию

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API