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`. Если оба указаны, в заголовке `Host:` 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. Если не задан, используется значение переменной окружения 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 boolean добавлен в 1.5	Варианты: no yes ←	При установке в «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), если учетные данные не предоставлены. См. 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.7/modules/route53_health_check_module.html