73 lines
3.2 KiB
Markdown
73 lines
3.2 KiB
Markdown
# DNS-зоны и записи (зоны — карта)
|
|
|
|
Управление доменными зонами и их записями через Terraform вместо личного кабинета. Зоны и записи задаются одной картой `zones`.
|
|
|
|
## Что получится после `apply`
|
|
|
|
По умолчанию — 2 зоны, по 3 записи в каждой:
|
|
|
|
| Зона | Записи |
|
|
|---|---|
|
|
| `tfzone-a.test` | `www` → A `10.0.0.77, 203.0.113.14` · `api` → A · `cdn` → CNAME `www.tfzone-a.test.` |
|
|
| `tfzone-b.test` | `www` → A · `api` → A · `cdn` → CNAME |
|
|
|
|
## Ресурсы
|
|
|
|
| Ресурс | Что делает |
|
|
|---|---|
|
|
| `nubes_zones_v2` | DNS-зона |
|
|
| `nubes_zones_v2_record` | запись внутри зоны (`A`, `CNAME`, `TXT`, …) |
|
|
|
|
Запись — отдельный ресурс, поэтому одну запись можно изменить или удалить, не трогая зону целиком.
|
|
|
|
## Быстрый старт
|
|
|
|
```bash
|
|
cd dns_zones
|
|
cp terraform.tfvars.example terraform.tfvars
|
|
|
|
# 1. Создайте secrets.auto.tfvars (токен — СЕКРЕТ, НЕ в terraform.tfvars):
|
|
# api_token = "<JWT>"
|
|
# JWT берётся в ЛК: Профиль → Токены.
|
|
|
|
terraform init
|
|
terraform plan
|
|
terraform apply
|
|
```
|
|
|
|
## Как изменить зоны и записи
|
|
|
|
Всё лежит в переменной `zones` (`variables.tf` — дефолт, или переопределите в `terraform.tfvars`):
|
|
|
|
```hcl
|
|
zones = {
|
|
a = {
|
|
zone_name = "tfzone-a.test"
|
|
records = {
|
|
www = { type = "A", values = ["10.0.0.77", "203.0.113.14"] } # одно имя → несколько адресов
|
|
cdn = { type = "CNAME", values = ["www.tfzone-a.test."] } # CNAME — с точкой на конце
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Правила, которые сэкономят время:
|
|
|
|
- **Ключ карты** (`a`, `b`, `www`…) — это адрес объекта в state. Смена ключа = «удалить + создать заново», а не «переименовать». Значение (`zone_name`, `values`) меняйте свободно.
|
|
- **Несколько адресов** у одной записи — это один ресурс, а не несколько.
|
|
- **`CNAME` пишется с точкой на конце** (`www.example.com.`), иначе платформа припишет домен зоны.
|
|
|
|
## Допустимые типы записей
|
|
|
|
`A`, `AAAA`, `CNAME`, `MX`, `SRV`, `TXT`, `LUA`, `NS`, `SSHFP`.
|
|
|
|
## Важно
|
|
|
|
- **Токен** — только в `secrets.auto.tfvars` (файл в `.gitignore`). Никогда не коммитить.
|
|
- **Чтобы зона работала в интернете**, у регистратора делегируйте домен на NS `ns3.ngcloud.ru` / `ns4.ngcloud.ru`.
|
|
- **Проверка**: после `apply` повторный `terraform plan` должен дать `No changes`.
|
|
|
|
## См. также
|
|
|
|
`../dns_zones_generated/` — тот же сценарий, но зоны генерируются циклом из одного числа `zone_count` (удобно для многих однотипных зон).
|