Spec-Zone.ru › Ansible 2.5

bigip_device_httpd - Управление настройками HTTPD на BIG-IP

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

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

Обзор

  • Управляет настройками, связанными с HTTPD на BIG-IP. Эти настройки интересно изменять, когда нужно устанавливать таймауты интерфейса и другие параметры, связанные с TMUI.

Требования

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

  • f5-sdk >= 3.0.9
  • requests

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
allow
    Варианты:
  • all
  • IP-адрес, например 172.27.1.10
  • Диапазон IP-адресов, например 172.27.*.* или 172.27.0.0/255.255.0.0
Указывает, если доступ к HTTPD включен, IP-адрес или диапазон адресов для других систем, которые могут взаимодействовать с данной системой.
auth_name
Устанавливает имя области аутентификации BIG-IP.
auth_pam_dashboard_timeout
    Варианты:
  • no
  • yes
Устанавливает, будет ли время ожидания панели управления BIG-IP.
auth_pam_idle_timeout
Устанавливает таймаут интерфейса для автоматического выхода, в секундах.
auth_pam_validate_ip
    Варианты:
  • no
  • yes
Устанавливает параметр authPamValidateIp.
fast_cgi_timeout
Устанавливает таймаут FastCGI.
hostname_lookup
    Варианты:
  • no
  • yes
Устанавливает, отображать ли имя хоста, если возможно.
log_level
    Варианты:
  • alert
  • crit
  • debug
  • emerg
  • error
  • info
  • notice
  • warn
Устанавливает минимальный уровень журнала httpd.
max_clients
Устанавливает максимальное количество клиентов, которые могут одновременно подключиться к интерфейсу.
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 ←
Настраивает транспортное подключение для подключения к удаленному устройству.
redirect_http_to_https
    Варианты:
  • no
  • yes
Перенаправлять ли запросы http на интерфейс на https.
server
обязательно
Хост BIG-IP. Можно опустить этот параметр, если переменная среды F5_SERVER задана.
server_port
(добавлено в 2.2)
Значение по умолчанию:
443
Порт сервера BIG-IP. Можно опустить этот параметр, если переменная среды F5_SERVER_PORT задана.
ssl_port
Порт HTTPS для прослушивания.
user
обязательно
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Можно опустить этот параметр, если переменная среды F5_USER задана.
validate_certs
(добавлено в 2.0)
    Варианты:
  • no
  • yes ←
Если no, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых лично, с самозаверенными сертификатами. Можно опустить этот параметр, если переменная среды F5_VALIDATE_CERTS задана.

Примечания

Примечание

  • Требуется пакет Python requests на хосте. Это так же просто, как pip install requests.
  • Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
  • Требуется пакет Python f5-sdk на хосте. Это так же просто, как pip install f5-sdk.

Примеры

- name: Set the BIG-IP authentication realm name
  bigip_device_httpd:
    auth_name: BIG-IP
    password: secret
    server: lb.mydomain.com
    user: admin
  delegate_to: localhost

- name: Set the auth pam timeout to 3600 seconds
  bigip_device_httpd:
    auth_pam_idle_timeout: 1200
    password: secret
    server: lb.mydomain.com
    user: admin
  delegate_to: localhost

- name: Set the validate IP settings
  bigip_device_httpd:
    auth_pam_validate_ip: on
    password: secret
    server: lb.mydomain.com
    user: admin
  delegate_to: localhost

Возвращаемые значения

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

Ключ Возвращаемое значение Описание
auth_name
строка
изменено
Новое имя домена аутентификации.

Пример:
foo
auth_pam_dashboard_timeout
булево
изменено
Указывает, будет ли панель управления BIG-IP отключаться по таймауту.

auth_pam_idle_timeout
строка
изменено
Новое значение времени ожидания (в секундах) для интерфейса.

Пример:
1200
auth_pam_validate_ip
булево
изменено
Новое значение параметра authPamValidateIp.

Пример:
True
fast_cgi_timeout
целое число
изменено
Новое время ожидания FastCGI.

Пример:
500
hostname_lookup
булево
изменено
Указывает, будет ли отображаться имя хоста, если возможно.

Пример:
True
log_level
строка
изменено
Новый минимальный уровень логов httpd.

Пример:
crit
max_clients
целое число
изменено
Новое максимальное количество клиентов, которые могут одновременно подключиться к интерфейсу.

Пример:
20
redirect_http_to_https
булево
изменено
Указывает, будет ли перенаправляться http-запросы на https-интерфейс.

Пример:
True
ssl_port
целое число
изменено
Новый порт HTTPS для прослушивания.

Пример:
10443


Статус

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

Автор

  • Joe Reifel (@JoeReifel)
  • 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_device_httpd_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API