consul – Добавление, изменение и удаление служб в кластере consul.
Новое в версии 2.0.
Описание
- Регистрирует службы и проверяет агента в кластере consul. Служба — это какой-либо процесс, выполняющийся на узле агента, который должен быть объявлен механизмом обнаружения consul. Она может по желанию предоставить определение проверки — периодический тест службы для уведомления кластера consul о состоянии службы.
- Проверки также могут регистрироваться на узел, например, использование диска или ЦП, и сообщать о состоянии всего узла в кластер. Проверки уровня службы не требуют имени или идентификатора проверки, так как они выводятся Consul из имени службы и идентификатора соответственно путем добавления «service:». Проверки уровня узла требуют check_name и необязательно check_id.
- В настоящее время нет полного способа извлечения метаданных скрипта, интервала или ttl для зарегистрированной проверки. Без этих метаданных невозможно определить, представляет ли предоставленные данные Ansible изменение проверки. В результате это не пытается определить изменения и всегда будет сообщать об изменениях. Планируется добавить метод API для предоставления этих метаданных, после чего будет добавлена система управления изменениями.
- Дополнительную информацию см. на сайте http://consul.io.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- python-consul
- requests
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| check_id - | Идентификатор проверки службы, по умолчанию соответствует имени проверки, игнорируется, если входит в определение службы. | |
| check_name - | Имя проверки службы, по умолчанию соответствует идентификатору проверки. Требуется, если самостоятельный, игнорируется, если входит в определение службы. | |
| host - | По умолчанию: "localhost" | Хост агента consul, по умолчанию localhost |
| http - добавлено в 2.0 | Проверки могут регистрироваться с помощью конечной точки http. Это означает, что consul проверит, возвращает ли конечная точка http успешный HTTP-статус. Также необходимо указать интервал. | |
| interval - | Интервал, с которым будет выполняться проверка службы. Это число с суффиксом s или m, указывающим единицы измерения (секунды или минуты), например, 15s или 1m. Если суффикс не указан, по умолчанию используется m, например, 1 будет 1m. Требуется, если указан параметр script. | |
| notes - | Примечания, которые следует добавить к проверке при ее регистрации. | |
| port - | По умолчанию: 8500 | Порт, на котором работает агент consul |
| scheme - добавлено в 2.1 | По умолчанию: "http" | Схема протокола, на котором работает агент consul |
| script - | Скрипт/команда, которая будет периодически выполняться для проверки работоспособности службы. Для скриптов требуется интервал и наоборот | |
| service_address - добавлено в 2.1 | Адрес, который будет объявлен, что служба будет слушать. Это значение будет передано в качестве параметра Address в метод API Consul /v1/agent/service/register, поэтому см. документацию API Consul для получения дополнительной информации. | |
| service_id - | По умолчанию: "service_name if supplied" | Идентификатор службы, должен быть уникальным для каждого узла, по умолчанию соответствует имени службы, если имя службы указано |
| service_name - | Уникальное имя службы на узле, должно быть уникальным для каждого узла, требуется при регистрации службы. Может быть опущено при регистрации проверки на уровне узла | |
| service_port - | Порт, на котором слушает служба. Может быть указан для регистрации службы, т.е. если service_name или service_id заданы | |
| state - / требуется |
| регистрация или отмена регистрации службы consul, по умолчанию present |
| tags - | Список тегов, которые будут добавлены к регистрации службы. | |
| timeout - добавлено в 2.0 | Пользовательский таймаут проверки HTTP. Значение по умолчанию consul — 10 секунд. Аналогично интервалу, это число с суффиксом s или m, указывающим единицы измерения (секунды или минуты), например, 15s или 1m. | |
| token - | Ключ токена, определяющий набор правил ACL. Может потребоваться для регистрации служб. | |
| ttl - | Проверки могут быть зарегистрированы с ttl вместо скрипта и интервала, это означает, что служба будет проверять соединение с агентом до истечения срока действия ttl. Если этого не произойдет, проверка будет считаться неудачной. Требуется при регистрации проверки, если скрипт и интервал отсутствуют. Аналогично интервалу, это число с суффиксом s или m, указывающим единицы измерения (секунды или минуты), например, 15s или 1m. Если суффикс не указан, по умолчанию используется m, например, 1 будет 1m. | |
| validate_certs boolean добавлено в 2.1 |
| Требуется ли проверка сертификата TLS агента consul |
Примеры
- 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. [сообщество]
Авторы
- Steve Gargan (@sgargan)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ для его улучшения.
© 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/consul_module.html
