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

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

Описание

Создает и удаляет проверки работоспособности 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
debug_botocore_endpoint_logs логический тип добавлено в 2.8	Варианты: нет ← да	Используйте логгер botocore.endpoint для анализа уникальных (а не общих) API-вызовов «ресурс:действие», выполненных во время задачи, выводив набор в ключ resource_actions в результатах задачи. Используйте обратный вызов aws_resource_action для вывода общего списка, созданного во время выполнения книги задач.
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`. Когда оба параметра заданы, `fqdn` используется в заголовке `Host:` HTTP-запроса.
ip_address -		IP-адрес конечной точки для проверки. Должен быть предоставлен либо этот параметр, либо `fqdn`.
port -		Порт на конечной точке, на котором Amazon Route 53 должен выполнять проверки работоспособности. Требуется для проверок TCP.
profile строка		Использует профиль 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 строка		Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token
state - / обязательно	Варианты: присутствует отсутствует	Указывает действие, которое нужно выполнить.
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 логический тип	Варианты: нет да ←	При значении «нет» сертификаты 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), если учетные данные не предоставлены. См. https://boto.readthedocs.io/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]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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