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

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

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

Описание

Создаёт и удаляет проверки работоспособности DNS в сервисе Amazon 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` должны быть указаны. Если оба значения указаны, в заголовке запроса HTTP используется `fqdn`.
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 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 логический	Варианты: нет да ←	При значении "нет", сертификаты 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.8/modules/route53_health_check_module.html