bigip_gtm_server — Управление серверами F5 BIG-IP GTM

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

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

Описание

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

Требования

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

f5-sdk >= 3.0.9

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
datacenter			Дата-центр, к которому принадлежит сервер. При создании нового сервера GTM это значение обязательно.
devices			Список собственных IP-адресов и переводов для каждого устройства. При создании нового сервера GTM это значение обязательно. Этот список — сложный список, в котором указывается ряд ключей. Поддерживаются несколько ключей. Ключ `name` указывает имя устройства. Имя устройства должно быть уникальным для каждого сервера. Этот ключ обязателен. Ключ `address` содержит IP-адрес или список IP-адресов целевого сервера. Этот ключ обязателен. Ключ `translation` содержит IP-адрес для перевода значения `address` выше. Этот ключ необязателен. Указание дублирующих полей `name` — это поддерживаемый способ предоставления адресов устройств. В этом случае адреса будут назначены в список адресов `name`.
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)		Значение по умолчанию: None	Объект словаря, содержащий данные подключения.
	ssh_keyfile		Указывает файл SSH-ключа, используемый для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Если значение не указано в задаче, вместо него используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout	Значение по умолчанию: 10	Указывает тайм-аут в секундах для связи с сетевым устройством при подключении или отправке команд. Если тайм-аут истекает до завершения операции, модуль выдаст ошибку.
	server обязательно		Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER` задана.
	user обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, если переменная среды `F5_USER` задана.
	server_port	Значение по умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER_PORT` задана.
	password обязательно		Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_PASSWORD` задана. псевдонимы: pass, pwd
	validate_certs	Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых лично, с использованием самозаверенных сертификатов. Вы можете опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` задана.
	transport обязательно	Варианты: rest cli ←	Настраивает транспортное подключение для подключения к удаленному устройству.
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 (добавлен в 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.

Примеры

- 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 строка	изменённое	Новая `datacenter`, к которой относится сервер. Пример: datacenter01
link_discovery строка	изменённое	Новая `link_discovery`, настроенная на удалённом устройстве. Пример: enabled
server_type строка	изменённое	Новый тип сервера. Пример: bigip
virtual_server_discovery строка	изменённое	Новое имя `virtual_server_discovery` для назначения ловушки. Пример: disabled

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимостью.

Автор

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.5/modules/bigip_gtm_server_module.html