docs: initial project documentation

- architecture overview and stack
- project structure and development order
- API design (endpoints, models, runtimes)
- infrastructure overview (k8s cluster, S3, registry)
- decisions log with rationale
- progress tracker v1/v2
This commit is contained in:
“Naeel”
2026-03-06 09:51:01 +04:00
commit b29b6c3d10
7 changed files with 344 additions and 0 deletions
+41
View File
@@ -0,0 +1,41 @@
# Инфраструктура
## Kubernetes кластер (существующий, временный)
- **Version:** v1.33.1
- **Ноды:** 1 control-plane + 2 workers
- **CNI:** Cilium
- **Ingress:** nginx, external IP `5.172.178.182`
- **Storage:** rawfile CSI (OpenEBS), StorageClass `local-path` (default)
- **cert-manager:** есть
- **Kyverno:** есть (политики — проверить при деплое)
## Namespace'ы для sless
| Namespace | Что там |
|-----------|---------|
| `sless` | API сервер, PostgreSQL, Redis |
| `sless-fn-{id}` | Функции пользователей (Jobs/Deployments) |
## S3
- **URL:** `http://ceph.tst.nubes.ru/`
- **Тип:** Ceph S3 compatible
- Доступ: внешний, через access/secret key
- Бакет для кода функций: `sless-functions`
## Container Registry
- Внутренний registry кластера в namespace `registry`
- Service: `registry.registry.svc.cluster.local:18080`
## Мониторинг
- Victoria Metrics — в кластере
- Grafana: `https://grafana.ngcloud.ru`
## Будущий кластер
Новый кластер готовится. После переезда:
- Манифесты переносятся без изменений
- Меняются только конфиги подключения к S3/PostgreSQL если нужно