sless/doc/progress.md

Прогресс разработки

Последнее обновление: 2026-03-07 (operator v0.1.5, provider v0.1.3)

Статусы: ✅ готово | 🔄 в процессе | ⏳ не начато

---

v1 — Базовый сервис

Код

#	Компонент	Статус	Заметки
1	Структура проекта, operator-sdk init	✅	module: gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless
2	CRD types: Function, Trigger	✅	api/v1alpha1/, zz_generated.deepcopy.go
3	internal/config	✅	config.go, Load() из env vars, добавлены IngressHost + APIToken
4	Миграции PostgreSQL	✅	migrations/001_initial.sql — таблица invocations
5	internal/storage/postgres	✅	store.go: SaveInvocation, ListInvocations, RunMigrations
6	internal/storage/s3	✅	client.go: Upload, Download, Delete, EnsureBucket (Ceph S3)
7	internal/builder	✅	builder.go: kaniko Jobs для сборки образов функций
8	controllers/function_controller.go	✅	Pending→Building(kaniko)→Ready/Failed, Deployment, finalizer
9	controllers/trigger_controller.go	✅	HTTP→Service+Ingress (fallback) или прокси через ExternalURL, Cron→CronJob, finalizer
10	internal/api/router.go	✅	gorilla/mux, /v1/namespaces/{ns}/... (auth), /fn/{ns}/{name} (публичный прокси)
11	internal/api/handler/	✅	functions.go, triggers.go, invocations.go, invoke.go (proxy), handler.go (slog)
12	internal/api/middleware/	✅	auth.go (Bearer token), logging.go (slog)
13	main.go	✅	operator manager + HTTP сервер параллельно, wire всех зависимостей

Кластер (namespace: sless)

#	Ресурс	Статус	Заметки
1	namespace sless	✅	создан
2	CRD functions.sless.kube5s.ru	✅	установлен из config/crd/bases/
3	CRD triggers.sless.kube5s.ru	✅	установлен из config/crd/bases/
4	ServiceAccount sless-operator	✅	deployments/k8s/rbac.yaml
5	ClusterRole + ClusterRoleBinding	✅	deployments/k8s/rbac.yaml
6	PostgreSQL Deployment + Service	✅	deployments/k8s/postgres.yaml, Running
7	Secret postgres-secret	✅	в namespace sless

Runtime image + Upload endpoint (2026-03-07)

#	Компонент	Статус	Заметки
1	runtimes/python3.11/server.py	✅	HTTP wrapper :8080, loads /app/function/handler.py
2	runtimes/python3.11/Dockerfile	✅	FROM python:3.11-slim, naeel/sless-runtime-python3.11:v0.1.0
3	Secret sless-registry-auth	✅	DockerHub creds для kaniko в namespace sless
4	internal/api/handler/upload.go	✅	POST /v1/namespaces/{ns}/functions/{name}/upload
5	Fix: kaniko S3 endpoint	✅	https:// + S3_FORCE_PATH_STYLE=true (Ceph)
6	Fix: бесконечный цикл сборки	✅	idempotency guard через аннотацию last-built-s3key

E2E тест (2026-03-07)

#	Шаг	Результат
1	Запуск оператора локально	✅ source hack/local.env && go run main.go
2	Создание функции hello + upload handler.zip	✅ kaniko собрал naeel/sless-default-hello:latest
3	Function phase=Ready, Deployment Running	✅ namespace sless-fn-default
4	GET /health	✅ {"status": "ok"}
5	POST / {"name":"Naeel"}	✅ {"message": "Hello, Naeel!"}
6	terraform apply (pg-query python3.11)	✅ {"invocations": [], "count": 0} через https://sless-api.kube5s.ru
7	hello-node (nodejs20) E2E	✅

Terraform провайдер (2026-03-07)

#	Компонент	Статус	Заметки
1	terraform/provider/ — независимый Go-модуль	✅	module: terraform-provider-sless
2	internal/client/client.go	✅	HTTP-клиент sless API, готов к переносу в nubes
3	internal/provider/provider.go	✅	паттерн идентичен nubes NubesProvider
4	sless_function resource	✅	CRUD + upload zip + WaitReady (kaniko)
5	sless_trigger resource	✅	CRUD (http/cron)
6	hack/build-and-publish.sh	✅	GPG-подпись + mc upload в S3
7	Публикация в terra.k8c.ru	✅	v0.1.3, key CB3A0DF161ECC416
8	terraform init	✅	Installed terra.k8c.ru/naeel/sless v0.1.3
9	sless_job resource	✅	одноразовые запуски функции через FunctionJob CRD
10	build_timeout_sec / wait_timeout_sec	✅	настраиваемые таймауты в sless_function и sless_job

Примечание: Код провайдера писался с прицелом на перенос в nubes провайдер. internal/client/ → internal/core/ nubes, ресурсы → internal/resources_gen/.

Что ещё не сделано

#	Компонент	Статус	Заметки
1	terraform apply e2e — функция с postgres	✅	{"invocations": [], "count": 0} — функция подключилась к postgres.sless.svc, таблица пустая
2	HTTP trigger e2e тест	✅	прокси /fn/ через sless-api, без wildcard DNS
3	deployments/k8s/operator.yaml	✅	Deployment+Service+Ingress, naeel/sless-operator:v0.1.5, Running
4	Внешний доступ к API оператора	✅	https://sless-api.kube5s.ru → HTTP/2 200, TLS cert OK
5	DNS запись sless-api.kube5s.ru	✅	A → 5.172.178.182, TTL 3600, zone kube5s.ru
6	nodejs20 runtime	✅	runtimes/nodejs20/server.js + Dockerfile, naeel/sless-runtime-nodejs20:v0.1.0
7	upload.go: nodejs20 + package.json	✅	runtimeBaseImage switch, hasPackageJSON → npm install
8	go.mod: direct/indirect fix	✅	go mod tidy — gorilla/mux, lib/pq, minio-go, k8s.io/api помечены direct
9	Runtime образы: версионированные теги	✅	python3.11:v0.1.0, nodejs20:v0.1.0 (убираем :latest)

---

v2 — Расширения

#	Компонент	Статус	Заметки
1	RabbitMQ event triggers	⏳
2	Облачный auth (nubes.ru token validation)	⏳	v1 — статический токен
3	Метрики → Victoria Metrics	⏳
4	Managed PostgreSQL от провайдера	⏳	сейчас postgres в k8s
5	Pre-warm для cron триггеров	⏳	TriggerSpec.PreWarmSeconds — поле есть, логика не реализована
11	trigger.enabled	✅	enabled=false → Deployment replicas=0, in-place update через PATCH
12	job.run_id	✅	run_id=0 → skip, run_id>0 → execute. Повторный запуск = увеличить run_id