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

Статус

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

Для получения помощи в разработке модулей, если вы заинтересованы, прочтите Справочная информация по сообществу и участие в разработке, Тестирование Ansible и Разработка модулей.