Анализ 43 YAML-файлов из нового API Gateway

Дата: 2026-07-02 Источник: devops/profiles/test/generated/resources_yaml/ Gateway: https://lk-api-gateway-test.ngcloud.ru/api/v1/svc

Идеология построения сервисов

Два класса сервисов

Класс	Признак	Примеры	Кол-во
Простые (flat)	Плоские параметры: `resourceRealm`, `resourceCPU`, `domain`, ...	s3bucket, vc_vm, dnszone, harbor, gitea, rabbitmq, ...	31
Сложные (map-fixed)	Структурированные JSON-блоки: `clusterConfiguration`, `startupConfiguration`, ...	postgres, redis, mariadb, clickhouse, kafka, nextcloud, flask, lucee, nodejs, valoTenant, dummy, template	12

Закономерность: map-fixed используют сервисы, разворачиваемые в Kubernetes (БД, приложения). Простые flat — всё остальное (VM, сеть, DNS, S3).

Типы данных (435 параметров всего)

Тип	Кол-во	Где
`string`	146	Имена, домены, UUID
`integer > 0`	101	CPU, memory, disk
`map-fixed`	93	K8s-сервисы (12 шт.)
`boolean`	21	Флаги
`array-map-fixed`	17	Массивы объектов (7 сервисов)
`uuid`	14	ref-параметры
`json`	11	Произвольный JSON
`map`	14	Только в outputs
`yaml`	2	Редко
`array`	1	Редко
`integer >= 0`	2	Числовые, допускающие 0

Обязательность

required: 340 (78%)
optional: 95 (22%)
default: 120 параметров имеют значение по умолчанию

Большинство параметров обязательные, но многие с дефолтами.

Типы операций

Kind	Кол-во	Паттерн
`instance`	164	create/delete + modify/suspend/resume (у 27 из 43)
`action`	32	reconcile (20), redeploy (7), restart (3), recovery (2)
`subresource`	31	user (16), database (6), topic (3), backup (2), vdc (2)

Subresource-паттерн

Самый частый — user (16 сервисов). Создаётся отдельный nubes_{service}_user ресурс с параметрами username + role. Аналогично database (6 сервисов) с dbName + dbOwner.

subresource	Кол-во	Параметры
`user`	16	`username` (string, regex), `role` (string, value_list)
`database`	6	`dbName` (string, regex), `dbOwner` (string)
`topic`	3	Kafka
`backup`	2	S3, PostgreSQL
`vdc`	2	vcOrg
`sub_user`	2	openwhisk

Топ параметров create

code	Кол-во	Назначение
`resourceRealm`	19	Платформа/K8s-кластер
`resourceMemory`	11	Память
`resourceCPU`	11	CPU
`startupConfiguration`	10	map-fixed (K8s)
`clusterConfiguration`	10	map-fixed (K8s)
`accessConfiguration`	10	map-fixed (K8s)
`resourceInstances`	10	Кол-во реплик
`domain`	9	Домен
`resourceDisk`	8	Диск
`ipSpaceName`	4	IP-space
`appConfiguration`	4	Конфигурация приложения
`jsonEnv`	4	Переменные окружения
`backupConfiguration`	3	Бэкапы
`autoscaleConfiguration`	3	Автоскейлинг
`ipSpaceNameMaster`	3	IP для master
`vdcUid`	3	Ссылка на VDC
`vappName`	2	Имя vApp
`storageConfig`	2	Конфигурация хранилища

Action-операции

action	Кол-во	У каких сервисов
`reconcile`	20	Универсальная синхронизация (почти все)
`redeploy`	7	flask, nodejs, lucee, nifi, superset, nextcloud, gitea
`restart`	3	postgres, mariadb, redis
`recovery`	2	postgres, clickhouse

Жизненный цикл

27 из 43 сервисов поддерживают suspend
27 из 43 сервисов поддерживают resume
Все кто имеет suspend — имеют и resume (и наоборот)

Валидация параметров

Механизм	Кол-во	Пример
`regex`	29	`dbName: ^[A-Za-z0-9]+$`
`value_list`	38	`role: [app_user, ddl_user]`
`min/max value/length`	87/74	Числовые и строковые ограничения
`default`	120	`deleteS3Bucket: true`
`is_modifiable`	106 (24%)	Можно менять после создания
`is_sensitive`	2	`vault_secrets`

Сервисы с map-fixed (12)

mariadb, clickhouse, valo_tenant, k8s_sthutrval_cluster, dummy, template, nextcloud, flask, postgres, redis, lucee, nodejs

Сервисы с array-map-fixed (7)

mariadb, clickhouse, k8s_sthutrval_cluster, vc_org, dummy, vc_vdc, postgres

Сервисы без операций (4)

openwhisk, gitea_complex, vmpostgre, template — только заглушки/заготовки.

Полный список сервисов и их операций

100_openwhisk              | (нет операций)
110_dnszone                | instance
111_dnsrecord              | instance, action
112_tenant                 | instance
113_vc_complex             | instance
114_gitea_complex          | (нет операций)
115_mariadb                | instance, subresource, action
116_kafka                  | instance, subresource
117_nifi                   | instance
119_akhq                   | instance
120_clickhouse             | instance, subresource, action
12_s3                      | instance, subresource, action
13_s3bucket                | instance
149_valo_tenant            | instance
150_k8s_sthutrval_cluster  | instance, subresource, action
19_vc_org                  | instance, subresource, action
1_dummy                    | instance, action
20_vc_org_saas             | instance
21_vc_vdc                  | instance, action
22_vc_nsxt                 | instance, action
23_vc_vm                   | instance
25_vcexternalip            | instance
26_vapp                    | instance, action
27_vc_vm_v2                | instance
28_vc_vm_v3                | instance, action
29_vc_vdc_group            | instance, subresource, action
2_template                 | instance, action
32_vmpostgre               | (нет операций)
50_nextcloud               | instance, subresource, action
81_superset                | instance
82_harbor                  | instance
88_k8s_ziti_controller     | instance
89_flask                   | instance, action
90_postgres                | instance, subresource, action
91_redis                   | instance, action
92_mongodb                 | instance, subresource
93_rabbitmq                | instance
94_lucee                   | instance, action
95_nodejs                  | instance, action
96_pgadmin                 | instance, action
97_nodered                 | instance
98_http                    | instance, action
99_gitea                   | instance

7.4 KiB Raw Blame History Unescape Escape