f5networks.f5_modules.bigip_routedomain – Управление областями маршрутизации на BIG-IP
Примечание
Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в плейбуке укажите: f5networks.f5_modules.bigip_routedomain.
Введен в версии 1.0.0: модуля f5networks.f5_modules
Описание
- Управление областями маршрутизации на системе BIG-IP. Область маршрутизации — это объект конфигурации BIG-IP, который изолирует сетевой трафик для определённого приложения в сети.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| bwc_policy строка | Контроллер пропускной способности для области маршрутизации. | ||
| connection_limit целое число | Максимальное количество одновременных подключений, разрешённых для области маршрутизации. Установка значения 0 отключает ограничения на подключения. | ||
| description строка | Указывает описательный текст, идентифицирующий область маршрутизации. | ||
| flow_eviction_policy строка | Политика удаления потоков для этой области маршрутизации. Применяйте политику удаления, чтобы настроить ответы на переполнения потоков и медленные потоки в области маршрутизации. | ||
| fw_enforced_policy строка | Указывает политику AFM, которая должна быть прикреплена к области маршрутизации. | ||
| id целое число | Уникальное целое число, представляющее идентификатор области маршрутизации. Это поле необходимо при создании новой области маршрутизации. В версии 2.5 это значение больше не используется для ссылки на область маршрутизации при внесении изменений (например, при обновлении и удалении). Вместо этого используется параметр name. В версии 2.6 параметр name станет обязательным. | ||
| name строка | Имя области маршрутизации. | ||
| parent строка | Указывает область маршрутизации, которую система ищет, если не может найти маршрут в конфигурированной области. | ||
| partition строка | По умолчанию: "Common" | Раздел, в котором вы хотите создать область маршрутизации. Разделы нельзя обновлять после их создания. | |
| provider словарь добавлен в версии 1.0.0 модуля f5networks.f5_modules | Объект словаря, содержащий данные подключения. | ||
| auth_provider строка | Настраивает поставщика аутентификации для получения токенов аутентификации с удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ. | ||
| no_f5_teem логическое значение |
| Если yes, данные телеметрии TEEM не отправляются в F5.Вы можете опустить этот параметр, установив переменную окружения F5_TEEM. | |
| password строка / обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную окружения F5_PASSWORD.псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Вы можете опустить этот параметр, установив переменную окружения F5_SERVER. | ||
| server_port целое число | По умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную окружения F5_SERVER_PORT. | |
| timeout целое число | Устанавливает тайм-аут в секундах для связи с сетевым устройством для подключения или отправки команд. Если тайм-аут истечёт до завершения операции, модуль выдаст ошибку. | ||
| transport строка |
| Настраивает транспортное соединение для использования при подключении к удалённому устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную окружения F5_USER. | ||
| validate_certs логическое значение |
| Если no, сертификаты SSL не будут проверены. Используйте это только на контролируемых вами сайтах, использующих самозаверяющие сертификаты.Вы можете опустить этот параметр, установив переменную окружения F5_VALIDATE_CERTS. | |
| routing_protocol список / элементы=строка |
| Динамические протоколы маршрутизации для использования системой в области маршрутизации. | |
| service_policy строка | Политика сервиса для ассоциации с областью маршрутизации. | ||
| state строка |
| Необходимо ли существование области маршрутизации. | |
| strict логическое значение |
| Указывает, применяет ли система ограничения на межсетевую маршрутизацию. | |
| vlans список / элементы=строка | VLANы для использования системой в области маршрутизации. | ||
Примечания
Примечание
- Дополнительную информацию об использовании 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 route domain
bigip_routedomain:
name: foo
id: 1234
state: present
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
- name: Set VLANs on the route domain
bigip_routedomain:
name: bar
state: present
vlans:
- net1
- foo
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| bwc_policy строка | изменённое | Новый контроллер пропускной способности. Пример: /Common/foo |
| connection_limit целое число | изменённое | Новый лимит подключений для домена маршрутизации. Пример: 100 |
| description строка | изменённое | Описание домена маршрутизации. Пример: домен маршрутизации foo |
| flow_eviction_policy строка | изменённое | Новая политика вытеснения, используемая с этим доменом маршрутизации. Пример: /Common/default-eviction-policy |
| fw_enforced_policy строка | изменённое | Указывает политику AFM, которая должна быть прикреплена к домену маршрутизации. Пример: /Common/afm-blocking-policy |
| id целое число | изменённое | Идентификатор домена маршрутизации, который был изменён. Пример: 2 |
| parent целое число | изменённое | Новый родительский домен маршрутизации. |
| routing_protocol список / элементы=строка | изменённое | Список протоколов маршрутизации, применённых к домену маршрутизации. Пример: ['bfd', 'bgp'] |
| service_policy строка | изменённое | Новая политика сервиса, используемая с этим доменом маршрутизации. Пример: /Common-my-service-policy |
| strict строка | изменённое | Новая настройка строгой изоляции. Пример: включено |
| vlans список / элементы=строка | изменённое | Список новых VLAN, к которым применяется домен маршрутизации. Пример: ['/Common/http-tunnel', '/Common/socks-tunnel'] |
Авторы
- Tim Rupp (@caphrim007)
- Wojciech Wypior (@wojtek0806)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/f5networks/f5_modules/bigip_routedomain_module.html