Revert "CRUD: пример переведён на схему pg/ + apps/ (как в документации)"
This reverts commit eb65f8b0d3.
This commit is contained in:
Repinoid
+47
-241
@@ -1,256 +1,62 @@
|
|||||||
# CRUD Test Stand
|
# CRUD Test Stand
|
||||||
|
|
||||||
CRUD = Create / Read / Update / Delete — создать, прочитать, изменить, удалить.
|
Три приложения (Lucee / Flask / Node.js) + общая PostgreSQL. Каждое делает CRUD в одной таблице `crud_items`.
|
||||||
|
|
||||||
Три приложения (Lucee, Flask, Node.js) работают с одной общей таблицей `crud_items` в PostgreSQL:
|
## Код приложений
|
||||||
в любом из них можно добавлять записи, просматривать их, редактировать и удалять.
|
|
||||||
|
|
||||||
Итог после запуска: добавьте запись в одном приложении — остальные два её увидят.
|
|
||||||
|
|
||||||
Манифесты: репозиторий примеров `tf_examples`, папка `CRUD`.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Быстрый старт
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# 1. получить манифесты (нужен установленный Terraform — проверьте `terraform version`)
|
|
||||||
git clone https://gitea.services.ngcloud.ru/Nail/tf_examples.git
|
|
||||||
cd tf_examples/CRUD
|
|
||||||
|
|
||||||
# 2. заполнить переменные (что именно — в разделе «Что пользователь задаёт сам»)
|
|
||||||
cd pg && cp terraform.tfvars.example terraform.tfvars # api_token, realm, s3_name
|
|
||||||
cd ../apps && cp terraform.tfvars.example terraform.tfvars # api_token, realm — те же
|
|
||||||
|
|
||||||
# 3. база данных (кластер создаётся несколько минут)
|
|
||||||
cd ../pg && terraform init && terraform apply
|
|
||||||
|
|
||||||
# 4. передать креды БД приложениям
|
|
||||||
terraform output -json > ../apps/creds.json
|
|
||||||
|
|
||||||
# 5. три приложения
|
|
||||||
cd ../apps && terraform init && terraform apply
|
|
||||||
```
|
|
||||||
|
|
||||||
После этого приложения открываются в браузере (имена заданы в `apps/locals.tf`):
|
|
||||||
|
|
||||||
| Приложение | Адрес |
|
|
||||||
|---|---|
|
|
||||||
| Lucee | <https://lucee-crud.luceek8s.dev.nubes.ru> |
|
|
||||||
| Flask | <https://flask-crud.pythonk8s.dev.nubes.ru> |
|
|
||||||
| Node.js | <https://nodejs-crud.nodejsk8s.dev.nubes.ru> |
|
|
||||||
|
|
||||||
Добавьте запись в одном приложении — она появится в двух других (таблица `crud_items` общая).
|
|
||||||
|
|
||||||
> ⚠️ В `apps/creds.json` пароль лежит **открытым текстом**: файл в `apps/.gitignore` — не коммитить и не пересылать.
|
|
||||||
|
|
||||||
Провайдер берётся из реестра: источник и версия заданы в `pg/main.tf` и `apps/main.tf`.
|
|
||||||
|
|
||||||
Подробности дальше: что задавать руками и как всё устроено.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Что создаётся
|
|
||||||
|
|
||||||
| Ресурс | Имя (по умолчанию) | Что это |
|
|
||||||
|---|---|---|
|
|
||||||
| `nubes_postgres` | `pg4crud2` | кластер PostgreSQL 17 |
|
|
||||||
| `nubes_postgres_user` | `user4crudpg` | пользователь БД, роль `ddl_user` |
|
|
||||||
| `nubes_postgres_database` | `db4crudpg` | база, владелец — этот пользователь |
|
|
||||||
| `nubes_lucee` | `lucee-crud` | приложение на Lucee 5.4 |
|
|
||||||
| `nubes_flask` | `flask-crud` | приложение на Python 3.12 |
|
|
||||||
| `nubes_nodejs` | `nodejs-crud` | приложение на Node.js 22 |
|
|
||||||
|
|
||||||
Все три приложения ходят в одну базу и одну таблицу — так видно, что CRUD работает одинаково
|
|
||||||
с любого стека.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Как это устроено
|
|
||||||
|
|
||||||
Два каталога — два отдельных файла состояния Terraform:
|
|
||||||
|
|
||||||
```
|
|
||||||
CRUD/
|
|
||||||
├── pg/ база данных: кластер PostgreSQL + пользователь + база
|
|
||||||
└── apps/ приложения: Lucee + Flask + Node.js
|
|
||||||
```
|
|
||||||
|
|
||||||
- `terraform apply` и `terraform destroy` в `apps/` меняют **только приложения** (создают, изменяют, удаляют) — база в `pg/` не затрагивается;
|
|
||||||
- `terraform apply` и `terraform destroy` в `pg/` меняют только базу — приложения в `apps/` не затрагиваются;
|
|
||||||
- приложения можно пересоздавать сколько угодно, база при этом не меняется;
|
|
||||||
- связь между каталогами — файл `apps/creds.json` (шаг 4 быстрого старта): он делается из `terraform output` в `pg/`, поэтому после смены хоста или пароля его нужно обновить и повторить `apply` в `apps/`.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Что пользователь задаёт сам
|
|
||||||
|
|
||||||
### Обязательные значения (без них `apply` не пройдёт)
|
|
||||||
|
|
||||||
| Переменная | Где | Что это |
|
|
||||||
|---|---|---|
|
|
||||||
| `api_token` | `pg/terraform.tfvars` и `apps/terraform.tfvars` | токен Nubes: ЛК → Профиль → Токены → создать «Технический» |
|
|
||||||
| `realm` | там же, **одно и то же значение** | ресурсная платформа (кластер Kubernetes), например `k8s-4-sandbox-nubes-ru`; в `apps/` обязан совпасть с `pg/`, иначе приложения не увидят кластер с базой |
|
|
||||||
| `s3_name` | `pg/terraform.tfvars` | имя (или UUID) экземпляра S3 для бэкапов: ЛК → S3 |
|
|
||||||
|
|
||||||
Файлы создаются из примеров и нужны в обеих папках:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cd pg && cp terraform.tfvars.example terraform.tfvars
|
|
||||||
cd ../apps && cp terraform.tfvars.example terraform.tfvars
|
|
||||||
```
|
|
||||||
|
|
||||||
### Имена: придумать самому, и они обязаны быть уникальными
|
|
||||||
|
|
||||||
| Имя | Где задаётся | Правило |
|
|
||||||
|---|---|---|
|
|
||||||
| `pg_resource_name` (кластер) | `pg/terraform.tfvars` | уникально **внутри сервиса `postgres`** — другого инстанса с таким именем быть не должно |
|
|
||||||
| `pg_username`, `pg_db_name` | `pg/terraform.tfvars` | уникальны в пределах кластера; служебные имена (`admin`, `postgres`, `standby`) платформа не примет |
|
|
||||||
| `lucee_resource_name`, `flask_resource_name`, `nodejs_resource_name` | `apps/locals.tf` | уникальны **внутри своего сервиса** (`lucee`, `flask`, `nodejs` — у каждого свой набор имён) |
|
|
||||||
| `lucee_domain`, `flask_domain`, `nodejs_domain` | `apps/locals.tf` | здесь задаётся **не полный домен, а имя** — суффикс платформа добавляет сама: `lucee-crud` → `lucee-crud.luceek8s.dev.nubes.ru`, `flask-crud` → `flask-crud.pythonk8s.dev.nubes.ru`, `nodejs-crud` → `nodejs-crud.nodejsk8s.dev.nubes.ru`. Полные имена уникальны (это обычные DNS-имена), поэтому и задаваемое имя должно быть уникальным |
|
|
||||||
|
|
||||||
Почему это важно: все ресурсы создаются с `adopt_existing_on_create = true`, а провайдер ищет
|
|
||||||
инстанс **по имени внутри своего сервиса**. Если такое имя уже занято, он не станет создавать
|
|
||||||
новый ресурс, а **усыновит** существующий — то есть при занятом имени можно подцепить чужой или
|
|
||||||
старый инстанс. Если усыновление отключено, `apply` упадёт с «инстанс с resource_name … уже
|
|
||||||
существует».
|
|
||||||
|
|
||||||
### Можно не задавать (есть значения по умолчанию)
|
|
||||||
|
|
||||||
`pg/main.tf`: `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"`, `pg_username="user4crudpg"`,
|
|
||||||
`pg_role="ddl_user"`, `pg_db_name="db4crudpg"`. Размеры приложений (`*_cpu`, `*_memory`,
|
|
||||||
`*_replicas`) — в `apps/locals.tf`.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Код приложений (git)
|
|
||||||
|
|
||||||
| Приложение | Репозиторий |
|
| Приложение | Репозиторий |
|
||||||
|---|---|
|
|---|---|
|
||||||
| Lucee (CFML) | `https://gitea.services.ngcloud.ru/terraform/tfluceecrud.git` |
|
| Lucee | https://gitea.services.ngcloud.ru/terraform/tfluceecrud |
|
||||||
| Flask (Python) | `https://gitea.services.ngcloud.ru/terraform/tfflaskcrud.git` |
|
| Flask | https://gitea.services.ngcloud.ru/terraform/tfflaskcrud |
|
||||||
| Node.js (Express) | `https://gitea.services.ngcloud.ru/terraform/tfnodejscrud.git` |
|
| Node.js | https://gitea.services.ngcloud.ru/terraform/tfnodejscrud |
|
||||||
|
|
||||||
Пути задаются в `apps/locals.tf` (`lucee_git_path`, `flask_git_path`, `nodejs_git_path`) —
|
## Что где менять
|
||||||
платформа сама клонирует код, собирать и заливать вручную не нужно.
|
|
||||||
|
|
||||||
Каждое приложение получает в `json_env` переменную `SERVICE_NAME` (`lucee` / `flask` / `nodejs`) —
|
### 1. `terraform.tfvars` — заполнить `terraform.tfvars.example` и переименовать в `terraform.tfvars`
|
||||||
это значение колонки `created_by`, чтобы было видно, кто добавил строку.
|
|
||||||
|
|
||||||
---
|
| Параметр | Где брать |
|
||||||
|
|
||||||
## Провайдер
|
|
||||||
|
|
||||||
Так он объявлен в `pg/main.tf` и `apps/main.tf`:
|
|
||||||
|
|
||||||
```hcl
|
|
||||||
terraform {
|
|
||||||
required_providers {
|
|
||||||
nubes = {
|
|
||||||
source = "tf-registry.containerk8s.services.ngcloud.ru/nubes-test/nubes"
|
|
||||||
version = "3.0.0"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
provider "nubes" {
|
|
||||||
api_token = var.api_token
|
|
||||||
api_endpoint = "https://lk-api-gateway-test.ngcloud.ru/api/v1/svc"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Повседневные операции
|
|
||||||
|
|
||||||
| Задача | Команда |
|
|
||||||
|---|---|
|
|---|---|
|
||||||
| Передеплоить приложения | `cd apps && terraform apply` |
|
| `api_token` | ЛК → Профиль → Токены → создать «Технический» |
|
||||||
| Удалить приложения | `cd apps && terraform destroy` — БД не трогается |
|
| `realm` | Кластер Kubernetes: `k8s-3-sandbox-nubes-ru` (песочница) или другой |
|
||||||
| Изменить БД | `cd pg && terraform apply` |
|
| `s3_name` | ЛК → S3 → Имя экземпляра |
|
||||||
| Удалить БД | `cd pg && terraform destroy` — кластер уйдёт в `Suspend`, а не удалится |
|
| `s3_user_uid` | Там же — UUID. **ИЛИ** `s3_name` — любое одно, провайдер сам найдёт пару |
|
||||||
|
|
||||||
> При `destroy` БД кластер переводится в `Suspend`, а пользователь и база остаются (`keep_on_destroy = true`).
|
### 2. `locals.tf` — сменить домены
|
||||||
> Полное удаление: снять `keep_on_destroy` в `pg/postgres_user_db.tf` и `apply`.
|
|
||||||
|
|
||||||
---
|
Каждое приложение должно иметь **уникальный** домен. Замени:
|
||||||
|
|
||||||
## Файлы
|
```
|
||||||
|
lucee_domain = "..." # станет <имя>.luceek8s.dev.nubes.ru
|
||||||
|
flask_domain = "..." # станет <имя>.pythonk8s.dev.nubes.ru
|
||||||
|
nodejs_domain = "..." # станет <имя>.<суффикс>.dev.nubes.ru
|
||||||
|
```
|
||||||
|
|
||||||
| Файл | Что делает |
|
### 3. `locals.tf` — git_revision
|
||||||
|
|
||||||
|
При изменении кода в репозиториях (`tfluceecrud`, `tfflaskcrud`, `tfnodejscrud`) — обновить `*_git_revision` на новый хеш коммита. Terraform сам сделает redeploy.
|
||||||
|
|
||||||
|
## Порядок запуска
|
||||||
|
|
||||||
|
При первом создании PG не успевает отдать пароль юзера до того как стартуют приложения — Lucee/Flask/Node.js падают с ошибкой. Проще всего сделать два apply, чем усложнять `.tf` файлы:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
terraform init
|
||||||
|
terraform apply # 1. создаст PG + пользователя + БД
|
||||||
|
terraform apply # 2. создаст Lucee + Flask + Node.js (пароль уже в стейте)
|
||||||
|
```
|
||||||
|
|
||||||
|
**Альтернатива:** закомментировать `lucee.tf`, `flask.tf`, `nodejs.tf` → `terraform apply` → раскомментировать → `terraform apply`.
|
||||||
|
|
||||||
|
Дальше — один `terraform apply` при любых изменениях.
|
||||||
|
|
||||||
|
## Состав
|
||||||
|
|
||||||
|
| Файл | Ресурс |
|
||||||
|---|---|
|
|---|---|
|
||||||
| `pg/main.tf` | провайдер, переменные кластера/пользователя/базы |
|
| `main.tf` | Провайдер (`nubes-test/nubes`) + переменные |
|
||||||
| `pg/postgres.tf` | кластер `nubes_postgres.main_pg` |
|
| `postgres.tf` | `nubes_postgres.main_pg` |
|
||||||
| `pg/postgres_user_db.tf` | пользователь `crud_user_0` + база `pg_db` |
|
| `postgres_user_db.tf` | Пользователь + БД |
|
||||||
| `pg/outputs.tf` | хост, порт, юзер, база, пароль — для выгрузки кредов |
|
| `lucee.tf` | `nubes_lucee.applucee` |
|
||||||
| `apps/main.tf` | провайдер, переменные приложений |
|
| `flask.tf` | `nubes_flask.appflask` |
|
||||||
| `apps/locals.tf` | чтение `creds.json`, домены, версии, размеры |
|
| `nodejs.tf` | `nubes_nodejs.appnodejs` |
|
||||||
| `apps/lucee.tf`, `apps/flask.tf`, `apps/nodejs.tf` | три приложения |
|
| `locals.tf` | Все настраиваемые значения |
|
||||||
| `pg/terraform.tfvars.example`, `apps/terraform.tfvars.example` | шаблоны для копирования в `terraform.tfvars` |
|
|
||||||
| `apps/creds.json` | создаётся шагом 4 быстрого старта, **не в git** |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Особенности этого примера
|
|
||||||
|
|
||||||
- **`adopt_existing_on_create = true`** у всех ресурсов — если инстанс с таким именем уже есть
|
|
||||||
(например после `destroy`, который приостанавливает, а не удаляет), провайдер его **усыновит**,
|
|
||||||
а не упадёт с «ресурс с таким именем уже существует».
|
|
||||||
- **`keep_on_destroy = true`** у пользователя и базы: при `destroy` в `pg/` кластер уходит в `Suspend`,
|
|
||||||
а пользователь и база остаются. Иначе база исчезла бы вместе с кластером. Повторный `apply`
|
|
||||||
возвращает их в state (усыновление).
|
|
||||||
- **Домены приложений должны быть уникальными** — `lucee_domain`, `flask_domain`, `nodejs_domain`
|
|
||||||
в `apps/locals.tf`. Иначе платформа откажет.
|
|
||||||
- **`postgres_conf`** — ключи строго как в спецификации платформы: `paramName` / `paramValue`
|
|
||||||
(camelCase). Допустимы только `log_connections` и `log_disconnections`.
|
|
||||||
- **`realm`** — рабочая ресурсная платформа. Если у неё нет ёмкости, операция падает
|
|
||||||
с сообщением «Невозможно развернуть приложение в данной ресурсной платформе».
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Справка: выходные параметры `pg/`
|
|
||||||
|
|
||||||
В `pg/outputs.tf` объявлено шесть выходов:
|
|
||||||
|
|
||||||
| Выход | Значение | Откуда |
|
|
||||||
|---|---|---|
|
|
||||||
| `pg_host` | внутренний хост master — приложения ходят к базе по внутренней сети кластера, а сами приложения открываются по внешним доменам (см. «Быстрый старт») | `state_out_flat["internalMaster"]` кластера |
|
|
||||||
| `pg_port` | `5432` | константа в `outputs.tf` |
|
|
||||||
| `pg_username` | имя пользователя БД | выход подресурса `nubes_postgres_user` |
|
|
||||||
| `pg_db_name` | имя базы | выход `nubes_postgres_database` |
|
|
||||||
| `pg_password` | пароль, `sensitive = true` | выход подресурса `nubes_postgres_user`: платформа генерирует пароль сама при создании пользователя, провайдер читает его из Vault и отдаёт выходом подресурса |
|
|
||||||
| `pg_ssl_mode` | `require` | константа в `outputs.tf` |
|
|
||||||
|
|
||||||
`terraform output -json` кладёт в файл не голые значения, а объекты вида `{ "sensitive": ..., "type": ..., "value": ... }`:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"pg_host": { "sensitive": false, "type": "string", "value": "<хост master>" },
|
|
||||||
"pg_password": { "sensitive": true, "type": "string", "value": "<пароль>" }
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Поэтому в `apps/locals.tf` значение берётся через `.value`:
|
|
||||||
|
|
||||||
```hcl
|
|
||||||
creds = jsondecode(file("${path.module}/creds.json"))
|
|
||||||
pg_host = local.creds.pg_host.value
|
|
||||||
pg_pass = local.creds.pg_password.value
|
|
||||||
```
|
|
||||||
|
|
||||||
Дальше `apps/*.tf` передают эти значения приложениям как переменные окружения:
|
|
||||||
|
|
||||||
| Выход `pg/` | Flask | Node.js | Lucee |
|
|
||||||
|---|---|---|---|
|
|
||||||
| `pg_host` | `PGHOST` | `PGHOST` | `PGHOST` |
|
|
||||||
| `pg_port` | `PGPORT` | `PGPORT` | `PGPORT` |
|
|
||||||
| `pg_username` | `PGUSER` | `PGUSER` | `PGUSER` |
|
|
||||||
| `pg_password` | `PGPASSWORD` | `PGPASSWORD` | `PGPASSWORD` |
|
|
||||||
| `pg_db_name` | `PGDATABASE` | `PGDATABASE` | — (входит в строки подключения ниже) |
|
|
||||||
| `pg_ssl_mode` | `PGSSLMODE` | `PGSSLMODE` | `PGSSLMODE` |
|
|
||||||
|
|
||||||
Кроме этого Lucee получает `testds_connectionString` и `DATABASE_URL` — это **строки подключения**,
|
|
||||||
собранные из хоста, порта, пользователя, пароля и имени базы (`apps/lucee.tf`), а не отдельные
|
|
||||||
значения выходов. Остальные `testds_*` (`class`, `bundleName`, `bundleVersion`, `username`,
|
|
||||||
`password`, `connectionLimit`, `liveTimeout`, `validate`) — параметры JDBC-драйвера.
|
|
||||||
|
|||||||
@@ -1,22 +0,0 @@
|
|||||||
# =============================================================================
|
|
||||||
# .gitignore папки apps/ — СЕКРЕТЫ И ЛОКАЛЬНОЕ СОСТОЯНИЕ, в git не коммитить
|
|
||||||
# =============================================================================
|
|
||||||
|
|
||||||
# Креды БД, выгруженные из ../pg/ (внутри — пароль в открытом виде!)
|
|
||||||
creds.json
|
|
||||||
|
|
||||||
# Переменные с токеном
|
|
||||||
terraform.tfvars
|
|
||||||
|
|
||||||
# Локальный state и кэш провайдера — своё у каждого, не коммитится
|
|
||||||
.terraform/
|
|
||||||
.terraform.lock.hcl
|
|
||||||
terraform.tfstate
|
|
||||||
terraform.tfstate.backup
|
|
||||||
*.tfstate
|
|
||||||
*.tfstate.*
|
|
||||||
.terraform.tfstate.lock.info
|
|
||||||
|
|
||||||
# Прочее локальное
|
|
||||||
crash.log
|
|
||||||
*.tfplan
|
|
||||||
@@ -1,44 +0,0 @@
|
|||||||
# =============================================================================
|
|
||||||
# Flask — Python-приложение (CRUD, та же БД и таблица, что у Lucee/Node.js)
|
|
||||||
# =============================================================================
|
|
||||||
#
|
|
||||||
# Креды БД приходят из файла apps/creds.json (см. apps/locals.tf).
|
|
||||||
# =============================================================================
|
|
||||||
|
|
||||||
resource "nubes_flask" "appflask" {
|
|
||||||
resource_name = local.flask_resource_name
|
|
||||||
|
|
||||||
adopt_existing_on_create = true
|
|
||||||
|
|
||||||
startup_configuration = {
|
|
||||||
resource_realm = var.realm
|
|
||||||
}
|
|
||||||
|
|
||||||
cluster_configuration = {
|
|
||||||
cpu = local.flask_cpu
|
|
||||||
memory = local.flask_memory
|
|
||||||
replicas = local.flask_replicas
|
|
||||||
}
|
|
||||||
|
|
||||||
access_configuration = {
|
|
||||||
domain = local.flask_domain
|
|
||||||
}
|
|
||||||
|
|
||||||
app_configuration = {
|
|
||||||
version = "3.12"
|
|
||||||
git_path = local.flask_git_path
|
|
||||||
health_path = "/"
|
|
||||||
}
|
|
||||||
|
|
||||||
json_env = jsonencode({
|
|
||||||
TABLE_NAME = local.crud_table_name
|
|
||||||
# SERVICE_NAME — значение колонки created_by («кто добавил строку»).
|
|
||||||
SERVICE_NAME = "flask"
|
|
||||||
PGHOST = local.pg_host
|
|
||||||
PGPORT = local.pg_port
|
|
||||||
PGUSER = local.pg_user
|
|
||||||
PGPASSWORD = local.pg_pass
|
|
||||||
PGDATABASE = local.pg_db
|
|
||||||
PGSSLMODE = local.pg_ssl
|
|
||||||
})
|
|
||||||
}
|
|
||||||
@@ -1,85 +0,0 @@
|
|||||||
# =============================================================================
|
|
||||||
# APPS — все настраиваемые значения + чтение кредов БД
|
|
||||||
# =============================================================================
|
|
||||||
|
|
||||||
locals {
|
|
||||||
|
|
||||||
# ═══════════════════════════════════════════════════════════════════════════
|
|
||||||
# КРЕДЫ БД — берутся из файла, выгруженного из папки ../pg/
|
|
||||||
# ═══════════════════════════════════════════════════════════════════════════
|
|
||||||
#
|
|
||||||
# Порядок (см. ../README.md):
|
|
||||||
# 1) cd ../pg && terraform apply
|
|
||||||
# 2) cd ../pg && terraform output -json > ../apps/creds.json
|
|
||||||
# 3) cd ../apps && terraform apply
|
|
||||||
#
|
|
||||||
# Почему через файл: pg/ и apps/ — РАЗНЫЕ состояния Terraform, значения между
|
|
||||||
# ними сами не передаются. Поэтому креды передаются явной выгрузкой outputs → файлом.
|
|
||||||
#
|
|
||||||
# Структура creds.json (так отдаёт `terraform output -json`):
|
|
||||||
# { "pg_host": { "sensitive": false, "type": "string", "value": "..." }, ... }
|
|
||||||
# Отсюда и обращение `local.creds.pg_host.value`.
|
|
||||||
#
|
|
||||||
# Пароль в открытом виде! Файл в .gitignore — в git не коммитить.
|
|
||||||
# При ротации пароля (повторный create_user) — перегенерить файл шагом 2.
|
|
||||||
creds = jsondecode(file("${path.module}/creds.json"))
|
|
||||||
|
|
||||||
pg_host = local.creds.pg_host.value
|
|
||||||
pg_port = local.creds.pg_port.value
|
|
||||||
pg_user = local.creds.pg_username.value
|
|
||||||
pg_pass = local.creds.pg_password.value
|
|
||||||
pg_db = local.creds.pg_db_name.value
|
|
||||||
pg_ssl = local.creds.pg_ssl_mode.value
|
|
||||||
|
|
||||||
# ═══════════════════════════════════════════════════════════════════════════
|
|
||||||
# Общая таблица CRUD — одна на все три приложения
|
|
||||||
# ═══════════════════════════════════════════════════════════════════════════
|
|
||||||
|
|
||||||
crud_table_name = "crud_items"
|
|
||||||
|
|
||||||
# ═══════════════════════════════════════════════════════════════════════════
|
|
||||||
# Lucee — CFML-приложение (сервис 94)
|
|
||||||
# ═══════════════════════════════════════════════════════════════════════════
|
|
||||||
|
|
||||||
lucee_resource_name = "lucee-crud" # имя ресурса в Nubes
|
|
||||||
lucee_domain = "lucee-crud" # домен → lucee-crud.luceek8s.dev.nubes.ru. Прежний tflucee занят старым инстансом
|
|
||||||
lucee_version = "5.4"
|
|
||||||
lucee_git_path = "https://gitea.services.ngcloud.ru/terraform/tfluceecrud.git"
|
|
||||||
lucee_cpu = 300
|
|
||||||
lucee_memory = 512
|
|
||||||
lucee_replicas = 1
|
|
||||||
|
|
||||||
# ═══════════════════════════════════════════════════════════════════════════
|
|
||||||
# Flask — Python-приложение (сервис 89)
|
|
||||||
# ═══════════════════════════════════════════════════════════════════════════
|
|
||||||
|
|
||||||
flask_resource_name = "flask-crud"
|
|
||||||
flask_domain = "flask-crud" # → flask-crud.pythonk8s.dev.nubes.ru. Прежний tfflask занят старым инстансом
|
|
||||||
flask_git_path = "https://gitea.services.ngcloud.ru/terraform/tfflaskcrud.git"
|
|
||||||
flask_cpu = 300
|
|
||||||
flask_memory = 512
|
|
||||||
flask_replicas = 1
|
|
||||||
|
|
||||||
# ═══════════════════════════════════════════════════════════════════════════
|
|
||||||
# Node.js — Express-приложение (сервис 95)
|
|
||||||
# ═══════════════════════════════════════════════════════════════════════════
|
|
||||||
|
|
||||||
nodejs_resource_name = "nodejs-crud"
|
|
||||||
nodejs_domain = "nodejs-crud" # → nodejs-crud.<суффикс>.dev.nubes.ru. Прежний tfnodejs занят старым инстансом
|
|
||||||
nodejs_git_path = "https://gitea.services.ngcloud.ru/terraform/tfnodejscrud.git"
|
|
||||||
nodejs_cpu = 300
|
|
||||||
nodejs_memory = 512
|
|
||||||
nodejs_replicas = 1
|
|
||||||
nodejs_timeout = "15m"
|
|
||||||
|
|
||||||
# ═══════════════════════════════════════════════════════════════════════════
|
|
||||||
# JDBC — параметры подключения Lucee к PostgreSQL
|
|
||||||
# ═══════════════════════════════════════════════════════════════════════════
|
|
||||||
|
|
||||||
jdbc_class = "org.postgresql.Driver"
|
|
||||||
jdbc_bundle_name = "org.postgresql.jdbc"
|
|
||||||
jdbc_bundle_version = "42.6.0"
|
|
||||||
jdbc_conn_limit = "5"
|
|
||||||
jdbc_live_timeout = "15"
|
|
||||||
jdbc_validate = "false"
|
|
||||||
}
|
|
||||||
@@ -1,62 +0,0 @@
|
|||||||
# =============================================================================
|
|
||||||
# Lucee — CFML-приложение (CRUD в общей таблице crud_items)
|
|
||||||
# =============================================================================
|
|
||||||
#
|
|
||||||
# Креды БД приходят из файла apps/creds.json (см. apps/locals.tf).
|
|
||||||
# =============================================================================
|
|
||||||
|
|
||||||
resource "nubes_lucee" "applucee" {
|
|
||||||
resource_name = local.lucee_resource_name
|
|
||||||
|
|
||||||
# Если в облаке уже есть инстанс с таким именем — усыновить его, а не падать.
|
|
||||||
adopt_existing_on_create = true
|
|
||||||
|
|
||||||
startup_configuration = {
|
|
||||||
resource_realm = var.realm
|
|
||||||
}
|
|
||||||
|
|
||||||
cluster_configuration = {
|
|
||||||
cpu = local.lucee_cpu
|
|
||||||
memory = local.lucee_memory
|
|
||||||
replicas = local.lucee_replicas
|
|
||||||
}
|
|
||||||
|
|
||||||
access_configuration = {
|
|
||||||
domain = local.lucee_domain
|
|
||||||
}
|
|
||||||
|
|
||||||
app_configuration = {
|
|
||||||
version = local.lucee_version
|
|
||||||
git_path = local.lucee_git_path
|
|
||||||
}
|
|
||||||
|
|
||||||
json_env = jsonencode({
|
|
||||||
TABLE_NAME = local.crud_table_name
|
|
||||||
# SERVICE_NAME — значение колонки created_by («кто добавил строку»).
|
|
||||||
# Все три приложения пишут в одну таблицу, поэтому имя сервиса обязательно.
|
|
||||||
SERVICE_NAME = "lucee"
|
|
||||||
testds_class = local.jdbc_class
|
|
||||||
testds_bundleName = local.jdbc_bundle_name
|
|
||||||
testds_bundleVersion = local.jdbc_bundle_version
|
|
||||||
testds_connectionString = "jdbc:postgresql://${local.pg_host}:${local.pg_port}/${local.pg_db}"
|
|
||||||
testds_username = local.pg_user
|
|
||||||
testds_password = local.pg_pass
|
|
||||||
testds_connectionLimit = local.jdbc_conn_limit
|
|
||||||
testds_liveTimeout = local.jdbc_live_timeout
|
|
||||||
testds_validate = local.jdbc_validate
|
|
||||||
|
|
||||||
PGHOST = local.pg_host
|
|
||||||
PGPORT = local.pg_port
|
|
||||||
PGUSER = local.pg_user
|
|
||||||
PGPASSWORD = local.pg_pass
|
|
||||||
PGSSLMODE = local.pg_ssl
|
|
||||||
DATABASE_URL = format(
|
|
||||||
"postgresql://%s:%s@%s:%s/%s",
|
|
||||||
local.pg_user,
|
|
||||||
local.pg_pass,
|
|
||||||
local.pg_host,
|
|
||||||
local.pg_port,
|
|
||||||
local.pg_db
|
|
||||||
)
|
|
||||||
})
|
|
||||||
}
|
|
||||||
@@ -1,41 +0,0 @@
|
|||||||
# =============================================================================
|
|
||||||
# APPS — провайдер и переменные
|
|
||||||
# =============================================================================
|
|
||||||
#
|
|
||||||
# Здесь только приложения-потребители: Lucee / Flask / Node.js.
|
|
||||||
# База данных (кластер, пользователь, база) живёт в ../pg/ — в СВОЁМ state.
|
|
||||||
#
|
|
||||||
# Почему так разделено (кратко, подробно — в ../README.md):
|
|
||||||
# - `terraform destroy` здесь убивает ТОЛЬКО приложения, БД с данными не трогает;
|
|
||||||
# - к одной БД можно подключить несколько папок-потребителей (эта, и любые новые);
|
|
||||||
# - БД живёт дольше приложений: приложения можно пересоздавать свободно.
|
|
||||||
#
|
|
||||||
# Креды подключения берутся из creds.json — выгрузки outputs папки ../pg/.
|
|
||||||
# Как её получить — см. ../README.md и apps/locals.tf.
|
|
||||||
# =============================================================================
|
|
||||||
|
|
||||||
terraform {
|
|
||||||
required_providers {
|
|
||||||
nubes = {
|
|
||||||
source = "tf-registry.containerk8s.services.ngcloud.ru/nubes-test/nubes"
|
|
||||||
version = "3.0.0"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
provider "nubes" {
|
|
||||||
api_token = var.api_token
|
|
||||||
api_endpoint = "https://lk-api-gateway-test.ngcloud.ru/api/v1/svc"
|
|
||||||
# log_level = "debug" # none | info | debug, default = "none"
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "api_token" {
|
|
||||||
type = string
|
|
||||||
sensitive = true
|
|
||||||
description = "Nubes API token — тот же, что в ../pg/terraform.tfvars"
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "realm" {
|
|
||||||
type = string
|
|
||||||
description = "resource_realm приложений. ДОЛЖЕН совпадать с realm, где создана БД (../pg/terraform.tfvars)"
|
|
||||||
}
|
|
||||||
@@ -1,46 +0,0 @@
|
|||||||
# =============================================================================
|
|
||||||
# Node.js — Express-приложение (CRUD, та же БД и таблица, что у Lucee/Flask)
|
|
||||||
# =============================================================================
|
|
||||||
#
|
|
||||||
# Креды БД приходят из файла apps/creds.json (см. apps/locals.tf).
|
|
||||||
# =============================================================================
|
|
||||||
|
|
||||||
resource "nubes_nodejs" "appnodejs" {
|
|
||||||
resource_name = local.nodejs_resource_name
|
|
||||||
|
|
||||||
adopt_existing_on_create = true
|
|
||||||
|
|
||||||
startup_configuration = {
|
|
||||||
resource_realm = var.realm
|
|
||||||
}
|
|
||||||
|
|
||||||
cluster_configuration = {
|
|
||||||
cpu = local.nodejs_cpu
|
|
||||||
memory = local.nodejs_memory
|
|
||||||
replicas = local.nodejs_replicas
|
|
||||||
}
|
|
||||||
|
|
||||||
access_configuration = {
|
|
||||||
domain = local.nodejs_domain
|
|
||||||
}
|
|
||||||
|
|
||||||
app_configuration = {
|
|
||||||
version = "22"
|
|
||||||
git_path = local.nodejs_git_path
|
|
||||||
health_path = "/"
|
|
||||||
}
|
|
||||||
|
|
||||||
operation_timeout = local.nodejs_timeout
|
|
||||||
|
|
||||||
json_env = jsonencode({
|
|
||||||
TABLE_NAME = local.crud_table_name
|
|
||||||
# SERVICE_NAME — значение колонки created_by («кто добавил строку»).
|
|
||||||
SERVICE_NAME = "nodejs"
|
|
||||||
PGHOST = local.pg_host
|
|
||||||
PGPORT = local.pg_port
|
|
||||||
PGUSER = local.pg_user
|
|
||||||
PGPASSWORD = local.pg_pass
|
|
||||||
PGDATABASE = local.pg_db
|
|
||||||
PGSSLMODE = local.pg_ssl
|
|
||||||
})
|
|
||||||
}
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
# =============================================================================
|
|
||||||
# terraform.tfvars.example — скопировать в terraform.tfvars и заполнить
|
|
||||||
# =============================================================================
|
|
||||||
#
|
|
||||||
# cp terraform.tfvars.example terraform.tfvars
|
|
||||||
#
|
|
||||||
# api_token — тот же, что в ../pg/terraform.tfvars
|
|
||||||
# realm — ОБЯЗАТЕЛЬНО тот же, где создана БД (иначе приложение не увидит кластер)
|
|
||||||
# =============================================================================
|
|
||||||
|
|
||||||
api_token = ""
|
|
||||||
realm = "k8s-4-sandbox-nubes-ru"
|
|
||||||
@@ -0,0 +1,48 @@
|
|||||||
|
# =============================================================================
|
||||||
|
# Flask — CRUD (та же PG, та же таблица что у Lucee)
|
||||||
|
# =============================================================================
|
||||||
|
locals {
|
||||||
|
# Повторно используем pg_host/pg_user/pg_pass/pg_db из lucee.tf locals
|
||||||
|
flask_pg_host = nubes_postgres.main_pg.state_out_flat["internalMaster"]
|
||||||
|
flask_pg_user = nubes_postgres_user.crud_user_0.username
|
||||||
|
flask_pg_pass = nonsensitive(jsondecode(nubes_postgres.main_pg.vault_secrets["users"]).user4crudpg.password)
|
||||||
|
flask_pg_db = nubes_postgres_database.pg_db.db_name
|
||||||
|
}
|
||||||
|
|
||||||
|
resource "nubes_flask" "appflask" {
|
||||||
|
resource_name = local.flask_resource_name
|
||||||
|
|
||||||
|
startup_configuration = {
|
||||||
|
resource_realm = var.realm
|
||||||
|
}
|
||||||
|
|
||||||
|
cluster_configuration = {
|
||||||
|
cpu = local.flask_cpu
|
||||||
|
memory = local.flask_memory
|
||||||
|
replicas = local.flask_replicas
|
||||||
|
}
|
||||||
|
|
||||||
|
access_configuration = {
|
||||||
|
domain = local.flask_domain
|
||||||
|
}
|
||||||
|
|
||||||
|
app_configuration = {
|
||||||
|
version = "3.12"
|
||||||
|
git_path = local.flask_git_path
|
||||||
|
health_path = "/"
|
||||||
|
}
|
||||||
|
|
||||||
|
git_revision = local.flask_git_revision
|
||||||
|
|
||||||
|
json_env = jsonencode({
|
||||||
|
TABLE_NAME = local.crud_table_name
|
||||||
|
PGHOST = local.flask_pg_host
|
||||||
|
PGPORT = local.pg_port
|
||||||
|
PGUSER = local.flask_pg_user
|
||||||
|
PGPASSWORD = local.flask_pg_pass
|
||||||
|
PGDATABASE = local.flask_pg_db
|
||||||
|
PGSSLMODE = local.pg_ssl_mode
|
||||||
|
})
|
||||||
|
|
||||||
|
depends_on = [nubes_postgres.main_pg]
|
||||||
|
}
|
||||||
@@ -0,0 +1,91 @@
|
|||||||
|
# =============================================================================
|
||||||
|
# locals.tf — все настраиваемые значения модуля CRUD (PG + Lucee + Flask + Node.js)
|
||||||
|
# Никакого хардкода в ресурсах — всё здесь.
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
locals {
|
||||||
|
|
||||||
|
# ═══════════════════════════════════════════════════════════════════════════
|
||||||
|
# PostgreSQL — общая БД для всех трёх приложений
|
||||||
|
# ═══════════════════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
pg_resource_name = "pg4crud" # имя ресурса в Nubes
|
||||||
|
pg_cpu = 500 # CPU в millicores (500 = 0.5 ядра)
|
||||||
|
pg_memory = 512 # память в MB
|
||||||
|
pg_replicas = 1 # количество реплик
|
||||||
|
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 = "82685681" # коммит/тег в git (менять для редеплоя)
|
||||||
|
lucee_resource_name = "luceecrud" # имя ресурса в Nubes
|
||||||
|
lucee_domain = "tflucee" # домен (станет tflucee.luceek8s.dev.nubes.ru). Имя должно быть уникальным — заменяйте на своё!
|
||||||
|
lucee_version = "5.4" # версия Lucee (CFML engine)
|
||||||
|
lucee_git_path = "https://gitea.services.ngcloud.ru/terraform/tfluceecrud.git"
|
||||||
|
lucee_cpu = 300 # CPU в millicores
|
||||||
|
lucee_memory = 512 # память в MB
|
||||||
|
lucee_replicas = 1 # количество реплик
|
||||||
|
|
||||||
|
# ═══════════════════════════════════════════════════════════════════════════
|
||||||
|
# Таблица CRUD — общая для всех трёх приложений
|
||||||
|
# ═══════════════════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
crud_table_name = "crud_items" # имя таблицы (TABLE_NAME в env)
|
||||||
|
|
||||||
|
# ═══════════════════════════════════════════════════════════════════════════
|
||||||
|
# Flask — Python-приложение (сервис 89)
|
||||||
|
# ═══════════════════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
flask_git_revision = "54746e91" # коммит/тег в git (менять для редеплоя)
|
||||||
|
flask_resource_name = "flaskcrud" # имя ресурса в Nubes
|
||||||
|
flask_domain = "tfflask" # домен (станет tfflask.pythonk8s.dev.nubes.ru). Имя должно быть уникальным — заменяйте на своё!
|
||||||
|
flask_git_path = "https://gitea.services.ngcloud.ru/terraform/tfflaskcrud.git"
|
||||||
|
flask_cpu = 300 # CPU в millicores
|
||||||
|
flask_memory = 512 # память в MB
|
||||||
|
flask_replicas = 1 # количество реплик
|
||||||
|
|
||||||
|
# ═══════════════════════════════════════════════════════════════════════════
|
||||||
|
# Node.js — Express-приложение (сервис 95)
|
||||||
|
# ═══════════════════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
nodejs_git_revision = "809d303b" # коммит/тег в git (менять для редеплоя)
|
||||||
|
nodejs_resource_name = "nodejscrud" # имя ресурса в Nubes
|
||||||
|
nodejs_domain = "tfnodejs" # домен (станет tfnodejs.<суффикс>.dev.nubes.ru). Имя должно быть уникальным — заменяйте на своё!
|
||||||
|
nodejs_git_path = "https://gitea.services.ngcloud.ru/terraform/tfnodejscrud.git"
|
||||||
|
nodejs_cpu = 300 # CPU в millicores
|
||||||
|
nodejs_memory = 512 # память в MB
|
||||||
|
nodejs_replicas = 1 # количество реплик
|
||||||
|
nodejs_timeout = "15m" # таймаут операций create/modify
|
||||||
|
|
||||||
|
# ═══════════════════════════════════════════════════════════════════════════
|
||||||
|
# JDBC — параметры подключения Lucee к PostgreSQL
|
||||||
|
# ═══════════════════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
jdbc_class = "org.postgresql.Driver"
|
||||||
|
jdbc_bundle_name = "org.postgresql.jdbc"
|
||||||
|
jdbc_bundle_version = "42.6.0"
|
||||||
|
jdbc_conn_limit = "5" # макс. количество соединений
|
||||||
|
jdbc_live_timeout = "15" # таймаут неактивного соединения (минут)
|
||||||
|
jdbc_validate = "false" # валидация соединения при выдаче из пула
|
||||||
|
|
||||||
|
# ═══════════════════════════════════════════════════════════════════════════
|
||||||
|
# PostgreSQL — общие параметры подключения
|
||||||
|
# ═══════════════════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
pg_port = "5432" # порт PostgreSQL
|
||||||
|
pg_ssl_mode = "require" # SSL-режим (require = обязательно TLS)
|
||||||
|
}
|
||||||
@@ -0,0 +1,59 @@
|
|||||||
|
locals {
|
||||||
|
pg_host = nubes_postgres.main_pg.state_out_flat["internalMaster"]
|
||||||
|
pg_user = nubes_postgres_user.crud_user_0.username
|
||||||
|
pg_pass = nonsensitive(jsondecode(nubes_postgres.main_pg.vault_secrets["users"]).user4crudpg.password)
|
||||||
|
pg_db = nubes_postgres_database.pg_db.db_name
|
||||||
|
}
|
||||||
|
|
||||||
|
resource "nubes_lucee" "applucee" {
|
||||||
|
resource_name = local.lucee_resource_name
|
||||||
|
|
||||||
|
startup_configuration = {
|
||||||
|
resource_realm = var.realm
|
||||||
|
}
|
||||||
|
|
||||||
|
cluster_configuration = {
|
||||||
|
cpu = local.lucee_cpu
|
||||||
|
memory = local.lucee_memory
|
||||||
|
replicas = local.lucee_replicas
|
||||||
|
}
|
||||||
|
|
||||||
|
access_configuration = {
|
||||||
|
domain = local.lucee_domain
|
||||||
|
}
|
||||||
|
|
||||||
|
app_configuration = {
|
||||||
|
version = local.lucee_version
|
||||||
|
git_path = local.lucee_git_path
|
||||||
|
}
|
||||||
|
|
||||||
|
git_revision = local.lucee_git_revision
|
||||||
|
|
||||||
|
json_env = jsonencode({
|
||||||
|
TABLE_NAME = local.crud_table_name
|
||||||
|
testds_class = local.jdbc_class
|
||||||
|
testds_bundleName = local.jdbc_bundle_name
|
||||||
|
testds_bundleVersion = local.jdbc_bundle_version
|
||||||
|
testds_connectionString = "jdbc:postgresql://${local.pg_host}:5432/${local.pg_db}"
|
||||||
|
testds_username = local.pg_user
|
||||||
|
testds_password = local.pg_pass
|
||||||
|
testds_connectionLimit = local.jdbc_conn_limit
|
||||||
|
testds_liveTimeout = local.jdbc_live_timeout
|
||||||
|
testds_validate = local.jdbc_validate
|
||||||
|
|
||||||
|
PGHOST = local.pg_host
|
||||||
|
PGPORT = local.pg_port
|
||||||
|
PGUSER = local.pg_user
|
||||||
|
PGPASSWORD = local.pg_pass
|
||||||
|
PGSSLMODE = local.pg_ssl_mode
|
||||||
|
DATABASE_URL = format(
|
||||||
|
"postgresql://%s:%s@%s:5432/%s",
|
||||||
|
local.pg_user,
|
||||||
|
local.pg_pass,
|
||||||
|
local.pg_host,
|
||||||
|
local.pg_db
|
||||||
|
)
|
||||||
|
})
|
||||||
|
|
||||||
|
depends_on = [nubes_postgres.main_pg]
|
||||||
|
}
|
||||||
@@ -0,0 +1,39 @@
|
|||||||
|
terraform {
|
||||||
|
required_providers {
|
||||||
|
nubes = {
|
||||||
|
source = "tf-registry.containerk8s.services.ngcloud.ru/nubes-test/nubes"
|
||||||
|
version = "5.1.16"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
variable "api_token" {
|
||||||
|
type = string
|
||||||
|
sensitive = true
|
||||||
|
description = "Nubes API token"
|
||||||
|
}
|
||||||
|
# variable "s3_uid" {
|
||||||
|
# type = string
|
||||||
|
# sensitive = true
|
||||||
|
# description = "Nubes S3 UID"
|
||||||
|
# }
|
||||||
|
variable "realm" {
|
||||||
|
type = string
|
||||||
|
sensitive = true
|
||||||
|
description = "resource_realm parameter for nubes_postgres resource"
|
||||||
|
}
|
||||||
|
variable "s3_user_uid" {
|
||||||
|
type = string
|
||||||
|
description = "S3 user UUID"
|
||||||
|
}
|
||||||
|
variable "s3_name" {
|
||||||
|
type = string
|
||||||
|
description = "S3 user name"
|
||||||
|
}
|
||||||
|
|
||||||
|
provider "nubes" {
|
||||||
|
api_token = var.api_token
|
||||||
|
api_endpoint = "https://lk-api-gateway-test.ngcloud.ru/api/v1/svc"
|
||||||
|
# log_level = "debug" # none | info | debug, default = "none"
|
||||||
|
}
|
||||||
|
|
||||||
@@ -0,0 +1,48 @@
|
|||||||
|
# =============================================================================
|
||||||
|
# Node.js — CRUD (та же PG, та же таблица что у Lucee/Flask)
|
||||||
|
# =============================================================================
|
||||||
|
locals {
|
||||||
|
nodejs_pg_host = nubes_postgres.main_pg.state_out_flat["internalMaster"]
|
||||||
|
nodejs_pg_user = nubes_postgres_user.crud_user_0.username
|
||||||
|
nodejs_pg_pass = nonsensitive(jsondecode(nubes_postgres.main_pg.vault_secrets["users"]).user4crudpg.password)
|
||||||
|
nodejs_pg_db = nubes_postgres_database.pg_db.db_name
|
||||||
|
}
|
||||||
|
|
||||||
|
resource "nubes_nodejs" "appnodejs" {
|
||||||
|
resource_name = local.nodejs_resource_name
|
||||||
|
|
||||||
|
startup_configuration = {
|
||||||
|
resource_realm = var.realm
|
||||||
|
}
|
||||||
|
|
||||||
|
cluster_configuration = {
|
||||||
|
cpu = local.nodejs_cpu
|
||||||
|
memory = local.nodejs_memory
|
||||||
|
replicas = local.nodejs_replicas
|
||||||
|
}
|
||||||
|
|
||||||
|
access_configuration = {
|
||||||
|
domain = local.nodejs_domain
|
||||||
|
}
|
||||||
|
|
||||||
|
app_configuration = {
|
||||||
|
version = "22"
|
||||||
|
git_path = local.nodejs_git_path
|
||||||
|
health_path = "/"
|
||||||
|
}
|
||||||
|
|
||||||
|
git_revision = local.nodejs_git_revision
|
||||||
|
operation_timeout = local.nodejs_timeout
|
||||||
|
|
||||||
|
json_env = jsonencode({
|
||||||
|
TABLE_NAME = local.crud_table_name
|
||||||
|
PGHOST = local.nodejs_pg_host
|
||||||
|
PGPORT = local.pg_port
|
||||||
|
PGUSER = local.nodejs_pg_user
|
||||||
|
PGPASSWORD = local.nodejs_pg_pass
|
||||||
|
PGDATABASE = local.nodejs_pg_db
|
||||||
|
PGSSLMODE = local.pg_ssl_mode
|
||||||
|
})
|
||||||
|
|
||||||
|
depends_on = [nubes_postgres.main_pg]
|
||||||
|
}
|
||||||
-114
@@ -1,114 +0,0 @@
|
|||||||
# =============================================================================
|
|
||||||
# PG — провайдер и переменные
|
|
||||||
# =============================================================================
|
|
||||||
#
|
|
||||||
# Здесь только БД: кластер + пользователь + база. Приложения — в ../apps/.
|
|
||||||
# Почему так разделено — см. README.md в родительской папке CRUD/.
|
|
||||||
# =============================================================================
|
|
||||||
|
|
||||||
terraform {
|
|
||||||
required_providers {
|
|
||||||
nubes = {
|
|
||||||
source = "tf-registry.containerk8s.services.ngcloud.ru/nubes-test/nubes"
|
|
||||||
version = "3.0.0"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
provider "nubes" {
|
|
||||||
api_token = var.api_token
|
|
||||||
api_endpoint = "https://lk-api-gateway-test.ngcloud.ru/api/v1/svc"
|
|
||||||
# log_level = "debug" # none | info | debug, default = "none"
|
|
||||||
}
|
|
||||||
|
|
||||||
# ─────────────────────────────────────────────────────────────────────────────
|
|
||||||
# Обязательные (заполняются в terraform.tfvars)
|
|
||||||
# ─────────────────────────────────────────────────────────────────────────────
|
|
||||||
|
|
||||||
variable "api_token" {
|
|
||||||
type = string
|
|
||||||
sensitive = true
|
|
||||||
description = "Nubes API token (ЛК → Профиль → Токены → создать «Технический»)"
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "realm" {
|
|
||||||
type = string
|
|
||||||
description = "resource_realm: ресурсная платформа (кластер Kubernetes), например k8s-4-sandbox-nubes-ru"
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "s3_name" {
|
|
||||||
type = string
|
|
||||||
description = "Имя (или UUID) S3-экземпляра для бэкапов PostgreSQL: ЛК → S3"
|
|
||||||
}
|
|
||||||
|
|
||||||
# ─────────────────────────────────────────────────────────────────────────────
|
|
||||||
# Кластер — значения по умолчанию можно не задавать
|
|
||||||
# ─────────────────────────────────────────────────────────────────────────────
|
|
||||||
|
|
||||||
variable "pg_resource_name" {
|
|
||||||
type = string
|
|
||||||
default = "pg4crud2"
|
|
||||||
description = "Имя ресурса кластера в Nubes (по нему же ищется существующий — adopt)"
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "pg_cpu" {
|
|
||||||
type = number
|
|
||||||
default = 500
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "pg_memory" {
|
|
||||||
type = number
|
|
||||||
default = 512
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "pg_replicas" {
|
|
||||||
type = number
|
|
||||||
default = 1
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "pg_disk" {
|
|
||||||
type = number
|
|
||||||
default = 10
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "pg_version" {
|
|
||||||
type = string
|
|
||||||
default = "17"
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "pg_retain" {
|
|
||||||
type = number
|
|
||||||
default = 14
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "pg_schedule" {
|
|
||||||
type = string
|
|
||||||
default = "0 0 * * *"
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "pg_timeout" {
|
|
||||||
type = string
|
|
||||||
default = "11m"
|
|
||||||
description = "Таймаут операций кластера (create/modify/suspend)"
|
|
||||||
}
|
|
||||||
|
|
||||||
# ─────────────────────────────────────────────────────────────────────────────
|
|
||||||
# Пользователь и база — имена константны: по ним приложения собирают подключение
|
|
||||||
# ─────────────────────────────────────────────────────────────────────────────
|
|
||||||
|
|
||||||
variable "pg_username" {
|
|
||||||
type = string
|
|
||||||
default = "user4crudpg"
|
|
||||||
description = "Имя пользователя БД. Защищённые имена (admin/postgres/standby) платформа не примет"
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "pg_role" {
|
|
||||||
type = string
|
|
||||||
default = "ddl_user"
|
|
||||||
description = "app_user = только DML, ddl_user = плюс создание баз/ролей (нужно приложению для CREATE TABLE)"
|
|
||||||
}
|
|
||||||
|
|
||||||
variable "pg_db_name" {
|
|
||||||
type = string
|
|
||||||
default = "db4crudpg"
|
|
||||||
}
|
|
||||||
@@ -1,52 +0,0 @@
|
|||||||
# =============================================================================
|
|
||||||
# PG — outputs для потребителей (папка ../apps/ и любые будущие папки)
|
|
||||||
# =============================================================================
|
|
||||||
#
|
|
||||||
# ЗАЧЕМ outputs: папки приложений — это ДРУГИЕ state, и Terraform между ними
|
|
||||||
# значения сам не передаёт (у провайдера нет data-source, общего backend тоже нет).
|
|
||||||
# Поэтому после создания БД юзер выгружает эти outputs в файл и кладёт его
|
|
||||||
# в папку потребителя:
|
|
||||||
#
|
|
||||||
# cd TEST_STAND/CRUD/pg
|
|
||||||
# terraform apply
|
|
||||||
# terraform output -json > ../apps/creds.json # ← это и есть «передать креды»
|
|
||||||
#
|
|
||||||
# Папка apps/ читает creds.json (см. apps/locals.tf). Файл содержит пароль —
|
|
||||||
# он в .gitignore папки apps/.
|
|
||||||
#
|
|
||||||
# ВАЖНО про порядок: пароль берётся из ВЫХОДА подресурса nubes_postgres_user, а не из
|
|
||||||
# vault_secrets кластера. Внутри одного apply vault_secrets кластера ещё пуст (пароль
|
|
||||||
# появляется после create_user и обновляется в state кластера только при его чтении),
|
|
||||||
# поэтому надёжный источник — сам подресурс.
|
|
||||||
# =============================================================================
|
|
||||||
|
|
||||||
output "pg_host" {
|
|
||||||
description = "Внутренний хост master для подключения (state_out_flat.internalMaster)"
|
|
||||||
value = nubes_postgres.main_pg.state_out_flat["internalMaster"]
|
|
||||||
}
|
|
||||||
|
|
||||||
output "pg_port" {
|
|
||||||
description = "Порт PostgreSQL"
|
|
||||||
value = "5432"
|
|
||||||
}
|
|
||||||
|
|
||||||
output "pg_username" {
|
|
||||||
description = "Имя пользователя БД"
|
|
||||||
value = nubes_postgres_user.crud_user_0.username
|
|
||||||
}
|
|
||||||
|
|
||||||
output "pg_db_name" {
|
|
||||||
description = "Имя базы данных"
|
|
||||||
value = nubes_postgres_database.pg_db.db_name
|
|
||||||
}
|
|
||||||
|
|
||||||
output "pg_password" {
|
|
||||||
description = "Пароль пользователя БД (платформа генерирует его сама при create_user; провайдер читает его из Vault и отдаёт выходом подресурса)"
|
|
||||||
value = nubes_postgres_user.crud_user_0.password
|
|
||||||
sensitive = true
|
|
||||||
}
|
|
||||||
|
|
||||||
output "pg_ssl_mode" {
|
|
||||||
description = "Режим SSL для строки подключения"
|
|
||||||
value = "require"
|
|
||||||
}
|
|
||||||
@@ -1,72 +0,0 @@
|
|||||||
# =============================================================================
|
|
||||||
# PG — общая база данных для CRUD-приложений
|
|
||||||
# =============================================================================
|
|
||||||
#
|
|
||||||
# Эта папка управляет ТОЛЬКО базой данных: сам кластер PostgreSQL, пользователь и
|
|
||||||
# база. Она НЕ знает про приложения (Lucee/Flask/Node.js) — приложения живут в
|
|
||||||
# соседней папке apps/ и подключаются к этой БД через выгруженные креды.
|
|
||||||
#
|
|
||||||
# ЗАЧЕМ так разделено (папка pg/ отдельно от apps/):
|
|
||||||
# - БД — общий ресурс: к одному кластеру может подключаться несколько наборов
|
|
||||||
# приложений (сейчас apps/, потом любые другие папки).
|
|
||||||
# - terraform destroy в apps/ должен убивать ТОЛЬКО приложения, а не БД с данными.
|
|
||||||
# Если бы всё лежало в одном state, destroy снёс бы и кластер.
|
|
||||||
# - Разные state ⇒ разные жизненные циклы: БД живёт дольше приложений.
|
|
||||||
#
|
|
||||||
# Порядок запуска — см. README.md в родительской папке CRUD/.
|
|
||||||
# =============================================================================
|
|
||||||
|
|
||||||
resource "nubes_postgres" "main_pg" {
|
|
||||||
resource_name = var.pg_resource_name
|
|
||||||
|
|
||||||
startup_configuration = {
|
|
||||||
resource_realm = var.realm
|
|
||||||
}
|
|
||||||
|
|
||||||
cluster_configuration = {
|
|
||||||
cpu = var.pg_cpu
|
|
||||||
memory = var.pg_memory
|
|
||||||
replicas = var.pg_replicas
|
|
||||||
disk = var.pg_disk
|
|
||||||
}
|
|
||||||
|
|
||||||
access_configuration = {
|
|
||||||
master_ip_space = "no-needed"
|
|
||||||
master_access_list = jsonencode(["10.0.0.0/8"])
|
|
||||||
slave_ip_space = "no-needed"
|
|
||||||
slave_access_list = jsonencode([])
|
|
||||||
}
|
|
||||||
|
|
||||||
postgres_configuration = {
|
|
||||||
version = var.pg_version
|
|
||||||
ssl_required = true
|
|
||||||
pooler_master = false
|
|
||||||
pooler_slave = false
|
|
||||||
}
|
|
||||||
|
|
||||||
postgres_conf = jsonencode([{
|
|
||||||
paramName = "log_connections"
|
|
||||||
paramValue = "''"
|
|
||||||
}])
|
|
||||||
|
|
||||||
backup_configuration = {
|
|
||||||
s3_uid = var.s3_name
|
|
||||||
retain = var.pg_retain
|
|
||||||
schedule = var.pg_schedule
|
|
||||||
}
|
|
||||||
|
|
||||||
autoscale_configuration = {
|
|
||||||
enabled = false
|
|
||||||
schedule = 0
|
|
||||||
percent = 10
|
|
||||||
quota = 100
|
|
||||||
}
|
|
||||||
|
|
||||||
operation_timeout = var.pg_timeout
|
|
||||||
adopt_existing_on_create = true
|
|
||||||
|
|
||||||
# ⚠️ destroy: кластер НЕ удалять, а переводить в Suspend.
|
|
||||||
# Это поведение по умолчанию сервиса postgres (suspend_on_destroy_default: true
|
|
||||||
# в generated/test/resources_yaml/90_postgres.yaml). Явно НЕ ставим отсюда, чтобы
|
|
||||||
# destroy случайно не снёс БД с данными.
|
|
||||||
}
|
|
||||||
@@ -1,36 +0,0 @@
|
|||||||
# =============================================================================
|
|
||||||
# PG — пользователь и база данных
|
|
||||||
# =============================================================================
|
|
||||||
#
|
|
||||||
# Пользователь и база создаются отдельными операциями (create_user / create_database)
|
|
||||||
# внутри кластера, который создал nubes_postgres.main_pg.
|
|
||||||
#
|
|
||||||
# ЗАЧЕМ keep_on_destroy = true (не удалять подресурс при destroy):
|
|
||||||
# - у кластера suspend_on_destroy_default = true ⇒ при destroy кластер уходит в
|
|
||||||
# Suspend, а НЕ удаляется;
|
|
||||||
# - по умолчанию же при destroy подресурс выполнил бы delete_user / delete_database —
|
|
||||||
# получилось бы расхождение: кластер в облаке жив, а юзер/база удалены (база = потеря данных);
|
|
||||||
# - keep_on_destroy = true ⇒ подресурс при destroy НЕ удаляется и НЕ меняется в облаке,
|
|
||||||
# только убирается из state. Провайдер печатает предупреждение «Подресурс оставлен как есть».
|
|
||||||
#
|
|
||||||
# Пара к keep_on_destroy = true обязательна:
|
|
||||||
# adopt_existing_on_create = true — иначе повторный apply попытается СОЗДАТЬ уже
|
|
||||||
# существующего юзера/базу и упадёт с «уже существует». С true провайдер усыновляет
|
|
||||||
# существующий объект обратно (авто-import).
|
|
||||||
# =============================================================================
|
|
||||||
|
|
||||||
resource "nubes_postgres_user" "crud_user_0" {
|
|
||||||
postgres_id = nubes_postgres.main_pg.id
|
|
||||||
username = var.pg_username
|
|
||||||
role = var.pg_role
|
|
||||||
adopt_existing_on_create = true
|
|
||||||
keep_on_destroy = true
|
|
||||||
}
|
|
||||||
|
|
||||||
resource "nubes_postgres_database" "pg_db" {
|
|
||||||
postgres_id = nubes_postgres.main_pg.id
|
|
||||||
db_name = var.pg_db_name
|
|
||||||
db_owner = nubes_postgres_user.crud_user_0.username
|
|
||||||
adopt_existing_on_create = true
|
|
||||||
keep_on_destroy = true
|
|
||||||
}
|
|
||||||
@@ -1,31 +0,0 @@
|
|||||||
# =============================================================================
|
|
||||||
# terraform.tfvars.example — скопировать в terraform.tfvars и заполнить
|
|
||||||
# =============================================================================
|
|
||||||
#
|
|
||||||
# cp terraform.tfvars.example terraform.tfvars
|
|
||||||
#
|
|
||||||
# Где брать значения:
|
|
||||||
# api_token — ЛК → Профиль → Токены → создать «Технический»
|
|
||||||
# realm — ЛК → Кластеры (напр. k8s-4-sandbox-nubes-ru)
|
|
||||||
# s3_name — ЛК → S3 → Имя экземпляра (для бэкапов PG). Можно UUID — провайдер найдёт пару сам
|
|
||||||
#
|
|
||||||
# Остальные переменные имеют значения по умолчанию (см. main.tf) — менять не обязательно.
|
|
||||||
# =============================================================================
|
|
||||||
|
|
||||||
api_token = ""
|
|
||||||
realm = "k8s-4-sandbox-nubes-ru"
|
|
||||||
s3_name = ""
|
|
||||||
|
|
||||||
# ── Необязательные (раскомментировать, если нужно изменить) ──────────────────
|
|
||||||
# pg_resource_name = "pg4crud2"
|
|
||||||
# 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"
|
|
||||||
# pg_username = "user4crudpg"
|
|
||||||
# pg_role = "ddl_user"
|
|
||||||
# pg_db_name = "db4crudpg"
|
|
||||||
@@ -0,0 +1,49 @@
|
|||||||
|
resource "nubes_postgres" "main_pg" {
|
||||||
|
resource_name = local.pg_resource_name
|
||||||
|
|
||||||
|
startup_configuration = {
|
||||||
|
resource_realm = var.realm
|
||||||
|
}
|
||||||
|
|
||||||
|
cluster_configuration = {
|
||||||
|
cpu = local.pg_cpu
|
||||||
|
memory = local.pg_memory
|
||||||
|
replicas = local.pg_replicas
|
||||||
|
disk = local.pg_disk
|
||||||
|
}
|
||||||
|
|
||||||
|
access_configuration = {
|
||||||
|
master_ip_space = "no-needed"
|
||||||
|
master_access_list = jsonencode(["10.0.0.0/8"])
|
||||||
|
slave_ip_space = "no-needed"
|
||||||
|
slave_access_list = jsonencode([])
|
||||||
|
}
|
||||||
|
|
||||||
|
postgres_configuration = {
|
||||||
|
version = local.pg_version
|
||||||
|
ssl_required = true
|
||||||
|
pooler_master = false
|
||||||
|
pooler_slave = false
|
||||||
|
}
|
||||||
|
|
||||||
|
postgres_conf = jsonencode([{
|
||||||
|
param_name = "log_connections"
|
||||||
|
param_value = ""
|
||||||
|
}])
|
||||||
|
|
||||||
|
backup_configuration = {
|
||||||
|
s3_uid = var.s3_name
|
||||||
|
retain = local.pg_retain
|
||||||
|
schedule = local.pg_schedule
|
||||||
|
}
|
||||||
|
|
||||||
|
autoscale_configuration = {
|
||||||
|
enabled = false
|
||||||
|
schedule = 0
|
||||||
|
percent = 10
|
||||||
|
quota = 100
|
||||||
|
}
|
||||||
|
|
||||||
|
operation_timeout = local.pg_timeout
|
||||||
|
adopt_existing_on_create = true
|
||||||
|
}
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
# =============================================================================
|
||||||
|
# PostgreSQL — пользователи и базы данных
|
||||||
|
# =============================================================================
|
||||||
|
resource "nubes_postgres_user" "crud_user_0" {
|
||||||
|
postgres_id = nubes_postgres.main_pg.id
|
||||||
|
username = local.pg_username
|
||||||
|
role = local.pg_role
|
||||||
|
adopt_existing_on_create = true
|
||||||
|
}
|
||||||
|
|
||||||
|
resource "nubes_postgres_database" "pg_db" {
|
||||||
|
postgres_id = nubes_postgres.main_pg.id
|
||||||
|
db_name = local.pg_db_name
|
||||||
|
db_owner = nubes_postgres_user.crud_user_0.username
|
||||||
|
adopt_existing_on_create = true
|
||||||
|
}
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
# =============================================================================
|
||||||
|
# terraform.tfvars.example
|
||||||
|
# Заполнить своими значениями и переименовать в terraform.tfvars
|
||||||
|
# =============================================================================
|
||||||
|
#
|
||||||
|
# Где брать:
|
||||||
|
# api_token — ЛК → Профиль → Токены → создать «Технический»
|
||||||
|
# realm — ЛК → Кластеры → выбрать (напр. k8s-3-sandbox-nubes-ru)
|
||||||
|
# s3_name — ЛК → S3 → Имя экземпляра
|
||||||
|
# s3_user_uid — там же → UUID. Указать ОДНО из s3_name/s3_user_uid
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
api_token = "" # JWT-токен
|
||||||
|
realm = "k8s-3-sandbox-nubes-ru" # кластер Kubernetes
|
||||||
|
s3_name = "" # имя S3-экземпляра
|
||||||
|
s3_user_uid = "" # UUID S3-пользователя
|
||||||
Reference in New Issue
Block a user