gcp_backend_service – Создание или удаление службы обратной связи
Новая версия 2.4.
УСТАРЕВШИЙ
| Удалено в Ansible: | |
|---|---|
| версия: 2.12 | |
| Почему: | Обновленные модули выпущены с повышенной функциональностью |
| Альтернатива: | Используйте gcp_compute_backend_service вместо этого. |
Синопсис
- Создание или уничтожение службы обратной связи. См. 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 boolean |
| Если значение true, включить Cloud CDN для этой службы обратной связи. |
| healthchecks - / обязательно | Список проверок работоспособности. Поддерживается только одна проверка работоспособности. | |
| port_name - | Имя порта в управляемой группе экземпляров (MIG), на который службы обратной связи могут пересылать данные. Требуется для балансировки нагрузки во внешней сети. | |
| project_id - | 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:
- 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:
- healthcheck_name_for_backend_service
port_name: myhttpport
state: present
timeout: 60
Значения возврата
Общие значения возвращаемых данных документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| backend_service_created boolean | При создании Backend Service. | Индикатор создания Backend Service. Пример: True |
| backend_service_deleted boolean | При удалении Backend Service. | Индикатор удаления Backend Service. Пример: True |
| backend_service_name string | Всегда. | Имя Backend Service. Пример: my-backend-service |
| backends list | Когда Backend Service существует. | Список бэкендов (состоящих из instance_group), составляющих Backend Service. Пример: [ { 'instance_group': 'mig_one', 'zone': 'us-central1-b'} ] |
| enable_cdn boolean | Когда Backend Service существует. | Если Cloud CDN включен. null, если не задано. Пример: True |
| healthchecks list | Когда Backend Service существует. | Список healthchecks, применённых к Backend Service. Пример: [ 'my-healthcheck' ] |
| port_name string | Когда Backend Service существует. | Имя Backend Port. Пример: myhttpport |
| protocol string | Когда Backend Service существует. | Протокол, используемый для связи с бэкендами. Пример: HTTP |
| timeout integer | Если указано. | В секундах, сколько времени должно пройти, прежде чем запрос, отправленный бэкенду, будет считаться неудачным. Пример: myhttpport |
Статус
- Этот модуль будет удалён в версии 2.12. [устаревший]
- Для получения дополнительной информации см. УСТАРЕВШЕЕ.
Авторы
- 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.9/modules/gcp_backend_service_module.html