Spec-Zone.ru › Ansible 2.11

community.aws.route53_zone – добавление или удаление зон Route53

Примечание

Этот плагин является частью коллекции community.aws (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install community.aws.

Для использования в плейбуке укажите: community.aws.route53_zone.

Новое в версии 1.0.0: коллекции community.aws

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

  • Создаёт и удаляет частные и публичные зоны Route53.

Требования

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

  • boto
  • boto3
  • python >= 2.6

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
aws_access_key
строка
Ключ доступа AWS. Если не задан, используется значение переменной среды AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY.
Если задан параметр profile, этот параметр игнорируется.
Одновременное использование параметров aws_access_key и profile устарело и будет сделано взаимоисключающим после 2022-06-01.

псевдонимы: ec2_access_key, access_key
aws_ca_bundle
путь
Расположение пакета CA для проверки SSL-сертификатов.
Используется только для модулей на основе boto3.
Примечание: Пакет CA читается со стороны модуля и, возможно, требует явного копирования с контроллера, если он не запускается локально.
aws_config
словарь
Словарь для изменения конфигурации botocore.
Параметры можно найти по адресу https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config.
Для модулей boto используется только ключ 'user_agent'. Подробную информацию о конфигурации boto можно найти по адресу http://boto.cloudhackers.com/en/latest/boto_config_tut.html#boto.
aws_secret_key
строка
Секретный ключ AWS. Если не задан, используется значение переменной среды AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY.
Если задан параметр profile, этот параметр игнорируется.
Одновременное использование параметров aws_secret_key и profile устарело и будет сделано взаимоисключающим после 2022-06-01.

псевдонимы: ec2_secret_key, secret_key
comment
строка
По умолчанию:
""
Комментарий, связанный с зоной.
debug_botocore_endpoint_logs
булево
    Варианты:
  • нет ←
  • да
Используйте logger botocore.endpoint для анализа уникальных (а не полных) вызовов API «resource:action» во время задачи, выводя набор в ключ resource_actions в результатах задачи. Используйте callback aws_resource_action для вывода полного списка, созданного во время плейбука. Также можно использовать переменную среды ANSIBLE_DEBUG_BOTOCORE_LOGS.
delegation_set_id
строка
Идентификатор набора делегирования, который следует связать с зоной.
Обратите внимание, что с частной размещённой зоной нельзя связать набор делегирования.
ec2_url
строка
URL для подключения к EC2 или облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Для всех остальных модулей должен быть указан, если регион не используется. Если не задан, используется значение переменной среды EC2_URL, если таковое есть.

псевдонимы: aws_endpoint_url, endpoint_url
hosted_zone_id
строка
Уникальный идентификатор зоны, которую нужно удалить, или «all», если существует несколько зон с одинаковым именем домена.
Требуется, если существует несколько зон, определённых вышеупомянутыми параметрами.
profile
строка
Использует профиль boto. Работает только с boto >= 2.24.0.
Использование profile переопределяет aws_access_key, aws_secret_key и security_token, а поддержка их одновременного использования с profile устарела.
Параметры aws_access_key, aws_secret_key и security_token будут взаимоисключающими с profile после 2022-06-01.

псевдонимы: aws_profile
region
строка
Регион AWS для использования. Если не задан, используется значение переменной среды AWS_REGION или EC2_REGION, если таковое есть. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region

псевдонимы: aws_region, ec2_region
security_token
строка
Токен безопасности AWS STS. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN.
Если задан параметр profile, этот параметр игнорируется.
Одновременное использование параметров security_token и profile устарело и будет сделано взаимоисключающим после 2022-06-01.

псевдонимы: aws_security_token, access_token
state
строка
    Варианты:
  • present ←
  • absent
Определяет, должна ли зона существовать или нет.
validate_certs
булево
    Варианты:
  • нет
  • да ←
При значении «нет» SSL-сертификаты не будут проверяться для версий boto >= 2.6.0.
vpc_id
строка
Идентификатор VPC, к которому должна принадлежать зона (если это частная зона).
vpc_region
строка
Регион VPC, к которому должна принадлежать зона (если это частная зона).
zone
строка / обязательно
Запись DNS-зоны (например: foo.com.)

Примечания

Примечание

  • Если параметры не заданы в модуле, можно использовать следующие переменные среды в порядке убывания приоритета AWS_URL или EC2_URL, AWS_PROFILE или AWS_DEFAULT_PROFILE, 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, AWS_CA_BUNDLE
  • Ansible использует конфигурационный файл boto (обычно ~/.boto), если учетные данные не предоставлены. См. https://boto.readthedocs.io/en/latest/boto_config_tut.html
  • AWS_REGION или EC2_REGION можно использовать для указания региона AWS, когда это необходимо, но его также можно настроить в конфигурационном файле boto

Примеры

- name: create a public zone
  community.aws.route53_zone:
    zone: example.com
    comment: this is an example

- name: delete a public zone
  community.aws.route53_zone:
    zone: example.com
    state: absent

- name: create a private zone
  community.aws.route53_zone:
    zone: devel.example.com
    vpc_id: '{{ myvpc_id }}'
    vpc_region: us-west-2
    comment: developer domain

- name: create a public zone associated with a specific reusable delegation set
  community.aws.route53_zone:
    zone: example.com
    comment: reusable delegation set example
    delegation_set_id: A1BCDEF2GHIJKL

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ Возвращаемое значение Описание
comment
строка
при существовании зоны
необязательный комментарий к зоне

Пример:
Частная зона
delegation_set_id
строка
для публичных зон, если они связаны с набором делегирования
идентификатор связанного набора делегирования

Пример:
A1BCDEF2GHIJKL
name
строка
при существовании зоны
имя зоны

Пример:
private.local.
private_zone
булево
при существовании зоны
является ли зона частной или публичной

Пример:
True
vpc_id
строка
для частной зоны
идентификатор VPC, присоединённой к частной зоне

Пример:
vpc-1d36c84f
vpc_region
строка
для частной зоны
регион VPC, присоединённой к частной зоне

Пример:
eu-west-1
zone_id
строка
при существовании зоны
идентификатор зоны

Пример:
Z6JQG9820BEFMW


Авторы

  • Christopher Troup (@minichate)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/aws/route53_zone_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API