Ресурс openstack_dns_zone_v2 предназначен для управления DNS-зонами в сервисе DNS OpenStack (Designate). Он позволяет создавать, обновлять и удалять зоны, которые служат контейнерами для DNS-записей (A, MX, TXT и др.).
Общие сведения
Использование этого ресурса является первым шагом при настройке DNS. После создания зоны вы сможете добавлять в неё конкретные записи с помощью ресурса openstack_dns_recordset_v2.
Важно: В названии зоны обязательно должна присутствовать точка в конце (например, example.com.).
Пример использования
resource "openstack_dns_zone_v2" "example_com" {
name = "my-company.ru."
email = "admin@my-company.ru"
description = "Основная зона для корпоративных сервисов"
ttl = 3000
type = "PRIMARY"
}Параметры конфигурации (Arguments)
Ниже приведен список аргументов, которые можно использовать в конфигурации ресурса:
- region — (Необязательно) Регион, в котором следует получить DNS-клиент V2. Если этот параметр опущен, используется region провайдера. Изменение создаст новую зону.
- name — (Обязательно) Название зоны. Важно: обязательно наличие точки . в конце названия. Изменение создаст новую зону.
- project_id — (Необязательно) Идентификатор проекта (tenant), для которого создается зона. Задает заголовок X-Auth-Sudo-Tenant-ID (требуются соответствующие права в целевом проекте).
- email — (Необязательно) Контактный e-mail, указанный в SOA-записи зоны.
- type — (Необязательно) Тип зоны. Значения: PRIMARY или SECONDARY. Изменение создаст новую зону.
- attributes — (Необязательно) Атрибуты планировщика (scheduler) службы DNS. Изменение создаст новую зону.
- ttl — (Необязательно) Время жизни (Time To Live) зоны.
- description — (Необязательно) Текстовое описание зоны.
- masters — (Необязательно) Массив IP-адресов мастер-серверов. Актуально только если type установлен в SECONDARY.
- value_specs — (Необязательно) Карта дополнительных параметров (Key/Value) для передачи в API. Изменение создаст новую зону.
- disable_status_check — (Необязательно) Отключить ожидание статуса ACTIVE. По умолчанию — false. Если true, ресурс считается созданным сразу после подтверждения запроса API.
Экспортируемые атрибуты
После создания ресурса, помимо входных параметров, становятся доступны следующие данные:
- id: Уникальный идентификатор зоны в OpenStack (UUID).
- attributes: Атрибуты планировщика службы DNS.
- value_specs: Карта дополнительных параметров, переданных API.
Импорт существующей зоны
Если зона уже создана вручную или через панель управления, её можно импортировать в состояние Terraform (state):
- Простой импорт:
terraform import openstack_dns_zone_v2.zone_1 <ID_ЗОНЫ>- Импорт в конкретном проекте:
terraform import openstack_dns_zone_v2.zone_1 <ID_ЗОНЫ>/<ID_ПРОЕКТА>
