bigip_gtm_server – Управляет серверами F5 BIG-IP GTM

Новая в версии 2.5.

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

Управление конфигурацией серверов BIG-IP. Этот модуль позволяет управлять определениями серверов в BIG-IP.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

f5-sdk >= 3.0.16

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
datacenter -			Центр обработки данных, к которому принадлежит сервер. При создании нового сервера GTM это значение обязательно.
devices -			Список собственных IP-адресов и переводов для каждого устройства. При создании нового сервера GTM это значение обязательно. Этот список представляет собой сложный список, который определяет ряд ключей. Ключ `name` указывает имя устройства. Имя устройства должно быть уникальным для каждого сервера. Этот ключ обязателен. Ключ `address` содержит IP-адрес или список IP-адресов целевого сервера. Этот ключ обязателен. Ключ `translation` содержит IP-адрес для перевода значения `address` выше. Этот ключ необязателен. Указание дублирующих полей `name` — это поддерживаемый способ предоставления адресов устройств. В этом случае адреса будут назначены списку адресов `name`.
iquery_options - добавлено в 2.7			Указывает, использует ли Global Traffic Manager этот BIG-IP сервер для проведения различных зондирований перед делегированием трафика на него.
	allow_path boolean	Варианты: no yes	Указывает, что система проверяет логический маршрут сети между сервером центра обработки данных и локальным сервером DNS.
	allow_service_check boolean	Варианты: no yes	Указывает, что система проверяет, запущен ли на сервере какой-либо из приложений, удаленно запуская приложение с помощью внешней программы проверки служб.
	allow_snmp boolean	Варианты: no yes	Указывает, что система проверяет производительность сервера, на котором запущен SNMP-агент.
link_discovery -		Варианты: enabled disabled enabled-no-delete	Указывает, автоматически ли система обнаруживает ссылки для этого сервера. При создании нового сервера GTM, если этот параметр не указан, используется значение по умолчанию `disabled`. Если вы установите этот параметр в значение `enabled` или `enabled-no-delete`, вы также должны убедиться, что параметр `virtual_server_discovery` также установлен на `enabled` или `enabled-no-delete`.
name - / обязательно			Имя сервера.
partition - добавлено в 2.5		Значение по умолчанию: "Common"	Раздел устройства для управления ресурсами.
password - / обязательно			Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
provider - добавлено в 2.5		Значение по умолчанию: null	Объект словаря, содержащий сведения о подключении.
	password - / обязательно		Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
	server - / обязательно		Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
	server_port -	Значение по умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
	ssh_keyfile -		Указывает файл SSH-ключа для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Вы можете опустить этот параметр, установив переменную среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout -	Значение по умолчанию: 10	Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку.
	transport - / обязательно	Варианты: rest cli ←	Настраивает транспортное соединение для использования при подключении к удаленному устройству.
	user - / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
	validate_certs boolean	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте это только на контролируемых вами сайтах, использующих самозаверенные сертификаты. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.
server - / обязательно			Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
server_port - добавлено в 2.2		Значение по умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`.
server_type -		Варианты: alteon-ace-director cisco-css cisco-server-load-balancer generic-host radware-wsd windows-nt-4.0 bigip cisco-local-director-v2 extreme generic-load-balancer sun-solaris cacheflow cisco-local-director-v3 foundry-server-iron netapp windows-2000-server	Указывает тип сервера. Тип сервера определяет метрики, которые система может собирать с сервера. При создании нового сервера GTM используется значение по умолчанию `bigip`. псевдонимы: product
state -		Варианты: present ← absent enabled disabled	Состояние сервера. Если `absent`, будет предпринята попытка удалить сервер. Это удастся только в том случае, если этот сервер не используется виртуальным сервером. `present` создает сервер и включает его. Если `enabled`, включить сервер, если он существует. Если `disabled`, создать сервер, если необходимо, и установить состояние на `disabled`.
user - / обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
validate_certs boolean добавлено в 2.0		Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте это только на контролируемых вами сайтах, использующих самозаверенные сертификаты. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`.

virtual_server_discovery

Варианты:

enabled
disabled
enabled-no-delete

Указывает, автоматически ли система обнаруживает виртуальные серверы для этого сервера. При создании нового сервера GTM, если этот параметр не указан, используется значение по умолчанию disabled.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется пакет f5-sdk Python на хосте. Это делается так же просто, как pip install f5-sdk.
Требуется версия программного обеспечения BIG-IP >= 12.
Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы убедиться, что специфичная для BIG-IP конфигурация сохраняется на диске, необходимо включить хотя бы одну задачу, использующую модуль bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.

Примеры

- name: Create server "GTM_Server"
  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'}]}
  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
  delegate_to: localhost

Значения возврата

Общие значения возврата описаны в этой статье. Ниже приведены поля, уникальные для этого модуля:

Ключ	Возвращаемое значение	Описание
datacenter строка	changed	Новая `datacenter`, к которой принадлежит сервер. Пример: datacenter01
link_discovery строка	changed	Новая `link_discovery`, настроенная на удалённом устройстве. Пример: enabled
server_type строка	changed	Новый тип сервера. Пример: bigip
virtual_server_discovery строка	changed	Новое `virtual_server_discovery` имя для пункта назначения ловушки. Пример: disabled

Статус

Этот модуль гарантированно не будет иметь обратной несовместимости в будущем. [stableinterface]
Этот модуль поддерживается партнером Ansible. [certified]

Авторы

Robert Teller
Tim Rupp (@caphrim007)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/bigip_gtm_server_module.html