add: documentation

2026-06-30 15:45:24 +04:00
parent 540c1f7293
commit ca276d200f
1055 changed files with 47294 additions and 0 deletions
@@ -0,0 +1,52 @@
+# Resource nubes_dnszone
+
+Service ID: `110`
+
+Service Name: DNS зона
+
+[Manual](dnszone.md) | [Create params](dnszone_params_create.md) | [Modify params](dnszone_params_modify.md) | [Output params](dnszone_outputs.md) | [Operations](dnszone_ops.md) | [Example](dnszone_example.md)
+
+## Copy-ready manifest (`dnszone_main.tf`)
+
+```hcl
+terraform {
+  required_providers {
+    nubes = {
+      source  = "terra.k8c.ru/nubes/nubes"
+      version = "2.1.23"
+    }
+  }
+}
+
+# Токен доступа api_token к Nubes API  — замените на реальный.
+provider "nubes" {
+  api_token    = "token_***"
+  api_endpoint = "https://deck-api.ngcloud.ru/api/v1/index.cfm"
+}
+resource "nubes_dnszone" "baza" {
+  zone_email = "TODO" # Контактный e-mail
+  zone_name = "TODO" # Имя зоны
+  resource_realm = "TODO" # Платформа для развертывания
+
+  # Параметры, имеющие значение по умолчанию, если не меняете - эти параметры не обязательно прописывать в манифесте
+  zone_kind = "NATIVE" # Тип зоны
+  zone_time_to_refresh = 86400 # Время ожидания ответа вторичного DNS перед запросом SOA-записи с первичных серверов
+  zone_time_to_retry = 7200 # Время в течение которого сервер повторно попробует синхронизировать информацию с первичных DNS-серверов
+  zone_time_to_expire = 3600000 # Время в течение которого вторичный DNS будет пытаться завершить синхронизацию зоны с первичным
+  zone_time_to_live = 86400 # Время, в течение которого информация будет кешироваться другими DNS-серверами
+}
+```
+
+## Outputs usage
+
+```hcl
+# Выходные параметры можно использовать как
+nubes_dnszone.baza.state_params["имя_ключа"]
+nubes_dnszone.baza.state_out["имя_ключа"]
+nubes_dnszone.baza.state_params_flat["имя_ключа"]
+nubes_dnszone.baza.state_out_flat["имя_ключа"]
+nubes_dnszone.baza.vault_secrets["имя_ключа"]
+nubes_dnszone.baza.vault_url
+nubes_dnszone.baza.vault_user_path
+nubes_dnszone.baza.vault_fields
+```