Spec-Zone.ru › Ansible 2.8

bigiq_application_https_offload – Управляет приложениями BIG-IQ HTTPS offload

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

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

Описание

  • Управляет приложениями BIG-IQ, используемыми для балансировки нагрузки веб-приложения HTTPS на порту 443 с SSL offloading на BIG-IP.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
add_analytics
boolean
    Варианты:
  • нет ←
  • да
Собирает статистику BIG-IP, на котором развернуто приложение.
Этот параметр актуален только при указании service_environment, являющегося BIG-IP, а не SSG.
client_ssl_profile
словарь
Указывает профиль SSL для управления трафиком SSL на стороне клиента.
cert_key_chain
сырые данные
Один или несколько сертификатов и ключей для ассоциации с профилем SSL.
Этот параметр всегда представляет собой список. Ключи в списке определяют детали сочетания клиент/ключ/цепь/пароль.
Обратите внимание, что BIG-IP может иметь только один из каждого типа каждого типа сертификата/ключа. Это означает, что у вас может быть только один RSA, один DSA и один ECDSA на профиль.
Если вы попытаетесь назначить два RSA, DSA или ECDSA сочетания сертификат/ключ, устройство отклонит это.
Этот список представляет собой сложный список, определяющий ряд ключей.
При создании нового профиля, если этот параметр не указан, будет использовано значение по умолчанию inherit.
cert
строка / обязательно
Указывает имя сертификата для использования.
chain
строка
Указывает цепочку сертификатов, которая актуальна для сертификата и ключа, упомянутых ранее.
Этот ключ необязателен.
key
строка / обязательно
Указывает имя ключа.
passphrase
строка
Содержит пароль к файлу ключа, если он требуется.
Пароли шифруются на удаленном устройстве BIG-IP.
name
-
Имя создаваемого и используемого профиля SSL клиента.
При создании нового приложения, если это значение не указано, будет использовано значение по умолчанию clientssl.
description
строка
Описание приложения.
inbound_virtual
словарь
Настройки для конфигурации виртуального сервера, который будет получать входящее соединение.
Этот виртуальный сервер будет использоваться для размещения HTTPS-точки входа приложения.
Трафик, предназначенный для redirect_virtual, будет перенаправлен на этот параметр, чтобы обеспечить правильное перенаправление с небезопасного на безопасный протокол.
address
строка
Указывает информацию об IP-адресе назначения, на который виртуальный сервер отправляет трафик.
Этот параметр необходим при создании нового приложения.
netmask
строка
Указывает маску сети для ассоциации с данным address.
Этот параметр необходим при создании нового приложения.
port
строка
Значение по умолчанию:
443
Порт, на котором виртуальный сервер прослушивает соединения.
При создании нового приложения, если этот параметр не указан, будет использовано значение по умолчанию 443.
name
строка / обязательно
Имя нового приложения.
password
строка / обязательно
Пароль учетной записи пользователя для подключения к BIG-IP.
Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD.

псевдонимы: pass, pwd
provider
словарь
добавлено в 2.5
Объект словаря, содержащий данные подключения.
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
строка
    Варианты:
  • cli
  • rest ←
Настраивает транспортное соединение для использования при подключении к удаленному устройству.
user
строка / обязательно
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве.
Вы можете опустить этот параметр, установив переменную среды F5_USER.
validate_certs
boolean
    Варианты:
  • нет
  • да ←
Если no, сертификаты SSL не будут проверены. Используйте это только на сайтах, находящихся под вашим контролем, использующих самозаверенные сертификаты.
Вы можете опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS.
redirect_virtual
словарь
Настройки для конфигурации виртуального сервера, который будет перенаправлять соединения.
Этот виртуальный сервер будет использоваться для размещения HTTP-точки входа приложения.
Трафик, предназначенный для этого параметра, будет перенаправлен на параметр inbound_virtual, чтобы обеспечить правильное перенаправление с небезопасного на безопасный протокол.
address
строка
Указывает информацию об IP-адресе назначения, на который виртуальный сервер отправляет трафик.
Этот параметр необходим при создании нового приложения.
netmask
строка
Указывает маску сети для ассоциации с данным address.
Этот параметр необходим при создании нового приложения.
port
строка
Значение по умолчанию:
80
Порт, на котором виртуальный сервер прослушивает соединения.
При создании нового приложения, если этот параметр не указан, будет использовано значение по умолчанию 80.
server
строка / обязательно
Хост BIG-IP.
Вы можете опустить этот параметр, установив переменную среды F5_SERVER.
server_port
целое число
добавлен в 2.2
Значение по умолчанию:
443
Порт сервера BIG-IP.
Вы можете опустить этот параметр, установив переменную окружения F5_SERVER_PORT.
servers
список
Список серверов, на которых размещено приложение.
Если вы знакомы с другими настройками BIG-IP, вы также можете рассматривать этот список как список членов пула.
При создании нового приложения требуется хотя бы один сервер.
address
строка
IP-адрес сервера.
port
строка
Значение по умолчанию:
80
Порт сервера.
service_environment
-
Указывает имя среды обслуживания или имя хоста BIG-IP, на котором будет развернуто приложение.
При создании нового приложения этот параметр обязателен.
state
строка
    Варианты:
  • absent
  • present ←
Состояние ресурса в системе.
Когда present, гарантируется, что ресурс существует с заданными атрибутами.
Когда absent, удаляет ресурс из системы.
user
строка / обязательно
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве.
Вы можете опустить этот параметр, установив переменную окружения F5_USER.
validate_certs
булево
добавлен в 2.0
    Варианты:
  • no
  • yes ←
Если no, сертификаты SSL не проверяются. Используйте только на сайтах, контролируемых вами лично, использующих самозаверяющие сертификаты.
Вы можете опустить этот параметр, установив переменную окружения F5_VALIDATE_CERTS.
wait
булево
    Варианты:
  • no
  • yes ←
Если модуль должен ждать создания, удаления или обновления приложения.

Примечания

Примечание

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

Примеры

- name: Load balance an HTTPS application on port 443 with SSL offloading on BIG-IP
  bigiq_application_https_offload:
    name: my-app
    description: Redirect HTTP to HTTPS
    service_environment: my-ssg
    servers:
      - address: 1.2.3.4
        port: 8080
      - address: 5.6.7.8
        port: 8080
    inbound_virtual:
      address: 2.2.2.2
      netmask: 255.255.255.255
      port: 443
    redirect_virtual:
      address: 2.2.2.2
      netmask: 255.255.255.255
      port: 80
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
    state: present
  delegate_to: localhost

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

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

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

Пример:
Моё приложение
inbound_virtual_destination
строка
изменено
Цель виртуального устройства, которое было создано.

Пример:
6.7.8.9
inbound_virtual_netmask
строка
изменено
Маска сети предоставленного входящего пункта назначения.

Пример:
255.255.255.0
inbound_virtual_port
целое число
изменено
Порт, на котором прослушивает входящий виртуальный адрес.

Пример:
80
servers
сложное
изменено
Список серверов и их портов, составляющих приложение.

Пример:
хеш/словарь значений
address
строка
изменено
IP-адрес сервера.

Пример:
2.3.4.5
port
целое число
изменено
Порт, на котором прослушивает сервер.

Пример:
8080
service_environment
строка
изменено
Среда, в которую было развернуто обслуживание.

Пример:
my-ssg1


Статус

  • Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
  • Этот модуль поддерживается партнером Ansible. [сертифицировано]

Авторы

  • 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.8/modules/bigiq_application_https_offload_module.html

Spec-Zone.ru

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