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

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

Обзор
- Требования
Параметры
Примечания
Примеры
Статус
Техническое обслуживание
- Автор

Обзор

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

Требования

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

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 обязательно	Варианты: 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 обязательно	Варианты: 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 или HTTPS_STR_MATCH, строка, которую вы хотите, чтобы Amazon Route 53 искал в теле ответа от указанного ресурса. Если строка появляется в первых 5120 байтах тела ответа, Amazon Route 53 считает ресурс работоспособным.
type обязательно	Варианты: HTTP HTTPS HTTP_STR_MATCH HTTPS_STR_MATCH TCP	Тип проверки работоспособности, который вы хотите создать, указывающий, как Amazon Route 53 определяет, является ли конечная точка работоспособной.
validate_certs bool (добавлен в 1.5)	Варианты: no да ←	Если установлено «нет», сертификаты SSL не будут проверены для версий boto >= 2.6.0.

Примечания

Примечание

Если параметры не заданы в модуле, можно использовать следующие переменные среды в порядке убывания приоритета 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

Примеры

# 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

Статус

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

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

zimbatm (@zimbatm)

Подсказка

Если вы заметили какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

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