doc: document operator deploy, nodejs20 runtime, Dockerfile fixes, go.mod fix
This commit is contained in:
@@ -103,3 +103,30 @@
|
||||
**Решение:** Postgres нужен только для логов вызовов (`invocations`). Для базового деплоя функций — не нужен. Оператор работает без него (просто не пишет логи).
|
||||
|
||||
**Минимальные зависимости для production:** k8s кластер + S3 + Docker registry + Ingress.
|
||||
|
||||
## 2026-03-07 — Версионированные теги для runtime образов (не :latest)
|
||||
|
||||
**Решение:** Runtime базовые образы (`sless-runtime-python3.11`, `sless-runtime-nodejs20`) и образ оператора (`sless-operator`) тегируются по схеме `v<major>.<minor>.<patch>`. `:latest` не используется.
|
||||
|
||||
**Причина:**
|
||||
- `:latest` приводит к непредсказуемому поведению: kaniko может взять старый кешированный образ, pod не перезапускается если `imagePullPolicy: IfNotPresent`.
|
||||
- Версионированные теги дают явный контроль: при изменении runtime нужно обновить тег в `upload.go` → это принудительно пересобирает все функции с новым базовым образом.
|
||||
- Аудит и откат: можно пинить конкретную версию runtime.
|
||||
|
||||
**Соглашение:**
|
||||
- Runtime образы: `naeel/sless-runtime-{lang}:v{версия}` (например `v0.1.0`)
|
||||
- Оператор: `naeel/sless-operator:v{версия}`
|
||||
- При изменении runtime — инкрементировать минорную версию образа и обновить константу в `upload.go`
|
||||
|
||||
---
|
||||
|
||||
## 2026-03-07 — nodejs20 как второй поддерживаемый runtime
|
||||
|
||||
**Решение:** Добавлен nodejs20 runtime (`node:20-alpine` base, `server.js` HTTP wrapper, `exports.handle(event)`).
|
||||
|
||||
**Причина:** Node.js — стандарт для serverless (AWS Lambda, Vercel). Покрывает JS/TypeScript аудиторию. Паттерн идентичен python3.11: runtime image → kaniko → Deployment.
|
||||
|
||||
**Детали реализации:**
|
||||
- `runtimes/nodejs20/server.js` — `http.createServer`, динамический `require(HANDLER_PATH)`
|
||||
- Зависимости через `package.json` → `npm install --omit=dev` (аналог `requirements.txt` → `pip install`)
|
||||
- `entrypoint` в HCL игнорируется для Node.js (всегда `handler.js` + `exports.handle`) — TODO: поддержать произвольный entrypoint в v1.1
|
||||
|
||||
Reference in New Issue
Block a user