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,53 @@
+# Resource nubes_nextcloud
+
+Service ID: `50`
+
+Service Name: Nextcloud
+
+[Manual](nextcloud.md) | [Create params](nextcloud_params_create.md) | [Modify params](nextcloud_params_modify.md) | [Output params](nextcloud_outputs.md) | [Operations](nextcloud_ops.md) | [Example](nextcloud_example.md)
+
+## Copy-ready manifest (`nextcloud_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_nextcloud" "baza" {
+  psql_uid = "TODO"
+  redis_uid = "TODO"
+
+  # Параметры, имеющие значение по умолчанию, если не меняете - эти параметры не обязательно прописывать в манифесте
+  domain = "web01" # Если будет указан FQDN, то происходят проверки DNS на валидность А-записи, или будет добавлено в зону resourceRealm
+  resource_c_p_u = 1000 # Квота ядра пода (Указывается в mili). 1 ядро = 1000 Mili
+  resource_memory = 1024 # Квота памяти пода (Указывается в Megabytes)
+  resource_disk = 2 # Квота диска (Указывается в GIGAbytes) Диск не может быть меньше 2G (!)
+  document_server = "collabora" # Выбор сервера документов (onlyoffice)/(collabora). onlyoffice пока не доступен Размер пода collabora: 1.8 ядра. 2Gi ОЗУ
+  resource_instances = 1 # Количество узлов Не может пока быть больше одного, так как нужны SC под RWMany
+  app_version = 32.0.1
+}
+```
+
+## Outputs usage
+
+```hcl
+# Выходные параметры можно использовать как
+nubes_nextcloud.baza.state_params["имя_ключа"]
+nubes_nextcloud.baza.state_out["имя_ключа"]
+nubes_nextcloud.baza.state_params_flat["имя_ключа"]
+nubes_nextcloud.baza.state_out_flat["имя_ключа"]
+nubes_nextcloud.baza.vault_secrets["имя_ключа"]
+nubes_nextcloud.baza.vault_url
+nubes_nextcloud.baza.vault_user_path
+nubes_nextcloud.baza.vault_fields
+```