Deployment

Сборка и запуск CUBIX в production.

Dev запускается на Windows напрямую через pnpm. Production собирается на Linux и подключается к отдельной PostgreSQL-инфраструктуре клиента. Приложение и база не должны публиковать PostgreSQL в Интернет.

Окружения

Development: Node.js LTS, pnpm, Nuxt dev, PostgreSQL локально или в инфраструктурном контейнере.
Staging: отдельная база, отдельные secrets, HTTPS или закрытый доступ через VPN/allowlist.
Production: Linux, Node.js LTS, reverse proxy, systemd/PM2, отдельная база клиента, backup/PITR и мониторинг.

Для isolated instance используются отдельные .env, DATABASE_URL, домен, uploads volume и политика резервного копирования.

Перед deployment проверьте переменные окружения, Prisma Client, миграции, доступность базы, HTTPS, upload volume, логи и rollback-план. GigaChat credentials хранятся только в secret store.

Минимальная проверка:

pnpm exec nuxt prepare
pnpm lint
pnpm build

После сборки запускайте .output/server/index.mjs через process manager. Не запускайте nuxt dev в production. Секреты GigaChat, auth session и database credentials не помещаются в Git, content или клиентский bundle.

Rollback

Храните предыдущий рабочий release, применяйте миграции до переключения трафика и имейте проверенный rollback-план. При ошибке сначала возвращайте предыдущий release, затем отдельно анализируйте миграцию и состояние базы. Не удаляйте uploads и backup при смене release.

Prisma и данные

Правила работы со схемой CUBIX и isolated instances.

Роли и права

Серверная модель доступа CUBIX.