Spec-Zone.ru › Ansible 2.7

gcp_healthcheck – Создание, обновление или удаление проверки работоспособности.

Новая версия 2.4.

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

Обзор

  • Создание, обновление или удаление проверки работоспособности. В настоящее время поддерживаются только проверки работоспособности HTTP и HTTPS. Проверки работоспособности используются для мониторинга отдельных экземпляров, управляемых групп экземпляров и/или служб обратного канала. Проверки работоспособности являются многоразовыми.
  • Для получения обзора проверок работоспособности в GCP посетите https://cloud.google.com/compute/docs/load-balancing/health-checks.
  • Подробную информацию об API проверок работоспособности HTTP см. в https://cloud.google.com/compute/docs/reference/latest/httpHealthChecks.
  • Более подробную информацию об API проверки работоспособности HTTPS см. в https://cloud.google.com/compute/docs/reference/latest/httpsHealthChecks.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

  • python >= 2.6
  • google-api-python-client >= 1.6.2
  • google-auth >= 0.9.0
  • google-auth-httplib2 >= 0.0.2

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
check_interval
-
Значение по умолчанию:
5
Частота (в секундах) отправки проверки работоспособности.
credentials_file
-
Путь к файлу JSON, связанному с адресом электронной почты учетной записи службы.
healthcheck_name
- / обязательно
Имя проверки работоспособности.
healthcheck_type
- / обязательно
    Варианты:
  • HTTP
  • HTTPS
Тип проверки работоспособности.
healthy_threshold
-
Значение по умолчанию:
2
Экземпляр, ранее неработоспособный, будет помечен как работоспособный после этого количества последовательных успехов.
host_header
- / обязательно
Значение по умолчанию:
""
Значение заголовка host в запросе проверки работоспособности. Если поле оставлено пустым, будет использован публичный IP-адрес, от имени которого выполняется эта проверка работоспособности.
port
-
Номер TCP-порта для запроса проверки работоспособности. Значение по умолчанию — 443 для HTTPS и 80 для HTTP.
project_id
-
Ваш идентификатор проекта GCP.
request_path
-
Значение по умолчанию:
"/"
Путь запроса к проверке работоспособности HTTPS.
service_account_email
-
Адрес электронной почты учетной записи службы.
service_account_permissions
-
добавлен в 2.0
    Варианты:
  • bigquery
  • cloud-platform
  • compute-ro
  • compute-rw
  • useraccounts-ro
  • useraccounts-rw
  • datastore
  • logging-write
  • monitoring
  • sql-admin
  • storage-full
  • storage-ro
  • storage-rw
  • taskqueue
  • userinfo-email
Разрешения учетной записи службы (см. https://cloud.google.com/sdk/gcloud/reference/compute/instances/create, раздел --scopes для подробной информации).
state
- / обязательно
    Варианты:
  • present
  • absent
Состояние проверки работоспособности.
timeout
-
Значение по умолчанию:
5
Время ожидания ответа (в секундах) перед признанием ошибки. Время ожидания не должно быть больше, чем интервал проверки.
unhealthy_threshold
-
Значение по умолчанию:
2
Экземпляр, ранее работоспособный, будет помечен как неработоспособный после этого количества последовательных сбоев.

Примечания

Примечание

  • В настоящее время поддерживаются только проверки работоспособности HTTP и HTTPS.

Примеры

- name: Create Minimum HealthCheck
  gcp_healthcheck:
    service_account_email: "{{ service_account_email }}"
    credentials_file: "{{ credentials_file }}"
    project_id: "{{ project_id }}"
    healthcheck_name: my-healthcheck
    healthcheck_type: HTTP
    state: present
- name: Create HTTP HealthCheck
  gcp_healthcheck:
    service_account_email: "{{ service_account_email }}"
    credentials_file: "{{ credentials_file }}"
    project_id: "{{ project_id }}"
    healthcheck_name: my-healthcheck
    healthcheck_type: HTTP
    host: my-host
    request_path: /hc
    check_interval: 10
    timeout: 30
    unhealthy_threshhold: 2
    healthy_threshhold: 1
    state: present
- name: Create HTTPS HealthCheck
  gcp_healthcheck:
    service_account_email: "{{ service_account_email }}"
    credentials_file: "{{ credentials_file }}"
    project_id: "{{ project_id }}"
    healthcheck_name: "{{ https_healthcheck }}"
    healthcheck_type: HTTPS
    host_header: my-host
    request_path: /hc
    check_interval: 5
    timeout: 5
    unhealthy_threshold: 2
    healthy_threshold: 1
    state: present

Возвращаемые значения

Общие возвращаемые значения описаны в этом месте, следующие поля уникальны для данного модуля:

Ключ Возвращаемое значение Описание
healthcheck
словарь
Всегда. Обратитесь к документации GCP для подробного описания полей.
Словарь проверки работоспособности GCP

Пример:
{'name': 'my-hc', 'port': 443, 'requestPath': '/foo'}
healthcheck_name
строка
Всегда
Имя проверки работоспособности

Пример:
my-url-map
healthcheck_type
строка
Всегда
Тип проверки работоспособности

Пример:
HTTP
state
строка
Всегда.
Состояние проверки работоспособности

Пример:
present


Статус

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API