bigip_virtual_server - Управление виртуальными серверами F5 BIG-IP LTM
Новое в версии 2.1.
- Обзор
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Обзор
- Управляет виртуальными серверами F5 BIG-IP LTM через iControl SOAP API
Требования (к хосту, на котором выполняется модуль)
- bigsuds
Параметры
| параметр | обязательно | значение по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| all_policies (добавлен в 2.3)
| нет | None | Список всех политик, включенных для виртуального сервера. | |
| all_profiles | нет | None | Список всех профилей (HTTP, ClientSSL, ServerSSL и т.д.), которые должны использоваться виртуальным сервером | |
| all_rules (добавлен в 2.2)
| нет | None | Список правил, которые должны применяться в порядке приоритета | |
| default_persistence_profile | нет | None | Профиль по умолчанию, управляющий сохранением сеансов | |
| description | нет | None | Описание виртуального сервера | |
| destination | да | IP-адрес назначения виртуального сервера (в настоящее время поддерживается только хост). Требуется, когда state=present и VS не существует. псевдонимы: адрес, ip | ||
| enabled_vlans (добавлен в 2.2)
| нет | None | Список VLAN, которые необходимо включить. При использовании VLAN с именем ALL, все VLAN будут разрешены. | |
| fallback_persistence_profile (добавлен в 2.3)
| нет | None | Указывает профиль сохранения, который система должна использовать, если не может использовать указанный профиль сохранения по умолчанию. | |
| name | да | Имя виртуального сервера псевдонимы: vs | ||
| partition | нет | Common | Раздел | |
| password | да | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, если переменная среды F5_PASSWORD установлена. | ||
| pool | нет | None | Пул по умолчанию для виртуального сервера | |
| port | нет | None | Порт виртуального сервера. Требуется, когда state=present и VS не существует. Если вы укажете значение для этого поля, оно должно быть числом от 0 до 65535. | |
| route_advertisement_state (добавлен в 2.3)
| нет | disabled | Включить объявление маршрута для назначения | |
| server | да | Хост BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER установлена. | ||
| server_port (добавлен в 2.2)
| нет | 443 | Порт сервера BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER_PORT установлена. | |
| snat | нет | None |
| Политика адресов исходной сети |
| state | нет | present |
| Состояние виртуального сервера Absent, удалит VS, если он есть present (и его синоним enabled), создаст VS при необходимости и установит состояние в enableddisabled, создаст VS при необходимости и установит состояние в disabled |
| user | да | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Этот параметр можно опустить, если переменная среды F5_USER установлена. | ||
| validate_certs (добавлен в 2.0)
| нет | True |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяемых сертификатов. Этот параметр можно опустить, если переменная среды F5_VALIDATE_CERTS установлена. |
Примеры
- name: Add virtual server
bigip_virtual_server:
server: lb.mydomain.net
user: admin
password: secret
state: present
partition: MyPartition
name: myvirtualserver
destination: "{{ ansible_default_ipv4['address'] }}"
port: 443
pool: "{{ mypool }}"
snat: Automap
description: Test Virtual Server
all_profiles:
- http
- clientssl
enabled_vlans:
- /Common/vlan2
delegate_to: localhost
- name: Modify Port of the Virtual Server
bigip_virtual_server:
server: lb.mydomain.net
user: admin
password: secret
state: present
partition: MyPartition
name: myvirtualserver
port: 8080
delegate_to: localhost
- name: Delete virtual server
bigip_virtual_server:
server: lb.mydomain.net
user: admin
password: secret
state: absent
partition: MyPartition
name: myvirtualserver
delegate_to: localhost
Возвращаемые значения
Общие значения возврата задокументированы здесь Возвращаемые значения, следующие — поля, уникальные для этого модуля:
| имя | описание | возвращено | тип | пример |
|---|---|---|---|---|
| deleted | Имя виртуального сервера, который был удален | изменено | строка | my-virtual-server |
Примечания
Примечание
- Требуется версия ПО BIG-IP >= 11
- Требуется модуль «bigsuds», разработанный F5 (см. http://devcentral.f5.com)
- Лучше всего запускать как local_action в вашем playbook
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Для получения помощи в разработке модулей, если у вас есть желание, пожалуйста, ознакомьтесь с Справочная информация по сообществу и сотрудничеству, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/bigip_virtual_server_module.html