consul - Добавление, изменение и удаление служб в кластере consul.

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

Обзор

• Регистрирует службы и проверяет агента в кластере consul. Служба — это какой-либо процесс, выполняющийся на узле агента, который должен быть объявлен механизмом обнаружения consul. Она может дополнительно предоставить определение проверки — периодический тест службы для уведомления кластера consul о состоянии службы.
• Проверки также могут быть зарегистрированы на узел, например, использование дискового пространства или ЦП, и уведомлять о состоянии всего узла в кластер. Проверки на уровне службы не требуют имени или идентификатора проверки, так как они выводятся Consul из имени и идентификатора службы, добавляя «service:». Проверки на уровне узла требуют check_name и необязательно check_id.
• В настоящее время нет полного способа извлечения метаданных скрипта, интервала или ttl для зарегистрированной проверки. Без этих метаданных невозможно определить, представляют ли данные, предоставленные ansible, изменения в проверке. В результате это не пытается определить изменения и всегда будет сообщать о произошедших изменениях. Планируется метод API для предоставления этих метаданных, так что на этом этапе будет добавлено управление изменениями.
• Для получения более подробной информации см. http://consul.io.

Требования

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

• python >= 2.6
• python-consul
• requests

Параметры

Примеры

- name: register nginx service with the local consul agent
  consul:
    service_name: nginx
    service_port: 80

- name: register nginx service with curl check
  consul:
    service_name: nginx
    service_port: 80
    script: curl http://localhost
    interval: 60s

- name: register nginx with an http check
  consul:
    service_name: nginx
    service_port: 80
    interval: 60s
    http: http://localhost:80/status

- name: register external service nginx available at 10.1.5.23
  consul:
    service_name: nginx
    service_port: 80
    service_address: 10.1.5.23

- name: register nginx with some service tags
  consul:
    service_name: nginx
    service_port: 80
    tags:
      - prod
      - webservers

- name: remove nginx service
  consul:
    service_name: nginx
    state: absent

- name: register celery worker service
  consul:
    service_name: celery-worker
    tags:
      - prod
      - worker

- name: create a node level check to test disk usage
  consul:
    check_name: Disk usage
    check_id: disk_usage
    script: /opt/disk_usage.py
    interval: 5m

- name: register an http check against a service that's already registered
  consul:
    check_name: nginx-check2
    check_id: nginx-check2
    service_id: nginx
    interval: 60s
    http: http://localhost:80/morestatus

Статус

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

Автор

• Steve Gargan (@sgargan)