Каталог сервисов - Wraithbound Engineering

Каталог связывает продуктовый сервис с инфраструктурой. Он не хранит пароли и не заменяет Portainer/Proxmox: здесь фиксируются ответственность, зависимости и способ проверки.

Product services

Сервис	Endpoint	Размещение	Зависимости	Критичность
Wraithbound site	`https://wraithbound.com`	Внешний application host; private `10.10.20.7`	DB, Redis, S3	Critical
Launcher public API	`https://launcher-api.wraithbound.com`	Edge → launcher-server	launcher-server, S3	Critical
Launcher control plane	private `10.10.10.40:50051`	PVE VM 104	S3, signing keys	Critical
Launcher CDN	`https://cdn.wraithbound.com`	CDN/object storage edge	S3 release objects	Critical
Minecraft	`play.wraithbound.com`, public `82.202.161.121`	PVE VM 100	Docker, game data, Authlib/site	Critical

Engineering and operations

Сервис	Endpoint	Размещение	Назначение
Proxmox	`https://10.10.10.1:8006`	`xinboshin`	Hypervisor и VM lifecycle
WireGuard	public UDP `51820` → `10.10.10.2`	PVE VM 101	Доступ в `10.10.20.0/24` и PVE network
GitLab	private `10.10.10.20`	PVE VM 102	Исходники и CI coordination
GitLab Runner	private `10.10.10.21`	PVE VM 103	Сборки и deployment jobs
Nginx Proxy Manager	`https://npm.wraithbound.com`	Отдельный edge host	DNS upstreams и TLS termination
Portainer	`https://portainer.wraithbound.com`	Отдельный management host	Управление Docker environments
Plane	`https://crm.wraithbound.com`	Отдельный application host	Проекты и задачи
Uptime Kuma	Подтвердить DNS	Отдельный monitoring host	Доступность и push monitors
Beszel	Подтвердить DNS	Отдельный monitoring host	CPU, RAM, disk, network и host metrics

Размещение внешних сервисов не связывается с конкретным public IP в Git. Для них нужно отдельно добавить private hostname, owner и backup policy после инвентаризации соответствующих VPS.

Startup order Proxmox

Текущая автоматическая последовательность:

VM 101 VPN:       order 1, delay 10 s
VM 100 Minecraft: order 2, delay 20 s
VM 102 GitLab:    autostart выключен
VM 103 Runner:    autostart выключен
VM 104 Launcher:  autostart выключен

Рекомендуемая зависимость после согласования: Launcher-server не зависит от GitLab/Runner во время обычной работы. Runner нужен только для нового релиза. Поэтому VM 104 можно запускать независимо после готовности сети.

Карточка нового сервиса

name: service-name
owner: team-or-person
criticality: critical | high | normal
runtime: systemd | docker-compose | kubernetes | managed
host: inventory-hostname
private_endpoint: null
public_endpoint: null
data:
  - database
dependencies:
  - dependency-name
healthcheck: https://service.example/health
backup_policy: daily-7
recovery_order: 0
runbook: /infrastructure/operations/incidents

Сервис добавляется в production только после заполнения healthcheck, owner, backup policy и rollback.