Модуль f5networks.f5_modules.bigip_gtm_server – Управляет серверами F5 BIG-IP GTM
Примечание
Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install f5networks.f5_modules.
Чтобы использовать её в плейбуке, укажите: f5networks.f5_modules.bigip_gtm_server.
Добавлено в f5networks.f5_modules 1.0.0
Краткое описание
- Управление конфигурацией серверов BIG-IP GTM (теперь BIG-IP DNS). Этот модуль позволяет изменять определения серверов на BIG-IP.
Параметры
Параметр | Комментарии |
|---|---|
availability_requirements dictionary | Если активировано несколько мониторов работоспособности, указывает количество мониторов, которые должны получить успешные ответы, чтобы канал считался доступным. |
|
at_least integer |
Указывает минимальное количество активных мониторов работоспособности, которые должны успешно пройти проверку, чтобы канал считался работающим. Этот параметр имеет значение, только если используется Этот параметр игнорируется, если используется тип |
|
number_of_probers integer |
Указывает количество проберов, которое следует использовать при выполнении проверок. При создании нового виртуального сервера, если указан этот параметр, также необходимо указать параметр Значение этого параметра всегда должно быть больше или равно значению Этот параметр имеет значение, только если используется Этот параметр игнорируется, если используется тип |
|
number_of_probes integer |
Указывает минимальное количество проверок, которые должны завершиться успешно, чтобы сервер считался работающим. При создании нового виртуального сервера, если указан этот параметр, также необходимо указать параметр Значение этого параметра всегда должно быть меньше или равно значению Этот параметр имеет значение, только если используется Этот параметр игнорируется, если используется тип |
|
type string / обязательный |
Тип правила мониторинга, если указано При создании нового пула, если это значение не указано, будет использоваться значение по умолчанию all. Варианты:
|
datacenter string | Центр обработки данных, к которому относится сервер. При создании нового сервера GTM это значение обязательно. |
devices any | Список IP-адресов self IP и преобразований для каждого устройства. При создании нового сервера GTM это значение обязательно. Этот список имеет сложную структуру и содержит несколько ключей. Ключ Ключ Ключ Указание повторяющихся полей |
iquery_options dictionary | Указывает, использует ли Global Traffic Manager эту систему BIG-IP для выполнения различных проверок перед перенаправлением трафика на нее. |
|
allow_path boolean |
Указывает, проверяет ли система логический сетевой маршрут между сервером центра обработки данных и локальным DNS-сервером. Варианты:
|
|
allow_service_check boolean |
Указывает, проверяет ли система, что приложение на сервере запущено, удаленно запуская его с помощью внешней программы проверки служб. Варианты:
|
|
allow_snmp boolean |
Указывает, проверяет ли система производительность сервера, на котором запущен агент SNMP. Варианты:
|
limits dictionary | Указывает пороговые значения ресурсов или требования к ограничениям на уровне участника пула. При включении одного или нескольких ограничений система использует эти данные для вывода участников из эксплуатации и возвращения их в работу. Можно задать любые или все ограничения. Однако, если участник не соответствует требованиям к пороговому значению ресурса, система помечает его как недоступного и направляет трафик балансировки нагрузки к другому ресурсу. |
|
bits_enabled boolean |
Указывает, включено ли ограничение битовой скорости. Этот параметр позволяет включать и отключать действие ограничения. Варианты:
|
|
bits_limit integer |
Указывает максимально допустимую скорость передачи данных для участника в битах в секунду. Если объем сетевого трафика превышает это ограничение, система помечает участника как недоступного. |
|
connections_enabled boolean |
Указывает, включено ли ограничение на количество текущих подключений. Этот параметр позволяет включать и отключать действие ограничения. Варианты:
|
|
connections_limit integer |
Указывает максимальное суммарное количество одновременных подключений для всех участников. Если количество подключений превышает это ограничение, система помечает сервер как недоступный. |
|
cpu_enabled boolean |
Указывает, включено ли ограничение на использование ЦП. Этот параметр позволяет включать и отключать действие ограничения. Варианты:
|
|
cpu_limit integer |
Указывает процент использования ЦП. Если процент использования ЦП превышает ограничение, система помечает сервер как недоступный. |
|
memory_enabled boolean |
Указывает, включено ли ограничение на использование памяти. Этот параметр позволяет включать и отключать действие ограничения. Варианты:
|
|
memory_limit integer |
Указывает объем доступной памяти, необходимый виртуальным серверам на этом сервере. Если объем доступной памяти опускается ниже этого ограничения, система помечает сервер как недоступный. |
|
packets_enabled boolean |
Указывает, включено ли ограничение на количество пакетов. Этот параметр позволяет включать и отключать действие ограничения. Варианты:
|
|
packets_limit integer |
Указывает максимально допустимую скорость передачи данных для участника в пакетах в секунду. Если объем сетевого трафика превышает это ограничение, система помечает участника как недоступного. |
link_discovery string | Указывает, выполняет ли система автоматическое обнаружение каналов для этого сервера. При создании нового сервера GTM, если этот параметр не указан, используется значение по умолчанию Если для этого параметра задано значение Варианты:
|
monitors list / elements=string | Указывает мониторы работоспособности, которые система использует для отслеживания этого ресурса. Если |
name string / обязательный | Имя сервера. Если виртуальный сервер автоматически обнаружен из LTM, при обращении к нему из модуля необходимо включить имя раздела в имя виртуального сервера, например «/Common/vsname». |
partition string | Раздел устройства для управления ресурсами. По умолчанию: |
prober_fallback string | Указывает тип пробера, используемого для мониторинга ресурсов этого сервера, если предпочтительный пробер недоступен. Этот параметр игнорируется в версии Начиная с версии Значения этого параметра взаимоисключающие со значениями параметра prober_preference, за исключением вариантов Варианты:
|
prober_pool string | Указывает имя пула проберов, используемого для мониторинга ресурсов этого сервера. В версии Имя можно указать с префиксом раздела ( В версии |
prober_preference 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 |
Если задано значение Этот параметр можно не указывать, задав переменную среды Варианты:
|
server_type псевдоним: product string | Указывает тип сервера. Тип сервера определяет метрики, которые система может собирать с сервера. При создании нового сервера GTM используется значение по умолчанию Варианты:
|
state string | Состояние сервера. Если задано значение Варианты:
|
virtual_server_discovery string | Указывает, выполняет ли система автоматическое обнаружение виртуальных серверов для этого сервера. При создании нового сервера GTM, если этот параметр не указан, используется значение по умолчанию Варианты:
|
Примечания
Примечание
- Дополнительные сведения об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется версия ПО BIG-IP >= 12.
- Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы сохранить конфигурацию BIG-IP на диске, обязательно включите хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Инструкции по правильному использованию модуля для сохранения текущей конфигурации см. в документации к модулю.
Примеры
- name: Create server "GTM_Server"
bigip_gtm_server:
name: GTM_Server
datacenter: /Common/New York
server_type: bigip
link_discovery: disabled
virtual_server_discovery: disabled
devices:
- name: server_1
address: 1.1.1.1
- name: server_2
address: 2.2.2.1
translation: 192.168.2.1
- name: server_2
address: 2.2.2.2
- name: server_3
addresses:
- address: 3.3.3.1
- address: 3.3.3.2
- name: server_4
addresses:
- address: 4.4.4.1
translation: 192.168.14.1
- address: 4.4.4.2
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
- name: Create server "GTM_Server" with expanded keys
bigip_gtm_server:
server: lb.mydomain.com
user: admin
password: secret
name: GTM_Server
datacenter: /Common/New York
server_type: bigip
link_discovery: disabled
virtual_server_discovery: disabled
devices:
- name: server_1
address: 1.1.1.1
- name: server_2
address: 2.2.2.1
translation: 192.168.2.1
- name: server_2
address: 2.2.2.2
- name: server_3
addresses:
- address: 3.3.3.1
- address: 3.3.3.2
- name: server_4
addresses:
- address: 4.4.4.1
translation: 192.168.14.1
- address: 4.4.4.2
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
bits_enabled boolean | Включено ли ограничение битовой скорости. Возвращается: при изменении Пример: |
bits_limit integer | Новое значение ограничения bits_enabled. Возвращается: при изменении Пример: |
connections_enabled boolean | Включено ли ограничение количества подключений. Возвращается: при изменении Пример: |
connections_limit integer | Новое значение ограничения connections_limit. Возвращается: при изменении Пример: |
datacenter string | Новый Возвращается: при изменении Пример: |
link_discovery string | Новая Возвращается: при изменении Пример: |
monitors list / элементы=string | Новый список мониторов для ресурса. Возвращается: при изменении Пример: |
packets_enabled boolean | Включено ли ограничение количества пакетов. Возвращается: при изменении Пример: |
packets_limit integer | Новое значение ограничения packets_limit. Возвращается: при изменении Пример: |
server_type string | Новый тип сервера. Возвращается: при изменении Пример: |
virtual_server_discovery string | Новое имя Возвращается: при изменении Пример: |
Ссылки на коллекцию
© 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_gtm_server_module.html