docs: TEST_STAND locals.tf — comments on every line

TEST_STAND/CRUD/locals.tf

@@ -1,64 +1,91 @@
 # =============================================================================
-# locals.tf — все настраиваемые значения модуля CRUD (PG + Lucee + Flask)
+# locals.tf — все настраиваемые значения модуля CRUD (PG + Lucee + Flask + Node.js)
 # Никакого хардкода в ресурсах — всё здесь.
 # =============================================================================
 
 locals {
-  # ─── PostgreSQL ──────────────────────────────────────────────────────────
-  pg_resource_name = "pg4crud"
-  pg_cpu           = 500
-  pg_memory        = 512
-  pg_replicas      = 1
-  pg_disk          = 10
-  pg_version       = "17"
-  pg_retain        = 14
-  pg_schedule      = "0 0 * * *"
-  pg_timeout       = "11m"
 
-  # ─── PostgreSQL User ─────────────────────────────────────────────────────
+  # ═══════════════════════════════════════════════════════════════════════════
-  pg_username = "user4crudpg"
+  # PostgreSQL — общая БД для всех трёх приложений
-  pg_role     = "ddl_user"
+  # ═══════════════════════════════════════════════════════════════════════════
-  pg_db_name  = "db4crudpg"
 
-  # ─── Lucee ───────────────────────────────────────────────────────────────
+  pg_resource_name = "pg4crud"         # имя ресурса в Nubes
-  lucee_git_revision  = "8268568"
+  pg_cpu           = 500               # CPU в millicores (500 = 0.5 ядра)
-  lucee_resource_name = "luceecrud"
+  pg_memory        = 512               # память в MB
-  lucee_domain        = "tflucee"
+  pg_replicas      = 1                 # количество реплик
-  lucee_version       = "5.4"
+  pg_disk          = 10                # диск в GB
+  pg_version       = "17"              # версия PostgreSQL
+  pg_retain        = 14                # дней хранения бэкапов
+  pg_schedule      = "0 0 * * *"       # cron расписание бэкапов (ежедневно в полночь)
+  pg_timeout       = "11m"             # таймаут операций create/modify
+
+  # ═══════════════════════════════════════════════════════════════════════════
+  # PostgreSQL — пользователь и база данных
+  # ═══════════════════════════════════════════════════════════════════════════
+
+  pg_username = "user4crudpg"          # имя пользователя БД
+  pg_role     = "ddl_user"             # роль (ddl_user = может создавать таблицы)
+  pg_db_name  = "db4crudpg"            # имя базы данных
+
+  # ═══════════════════════════════════════════════════════════════════════════
+  # Lucee — CFML-приложение (сервис 94)
+  # ═══════════════════════════════════════════════════════════════════════════
+
+  lucee_git_revision  = "8268568"      # коммит/тег в git (менять для редеплоя)
+  lucee_resource_name = "luceecrud"    # имя ресурса в Nubes
+  lucee_domain        = "tflucee"      # домен (станет tflucee.luceek8s.test.nubes.ru)
+  lucee_version       = "5.4"          # версия Lucee (CFML engine)
   lucee_git_path      = "https://gitea.services.ngcloud.ru/Nail/tfluceecrud.git"
-  lucee_cpu           = 300
+  lucee_cpu           = 300            # CPU в millicores
-  lucee_memory        = 512
+  lucee_memory        = 512            # память в MB
-  lucee_replicas      = 1
+  lucee_replicas      = 1              # количество реплик
 
-  # ─── Таблица CRUD ────────────────────────────────────────────────────────
+  # ═══════════════════════════════════════════════════════════════════════════
-  crud_table_name = "crud_items"
+  # Таблица CRUD — общая для всех трёх приложений
+  # ═══════════════════════════════════════════════════════════════════════════
 
-  # ─── Flask ───────────────────────────────────────────────────────────────
+  crud_table_name = "crud_items"       # имя таблицы (TABLE_NAME в env)
-  flask_git_revision  = "54746e9"
+
-  flask_resource_name = "flaskcrud"
+  # ═══════════════════════════════════════════════════════════════════════════
-  flask_domain        = "tfflask"
+  # Flask — Python-приложение (сервис 89)
+  # ═══════════════════════════════════════════════════════════════════════════
+
+  flask_git_revision  = "54746e9"      # коммит/тег в git (менять для редеплоя)
+  flask_resource_name = "flaskcrud"    # имя ресурса в Nubes
+  flask_domain        = "tfflask"      # домен (станет tfflask.pythonk8s.test.nubes.ru)
   flask_git_path      = "https://gitea.services.ngcloud.ru/Nail/tfflaskcrud.git"
-  flask_cpu           = 300
+  flask_cpu           = 300            # CPU в millicores
-  flask_memory        = 512
+  flask_memory        = 512            # память в MB
-  flask_replicas      = 1
+  flask_replicas      = 1              # количество реплик
 
-  # ─── Node.js ─────────────────────────────────────────────────────────────
+  # ═══════════════════════════════════════════════════════════════════════════
-  nodejs_git_revision  = "1c646c6"
+  # Node.js — Express-приложение (сервис 95)
-  nodejs_resource_name = "nodejscrud"
+  # ═══════════════════════════════════════════════════════════════════════════
-  nodejs_domain        = "tfnodejs"
+
+  nodejs_git_revision  = "1c646c6"     # коммит/тег в git (менять для редеплоя)
+  nodejs_resource_name = "nodejscrud"  # имя ресурса в Nubes
+  nodejs_domain        = "tfnodejs"    # домен (станет tfnodejs.<суффикс>.test.nubes.ru)
   nodejs_git_path      = "https://gitea.services.ngcloud.ru/Nail/tfnodejscrud.git"
-  nodejs_cpu           = 300
+  nodejs_cpu           = 300           # CPU в millicores
-  nodejs_memory        = 512
+  nodejs_memory        = 512           # память в MB
-  nodejs_replicas      = 1
+  nodejs_replicas      = 1             # количество реплик
-  nodejs_timeout       = "15m"
+  nodejs_timeout       = "15m"         # таймаут операций create/modify
+
+  # ═══════════════════════════════════════════════════════════════════════════
+  # JDBC — параметры подключения Lucee к PostgreSQL
+  # ═══════════════════════════════════════════════════════════════════════════
 
-  # ─── JDBC / БД ───────────────────────────────────────────────────────────
   jdbc_class          = "org.postgresql.Driver"
   jdbc_bundle_name    = "org.postgresql.jdbc"
   jdbc_bundle_version = "42.6.0"
-  jdbc_conn_limit     = "5"
+  jdbc_conn_limit     = "5"            # макс. количество соединений
-  jdbc_live_timeout   = "15"
+  jdbc_live_timeout   = "15"           # таймаут неактивного соединения (минут)
-  jdbc_validate       = "false"
+  jdbc_validate       = "false"        # валидация соединения при выдаче из пула
-  pg_port             = "5432"
+
-  pg_ssl_mode         = "require"
+  # ═══════════════════════════════════════════════════════════════════════════
+  # PostgreSQL — общие параметры подключения
+  # ═══════════════════════════════════════════════════════════════════════════
+
+  pg_port     = "5432"                 # порт PostgreSQL
+  pg_ssl_mode = "require"              # SSL-режим (require = обязательно TLS)
 }