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,57 @@
+# Resource nubes_mariadb
+
+Service ID: `115`
+
+Service Name: Mariadb
+
+[Manual](mariadb.md) | [Create params](mariadb_params_create.md) | [Modify params](mariadb_params_modify.md) | [Output params](mariadb_outputs.md) | [Operations](mariadb_ops.md) | [Example](mariadb_example.md)
+
+## Copy-ready manifest (`mariadb_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_mariadb" "baza" {
+  resource_realm = "TODO" # Платформа для развертывания
+  s3_uid = "235e0546-..." # Экземпляр (учетная запись) S3 для резервного копирования. Резервное копирование обязательно
+
+  # Параметры, имеющие значение по умолчанию, если не меняете - эти параметры не обязательно прописывать в манифесте
+  resource_c_p_u = 500 # Квота ядра пода (milicores)
+  resource_memory = 1024 # Квота памяти пода (MBytes)
+  resource_disk = 1 # Квота диска (Указывается в GIGAbytes)
+  resource_instances = 1 # Количество узлов
+  need_external_address_master = false # Выделяет внешний (белый) IP для доступа к master
+  ext__b_a_c_k_u_p__s_c_h_e_d_u_l_e = "0 * * * *" # Не обязательный. Время запуска бекапа
+  app_version = 9.4.0 # Версия MySQL
+  auto_scale = false # Включает автоскейлинг PV. При включении параметра необходимо настроить autoScalePercentage и autoScaleTechWindow. Алерт при срабатывании вызывает modify у текущей услуги
+  auto_scale_percentage = 10 # Требует включения autoScale. Позволяет указать в процентах расширение от текущего макс объема
+  auto_scale_tech_window = 0 # Требует включения autoScale. Окно обновления (пока не реализовано). Указывается час в виде Integer (0 / 5 / 12 / 23)
+  auto_scale_quota_gb = 1 # Квота для autoScale
+}
+```
+
+## Outputs usage
+
+```hcl
+# Выходные параметры можно использовать как
+nubes_mariadb.baza.state_params["имя_ключа"]
+nubes_mariadb.baza.state_out["имя_ключа"]
+nubes_mariadb.baza.state_params_flat["имя_ключа"]
+nubes_mariadb.baza.state_out_flat["имя_ключа"]
+nubes_mariadb.baza.vault_secrets["имя_ключа"]
+nubes_mariadb.baza.vault_url
+nubes_mariadb.baza.vault_user_path
+nubes_mariadb.baza.vault_fields
+```