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	Варианты: no yes	Если 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 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

Статус

Этот модуль будет удалён в версии 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.8/modules/gcp_backend_service_module.html