gcp_backend_service - Создание или удаление службы обратного вызова.
Новое в версии 2.4.
Обзор
- Создание или удаление службы обратного вызова. См. https://cloud.google.com/compute/docs/load-balancing/http/backend-service для общего обзора. Полные инструкции по установке и настройке модулей Google Cloud можно найти в комментариях к ansible/test/gce_tests.py.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- apache-libcloud >= 1.3.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| backend_service_name обязательно | Имя службы обратного вызова. | |
| backends обязательно | Список обратных вызовов, составляющих службу обратного вызова. Обратный вызов состоит из группы экземпляров и, необязательно, нескольких других параметров. См. https://cloud.google.com/compute/docs/reference/latest/backendServices для получения подробной информации. | |
| credentials_file | Путь к JSON-файлу, связанному с электронным адресом учетной записи службы. | |
| enable_cdn | Если true, включить Cloud CDN для этой службы обратного вызова. | |
| healthchecks обязательно | Список проверок работоспособности. Поддерживается только одна проверка работоспособности. | |
| port_name | Имя порта в управляемой группе экземпляров (MIG), на который службы обратного вызова могут передавать данные. Требуется для внешнего балансирования нагрузки. | |
| project_id | Идентификатор проекта GCE. | |
| protocol | Протокол, используемый этой службой обратного вызова для связи с обратными вызовами. Возможные значения: HTTP, HTTPS, TCP и SSL. По умолчанию - HTTP. | |
| service_account_email | Электронный адрес учетной записи службы | |
| state |
| Требуемое состояние ресурса |
| timeout | Сколько секунд ждать обратный вызов, прежде чем считать запрос неудачным. По умолчанию 30 секунд. Допустимый диапазон: 1–86400. |
Примечания
Примечание
- Обновление в настоящее время не поддерживается.
- В настоящее время поддерживаются только глобальные службы обратного вызова. Региональные обратные вызовы в настоящее время не поддерживаются.
- Внутреннее балансирование нагрузки в настоящее время не поддерживается.
Примеры
- name: Create Minimum Backend Service
gcp_backend_service:
service_account_email: "{{ service_account_email }}"
credentials_file: "{{ credentials_file }}"
project_id: "{{ project_id }}"
backend_service_name: "{{ bes }}"
backends:
- instance_group: managed_instance_group_1
healthchecks:
- name: healthcheck_name_for_backend_service
port_name: myhttpport
state: present
- name: Create BES with extended backend parameters
gcp_backend_service:
service_account_email: "{{ service_account_email }}"
credentials_file: "{{ credentials_file }}"
project_id: "{{ project_id }}"
backend_service_name: "{{ bes }}"
backends:
- instance_group: managed_instance_group_1
max_utilization: 0.6
max_rate: 10
- instance_group: managed_instance_group_2
max_utilization: 0.5
max_rate: 4
healthchecks:
- name: healthcheck_name_for_backend_service
port_name: myhttpport
state: present
timeout: 60
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| backend_service_created boolean | При создании службы обратного вызова. | Указатель того, что служба обратного вызова была создана. Пример: True |
| backend_service_deleted boolean | При удалении службы обратного вызова. | Указатель того, что служба обратного вызова была удалена. Пример: True |
| backend_service_name строка | Всегда. | Имя службы обратного вызова. Пример: my-backend-service |
| backends список | Когда служба обратного вызова существует. | Список обратных вызовов (состоящих из instance_group), составляющих службу обратного вызова. Пример: [ { 'instance_group': 'mig_one', 'zone': 'us-central1-b'} ] |
| enable_cdn boolean | Когда служба обратного вызова существует. | Если Cloud CDN включен. null, если не задано. Пример: True |
| healthchecks список | Когда служба обратного вызова существует. | Список проверок работоспособности, примененных к службе обратного вызова. Пример: [ 'my-healthcheck' ] |
| port_name строка | Когда служба обратного вызова существует. | Имя порта обратного вызова. Пример: myhttpport |
| protocol строка | Когда служба обратного вызова существует. | Протокол, используемый для связи с обратными вызовами. Пример: HTTP |
| timeout целое число | Если указано. | В секундах, сколько времени должно пройти, прежде чем запрос, отправленный на обратный вызов, будет считаться неудачным. Пример: myhttpport |
Статус
Этот модуль помечен как бета, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Tom Melendez (@supertom) <tom@supertom.com>
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете редактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/gcp_backend_service_module.html
