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 -	Варианты: 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:
    - 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 логическое значение	При создании сервиса обратной связи.	Индикатор создания сервиса обратной связи. Пример: True
backend_service_deleted логическое значение	При удалении сервиса обратной связи.	Индикатор удаления сервиса обратной связи. Пример: True
backend_service_name строка	Всегда.	Имя сервиса обратной связи. Пример: my-backend-service
backends список	Когда сервис обратной связи существует.	Список обратных каналов (состоящих из instance_group), составляющих сервис обратной связи. Пример: [ { 'instance_group': 'mig_one', 'zone': 'us-central1-b'} ]
enable_cdn логическое значение	При существовании сервиса обратной связи.	Если Cloud CDN включен. null, если не задано. Пример: True
healthchecks список	При существовании сервиса обратной связи.	Список проверок работоспособности, применённых к сервису обратной связи. Пример: [ 'my-healthcheck' ]
port_name строка	При существовании сервиса обратной связи.	Имя порта Backend. Пример: myhttpport
protocol строка	При существовании сервиса обратной связи.	Протокол, используемый для связи с обратными каналами. Пример: HTTP
timeout целое число	Если указано.	В секундах, сколько времени необходимо, прежде чем запрос, отправленный обратному каналу, считается неудачным. Пример: myhttpport

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [предварительная версия]
Этот модуль поддерживается сообществом 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.7/modules/gcp_backend_service_module.html