Модуль 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 | Слоты, на которые разрешено назначать гостя. При выборе слотов для назначения гостя хост учитывает только слоты из этого списка. Это удобный способ ограничить назначение гостей определёнными слотами или, задав непересекающиеся По умолчанию список включает все доступные слоты кластера. Это означает, что гостю по умолчанию может быть назначен любой слот. |
cores_per_slot integer | Задаёт количество ядер, выделяемых системой гостю. Каждое ядро представляет собой часть ресурсов ЦП и памяти. Поэтому объём памяти, выделяемой на одно ядро, напрямую зависит от объёма ресурсов ЦП. Этот объём памяти различается в зависимости от типа аппаратной платформы. Допустимое значение зависит от типа используемого оборудования. В случае перезагрузки система оставляет гостя в том же слоте, в котором он работал до перезагрузки. |
delete_virtual_disk boolean | Если Варианты:
|
initial_hotfix string | Задаёт файл ISO-образа исправления, применяемого поверх базового образа. |
initial_image string | Задаёт файл ISO-образа базового выпуска программного обеспечения для установки экземпляра гипервизора TMOS и всех лицензированных модулей BIG-IP на виртуальный диск гостя. При создании гостя этот параметр обязателен. Убедитесь, что этот образ находится на хосте VCMP, а не только на госте VCMP. Кроме того, ссылка на файл образа должна указывать на файл на хосте, а не на госте. |
mgmt_address string | Задаёт IP-адрес и подсеть или маску подсети, которые используются для доступа к гостю при управлении модулем, работающим внутри него. Этот параметр обязателен, если параметр При создании гостя, если сеть или маска сети не указаны, используется значение по умолчанию |
mgmt_network string | Задаёт способ использования адреса управления в госте vCMP. Если задано значение Если задано значение Если задано значение Если для гостя задано значение При изменении режима изменение Варианты:
|
mgmt_route string | Задаёт адрес шлюза для Если при создании гостя это значение не указано, используется значение Для удаления этого значения при обновлении можно использовать значение |
min_number_of_slots integer | Задаёт минимальное количество слотов, на которые необходимо назначить гостя для его развёртывания. Это поле определяет количество слотов, на которые необходимо назначить гостя. Если по завершении попытки выделения ресурсов гость назначен менее чем на указанное количество слотов, попытка завершается неудачей, а инициировавшее её изменение отменяется. Значение |
name string / обязательно | Имя управляемого гостя vCMP. |
number_of_slots integer | Задаёт количество слотов, используемых системой при создании гостя. Это значение определяет, сколько ядер из каждого назначенного гостю слота выделяется гостю. Допустимые значения зависят от типа блейдов, используемых в этом кластере. Значение по умолчанию зависит от типа блейдов, используемых в этом кластере. |
partition string | Раздел устройства, в котором будут управляться ресурсы. По умолчанию: |
provider dictionary добавлено в f5networks.f5_modules 1.0.0 | Словарь с параметрами подключения. |
|
auth_provider string |
Настраивает поставщика аутентификации для получения токенов аутентификации с удалённого устройства. Этот параметр используется главным образом при работе с устройствами BIG-IQ. |
|
no_f5_teem boolean |
Если задано значение Этот параметр можно не указывать, задав переменную окружения Ранее использовавшаяся переменная Варианты:
|
|
password псевдонимы: pass, pwd string / обязательно |
Пароль учётной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную окружения |
|
server string / обязательно |
Хост BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную окружения |
|
server_port integer |
Порт сервера BIG-IP. Этот параметр можно не указывать, задав переменную окружения По умолчанию: |
|
timeout integer |
Задаёт время ожидания в секундах при подключении к сетевому устройству или отправке ему команд. Если время ожидания истечёт до завершения операции, модуль сообщит об ошибке. |
|
transport string |
Настраивает транспортное подключение для соединения с удалённым устройством. Варианты:
|
|
user string / обязательно |
Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть административные привилегии на устройстве. Этот параметр можно не указывать, задав переменную окружения |
|
validate_certs boolean |
Если задано значение Этот параметр можно не указывать, задав переменную окружения Варианты:
|
state string | Состояние гостя vCMP в системе. Каждое состояние включает в себя действия всех предыдущих состояний. При значении При значении При значении При значении При значении Варианты:
|
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 Пример: |
Ссылки на коллекцию
© 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