SILVER
/
NODEDC_PLATFORM
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
NODEDC_PLATFORM/docs/DEPLOYMENT_LOCAL.md

5.3 KiB
Raw Blame History

Local Deployment Plan

Domains

Для локальной разработки целевая схема:

127.0.0.1 auth.local.nodedc
127.0.0.1 launcher.local.nodedc
127.0.0.1 task.local.nodedc
127.0.0.1 agents.local.nodedc
127.0.0.1 tender.local.nodedc
127.0.0.1 onec.local.nodedc
127.0.0.1 dm.local.nodedc

На macOS изменение /etc/hosts требует admin password. Если агент не может выполнить sudo, эти строки нужно добавить вручную.

Current local apps

Launcher сейчас запускается как Vite app из:

/Users/dcconstructions/Downloads/mnt/data/nodedc_launcher

Task Manager сейчас доступен как Plane self-host runtime:

http://localhost:8090

Runtime:

/Users/dcconstructions/Downloads/mnt/data/dc_taskmanager/NODEDC_TASKMANAGER/plane-app

Source fork:

/Users/dcconstructions/Downloads/mnt/data/dc_taskmanager/NODEDC_TASKMANAGER/plane-src

Target local flow

Первый local infra milestone:

auth.local.nodedc      -> Authentik
launcher.local.nodedc  -> Launcher web/backend
task.local.nodedc      -> Plane proxy/runtime

Все внешние запросы идут через reverse proxy.

На этом этапе reverse proxy реализуется через Caddy, а Authentik запускается за ним без прямой публикации host ports.

Для текущей локальной машины proxy image задан как nodedc/plane-proxy:ru: это уже существующий Caddy-based image из Plane-стенда. На чистой машине можно заменить PLATFORM_PROXY_IMAGE на caddy:2-alpine.

Текущие приложения подключаются как внешние upstream:

launcher.local.nodedc -> host.docker.internal:5173
task.local.nodedc     -> host.docker.internal:8090

Это сохраняет Launcher и Plane в их текущих репозиториях и runtime-папках.

Environment

Базовые переменные должны жить в:

platform/infra/.env

Пример значений хранится в:

platform/infra/.env.example

Для генерации локальных secrets:

cd /Users/dcconstructions/Downloads/mnt/NODEDC/platform
./infra/scripts/init-dev-env.sh

Скрипт создает platform/infra/.env, выставляет права 600 и не перезаписывает существующий файл.

Start commands

cd /Users/dcconstructions/Downloads/mnt/NODEDC/platform
docker compose --env-file infra/.env -f infra/docker-compose.dev.yml up -d

Authentik bootstrap

After Authentik is healthy, bootstrap local NODE.DC identity objects:

NODEDC_BOOTSTRAP_ADMIN_EMAIL=dcctouch@gmail.com infra/scripts/bootstrap-authentik-dev.sh

This creates:

  • nodedc:superadmin;
  • nodedc:launcher:admin;
  • nodedc:launcher:user;
  • nodedc:taskmanager:admin;
  • nodedc:taskmanager:user;
  • NODE.DC Launcher application with OAuth2/OIDC provider;
  • NODE.DC Task Manager application with OAuth2/OIDC provider;
  • group bindings for application access.

The script fills missing LAUNCHER_OIDC_CLIENT_SECRET and PLANE_OIDC_CLIENT_SECRET values in ignored infra/.env. Secrets are not committed.

Проверка:

docker compose --env-file infra/.env -f infra/docker-compose.dev.yml ps
curl -I -H 'Host: auth.local.nodedc' http://127.0.0.1/
curl -I -H 'Host: launcher.local.nodedc' http://127.0.0.1/
curl -I -H 'Host: task.local.nodedc' http://127.0.0.1/

Текущая локальная проверка:

auth.local.nodedc -> 302 Authentik authentication flow
launcher.local.nodedc -> 200 Launcher/Vite HTML
task.local.nodedc -> 200 Plane HTML

Эти проверки выполнены через curl с Host header. Для проверки в браузере нужны записи в /etc/hosts.

Authentik version note

Официальный compose Authentik для текущей ветки 2026.2 использует PostgreSQL, server и worker. Redis, указанный в раннем ТЗ как ожидаемый сервис, в актуальном официальном compose не используется. Если позже будет выбран старый pinned Authentik или отдельная HA-схема, Redis надо вернуть отдельной задачей.

Implementation order

  1. Согласовать локальные domain/port bindings.
  2. Добавить reverse proxy config.
  3. Поднять Authentik server, worker и Postgres.
  4. Прокинуть Authentik за proxy с корректными headers.
  5. Подключить текущий Launcher как внешний сервис или через compose service.
  6. Подключить текущий Plane runtime как внешний service target.
  7. После стабилизации собрать воспроизводимый compose.

Notes

Текущий Plane runtime не переносится на нулевом этапе. Любое изменение plane-app/plane.env, volumes или startup scripts делается только после backup и отдельной задачи.