f5networks.f5_modules.bigip_gtm_virtual_server module – Управляет виртуальными серверами 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_virtual_server.
Добавлено в f5networks.f5_modules 1.0.0
Краткое описание
- Управляет виртуальными серверами F5 BIG-IP GTM (теперь BIG-IP DNS). Сервер GTM может иметь несколько связанных с ним виртуальных серверов. Они организованы примерно так же, как участники пулов в пулах.
Параметры
Параметр | Комментарии |
|---|---|
address string | Указывает IP-адрес виртуального сервера. Этот параметр обязателен при создании виртуального сервера GTM. |
availability_requirements dictionary | Если активировано несколько мониторов работоспособности, указывает количество мониторов, которые должны получить успешные ответы, чтобы канал считался доступным. |
|
at_least integer |
Указывает минимальное количество активных мониторов работоспособности, которые должны успешно сработать, чтобы канал считался работающим. Этот параметр имеет значение только при использовании Этот параметр игнорируется, если используется тип |
|
number_of_probers integer |
Указывает количество проберов, используемых при выполнении проверок. При создании виртуального сервера, если указан этот параметр, необходимо также указать параметр Значение этого параметра всегда должно быть больше или равно значению Этот параметр имеет значение только при использовании Этот параметр игнорируется, если используется тип |
|
number_of_probes integer |
Указывает минимальное количество проб, которые должны завершиться успешно, чтобы сервер считался работающим. При создании виртуального сервера, если указан этот параметр, необходимо также указать параметр Значение этого параметра всегда должно быть меньше или равно значению Этот параметр имеет значение только при использовании Этот параметр игнорируется, если используется тип |
|
type string / обязательный |
Тип правила мониторинга, если указано При создании виртуального сервера, если это значение не указано, будет использоваться значение по умолчанию Допустимые значения:
|
limits dictionary | Указывает пороговые значения ресурсов или требования к ограничениям на уровне сервера. При включении одного или нескольких параметров ограничений система использует эти данные для вывода серверов из эксплуатации и возврата их в эксплуатацию. Можно задать любые или все параметры ограничений. Однако, если сервер не соответствует требованиям порогового значения ресурса, система помечает весь сервер как недоступный и направляет трафик балансировки нагрузки к другому ресурсу. Доступные параметры ограничений зависят от типа сервера. |
|
bits_enabled boolean |
Включено ли ограничение по битам. Этот параметр позволяет включить или отключить действие ограничения. Допустимые значения:
|
|
bits_limit integer |
Указывает максимально допустимую скорость передачи данных для виртуальных серверов на сервере в битах в секунду. Если объём сетевого трафика превышает это ограничение, система помечает сервер как недоступный. |
|
connections_enabled boolean |
Включено ли ограничение на текущее количество соединений. Этот параметр позволяет включить или отключить действие ограничения. Допустимые значения:
|
|
connections_limit integer |
Указывает максимальное совокупное количество одновременных соединений для всех виртуальных серверов на сервере. Если количество соединений превышает это ограничение, система помечает сервер как недоступный. |
|
packets_enabled boolean |
Включено ли ограничение по пакетам. Этот параметр позволяет включить или отключить действие ограничения. Допустимые значения:
|
|
packets_limit integer |
Указывает максимально допустимую скорость передачи данных для виртуальных серверов на сервере в пакетах в секунду. Если объём сетевого трафика превышает это ограничение, система помечает сервер как недоступный. |
link string | Указывает канал, который будет назначен серверу или виртуальному серверу. |
monitors list / элементы типа string | Указывает мониторы работоспособности, которые система использует для мониторинга этого ресурса. Если |
name string / обязательный | Указывает имя виртуального сервера. |
partition string | Раздел устройства, в котором управляются ресурсы. По умолчанию: |
port integer | Указывает номер порта службы виртуального сервера или участника пула. Например, для службы HTTP обычно используется порт 80. Чтобы указать все порты, используйте При создании виртуального сервера GTM, если этот параметр не указан, используется значение по умолчанию |
provider dictionary добавлено в f5networks.f5_modules 1.0.0 | Объект dict, содержащий сведения о подключении. |
|
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_name string / обязательный | Указывает имя сервера, с которым связан виртуальный сервер. |
state string | Если Если Допустимые значения:
|
translation_address string | Указывает IP-адрес трансляции для виртуального сервера. Чтобы сбросить этот параметр, укажите пустую строку ( При создании виртуального сервера GTM, если этот параметр не указан, используется значение по умолчанию |
translation_port string | Указывает номер порта трансляции или имя службы для виртуального сервера. Чтобы указать все порты, используйте При создании виртуального сервера GTM, если этот параметр не указан, используется значение по умолчанию |
virtual_server_dependencies list / элементы типа dictionary | Указывает виртуальные серверы, от которых зависит текущий виртуальный сервер. Если какой-либо из указанных серверов недоступен, текущий виртуальный сервер также помечается как недоступный. |
|
server string / обязательный |
Сервер, частью которого является зависимый виртуальный сервер. |
|
virtual_server string / обязательный |
Виртуальный сервер, от которого зависит текущий. |
Примечания
Примечание
- Дополнительные сведения об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется версия программного обеспечения BIG-IP >= 12.
- Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы сохранить конфигурацию BIG-IP на диск, обязательно добавьте хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Инструкции по правильному использованию модуля для сохранения текущей конфигурации см. в документации модуля.
Примеры
- name: Enable virtual server
bigip_gtm_virtual_server:
server_name: server1
name: my-virtual-server
state: enabled
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
address string | Новый адрес ресурса. Возвращается: changed Пример: |
availability_requirements dictionary | Новые настройки требований к доступности ресурса. Возвращается: changed Пример: |
limits dictionary | Новые настройки ограничений ресурса. Возвращается: changed Пример: |
link string | Новое значение ссылки для ресурса. Возвращается: changed Пример: |
monitors list / elements=string | Новый список мониторов ресурса. Возвращается: changed Пример: |
port integer | Новый порт ресурса. Возвращается: changed Пример: |
server_name string | Имя сервера, связанного с виртуальным сервером. Возвращается: changed Пример: |
translation_address integer | Новый адрес трансляции ресурса. Возвращается: changed Пример: |
translation_port integer | Новый порт трансляции ресурса. Возвращается: changed Пример: |
virtual_server_dependencies list / elements=string | Новый список зависимостей виртуального сервера для ресурса. Возвращается: 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_gtm_virtual_server_module.html