community.general.rax_clb_ssl – Управление завершением SSL для балансировщика нагрузки Rackspace Cloud.
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Чтобы использовать его в плейбуке, укажите: community.general.rax_clb_ssl.
Обзор
- Настройка, переконфигурация или удаление завершения SSL для существующего балансировщика нагрузки.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- pyrax
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_key строка | Ключ API Rackspace, переопределяет credentials. псевдонимы: password | |
| auth_endpoint строка | URI службы аутентификации. Если не указано, будет установлено значение https://identity.api.rackspacecloud.com/v2.0/
| |
| certificate строка | Общедоступные сертификаты SSL в формате PEM. | |
| credentials путь | Файл для поиска учетных данных Rackspace. Игнорируется, если заданы api_key и username. псевдонимы: creds_file | |
| enabled логический тип |
| Если установлено значение "false", временно отключить завершение SSL без удаления существующих учетных данных. |
| env строка | Среда, настроенная в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration. | |
| https_redirect логический тип |
| Если "true", балансировщик нагрузки будет перенаправлять HTTP-трафик на HTTPS. Требуется, чтобы "secure_traffic_only" было установлено в значение true. Возможна неявная задержка, если завершение SSL также применяется или удаляется. |
| identity_type строка | По умолчанию: "rackspace" | Использовать механизм аутентификации, например, rackspace или keystone. |
| intermediate_certificate строка | Один или несколько промежуточных сертификатов центров сертификации в формате PEM, объединённые в одну строку. | |
| loadbalancer строка / обязательно | Имя или ID балансировщика нагрузки, для которого нужно управлять завершением SSL. | |
| private_key строка | Закрытый ключ SSL в формате PEM. | |
| region строка | Регион для создания экземпляра. | |
| secure_port целое число | По умолчанию: 443 | Порт для прослушивания защищенного трафика. |
| secure_traffic_only логический тип |
| Если "true", балансировщик нагрузки будет *только* принимать защищенный трафик. |
| state строка |
| Если установлено значение "present", завершение SSL будет добавлено к этому балансировщику нагрузки. Если "absent", завершение SSL будет удалено. |
| tenant_id строка | Идентификатор клиента, используемый для аутентификации. | |
| tenant_name строка | Имя клиента, используемое для аутентификации. | |
| username строка | Имя пользователя Rackspace, переопределяет credentials. | |
| validate_certs логический тип |
| Требовать или нет валидации SSL конечных точек API. псевдонимы: verify_ssl |
| wait логический тип |
| Дождаться, пока балансировщик перейдет в состояние "running", прежде чем включить. |
| wait_timeout целое число | По умолчанию: 300 | Сколько времени ждать, прежде чем "wait" прекратит ожидание, в секундах. |
Примечания
Примечание
- Можно использовать следующие переменные среды:
RAX_USERNAME,RAX_API_KEY,RAX_CREDS_FILE,RAX_CREDENTIALS,RAX_REGION. -
RAX_CREDENTIALSиRAX_CREDS_FILEуказывают на файл учетных данных, подходящий для pyrax. См. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating -
RAX_USERNAMEиRAX_API_KEYпозволяют обойти использование файла учетных данных. -
RAX_REGIONопределяет регион Rackspace Public Cloud (DFW, ORD, LON, …) - Можно использовать следующие переменные среды:
RAX_USERNAME,RAX_API_KEY,RAX_CREDS_FILE,RAX_CREDENTIALS,RAX_REGION. -
RAX_CREDENTIALSиRAX_CREDS_FILEуказывают на файл учетных данных, подходящий для pyrax. См. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating -
RAX_USERNAMEиRAX_API_KEYпозволяют обойти использование файла учетных данных. -
RAX_REGIONопределяет регион Rackspace Public Cloud (DFW, ORD, LON, …)
Примеры
- name: Enable SSL termination on a load balancer
community.general.rax_clb_ssl:
loadbalancer: the_loadbalancer
state: present
private_key: "{{ lookup('file', 'credentials/server.key' ) }}"
certificate: "{{ lookup('file', 'credentials/server.crt' ) }}"
intermediate_certificate: "{{ lookup('file', 'credentials/trust-chain.crt') }}"
secure_traffic_only: true
wait: true
- name: Disable SSL termination
community.general.rax_clb_ssl:
loadbalancer: "{{ registered_lb.balancer.id }}"
state: absent
wait: true
Авторы
- Эш Вилсон (@smashwilson)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/rax_clb_ssl_module.html