route53_health_check - добавление или удаление проверок работоспособности в службе DNS Amazons Route53

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

Описание
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
Примечания
- Статус

Описание

Создаёт и удаляет проверки работоспособности DNS в службе Amazons Route53
При обновлении существующих проверок работоспособности учитываются только порт, путь к ресурсу, соответствие строки и интервал запросов.

Требования (к хосту, на котором выполняется модуль)

python >= 2.6
boto

Параметры

параметр	обязательно	по умолчанию	возможные значения	комментарии
aws_access_key	нет			Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. псевдонимы: ec2_access_key, access_key
aws_secret_key	нет			Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. псевдонимы: ec2_secret_key, secret_key
ec2_url	нет			URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если не используется регион. Если не задан, используется значение переменной окружения EC2_URL, если таковое есть.
failure_threshold	да	3	1 2 3 4 5 6 7 8 9 10	Количество последовательных проверок работоспособности, которые конечная точка должна пройти или не пройти, чтобы Amazon Route 53 изменил текущий статус конечной точки с нерабочей на рабочую или наоборот.
fqdn	нет			Имя домена конечной точки для проверки. Либо это, либо `ip_address` должны быть предоставлены. Если оба значения заданы, в заголовке HTTP-запроса используется `fqdn`.
ip_address	нет			IP-адрес конечной точки для проверки. Либо это, либо `fqdn` должны быть предоставлены.
port	нет			Порт конечной точки, на котором Amazon Route 53 будет выполнять проверки работоспособности. Требуется для TCP-проверок.
profile (добавлен в 1.6)	нет			Использует профиль boto. Работает только с boto >= 2.24.0.
region	нет			AWS-регион для использования. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION, если таковое есть. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region псевдонимы: aws_region, ec2_region
request_interval	да	30	10 30	Количество секунд между временем, когда Amazon Route 53 получает ответ от вашей конечной точки, и временем, когда она отправляет следующий запрос проверки работоспособности.
resource_path	нет			Путь, который вы хотите, чтобы Amazon Route 53 запрашивал при выполнении проверок работоспособности. Путь может быть любым значением, для которого ваша конечная точка вернёт HTTP-код состояния 2xx или 3xx, когда конечная точка работоспособна, например, файл /docs/route53-health-check.html. Требуется для всех проверок, кроме TCP. Путь должен начинаться с / Максимальная длина 255 символов.
security_token (добавлен в 1.6)	нет			AWS STS security token. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token
state	да		present absent	Определяет действие, которое нужно выполнить.
string_match	нет			Если тип проверки — HTTP_STR_MATCH или HTTP_STR_MATCH, строка, которую вы хотите, чтобы Amazon Route 53 искал в теле ответа от указанного ресурса. Если строка появляется в первых 5120 байтах тела ответа, Amazon Route 53 считает ресурс работоспособным.
type	да		HTTP HTTPS HTTP_STR_MATCH HTTPS_STR_MATCH TCP	Тип проверки работоспособности, который вы хотите создать, указывающий, как Amazon Route 53 определяет работоспособность конечной точки.
validate_certs (добавлен в 1.5)	нет	да	да нет	Если установлено «нет», сертификаты SSL не будут проверены для версий boto >= 2.6.0.

Примеры

# Create a health-check for host1.example.com and use it in record
- route53_health_check:
    state: present
    fqdn: host1.example.com
    type: HTTP_STR_MATCH
    resource_path: /
    string_match: "Hello"
    request_interval: 10
    failure_threshold: 2
  register: my_health_check

- route53:
    action: create
    zone: "example.com"
    type: CNAME
    record: "www.example.com"
    value: host1.example.com
    ttl: 30
    # Routing policy
    identifier: "host1@www"
    weight: 100
    health_check: "{{ my_health_check.health_check.id }}"

# Delete health-check
- route53_health_check:
    state: absent
    fqdn: host1.example.com

Примечания

Примечание

Если параметры не заданы в модуле, следующие переменные окружения могут использоваться в порядке убывания приоритета AWS_URL или EC2_URL, AWS_ACCESS_KEY_ID или AWS_ACCESS_KEY или EC2_ACCESS_KEY, AWS_SECRET_ACCESS_KEY или AWS_SECRET_KEY или EC2_SECRET_KEY, AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN, AWS_REGION или EC2_REGION
Ansible использует конфигурационный файл boto (обычно ~/.boto), если учетные данные не указаны. См. http://boto.readthedocs.org/en/latest/boto_config_tut.html
AWS_REGION или EC2_REGION могут использоваться для указания AWS региона, когда это необходимо, но это также можно настроить в файле конфигурации boto

Статус

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

Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, прочитайте Community Information & Contributing, Testing Ansible и Developing Modules.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/route53_health_check_module.html