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

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

Описание
- Требования
Параметры
Примечания
Примеры
Статус
- Автор

Описание

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

Требования

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

python >= 2.6
boto

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aws_access_key	Значение по умолчанию: None	Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Псевдонимы: ec2_access_key, access_key
aws_secret_key	Значение по умолчанию: None	Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Псевдонимы: ec2_secret_key, secret_key
ec2_url	Значение по умолчанию: None	URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию используется конечная точка EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если таковое имеется.
failure_threshold обязательно	Варианты: 1 2 3 4 5 6 7 8 9 10	Количество последовательных проверок состояния, которые конечная точка должна пройти или не пройти, чтобы Amazon Route 53 изменил текущий статус конечной точки с неисправной на исправную или наоборот.
fqdn		Имя домена конечной точки для проверки. Должен быть указан либо этот параметр, либо `ip_address`. При указании обоих параметров, используется `fqdn` в заголовке `Host:` HTTP-запроса.
ip_address	Значение по умолчанию: None	IP-адрес конечной точки для проверки. Должен быть указан либо этот параметр, либо `fqdn`.
port	Значение по умолчанию: None	Порт конечной точки, на котором Amazon Route 53 должен выполнять проверки состояния. Требуется для проверок TCP.
profile (добавлено в 1.6)	Значение по умолчанию: None	Использует профиль 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	Значение по умолчанию: None	Путь, который Amazon Route 53 должен запросить при выполнении проверок состояния. Путь может быть любым значением, для которого ваша конечная точка вернёт HTTP-код состояния 2xx или 3xx, когда конечная точка работоспособна, например, файл /docs/route53-health-check.html. Требуется для всех проверок, кроме TCP. Путь должен начинаться с / Максимальная длина 255 символов.
security_token (добавлено в 1.6)	Значение по умолчанию: None	Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token
state обязательно	Варианты: present absent	Указывает действие, которое нужно выполнить.
string_match	Значение по умолчанию: None	Если тип проверки — 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 (добавлено в 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, что означает, что разработчики этого модуля гарантируют, что не будут вноситься несовместимые с предыдущими версиями изменения в интерфейс.

Автор

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.5/modules/route53_health_check_module.html