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	По умолчанию: None	Путь к JSON-файлу, связанному с электронным адресом учетной записи службы.
enable_cdn		Если True, включить Cloud CDN для этой службы обратной связи.
healthchecks обязательно		Список проверок работоспособности. Поддерживается только одна проверка работоспособности.
port_name	По умолчанию: None	Имя порта в управляемой группе экземпляров (MIG), на который службы обратной связи могут пересылать данные. Требуется для внешнего балансирования нагрузки.
project_id	По умолчанию: None	Идентификатор проекта GCE.
protocol		Протокол, используемый этой службой обратной связи для связи с бэкендами. Возможные значения: HTTP, HTTPS, TCP и SSL. По умолчанию — HTTP.
service_account_email	По умолчанию: None	Электронный адрес учетной записи службы.
state	Варианты: absent present ←	Желаемое состояние ресурса
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

Статус

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

Автор

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.5/modules/gcp_backend_service_module.html