200 changed files with 3079 additions and 20595 deletions
-14
View File
@@ -46,20 +46,6 @@
---
## Именование
Имена должны быть **уникальными и осмысленными по всему проекту**:
- имена файлов
- имена функций/методов
- имена переменных/констант
- имена ресурсов (Terraform, Kubernetes и т.д.)
Цель: чтобы поиск по проекту находил нужные сущности без неоднозначности, а имя сразу отражало назначение.
Запрещены безликие и повторяющиеся имена вида `handler.py`, `handle`, `data`, `value`, `temp` без контекста.
---
## Git
Коммитить и пушить после каждого завершённого этапа.
-11
View File
@@ -43,9 +43,6 @@ examples/*/dist/
**/handler.zip
test.token
*.tfvars
*.tfplan
plan.out
sless-plan
.e2e-logs/
.stress-logs/
@@ -60,12 +57,4 @@ sless-plan
**/dist/
# дополнительные вариации переменных/файлов конфигурации
*.tfvars.json
*.tfplan
plan.out
sless-plan
examples/.git
event-dispatcher
# build artifacts
/sless
examples/POSTGRES/stress_log*.txt
-25
View File
@@ -1,25 +0,0 @@
# Изменено: 2026-03-19
# Multi-stage build для event-dispatcher.
# Stage 1: сборка бинаря
# Stage 2: минимальный образ (нужен ca-certificates для TLS к RabbitMQ и k8s API)
FROM golang:1.25-alpine AS builder
ARG TARGETOS
ARG TARGETARCH
WORKDIR /workspace
COPY go.mod go.mod
COPY go.sum go.sum
RUN go mod download
COPY api/ api/
COPY services/event-dispatcher/ services/event-dispatcher/
RUN CGO_ENABLED=0 GOOS=${TARGETOS:-linux} GOARCH=${TARGETARCH} \
go build -a -o event-dispatcher ./services/event-dispatcher/
FROM alpine:3.19
RUN apk add --no-cache ca-certificates
WORKDIR /
COPY --from=builder /workspace/event-dispatcher .
USER 65532:65532
ENTRYPOINT ["/event-dispatcher"]
+6 -41
View File
@@ -1,5 +1,4 @@
// Изменено: 2026-03-20 (merge sless_function+sless_job: FunctionJobSpec самодостаточен,
// больше не требует отдельного Function CRD)
// Изменено: 2026-03-08
// Описание CRD FunctionJob — одноразовый запуск функции.
// Отдельный ресурс (не Trigger) потому что семантика принципиально другая:
// - Trigger: постоянно живёт, описывает КАК функцию вызывают (http/cron)
@@ -15,8 +14,6 @@ import (
)
// FunctionJobSpec — параметры одноразового запуска функции.
// Самодостаточен: содержит всё для сборки образа и запуска Job.
// Отдельный Function CRD больше не требуется.
type FunctionJobSpec struct {
// RunID — идентификатор запуска. 0 = не запускать.
// Каждое ненулевое значение уникально идентифицирует запуск.
@@ -25,35 +22,9 @@ type FunctionJobSpec struct {
// +kubebuilder:default=0
RunID int64 `json:"runId"`
// --- Параметры функции (встроены, не нужен отдельный sless_function) ---
// Runtime — язык и версия выполнения (go1.23, python3.11, nodejs20)
// +kubebuilder:validation:Enum=go1.23;python3.11;nodejs20
// FunctionRef — имя Function ресурса в том же namespace
// +kubebuilder:validation:Required
Runtime string `json:"runtime"`
// Entrypoint — точка входа в код функции (например: handler.handle)
// +kubebuilder:validation:Required
Entrypoint string `json:"entrypoint"`
// S3Bucket — бакет S3 где хранится tar.gz контекст сборки
S3Bucket string `json:"s3Bucket,omitempty"`
// S3Key — ключ объекта в S3 (путь до tar.gz контекста)
S3Key string `json:"s3Key,omitempty"`
// MemoryMB — лимит памяти в мегабайтах (default: 128)
// +kubebuilder:default=128
MemoryMB int32 `json:"memoryMB,omitempty"`
// TimeoutSec — максимальное время выполнения в секундах (default: 30)
// +kubebuilder:default=30
TimeoutSec int32 `json:"timeoutSec,omitempty"`
// Env — переменные окружения, передаются в контейнер функции
Env map[string]string `json:"env,omitempty"`
// --- Job-специфичные параметры ---
FunctionRef string `json:"functionRef"`
// EventJSON — данные передаваемые в handle(event) в JSON формате.
// Если не задан — передаётся пустой объект {}.
@@ -66,10 +37,8 @@ type FunctionJobSpec struct {
type FunctionJobPhase string
const (
// FunctionJobPhasePending — ожидает начала сборки или запуска
// FunctionJobPhasePending — ожидает пока Function станет Ready
FunctionJobPhasePending FunctionJobPhase = "Pending"
// FunctionJobPhaseBuilding — идёт сборка Docker образа через kaniko
FunctionJobPhaseBuilding FunctionJobPhase = "Building"
// FunctionJobPhaseRunning — k8s Job запущен, функция выполняется
FunctionJobPhaseRunning FunctionJobPhase = "Running"
// FunctionJobPhaseSucceeded — функция успешно завершилась
@@ -80,16 +49,12 @@ const (
// FunctionJobStatus — наблюдаемое состояние (заполняет контроллер).
type FunctionJobStatus struct {
// Phase — текущая фаза: Pending, Building, Running, Succeeded, Failed
// Phase — текущая фаза: Pending, Running, Succeeded, Failed
Phase FunctionJobPhase `json:"phase,omitempty"`
// JobName — имя созданного k8s Job
JobName string `json:"jobName,omitempty"`
// ImageRef — полный путь к собранному Docker образу в registry
// Заполняется после успешной сборки (фаза Building → Running).
ImageRef string `json:"imageRef,omitempty"`
// StartTime — время запуска k8s Job
StartTime *metav1.Time `json:"startTime,omitempty"`
@@ -102,7 +67,7 @@ type FunctionJobStatus struct {
//+kubebuilder:object:root=true
//+kubebuilder:subresource:status
//+kubebuilder:printcolumn:name="Runtime",type=string,JSONPath=`.spec.runtime`
//+kubebuilder:printcolumn:name="Function",type=string,JSONPath=`.spec.functionRef`
//+kubebuilder:printcolumn:name="Phase",type=string,JSONPath=`.status.phase`
//+kubebuilder:printcolumn:name="Age",type=date,JSONPath=`.metadata.creationTimestamp`
-110
View File
@@ -1,110 +0,0 @@
// Создано: 2026-03-20
// service_types.go — CRD Service (sless_service): долгоживущий HTTP-сервис с постоянным URL.
// В отличие от Function (oneshot через Job), Service запускается как Deployment
// и всегда доступен по URL: https://sless.kube5s.ru/fn/{namespace}/{name}
// HTTP-триггер отдельно создавать не нужно — URL выдаётся оператором автоматически.
package v1alpha1
import (
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
)
// ServiceSpec — желаемое состояние сервиса.
// Поля идентичны FunctionSpec, но нет семантики "одноразового вызова".
type ServiceSpec struct {
// Runtime — язык и версия выполнения (go1.23, python3.11, nodejs20)
// +kubebuilder:validation:Enum=go1.23;python3.11;nodejs20
// +kubebuilder:validation:Required
Runtime string `json:"runtime"`
// Entrypoint — точка входа в код сервиса (например: handler.handle)
// +kubebuilder:validation:Required
Entrypoint string `json:"entrypoint"`
// S3Bucket — бакет S3 где хранится zip архив с кодом
S3Bucket string `json:"s3Bucket"`
// S3Key — ключ объекта в S3 (путь до zip архива)
S3Key string `json:"s3Key"`
// MemoryMB — лимит памяти в мегабайтах (default: 128)
// +kubebuilder:default=128
MemoryMB int32 `json:"memoryMB,omitempty"`
// TimeoutSec — таймаут HTTP-прокси в секундах.
// 0 (по умолчанию) = без ограничения времени выполнения.
// Задай > 0 чтобы принудительно обрывать медленные вызовы.
// Диапазон: 1–900. 0 = нет таймаута.
TimeoutSec int32 `json:"timeoutSec,omitempty"`
// Env — переменные окружения, передаются в контейнер сервиса
Env map[string]string `json:"env,omitempty"`
}
// ServicePhase — текущая фаза жизненного цикла сервиса.
type ServicePhase string
const (
// ServicePhasePending — сервис создан, ожидает сборки образа
ServicePhasePending ServicePhase = "Pending"
// ServicePhaseBuilding — идёт сборка Docker образа
ServicePhaseBuilding ServicePhase = "Building"
// ServicePhaseReady — образ собран, Deployment поднят, URL доступен
ServicePhaseReady ServicePhase = "Ready"
// ServicePhaseFailed — ошибка при сборке или деплое
ServicePhaseFailed ServicePhase = "Failed"
)
// ServiceStatus — наблюдаемое состояние сервиса (заполняет контроллер).
type ServiceStatus struct {
// Phase — текущая фаза: Pending, Building, Ready, Failed
Phase ServicePhase `json:"phase,omitempty"`
// ImageRef — полный путь к собранному Docker образу в registry
ImageRef string `json:"imageRef,omitempty"`
// URL — публичный URL сервиса, заполняется оператором после создания Ingress.
// Формат: {ExternalURL}/fn/{namespace}/{name}
URL string `json:"url,omitempty"`
// Message — человекочитаемое сообщение об ошибке или статусе
Message string `json:"message,omitempty"`
// Conditions — стандартные k8s conditions для интеграции с инструментами
Conditions []metav1.Condition `json:"conditions,omitempty"`
// LastBuiltAt — время последней успешной сборки образа
LastBuiltAt *metav1.Time `json:"lastBuiltAt,omitempty"`
}
//+kubebuilder:object:root=true
//+kubebuilder:subresource:status
//+kubebuilder:printcolumn:name="Runtime",type=string,JSONPath=`.spec.runtime`
//+kubebuilder:printcolumn:name="Phase",type=string,JSONPath=`.status.phase`
//+kubebuilder:printcolumn:name="URL",type=string,JSONPath=`.status.url`
//+kubebuilder:printcolumn:name="Age",type=date,JSONPath=`.metadata.creationTimestamp`
// Service — ресурс для долгоживущего HTTP-сервиса.
// Оператор создаёт Deployment + k8s Service + Ingress автоматически.
// URL доступен сразу после фазы Ready, без создания sless_trigger.
type Service struct {
metav1.TypeMeta `json:",inline"`
metav1.ObjectMeta `json:"metadata,omitempty"`
Spec ServiceSpec `json:"spec,omitempty"`
Status ServiceStatus `json:"status,omitempty"`
}
//+kubebuilder:object:root=true
// ServiceList contains a list of Service
type ServiceList struct {
metav1.TypeMeta `json:",inline"`
metav1.ListMeta `json:"metadata,omitempty"`
Items []Service `json:"items"`
}
func init() {
SchemeBuilder.Register(&Service{}, &ServiceList{})
}
+4 -14
View File
@@ -1,8 +1,6 @@
// Изменено: 2026-03-19
// Описание CRD Trigger — триггер для функции (HTTP, Cron или Event).
// Изменено: 2026-03-08
// Описание CRD Trigger — триггер для функции (HTTP или Cron).
// Один Trigger ссылается на одну Function и определяет способ вызова.
// Event-тип: event-dispatcher подписывается на AMQP очередь и при сообщении
// вызывает функцию по внутреннему HTTP.
package v1alpha1
@@ -18,9 +16,6 @@ const (
TriggerTypeHTTP TriggerType = "http"
// TriggerTypeCron — функция вызывается по расписанию (k8s CronJob)
TriggerTypeCron TriggerType = "cron"
// TriggerTypeEvent — функция вызывается при получении сообщения из AMQP очереди.
// event-dispatcher подписывается на spec.queue в RabbitMQ и делает POST на HTTP endpoint функции.
TriggerTypeEvent TriggerType = "event"
)
// TriggerSpec — желаемое состояние триггера.
@@ -35,8 +30,8 @@ type TriggerSpec struct {
// +kubebuilder:validation:Required
FunctionRef string `json:"functionRef"`
// Type — тип триггера: http, cron или event
// +kubebuilder:validation:Enum=http;cron;event
// Type — тип триггера: http или cron
// +kubebuilder:validation:Enum=http;cron
// +kubebuilder:validation:Required
Type TriggerType `json:"type"`
@@ -47,10 +42,6 @@ type TriggerSpec struct {
// Актуально для cron: запускаем pod заранее чтобы избежать cold start.
// +kubebuilder:default=300
PreWarmSeconds int32 `json:"preWarmSeconds,omitempty"`
// Queue — имя AMQP очереди в RabbitMQ (только для type=event).
// event-dispatcher подпишется на эту очередь и вызовет функцию при каждом сообщении.
Queue string `json:"queue,omitempty"`
}
// TriggerStatus — наблюдаемое состояние триггера (заполняет контроллер).
@@ -74,7 +65,6 @@ type TriggerStatus struct {
//+kubebuilder:printcolumn:name="Function",type=string,JSONPath=`.spec.functionRef`
//+kubebuilder:printcolumn:name="Active",type=boolean,JSONPath=`.status.active`
//+kubebuilder:printcolumn:name="URL",type=string,JSONPath=`.status.url`
//+kubebuilder:printcolumn:name="Queue",type=string,JSONPath=`.spec.queue`
//+kubebuilder:printcolumn:name="Age",type=date,JSONPath=`.metadata.creationTimestamp`
// Trigger — ресурс для управления способом вызова Function.
+2 -117
View File
@@ -21,7 +21,7 @@ limitations under the License.
package v1alpha1
import (
v1 "k8s.io/apimachinery/pkg/apis/meta/v1"
"k8s.io/apimachinery/pkg/apis/meta/v1"
runtime "k8s.io/apimachinery/pkg/runtime"
)
@@ -57,7 +57,7 @@ func (in *FunctionJob) DeepCopyInto(out *FunctionJob) {
*out = *in
out.TypeMeta = in.TypeMeta
in.ObjectMeta.DeepCopyInto(&out.ObjectMeta)
in.Spec.DeepCopyInto(&out.Spec)
out.Spec = in.Spec
in.Status.DeepCopyInto(&out.Status)
}
@@ -112,16 +112,8 @@ func (in *FunctionJobList) DeepCopyObject() runtime.Object {
}
// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
// FunctionJobSpec содержит map[string]string Env — требует явного deep copy.
func (in *FunctionJobSpec) DeepCopyInto(out *FunctionJobSpec) {
*out = *in
if in.Env != nil {
in, out := &in.Env, &out.Env
*out = make(map[string]string, len(*in))
for key, val := range *in {
(*out)[key] = val
}
}
}
// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new FunctionJobSpec.
@@ -296,113 +288,6 @@ func (in *TriggerList) DeepCopyObject() runtime.Object {
return nil
}
// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (in *Service) DeepCopyInto(out *Service) {
*out = *in
out.TypeMeta = in.TypeMeta
in.ObjectMeta.DeepCopyInto(&out.ObjectMeta)
in.Spec.DeepCopyInto(&out.Spec)
in.Status.DeepCopyInto(&out.Status)
}
// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Service.
func (in *Service) DeepCopy() *Service {
if in == nil {
return nil
}
out := new(Service)
in.DeepCopyInto(out)
return out
}
// DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
func (in *Service) DeepCopyObject() runtime.Object {
if c := in.DeepCopy(); c != nil {
return c
}
return nil
}
// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (in *ServiceList) DeepCopyInto(out *ServiceList) {
*out = *in
out.TypeMeta = in.TypeMeta
in.ListMeta.DeepCopyInto(&out.ListMeta)
if in.Items != nil {
in, out := &in.Items, &out.Items
*out = make([]Service, len(*in))
for i := range *in {
(*in)[i].DeepCopyInto(&(*out)[i])
}
}
}
// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ServiceList.
func (in *ServiceList) DeepCopy() *ServiceList {
if in == nil {
return nil
}
out := new(ServiceList)
in.DeepCopyInto(out)
return out
}
// DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
func (in *ServiceList) DeepCopyObject() runtime.Object {
if c := in.DeepCopy(); c != nil {
return c
}
return nil
}
// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (in *ServiceSpec) DeepCopyInto(out *ServiceSpec) {
*out = *in
if in.Env != nil {
in, out := &in.Env, &out.Env
*out = make(map[string]string, len(*in))
for key, val := range *in {
(*out)[key] = val
}
}
}
// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ServiceSpec.
func (in *ServiceSpec) DeepCopy() *ServiceSpec {
if in == nil {
return nil
}
out := new(ServiceSpec)
in.DeepCopyInto(out)
return out
}
// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (in *ServiceStatus) DeepCopyInto(out *ServiceStatus) {
*out = *in
if in.Conditions != nil {
in, out := &in.Conditions, &out.Conditions
*out = make([]v1.Condition, len(*in))
for i := range *in {
(*in)[i].DeepCopyInto(&(*out)[i])
}
}
if in.LastBuiltAt != nil {
in, out := &in.LastBuiltAt, &out.LastBuiltAt
*out = (*in).DeepCopy()
}
}
// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ServiceStatus.
func (in *ServiceStatus) DeepCopy() *ServiceStatus {
if in == nil {
return nil
}
out := new(ServiceStatus)
in.DeepCopyInto(out)
return out
}
// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (in *TriggerSpec) DeepCopyInto(out *TriggerSpec) {
*out = *in
+156
View File
@@ -0,0 +1,156 @@
// cmd/sless-plan/main.go
// Дата: 2026-03-12
// CLI-обёртка над `terraform plan`.
// Добавляет AI-анализ вывода если AI_HINT_LEVEL > 0.
// Существующий terraform plan не меняется — AI только дополняет вывод.
//
// Использование:
// sless-plan [terraform args...]
// sless-plan --ai-level=3 [terraform args...]
//
// Env-переменные:
// AI_HINT_LEVEL — уровень анализа 0–5 (0 = выключен, по умолчанию)
// AI_PROVIDER — провайдер: "groq" (по умолчанию), "google", "cloud"
// GROQ_API_KEY — API ключ Groq (рекомендуется, работает из РФ)
// GROQ_MODEL — модель Groq (по умолчанию "llama-3.3-70b-versatile")
// GROQ_ENDPOINT — endpoint (по умолчанию https://api.groq.com/openai/v1/chat/completions)
// GOOGLE_AI_API_KEY — API ключ Google Gemini (геоблок в РФ)
// GOOGLE_AI_MODEL — модель Gemini (по умолчанию "gemini-2.0-flash")
// CLOUD_LLM_ENDPOINT — endpoint будущего облачного LLM
// CLOUD_LLM_TOKEN — токен для облачного LLM
package main
import (
"bytes"
"context"
"flag"
"fmt"
"io"
"os"
"os/exec"
"strconv"
"time"
"gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless/internal/ai"
)
func main() {
// Флаг --ai-level переопределяет env AI_HINT_LEVEL
aiLevel := flag.Int("ai-level", -1, "уровень AI-анализа 0–5 (-1 = читать из AI_HINT_LEVEL)")
flag.Parse()
// Определяем уровень: флаг > env > 0
level := resolveLevel(*aiLevel)
// Собираем аргументы для terraform plan (всё что после флагов sless-plan)
tfArgs := append([]string{"plan"}, flag.Args()...)
// Запускаем terraform plan, захватывая вывод для AI
// но одновременно выводя его пользователю (tee-эффект)
planOutput, exitCode := runTerraform(tfArgs)
// Если уровень > 0 — запускаем AI анализ
if level > 0 {
runAIAnalysis(level, planOutput)
}
os.Exit(exitCode)
}
// resolveLevel определяет уровень AI анализа.
// Приоритет: --ai-level flag > AI_HINT_LEVEL env > 0
func resolveLevel(flagValue int) int {
if flagValue >= 0 {
// Флаг явно задан
if flagValue > 5 {
flagValue = 5
}
return flagValue
}
// Читаем из env
if envVal := os.Getenv("AI_HINT_LEVEL"); envVal != "" {
level, err := strconv.Atoi(envVal)
if err == nil && level >= 0 && level <= 5 {
return level
}
}
// TF_VAR_ai_hint_level тоже поддерживаем
if envVal := os.Getenv("TF_VAR_ai_hint_level"); envVal != "" {
level, err := strconv.Atoi(envVal)
if err == nil && level >= 0 && level <= 5 {
return level
}
}
return 0 // по умолчанию — AI выключен
}
// runTerraform запускает terraform с переданными аргументами.
// Вывод идёт напрямую в stdout/stderr пользователя И захватывается для AI.
// Возвращает текст вывода и код завершения.
func runTerraform(args []string) (string, int) {
cmd := exec.Command("terraform", args...)
// Захватываем stdout для AI, но также пишем напрямую в os.Stdout
var buf bytes.Buffer
cmd.Stdout = io.MultiWriter(os.Stdout, &buf)
cmd.Stderr = os.Stderr
cmd.Stdin = os.Stdin
err := cmd.Run()
if err != nil {
if exitErr, ok := err.(*exec.ExitError); ok {
return buf.String(), exitErr.ExitCode()
}
fmt.Fprintf(os.Stderr, "ошибка запуска terraform: %v\n", err)
return buf.String(), 1
}
return buf.String(), 0
}
// runAIAnalysis запускает AI анализ и выводит результат.
// Не прерывает работу если AI недоступен — только показывает предупреждение.
func runAIAnalysis(level int, planOutput string) {
cfg := ai.Config{
HintLevel: level,
Provider: getEnv("AI_PROVIDER", "groq"),
GroqAPIKey: os.Getenv("GROQ_API_KEY"),
GroqModel: getEnv("GROQ_MODEL", "llama-3.3-70b-versatile"),
GroqEndpoint: os.Getenv("GROQ_ENDPOINT"),
GoogleAPIKey: os.Getenv("GOOGLE_AI_API_KEY"),
GoogleModel: getEnv("GOOGLE_AI_MODEL", "gemini-2.0-flash"),
CloudEndpoint: os.Getenv("CLOUD_LLM_ENDPOINT"),
CloudToken: os.Getenv("CLOUD_LLM_TOKEN"),
}
analyzer, err := ai.NewAnalyzer(cfg)
if err != nil {
fmt.Fprintf(os.Stderr, "\n⚠ AI анализ недоступен: %v\n", err)
return
}
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
result, err := analyzer.Analyze(ctx, planOutput)
if err != nil {
fmt.Fprintf(os.Stderr, "\n⚠ AI анализ завершился с ошибкой: %v\n", err)
return
}
if result != "" {
fmt.Print(result)
}
}
// getEnv возвращает значение env-переменной или defaultVal если не задана.
func getEnv(key, defaultVal string) string {
if val := os.Getenv(key); val != "" {
return val
}
return defaultVal
}
@@ -15,8 +15,8 @@ spec:
scope: Namespaced
versions:
- additionalPrinterColumns:
- jsonPath: .spec.runtime
name: Runtime
- jsonPath: .spec.functionRef
name: Function
type: string
- jsonPath: .status.phase
name: Phase
@@ -50,19 +50,8 @@ spec:
metadata:
type: object
spec:
description: |-
FunctionJobSpec — параметры одноразового запуска функции.
Самодостаточен: содержит всё для сборки образа и запуска Job.
Отдельный Function CRD больше не требуется.
description: FunctionJobSpec — параметры одноразового запуска функции.
properties:
entrypoint:
description: 'Entrypoint — точка входа в код функции (например: handler.handle)'
type: string
env:
additionalProperties:
type: string
description: Env — переменные окружения, передаются в контейнер функции
type: object
eventJson:
default: '{}'
description: |-
@@ -70,11 +59,9 @@ spec:
Если не задан — передаётся пустой объект {}.
Пример: {"action": "migrate", "version": "002"}
type: string
memoryMB:
default: 128
description: 'MemoryMB — лимит памяти в мегабайтах (default: 128)'
format: int32
type: integer
functionRef:
description: FunctionRef — имя Function ресурса в том же namespace
type: string
runId:
default: 0
description: |-
@@ -84,30 +71,9 @@ spec:
При RunID=0 FunctionJob создаётся в кластере, но k8s Job не запускается.
format: int64
type: integer
runtime:
description: Runtime — язык и версия выполнения (go1.23, python3.11,
nodejs20)
enum:
- go1.23
- python3.11
- nodejs20
type: string
s3Bucket:
description: S3Bucket — бакет S3 где хранится tar.gz контекст сборки
type: string
s3Key:
description: S3Key — ключ объекта в S3 (путь до tar.gz контекста)
type: string
timeoutSec:
default: 30
description: 'TimeoutSec — максимальное время выполнения в секундах
(default: 30)'
format: int32
type: integer
required:
- entrypoint
- functionRef
- runId
- runtime
type: object
status:
description: FunctionJobStatus — наблюдаемое состояние (заполняет контроллер).
@@ -116,11 +82,6 @@ spec:
description: CompletionTime — время завершения
format: date-time
type: string
imageRef:
description: |-
ImageRef — полный путь к собранному Docker образу в registry
Заполняется после успешной сборки (фаза Building → Running).
type: string
jobName:
description: JobName — имя созданного k8s Job
type: string
@@ -128,8 +89,7 @@ spec:
description: Message — результат выполнения или сообщение об ошибке
type: string
phase:
description: 'Phase — текущая фаза: Pending, Building, Running, Succeeded,
Failed'
description: 'Phase — текущая фаза: Pending, Running, Succeeded, Failed'
type: string
startTime:
description: StartTime — время запуска k8s Job
@@ -1,199 +0,0 @@
---
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
annotations:
controller-gen.kubebuilder.io/version: v0.14.0
name: services.sless.kube5s.ru
spec:
group: sless.kube5s.ru
names:
kind: Service
listKind: ServiceList
plural: services
singular: service
scope: Namespaced
versions:
- additionalPrinterColumns:
- jsonPath: .spec.runtime
name: Runtime
type: string
- jsonPath: .status.phase
name: Phase
type: string
- jsonPath: .status.url
name: URL
type: string
- jsonPath: .metadata.creationTimestamp
name: Age
type: date
name: v1alpha1
schema:
openAPIV3Schema:
description: |-
Service — ресурс для долгоживущего HTTP-сервиса.
Оператор создаёт Deployment + k8s Service + Ingress автоматически.
URL доступен сразу после фазы Ready, без создания sless_trigger.
properties:
apiVersion:
description: |-
APIVersion defines the versioned schema of this representation of an object.
Servers should convert recognized schemas to the latest internal value, and
may reject unrecognized values.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
type: string
kind:
description: |-
Kind is a string value representing the REST resource this object represents.
Servers may infer this from the endpoint the client submits requests to.
Cannot be updated.
In CamelCase.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
type: string
metadata:
type: object
spec:
description: |-
ServiceSpec — желаемое состояние сервиса.
Поля идентичны FunctionSpec, но нет семантики "одноразового вызова".
properties:
entrypoint:
description: 'Entrypoint — точка входа в код сервиса (например: handler.handle)'
type: string
env:
additionalProperties:
type: string
description: Env — переменные окружения, передаются в контейнер сервиса
type: object
memoryMB:
default: 128
description: 'MemoryMB — лимит памяти в мегабайтах (default: 128)'
format: int32
type: integer
runtime:
description: Runtime — язык и версия выполнения (go1.23, python3.11,
nodejs20)
enum:
- go1.23
- python3.11
- nodejs20
type: string
s3Bucket:
description: S3Bucket — бакет S3 где хранится zip архив с кодом
type: string
s3Key:
description: S3Key — ключ объекта в S3 (путь до zip архива)
type: string
timeoutSec:
default: 30
description: |-
TimeoutSec — таймаут HTTP-прокси в секундах (default: 30).
Ограничивает время ожидания ответа от пода в invoke.go.
Для длительных вызовов (batch, pgstorm) увеличить до нужного значения.
format: int32
type: integer
required:
- entrypoint
- runtime
- s3Bucket
- s3Key
type: object
status:
description: ServiceStatus — наблюдаемое состояние сервиса (заполняет
контроллер).
properties:
conditions:
description: Conditions — стандартные k8s conditions для интеграции
с инструментами
items:
description: "Condition contains details for one aspect of the current
state of this API Resource.\n---\nThis struct is intended for
direct use as an array at the field path .status.conditions. For
example,\n\n\n\ttype FooStatus struct{\n\t // Represents the
observations of a foo's current state.\n\t // Known .status.conditions.type
are: \"Available\", \"Progressing\", and \"Degraded\"\n\t //
+patchMergeKey=type\n\t // +patchStrategy=merge\n\t // +listType=map\n\t
\ // +listMapKey=type\n\t Conditions []metav1.Condition `json:\"conditions,omitempty\"
patchStrategy:\"merge\" patchMergeKey:\"type\" protobuf:\"bytes,1,rep,name=conditions\"`\n\n\n\t
\ // other fields\n\t}"
properties:
lastTransitionTime:
description: |-
lastTransitionTime is the last time the condition transitioned from one status to another.
This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
format: date-time
type: string
message:
description: |-
message is a human readable message indicating details about the transition.
This may be an empty string.
maxLength: 32768
type: string
observedGeneration:
description: |-
observedGeneration represents the .metadata.generation that the condition was set based upon.
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
with respect to the current state of the instance.
format: int64
minimum: 0
type: integer
reason:
description: |-
reason contains a programmatic identifier indicating the reason for the condition's last transition.
Producers of specific condition types may define expected values and meanings for this field,
and whether the values are considered a guaranteed API.
The value should be a CamelCase string.
This field may not be empty.
maxLength: 1024
minLength: 1
pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
type: string
status:
description: status of the condition, one of True, False, Unknown.
enum:
- "True"
- "False"
- Unknown
type: string
type:
description: |-
type of condition in CamelCase or in foo.example.com/CamelCase.
---
Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be
useful (see .node.status.conditions), the ability to deconflict is important.
The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
maxLength: 316
pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
type: string
required:
- lastTransitionTime
- message
- reason
- status
- type
type: object
type: array
imageRef:
description: ImageRef — полный путь к собранному Docker образу в registry
type: string
lastBuiltAt:
description: LastBuiltAt — время последней успешной сборки образа
format: date-time
type: string
message:
description: Message — человекочитаемое сообщение об ошибке или статусе
type: string
phase:
description: 'Phase — текущая фаза: Pending, Building, Ready, Failed'
type: string
url:
description: |-
URL — публичный URL сервиса, заполняется оператором после создания Ingress.
Формат: {ExternalURL}/fn/{namespace}/{name}
type: string
type: object
type: object
served: true
storage: true
subresources:
status: {}
+1 -10
View File
@@ -27,9 +27,6 @@ spec:
- jsonPath: .status.url
name: URL
type: string
- jsonPath: .spec.queue
name: Queue
type: string
- jsonPath: .metadata.creationTimestamp
name: Age
type: date
@@ -75,21 +72,15 @@ spec:
Актуально для cron: запускаем pod заранее чтобы избежать cold start.
format: int32
type: integer
queue:
description: |-
Queue — имя AMQP очереди в RabbitMQ (только для type=event).
event-dispatcher подпишется на эту очередь и вызовет функцию при каждом сообщении.
type: string
schedule:
description: 'Schedule — расписание в формате cron (только для type=cron,
например: "0 2 * * *")'
type: string
type:
description: 'Type — тип триггера: http, cron или event'
description: 'Type — тип триггера: http или cron'
enum:
- http
- cron
- event
type: string
required:
- enabled
-7
View File
@@ -20,13 +20,6 @@ rules:
- get
- list
- watch
- apiGroups:
- ""
resources:
- secrets
verbs:
- create
- get
- apiGroups:
- ""
resources:
+182 -42
View File
@@ -1,11 +1,8 @@
// Изменено: 2026-03-20 (function-service-split: FunctionReconciler — только build pipeline)
// FunctionReconciler — контроллер Function CRD (sless_function = oneshot/Job).
// Функция = код который выполняется ОДИН РАЗ через k8s Job при каждом вызове.
// Нет Deployment, нет постоянного URL. Вызов — через FunctionJob или invoke API.
// Reconciler отвечает только за:
// 1. Сборку Docker-образа через kaniko (Pending → Building → Ready/Failed)
// 2. Очистку ресурсов при удалении (kaniko Job)
// Deployment/Service/Ingress — в ServiceReconciler (sless_service).
// Изменено: 2026-03-11
// FunctionReconciler — основной контроллер оператора.
// Следит за CRD Function и управляет lifecycle функции:
// Pending → Building (запуск kaniko Job) → Ready (образ собран, Deployment создан) / Failed
// Reconcile вызывается k8s при любом изменении Function объекта.
package controllers
@@ -14,11 +11,15 @@ import (
"context"
"fmt"
"io"
"sort"
"strings"
"time"
appsv1 "k8s.io/api/apps/v1"
corev1 "k8s.io/api/core/v1"
netv1 "k8s.io/api/networking/v1"
"k8s.io/apimachinery/pkg/api/errors"
"k8s.io/apimachinery/pkg/api/resource"
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
"k8s.io/apimachinery/pkg/runtime"
"k8s.io/client-go/kubernetes"
@@ -96,9 +97,7 @@ func (r *FunctionReconciler) Reconcile(ctx context.Context, req ctrl.Request) (c
case slessv1alpha1.FunctionPhaseBuilding:
return r.checkBuild(ctx, fn)
case slessv1alpha1.FunctionPhaseReady:
// Function = oneshot. После успешной сборки образ готов — Deployment не создаём.
// Вызов через FunctionJob или invoke API (Job per call).
return ctrl.Result{}, nil
return r.ensureDeployment(ctx, fn)
}
return ctrl.Result{}, nil
@@ -106,36 +105,11 @@ func (r *FunctionReconciler) Reconcile(ctx context.Context, req ctrl.Request) (c
const finalizerName = "sless.kube5s.ru/finalizer"
// startBuild проверяет наличие образа в registry и либо пропускает сборку,
// либо запускает kaniko Job. Идемпотентность: если код не менялся (тег = hash s3Key),
// образ уже в registry → deploy без пересборки.
// startBuild запускает kaniko Job и помечает функцию как Building.
// Критически важно: СНАЧАЛА сохраняем last-built-s3key аннотацию, ПОТОМ status.
// Это предотвращает повторный запуск сборки при параллельных reconcile —
// следующий reconcile увидит last-built-s3key == spec.S3Key и не войдёт в startBuild.
func (r *FunctionReconciler) startBuild(ctx context.Context, fn *slessv1alpha1.Function) (ctrl.Result, error) {
imageRef := r.Builder.ImageRef(fn.Namespace, fn.Name, fn.Spec.S3Key)
// Проверяем: образ с этим тегом уже существует в registry?
// Если да — пропускаем kaniko, сразу переходим в Ready.
if r.Builder.ImageExists(ctx, imageRef) {
logger := log.FromContext(ctx)
logger.Info("image already exists in registry, skipping build", "imageRef", imageRef)
if fn.Annotations == nil {
fn.Annotations = map[string]string{}
}
fn.Annotations["sless.kube5s.ru/last-built-s3key"] = fn.Spec.S3Key
if err := r.Update(ctx, fn); err != nil {
return ctrl.Result{}, fmt.Errorf("update annotations (cache hit): %w", err)
}
fn.Status.Phase = slessv1alpha1.FunctionPhaseReady
fn.Status.ImageRef = imageRef
fn.Status.Message = "Image restored from registry cache"
if err := r.Status().Update(ctx, fn); err != nil {
return ctrl.Result{}, fmt.Errorf("update status (cache hit): %w", err)
}
return ctrl.Result{}, nil
}
jobName, err := r.Builder.Build(ctx, fn.Namespace, fn.Name, fn.Spec.S3Key)
if err != nil {
return r.setFailed(ctx, fn, fmt.Sprintf("failed to start build: %v", err))
@@ -210,14 +184,180 @@ func (r *FunctionReconciler) checkBuild(ctx context.Context, fn *slessv1alpha1.F
return ctrl.Result{RequeueAfter: 10 * time.Second}, nil
}
// handleDeletion обрабатывает удаление Function: убивает kaniko Job и убирает finalizer.
// Deployment/Service/Ingress Function не создаёт — они принадлежат Service CRD.
// ensureDeployment создаёт или обновляет Deployment для HTTP функции.
// Deployment запускается в отдельном namespace sless-fn-{namespace}.
func (r *FunctionReconciler) ensureDeployment(ctx context.Context, fn *slessv1alpha1.Function) (ctrl.Result, error) {
deployNS := "sless-fn-" + fn.Namespace
// Создаём namespace для функций если не существует
ns := &corev1.Namespace{}
if err := r.Get(ctx, client.ObjectKey{Name: deployNS}, ns); err != nil {
if errors.IsNotFound(err) {
ns = &corev1.Namespace{ObjectMeta: metav1.ObjectMeta{Name: deployNS}}
if err := r.Create(ctx, ns); err != nil {
return ctrl.Result{}, fmt.Errorf("create function namespace: %w", err)
}
// Создаём Harbor-проект для namespace сразу при создании k8s NS (best-effort).
// Если не удалось — EnsureProject повторит вызов внутри Build().
if r.HarborClient != nil {
if err := r.HarborClient.EnsureProject(ctx, fn.Namespace); err != nil {
log.FromContext(ctx).Error(err, "harbor ensure project on ns create", "project", fn.Namespace)
}
}
} else {
return ctrl.Result{}, fmt.Errorf("get function namespace: %w", err)
}
}
// Обеспечиваем наличие registry pull-секрета в namespace функций.
// Без него kubelet не сможет pull-нуть private образ из Harbor.
if r.RegistrySecret != "" && r.OperatorNamespace != "" {
if err := r.ensureRegistrySecret(ctx, deployNS); err != nil {
// Не фатальная ошибка — логируем, но продолжаем
log.FromContext(ctx).Error(err, "failed to ensure registry secret", "ns", deployNS)
}
}
desired := r.buildDeployment(fn, deployNS)
existing := &appsv1.Deployment{}
err := r.Get(ctx, client.ObjectKey{Name: fn.Name, Namespace: deployNS}, existing)
if errors.IsNotFound(err) {
if err := r.Create(ctx, desired); err != nil {
return ctrl.Result{}, fmt.Errorf("create deployment: %w", err)
}
return ctrl.Result{}, nil
}
if err != nil {
return ctrl.Result{}, fmt.Errorf("get deployment: %w", err)
}
// Обновляем образ, env и imagePullSecrets при пересборке или изменении конфига.
// Тег образа уникален per build (sha256 от s3Key) → imagePullPolicy: IfNotPresent
// корректно подтягивает новый образ без дополнительных хаков.
// Env обновляем целиком — иначе изменение entrypoint/env_vars не применяется.
existing.Spec.Template.Spec.Containers[0].Image = fn.Status.ImageRef
existing.Spec.Template.Spec.Containers[0].Env = desired.Spec.Template.Spec.Containers[0].Env
existing.Spec.Template.Spec.ImagePullSecrets = desired.Spec.Template.Spec.ImagePullSecrets
if err := r.Update(ctx, existing); err != nil {
return ctrl.Result{}, fmt.Errorf("update deployment: %w", err)
}
return ctrl.Result{}, nil
}
// Изменено: 2026-03-11// buildDeployment формирует Deployment манифест для функции.
func (r *FunctionReconciler) buildDeployment(fn *slessv1alpha1.Function, namespace string) *appsv1.Deployment {
replicas := int32(1)
envVars := []corev1.EnvVar{
// SLESS_ENTRYPOINT сообщает server.py/server.js какой файл и функцию загружать.
// Формат: "module-name.funcName" (например: handler-http.handle)
{Name: "SLESS_ENTRYPOINT", Value: fn.Spec.Entrypoint},
}
// Сортируем ключи env vars для стабильного порядка в Pod spec.
// map range в Go — недетерминирован: разный порядок при каждом вызове.
// Нестабильный порядок → k8s видит изменение контейнера → лишние rollout'ы.
keys := make([]string, 0, len(fn.Spec.Env))
for k := range fn.Spec.Env {
keys = append(keys, k)
}
sort.Strings(keys)
for _, k := range keys {
envVars = append(envVars, corev1.EnvVar{Name: k, Value: fn.Spec.Env[k]})
}
return &appsv1.Deployment{
ObjectMeta: metav1.ObjectMeta{
Name: fn.Name,
Namespace: namespace,
Labels: map[string]string{"app": fn.Name, "managed-by": "sless"},
},
Spec: appsv1.DeploymentSpec{
Replicas: &replicas,
Selector: &metav1.LabelSelector{MatchLabels: map[string]string{"app": fn.Name}},
Template: corev1.PodTemplateSpec{
ObjectMeta: metav1.ObjectMeta{Labels: map[string]string{"app": fn.Name}},
Spec: corev1.PodSpec{
Containers: []corev1.Container{
{
Name: fn.Name,
Image: fn.Status.ImageRef,
Env: envVars,
Resources: corev1.ResourceRequirements{
Limits: corev1.ResourceList{
corev1.ResourceMemory: resource.MustParse(fmt.Sprintf("%dMi", fn.Spec.MemoryMB)),
},
},
},
},
ImagePullSecrets: func() []corev1.LocalObjectReference {
if r.RegistrySecret != "" {
return []corev1.LocalObjectReference{{Name: r.RegistrySecret}}
}
return nil
}(),
},
},
},
}
}
// ensureRegistrySecret копирует pull-секрет из namespace оператора в namespace функций.
// Вызывается при каждом reconcile — если секрет уже есть, ничего не делает.
func (r *FunctionReconciler) ensureRegistrySecret(ctx context.Context, targetNS string) error {
// Проверяем что секрет уже есть в целевом namespace
existing := &corev1.Secret{}
if err := r.Get(ctx, client.ObjectKey{Name: r.RegistrySecret, Namespace: targetNS}, existing); err == nil {
return nil // уже есть
} else if !errors.IsNotFound(err) {
return fmt.Errorf("check secret: %w", err)
}
// Копируем из namespace оператора
src := &corev1.Secret{}
if err := r.Get(ctx, client.ObjectKey{Name: r.RegistrySecret, Namespace: r.OperatorNamespace}, src); err != nil {
return fmt.Errorf("get source secret from %s: %w", r.OperatorNamespace, err)
}
copy := &corev1.Secret{
ObjectMeta: metav1.ObjectMeta{
Name: r.RegistrySecret,
Namespace: targetNS,
},
Type: src.Type,
Data: src.Data,
}
if err := r.Create(ctx, copy); err != nil {
if !errors.IsAlreadyExists(err) {
return fmt.Errorf("create secret in %s: %w", targetNS, err)
}
}
return nil
}
// handleDeletion обрабатывает удаление Function: удаляет Deployment, Service, Ingress и убирает finalizer.
// ВАЖНО: Namespace sless-fn-{userNS} НЕ удаляется — он принадлежит пользователю на всё время его существования.
func (r *FunctionReconciler) handleDeletion(ctx context.Context, fn *slessv1alpha1.Function) (ctrl.Result, error) {
// Убиваем kaniko Job если сборка шла в момент удаления
deployNS := "sless-fn-" + fn.Namespace
dep := &appsv1.Deployment{}
if err := r.Get(ctx, client.ObjectKey{Name: fn.Name, Namespace: deployNS}, dep); err == nil {
_ = r.Delete(ctx, dep)
}
// Если функция удалена в процессе сборки — убиваем kaniko Job.
// Без этого Job продолжит работу, займёт CPU/память и запушит образ которым никто не воспользуется.
if jobName := fn.Annotations["sless.kube5s.ru/build-job"]; jobName != "" {
_ = r.Builder.Cleanup(ctx, jobName)
}
// Удаляем Service и Ingress — созданы HTTP триггером, но именованы по функции.
// Если function_controller не удалит их, Ingress остаётся после destroy → 502.
svc := &corev1.Service{}
if err := r.Get(ctx, client.ObjectKey{Name: fn.Name, Namespace: deployNS}, svc); err == nil {
_ = r.Delete(ctx, svc)
}
ing := &netv1.Ingress{}
if err := r.Get(ctx, client.ObjectKey{Name: fn.Name, Namespace: deployNS}, ing); err == nil {
_ = r.Delete(ctx, ing)
}
fn.Finalizers = removeString(fn.Finalizers, finalizerName)
if err := r.Update(ctx, fn); err != nil {
return ctrl.Result{}, fmt.Errorf("remove finalizer: %w", err)
+52 -198
View File
@@ -1,8 +1,8 @@
// Изменено: 2026-03-20 (merge sless_function+sless_job: FunctionJobReconciler самодостаточен)
// Изменено: 2026-03-09 (feature B: захват stdout пода Job в status.Message)
// FunctionJobReconciler — контроллер одноразовых запусков функций.
// При создании FunctionJob с RunID>0:
// 1. Запускает kaniko сборку образа (фаза Building) — больше не зависит от Function CRD
// 2. После сборки создаёт k8s Job который запускает образ функции с CMD runner
// При создании FunctionJob:
// 1. Ждёт пока Function станет Ready
// 2. Создаёт k8s Job который запускает образ функции с CMD runner
// 3. Следит за завершением Job → обновляет статус (Succeeded/Failed)
//
// Почему отдельный ресурс (не Trigger type=job):
@@ -31,17 +31,14 @@ import (
"sigs.k8s.io/controller-runtime/pkg/log"
slessv1alpha1 "gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless/api/v1alpha1"
"gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless/internal/builder"
)
// FunctionJobReconciler reconciles a FunctionJob object
type FunctionJobReconciler struct {
client.Client
Scheme *runtime.Scheme
RegistrySecret string // имя k8s Secret с docker credentials (для imagePullSecrets)
KubeClient kubernetes.Interface // typed client для чтения логов подов (logs API недоступен через controller-runtime client)
Builder *builder.Builder // kaniko builder — собирает образ функции
OperatorNamespace string // namespace оператора — где запускаются kaniko job'ы (обычно "sless")
Scheme *runtime.Scheme
RegistrySecret string // имя k8s Secret с docker credentials (для imagePullSecrets)
KubeClient kubernetes.Interface // typed client для чтения логов подов (logs API недоступен через controller-runtime client)
}
//+kubebuilder:rbac:groups=sless.kube5s.ru,resources=functionjobs,verbs=get;list;watch;create;update;patch;delete
@@ -51,6 +48,8 @@ type FunctionJobReconciler struct {
// Reconcile — основной цикл контроллера.
func (r *FunctionJobReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error) {
logger := log.FromContext(ctx)
fj := &slessv1alpha1.FunctionJob{}
if err := r.Get(ctx, req.NamespacedName, fj); err != nil {
if errors.IsNotFound(err) {
@@ -77,28 +76,29 @@ func (r *FunctionJobReconciler) Reconcile(ctx context.Context, req ctrl.Request)
return ctrl.Result{}, nil
}
// Фаза Building — ждём завершения kaniko Job
if fj.Status.Phase == slessv1alpha1.FunctionJobPhaseBuilding {
return r.checkJobBuild(ctx, fj)
}
// Нет ImageRef — нужно собрать образ сначала.
// Если аннотация build-job уже есть но phase не Building (рестарт контроллера),
// восстанавливаем фазу Building.
if fj.Status.ImageRef == "" {
if fj.Annotations["sless.kube5s.ru/build-job"] != "" {
fj.Status.Phase = slessv1alpha1.FunctionJobPhaseBuilding
fj.Status.Message = "resuming build: " + fj.Annotations["sless.kube5s.ru/build-job"]
// Проверяем что Function существует и готова
fn := &slessv1alpha1.Function{}
if err := r.Get(ctx, client.ObjectKey{Name: fj.Spec.FunctionRef, Namespace: fj.Namespace}, fn); err != nil {
if errors.IsNotFound(err) {
fj.Status.Phase = slessv1alpha1.FunctionJobPhasePending
fj.Status.Message = "function not found: " + fj.Spec.FunctionRef
_ = r.Status().Update(ctx, fj)
return ctrl.Result{RequeueAfter: 10 * time.Second}, nil
return ctrl.Result{}, nil
}
return r.startJobBuild(ctx, fj)
return ctrl.Result{}, fmt.Errorf("get function: %w", err)
}
if fn.Status.Phase != slessv1alpha1.FunctionPhaseReady {
fj.Status.Phase = slessv1alpha1.FunctionJobPhasePending
fj.Status.Message = "waiting for function Ready (current: " + string(fn.Status.Phase) + ")"
_ = r.Status().Update(ctx, fj)
// RequeueAfter: опрашиваем каждые 15с пока Function не станет Ready.
return ctrl.Result{RequeueAfter: 15 * time.Second}, nil
}
// Образ собран — создаём/синхронизируем k8s Job
deployNS := "sless-fn-" + fj.Namespace
jobName := fmt.Sprintf("job-%s-%s", fj.Name, fj.CreationTimestamp.Format("20060102150405"))
// Если Job уже создан — проверяем его статус
existingJob := &batchv1.Job{}
if err := r.Get(ctx, client.ObjectKey{Name: jobName, Namespace: deployNS}, existingJob); err == nil {
return r.syncJobStatus(ctx, fj, existingJob)
@@ -106,136 +106,14 @@ func (r *FunctionJobReconciler) Reconcile(ctx context.Context, req ctrl.Request)
return ctrl.Result{}, fmt.Errorf("get job: %w", err)
}
return r.createRunJob(ctx, fj, deployNS, jobName)
}
// startJobBuild проверяет наличие образа в registry и либо пропускает сборку,
// либо запускает kaniko Job. Идемпотентность по hash s3Key аналогична service/function.
func (r *FunctionJobReconciler) startJobBuild(ctx context.Context, fj *slessv1alpha1.FunctionJob) (ctrl.Result, error) {
logger := log.FromContext(ctx)
// S3Key пустой — код ещё не загружен (provider делает upload после создания CRD).
// Ждём: через 5 секунд provider успеет выполнить UploadJobCode → S3Key заполнится.
if fj.Spec.S3Key == "" {
logger.Info("s3key empty, waiting for code upload", "job", fj.Name)
return ctrl.Result{RequeueAfter: 5 * time.Second}, nil
}
imageRef := r.Builder.ImageRef(r.OperatorNamespace, fj.Name, fj.Spec.S3Key)
// Проверяем: образ с этим тегом уже существует в registry?
if r.Builder.ImageExists(ctx, imageRef) {
logger.Info("image already exists in registry, skipping build", "imageRef", imageRef)
if fj.Annotations == nil {
fj.Annotations = map[string]string{}
}
if err := r.Update(ctx, fj); err != nil {
return ctrl.Result{}, fmt.Errorf("update annotations (cache hit): %w", err)
}
fj.Status.Phase = slessv1alpha1.FunctionJobPhaseBuilding // перейдёт в run сразу
fj.Status.ImageRef = imageRef
fj.Status.Message = "Image restored from registry cache"
if err := r.Status().Update(ctx, fj); err != nil {
return ctrl.Result{}, fmt.Errorf("update status (cache hit): %w", err)
}
return ctrl.Result{Requeue: true}, nil
}
buildJobName, err := r.Builder.Build(ctx, r.OperatorNamespace, fj.Name, fj.Spec.S3Key)
if err != nil {
fj.Status.Phase = slessv1alpha1.FunctionJobPhaseFailed
fj.Status.Message = "failed to start build: " + err.Error()
_ = r.Status().Update(ctx, fj)
return ctrl.Result{}, nil
}
// Аннотация build-job guard против повторного запуска при параллельных reconcile.
// Как только аннотация выставлена, следующий reconcile войдёт в checkJobBuild.
if fj.Annotations == nil {
fj.Annotations = map[string]string{}
}
fj.Annotations["sless.kube5s.ru/build-job"] = buildJobName
if err := r.Update(ctx, fj); err != nil {
return ctrl.Result{}, fmt.Errorf("update build annotation: %w", err)
}
fj.Status.Phase = slessv1alpha1.FunctionJobPhaseBuilding
fj.Status.Message = "building image: " + buildJobName
if err := r.Status().Update(ctx, fj); err != nil {
return ctrl.Result{}, fmt.Errorf("update status to building: %w", err)
}
logger.Info("started kaniko build for functionjob", "build-job", buildJobName, "functionjob", fj.Name)
return ctrl.Result{RequeueAfter: 10 * time.Second}, nil
}
// checkJobBuild опрашивает статус kaniko Job.
// При успехе: сохраняет ImageRef в status, очищает Build Job, requeue → createRunJob.
// При ошибке: переводит FunctionJob в Failed с логами kaniko.
func (r *FunctionJobReconciler) checkJobBuild(ctx context.Context, fj *slessv1alpha1.FunctionJob) (ctrl.Result, error) {
logger := log.FromContext(ctx)
buildJobName := fj.Annotations["sless.kube5s.ru/build-job"]
if buildJobName == "" {
fj.Status.Phase = slessv1alpha1.FunctionJobPhasePending
_ = r.Status().Update(ctx, fj)
return ctrl.Result{Requeue: true}, nil
}
status, err := r.Builder.JobStatus(ctx, buildJobName)
if err != nil {
return ctrl.Result{}, fmt.Errorf("check build job: %w", err)
}
switch status {
case "running":
return ctrl.Result{RequeueAfter: 10 * time.Second}, nil
case "succeeded":
// Builder вычисляет imageRef детерминировано по namespace+name+s3Key
imageRef := r.Builder.ImageRef(r.OperatorNamespace, fj.Name, fj.Spec.S3Key)
fj.Status.ImageRef = imageRef
// Сбрасываем Phase чтобы следующий reconcile пошёл в createRunJob
fj.Status.Phase = slessv1alpha1.FunctionJobPhasePending
fj.Status.Message = ""
if err := r.Status().Update(ctx, fj); err != nil {
return ctrl.Result{}, fmt.Errorf("update imageref in status: %w", err)
}
_ = r.Builder.Cleanup(ctx, buildJobName)
logger.Info("build succeeded, queuing run job", "image", imageRef, "functionjob", fj.Name)
return ctrl.Result{Requeue: true}, nil
case "failed":
// Ищем поды kaniko по лейблу job-name в namespace оператора
logs := getJobPodOutput(ctx, r.KubeClient, r.OperatorNamespace, "job-name="+buildJobName)
msg := "build job failed"
if logs != "" {
msg = "build job failed:\n" + logs
}
fj.Status.Phase = slessv1alpha1.FunctionJobPhaseFailed
fj.Status.Message = msg
_ = r.Status().Update(ctx, fj)
return ctrl.Result{}, nil
}
return ctrl.Result{RequeueAfter: 10 * time.Second}, nil
}
// createRunJob создаёт k8s Job для выполнения функции.
// Использует собранный образ из fj.Status.ImageRef.
func (r *FunctionJobReconciler) createRunJob(ctx context.Context, fj *slessv1alpha1.FunctionJob, deployNS, jobName string) (ctrl.Result, error) {
logger := log.FromContext(ctx)
// Создаём k8s Job
// Используем образ функции напрямую, переопределяем CMD чтобы запустить runner
// вместо server.py/server.js — runner выполняет handle(event) один раз и выходит
eventJSON := fj.Spec.EventJSON
if eventJSON == "" {
eventJSON = "{}"
}
memMB := fj.Spec.MemoryMB
if memMB <= 0 {
memMB = 128
}
// runner запускается через env var SLESS_EVENT — безопаснее чем передавать в args
// (args видны в ps aux, env vars — нет)
ttl := int32(600) // автоудаление Job через 10 мин после завершения
@@ -247,6 +125,7 @@ func (r *FunctionJobReconciler) createRunJob(ctx context.Context, fj *slessv1alp
Labels: map[string]string{
"managed-by": "sless",
"functionjob": fj.Name,
"function": fn.Name,
},
},
Spec: batchv1.JobSpec{
@@ -255,29 +134,28 @@ func (r *FunctionJobReconciler) createRunJob(ctx context.Context, fj *slessv1alp
// Автоудаление через 10 мин после завершения — чтобы не засорять кластер
TTLSecondsAfterFinished: &ttl,
Template: corev1.PodTemplateSpec{
ObjectMeta: metav1.ObjectMeta{
Labels: map[string]string{
"managed-by": "sless",
"functionjob": fj.Name,
},
},
Spec: corev1.PodSpec{
RestartPolicy: corev1.RestartPolicyNever,
// Используем тот же образ что и Deployment функции
// runner.py/runner.js переопределяет CMD сервера
InitContainers: nil,
Containers: []corev1.Container{
{
Name: "runner",
Image: fj.Status.ImageRef,
Command: runtimeRunnerCommand(fj.Spec.Runtime),
Name: "runner",
Image: fn.Status.ImageRef,
// Переопределяем точку входа: запускаем runner вместо server
// runner читает SLESS_EVENT и вызывает handle(event) один раз
Command: runtimeRunnerCommand(fn.Spec.Runtime),
Env: append(
append(fjEnvVars(fj), corev1.EnvVar{
append(fnEnvVars(fn), corev1.EnvVar{
Name: "SLESS_EVENT",
Value: eventJSON,
}),
goJobModeEnv(fj.Spec.Runtime)...,
goJobModeEnv(fn.Spec.Runtime)...,
),
Resources: corev1.ResourceRequirements{
Limits: corev1.ResourceList{
corev1.ResourceMemory: resource.MustParse(fmt.Sprintf("%dMi", memMB)),
corev1.ResourceMemory: resource.MustParse(fmt.Sprintf("%dMi", fn.Spec.MemoryMB)),
},
},
},
@@ -303,7 +181,7 @@ func (r *FunctionJobReconciler) createRunJob(ctx context.Context, fj *slessv1alp
return ctrl.Result{}, fmt.Errorf("update functionjob status: %w", err)
}
logger.Info("created run job for functionjob", "job", jobName, "functionjob", fj.Name)
logger.Info("created job for functionjob", "job", jobName, "functionjob", fj.Name)
return ctrl.Result{}, nil
}
@@ -316,19 +194,12 @@ func (r *FunctionJobReconciler) syncJobStatus(ctx context.Context, fj *slessv1al
fj.Status.Phase = slessv1alpha1.FunctionJobPhaseSucceeded
fj.Status.CompletionTime = &now
// Захватываем stdout пода — это return value функции (runner делает print(json.dumps(result)))
fj.Status.Message = getJobPodOutput(ctx, r.KubeClient, job.Namespace, "functionjob="+fj.Name)
fj.Status.Message = getJobPodOutput(ctx, r.KubeClient, job.Namespace, job.Name)
} else if job.Status.Failed > 0 {
now := metav1.Now()
fj.Status.Phase = slessv1alpha1.FunctionJobPhaseFailed
fj.Status.CompletionTime = &now
// Захватываем логи по нашему лейблу functionjob= (работает во всех версиях k8s).
// Устаревший job-name= удалён в k8s 1.27+, batch.kubernetes.io/job-name= — только с 1.27.
podOutput := strings.TrimSpace(getJobPodOutput(ctx, r.KubeClient, job.Namespace, "functionjob="+fj.Name))
if podOutput == "" || podOutput == "completed successfully" {
fj.Status.Message = "job failed, check pod logs: kubectl logs -n " + job.Namespace + " -l functionjob=" + fj.Name
} else {
fj.Status.Message = "job failed: " + truncateForStatus(podOutput, 2000)
}
fj.Status.Message = "job failed, check pod logs: kubectl logs -n sless-fn-" + fj.Namespace + " -l functionjob=" + fj.Name
} else {
// Job ещё выполняется — перечитаем через 5 секунд
if err := r.Status().Update(ctx, fj); err != nil {
@@ -342,17 +213,6 @@ func (r *FunctionJobReconciler) syncJobStatus(ctx context.Context, fj *slessv1al
return ctrl.Result{}, nil
}
// truncateForStatus ограничивает длину текста для безопасной записи в status.message.
func truncateForStatus(message string, maxLen int) string {
if len(message) <= maxLen {
return message
}
if maxLen <= 3 {
return message[:maxLen]
}
return message[:maxLen-3] + "..."
}
// runtimeRunnerCommand возвращает CMD для запуска одноразового runner вместо HTTP-сервера.
// runner читает env SLESS_EVENT и SLESS_ENTRYPOINT, вызывает handle(event) один раз и завершается.
func runtimeRunnerCommand(runtime string) []string {
@@ -397,13 +257,13 @@ print(json.dumps(result))
}
}
// fjEnvVars формирует k8s EnvVar из полей FunctionJobSpec.
// SLESS_ENTRYPOINT сообщает runner'у какую функцию вызывать.
func fjEnvVars(fj *slessv1alpha1.FunctionJob) []corev1.EnvVar {
// fnEnvVars преобразует env vars из FunctionSpec в k8s EnvVar slice.
// Включает SLESS_ENTRYPOINT чтобы runner.py/runner.js знал какую функцию вызывать.
func fnEnvVars(fn *slessv1alpha1.Function) []corev1.EnvVar {
result := []corev1.EnvVar{
{Name: "SLESS_ENTRYPOINT", Value: fj.Spec.Entrypoint},
{Name: "SLESS_ENTRYPOINT", Value: fn.Spec.Entrypoint},
}
for k, v := range fj.Spec.Env {
for k, v := range fn.Spec.Env {
result = append(result, corev1.EnvVar{Name: k, Value: v})
}
return result
@@ -420,22 +280,16 @@ func goJobModeEnv(runtime string) []corev1.EnvVar {
return nil
}
// getJobPodOutput находит под по labelSelector и возвращает его stdout+stderr (trimmed).
// runner.py/runner.js печатают json.dumps(result) в stdout — return value функции.
// Исключения/трейсбэки Python/Node пишут в stderr — поэтому собираем оба потока.
// getJobPodOutput находит под созданный Job-ом и возвращает его stdout (trimmed).
// runner.py/runner.js печатают json.dumps(result) в stdout — это и есть return value функции.
// Если под не найден или логи недоступны — возвращает "completed successfully" как fallback.
// labelSelector передаётся снаружи — вызывающий код использует "functionjob=<name>" (наш лейбл,
// выставляется на PodTemplate контроллером и не зависит от версии k8s).
// НЕ использовать "job-name=" — этот встроенный лейбл удалён в k8s 1.27+ (у нас 1.34.1).
func getJobPodOutput(ctx context.Context, kube kubernetes.Interface, namespace, labelSelector string) string {
func getJobPodOutput(ctx context.Context, kube kubernetes.Interface, namespace, jobName string) string {
pods, err := kube.CoreV1().Pods(namespace).List(ctx, metav1.ListOptions{
LabelSelector: labelSelector,
LabelSelector: "job-name=" + jobName,
})
if err != nil || len(pods.Items) == 0 {
return "completed successfully"
}
// Stdout: true, Stderr: true — собираем оба потока.
// Python исключения идут в stderr, runner.py пишет результат в stdout.
req := kube.CoreV1().Pods(namespace).GetLogs(pods.Items[0].Name, &corev1.PodLogOptions{})
stream, err := req.Stream(ctx)
if err != nil {
-494
View File
@@ -1,494 +0,0 @@
// Создано: 2026-03-20
// ServiceReconciler — контроллер для Service CRD (sless_service).
// Service = долгоживущий HTTP-сервис с постоянным URL.
// Lifecycle: Pending → Building (kaniko) → Ready (Deployment+k8s Service+Ingress, URL в Status) / Failed
//
// Отличие от Function:
// Function = oneshot, запускается k8s Job через FunctionJob/invoke.
// Service = HTTP-сервис, Deployment всегда запущен, URL доступен без отдельного sless_trigger.
package controllers
import (
"bytes"
"context"
"fmt"
"io"
"sort"
"strings"
"time"
appsv1 "k8s.io/api/apps/v1"
corev1 "k8s.io/api/core/v1"
netv1 "k8s.io/api/networking/v1"
"k8s.io/apimachinery/pkg/api/errors"
"k8s.io/apimachinery/pkg/api/resource"
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
"k8s.io/apimachinery/pkg/runtime"
"k8s.io/client-go/kubernetes"
ctrl "sigs.k8s.io/controller-runtime"
"sigs.k8s.io/controller-runtime/pkg/client"
"sigs.k8s.io/controller-runtime/pkg/log"
slessv1alpha1 "gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless/api/v1alpha1"
"gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless/internal/builder"
"gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless/internal/harbor"
)
// ServiceReconciler reconciles a Service object
type ServiceReconciler struct {
client.Client
Scheme *runtime.Scheme
Builder *builder.Builder
KubeClient kubernetes.Interface // typed client для чтения логов build-подов
RegistrySecret string // имя Secret с docker credentials
OperatorNamespace string // откуда копируем RegistrySecret в sless-fn-*
HarborClient *harbor.Client // nil — EnsureProject пропускается
ExternalURL string // базовый URL для Status.URL: {ExternalURL}/fn/{ns}/{name}
IngressHost string // fallback домен если ExternalURL не задан
}
//+kubebuilder:rbac:groups=sless.kube5s.ru,resources=services,verbs=get;list;watch;create;update;patch;delete
//+kubebuilder:rbac:groups=sless.kube5s.ru,resources=services/status,verbs=get;update;patch
//+kubebuilder:rbac:groups=sless.kube5s.ru,resources=services/finalizers,verbs=update
//+kubebuilder:rbac:groups=apps,resources=deployments,verbs=get;list;watch;create;update;patch;delete
//+kubebuilder:rbac:groups="",resources=services,verbs=get;list;watch;create;update;patch;delete
//+kubebuilder:rbac:groups=networking.k8s.io,resources=ingresses,verbs=get;list;watch;create;update;patch;delete
const serviceFinalizerName = "sless.kube5s.ru/service-finalizer"
// Reconcile — главный цикл управления Service.
// Pending → Building (запуск kaniko) → Ready (Deployment+Service+Ingress созданы, URL в Status)
func (r *ServiceReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error) {
logger := log.FromContext(ctx)
svc := &slessv1alpha1.Service{}
if err := r.Get(ctx, req.NamespacedName, svc); err != nil {
if errors.IsNotFound(err) {
return ctrl.Result{}, nil
}
return ctrl.Result{}, fmt.Errorf("get service: %w", err)
}
if !svc.DeletionTimestamp.IsZero() {
return r.handleServiceDeletion(ctx, svc)
}
if !containsString(svc.Finalizers, serviceFinalizerName) {
svc.Finalizers = append(svc.Finalizers, serviceFinalizerName)
if err := r.Update(ctx, svc); err != nil {
return ctrl.Result{}, fmt.Errorf("add service finalizer: %w", err)
}
return ctrl.Result{Requeue: true}, nil
}
// Идентичная логике FunctionReconciler: если s3Key изменился — пересобираем образ.
builtKey := svc.Annotations["sless.kube5s.ru/last-built-s3key"]
needsBuild := svc.Spec.S3Key != "" && builtKey != svc.Spec.S3Key
if needsBuild && svc.Status.Phase != slessv1alpha1.ServicePhaseBuilding {
logger.Info("starting service build", "service", svc.Name)
return r.startServiceBuild(ctx, svc)
}
switch svc.Status.Phase {
case slessv1alpha1.ServicePhaseBuilding:
return r.checkServiceBuild(ctx, svc)
case slessv1alpha1.ServicePhaseReady:
return r.ensureServiceDeployment(ctx, svc)
}
return ctrl.Result{}, nil
}
// startServiceBuild проверяет наличие образа в registry и либо пропускает сборку,
// либо запускает kaniko Job. Идемпотентность: если код не менялся (тег = hash s3Key),
// образ уже в registry → deploy без пересборки.
func (r *ServiceReconciler) startServiceBuild(ctx context.Context, svc *slessv1alpha1.Service) (ctrl.Result, error) {
imageRef := r.Builder.ImageRef(svc.Namespace, svc.Name, svc.Spec.S3Key)
// Проверяем: образ с этим тегом уже существует в registry?
// Если да — пропускаем kaniko, сразу переходим в Ready с известным imageRef.
if r.Builder.ImageExists(ctx, imageRef) {
logger := log.FromContext(ctx)
logger.Info("image already exists in registry, skipping build", "imageRef", imageRef)
if svc.Annotations == nil {
svc.Annotations = map[string]string{}
}
svc.Annotations["sless.kube5s.ru/last-built-s3key"] = svc.Spec.S3Key
if err := r.Update(ctx, svc); err != nil {
return ctrl.Result{}, fmt.Errorf("update service annotations (cache hit): %w", err)
}
svc.Status.Phase = slessv1alpha1.ServicePhaseReady
svc.Status.ImageRef = imageRef
svc.Status.Message = "Image restored from registry cache"
if err := r.Status().Update(ctx, svc); err != nil {
return ctrl.Result{}, fmt.Errorf("update service status (cache hit): %w", err)
}
return ctrl.Result{}, nil
}
jobName, err := r.Builder.Build(ctx, svc.Namespace, svc.Name, svc.Spec.S3Key)
if err != nil {
return r.setServiceFailed(ctx, svc, fmt.Sprintf("failed to start build: %v", err))
}
if svc.Annotations == nil {
svc.Annotations = map[string]string{}
}
svc.Annotations["sless.kube5s.ru/build-job"] = jobName
svc.Annotations["sless.kube5s.ru/last-built-s3key"] = svc.Spec.S3Key
if err := r.Update(ctx, svc); err != nil {
return ctrl.Result{}, fmt.Errorf("update service build annotations: %w", err)
}
svc.Status.Phase = slessv1alpha1.ServicePhaseBuilding
svc.Status.Message = "Building image: " + jobName
if err := r.Status().Update(ctx, svc); err != nil {
return ctrl.Result{}, fmt.Errorf("update service status to building: %w", err)
}
return ctrl.Result{RequeueAfter: 10 * time.Second}, nil
}
// checkServiceBuild проверяет статус kaniko Job.
func (r *ServiceReconciler) checkServiceBuild(ctx context.Context, svc *slessv1alpha1.Service) (ctrl.Result, error) {
jobName := svc.Annotations["sless.kube5s.ru/build-job"]
if jobName == "" {
svc.Status.Phase = slessv1alpha1.ServicePhasePending
_ = r.Status().Update(ctx, svc)
return ctrl.Result{Requeue: true}, nil
}
status, err := r.Builder.JobStatus(ctx, jobName)
if err != nil {
return ctrl.Result{}, fmt.Errorf("check service build job: %w", err)
}
switch status {
case "running":
return ctrl.Result{RequeueAfter: 10 * time.Second}, nil
case "succeeded":
imageRef := r.Builder.ImageRef(svc.Namespace, svc.Name, svc.Spec.S3Key)
svc.Status.Phase = slessv1alpha1.ServicePhaseReady
svc.Status.ImageRef = imageRef
svc.Status.Message = ""
now := metav1.Now()
svc.Status.LastBuiltAt = &now
if err := r.Status().Update(ctx, svc); err != nil {
return ctrl.Result{}, fmt.Errorf("update service status to ready: %w", err)
}
_ = r.Builder.Cleanup(ctx, jobName)
return ctrl.Result{Requeue: true}, nil
case "failed":
logs := getServiceBuildPodLogs(ctx, r.KubeClient, r.OperatorNamespace, jobName)
msg := "build job failed"
if logs != "" {
msg = "build job failed:\n" + logs
}
return r.setServiceFailed(ctx, svc, msg)
}
return ctrl.Result{RequeueAfter: 10 * time.Second}, nil
}
// ensureServiceDeployment создаёт или обновляет Deployment + k8s Service + Ingress.
// URL записывается в svc.Status.URL — доступен сразу без отдельного sless_trigger.
func (r *ServiceReconciler) ensureServiceDeployment(ctx context.Context, svc *slessv1alpha1.Service) (ctrl.Result, error) {
deployNS := "sless-fn-" + svc.Namespace
// Создаём namespace для функций/сервисов если не существует
ns := &corev1.Namespace{}
if err := r.Get(ctx, client.ObjectKey{Name: deployNS}, ns); err != nil {
if errors.IsNotFound(err) {
ns = &corev1.Namespace{ObjectMeta: metav1.ObjectMeta{Name: deployNS}}
if err := r.Create(ctx, ns); err != nil {
return ctrl.Result{}, fmt.Errorf("create service namespace: %w", err)
}
if r.HarborClient != nil {
if err := r.HarborClient.EnsureProject(ctx, svc.Namespace); err != nil {
log.FromContext(ctx).Error(err, "harbor ensure project", "project", svc.Namespace)
}
}
} else {
return ctrl.Result{}, fmt.Errorf("get service namespace: %w", err)
}
}
// Копируем pull-секрет чтобы kubelet мог скачать образ из приватного registry
if r.RegistrySecret != "" && r.OperatorNamespace != "" {
if err := r.ensureServiceRegistrySecret(ctx, deployNS); err != nil {
log.FromContext(ctx).Error(err, "failed to ensure registry secret", "ns", deployNS)
}
}
// Deployment
desired := r.buildServiceDeployment(svc, deployNS)
existing := &appsv1.Deployment{}
err := r.Get(ctx, client.ObjectKey{Name: svc.Name, Namespace: deployNS}, existing)
if errors.IsNotFound(err) {
if err := r.Create(ctx, desired); err != nil {
return ctrl.Result{}, fmt.Errorf("create service deployment: %w", err)
}
} else if err != nil {
return ctrl.Result{}, fmt.Errorf("get service deployment: %w", err)
} else {
existing.Spec.Template.Spec.Containers[0].Image = svc.Status.ImageRef
existing.Spec.Template.Spec.Containers[0].Env = desired.Spec.Template.Spec.Containers[0].Env
// Обновляем ресурсы — иначе memory_mb из PUT не применяется к Deployment
existing.Spec.Template.Spec.Containers[0].Resources = desired.Spec.Template.Spec.Containers[0].Resources
existing.Spec.Template.Spec.ImagePullSecrets = desired.Spec.Template.Spec.ImagePullSecrets
if err := r.Update(ctx, existing); err != nil {
return ctrl.Result{}, fmt.Errorf("update service deployment: %w", err)
}
}
// k8s Service — направляет трафик к Deployment
wantSvc := &corev1.Service{
ObjectMeta: metav1.ObjectMeta{
Name: svc.Name,
Namespace: deployNS,
Labels: map[string]string{"managed-by": "sless"},
},
Spec: corev1.ServiceSpec{
Selector: map[string]string{"app": svc.Name},
Ports: []corev1.ServicePort{{Port: 8080, Protocol: corev1.ProtocolTCP}},
},
}
existingSvc := &corev1.Service{}
if err := r.Get(ctx, client.ObjectKey{Name: svc.Name, Namespace: deployNS}, existingSvc); err != nil {
if errors.IsNotFound(err) {
if err := r.Create(ctx, wantSvc); err != nil {
return ctrl.Result{}, fmt.Errorf("create k8s service: %w", err)
}
} else {
return ctrl.Result{}, fmt.Errorf("get k8s service: %w", err)
}
}
// URL и Ingress формируются либо через ExternalURL (прокси через API), либо через Ingress
var funcURL string
if r.ExternalURL != "" {
// ExternalURL/fn/{ns}/{name} — работает через sless-api прокси, без wildcard DNS
funcURL = fmt.Sprintf("%s/fn/%s/%s", r.ExternalURL, svc.Namespace, svc.Name)
} else {
// Fallback: Ingress с поддоменом (требует wildcard DNS *.IngressHost)
host := fmt.Sprintf("%s-%s.%s", svc.Name, svc.Namespace, r.IngressHost)
pathType := netv1.PathTypePrefix
wantIng := &netv1.Ingress{
ObjectMeta: metav1.ObjectMeta{
Name: svc.Name,
Namespace: deployNS,
Annotations: map[string]string{
"kubernetes.io/ingress.class": "nginx",
},
},
Spec: netv1.IngressSpec{
Rules: []netv1.IngressRule{{
Host: host,
IngressRuleValue: netv1.IngressRuleValue{
HTTP: &netv1.HTTPIngressRuleValue{
Paths: []netv1.HTTPIngressPath{{
Path: "/",
PathType: &pathType,
Backend: netv1.IngressBackend{
Service: &netv1.IngressServiceBackend{
Name: svc.Name,
Port: netv1.ServiceBackendPort{Number: 8080},
},
},
}},
},
},
}},
},
}
existingIng := &netv1.Ingress{}
if err := r.Get(ctx, client.ObjectKey{Name: svc.Name, Namespace: deployNS}, existingIng); err != nil {
if errors.IsNotFound(err) {
if err := r.Create(ctx, wantIng); err != nil {
return ctrl.Result{}, fmt.Errorf("create service ingress: %w", err)
}
} else {
return ctrl.Result{}, fmt.Errorf("get service ingress: %w", err)
}
}
funcURL = "https://" + host
}
// Записываем URL в Status если изменился
if svc.Status.URL != funcURL {
svc.Status.URL = funcURL
if err := r.Status().Update(ctx, svc); err != nil {
return ctrl.Result{}, fmt.Errorf("update service status url: %w", err)
}
}
// Периодический requeue — self-healing: если Deployment/Service/Ingress удалены вручную, контроллер их пересоздаст
return ctrl.Result{RequeueAfter: 60 * time.Second}, nil
}
// buildServiceDeployment формирует Deployment манифест.
func (r *ServiceReconciler) buildServiceDeployment(svc *slessv1alpha1.Service, namespace string) *appsv1.Deployment {
replicas := int32(1)
var envVars []corev1.EnvVar
// Сортируем ключи для стабильного порядка — нестабильный порядок env vars вызывает лишние rollout'ы
keys := make([]string, 0, len(svc.Spec.Env))
for k := range svc.Spec.Env {
keys = append(keys, k)
}
sort.Strings(keys)
for _, k := range keys {
envVars = append(envVars, corev1.EnvVar{Name: k, Value: svc.Spec.Env[k]})
}
// SLESS_ENTRYPOINT обязан быть передан в pod — runtime server использует его для загрузки функции.
// Если не передать, server.py/nodejs/go server упадёт на fallback handler.handle и не заметит
// неверный entrypoint, что маскирует проблему конфигурации.
if svc.Spec.Entrypoint != "" {
envVars = append(envVars, corev1.EnvVar{Name: "SLESS_ENTRYPOINT", Value: svc.Spec.Entrypoint})
}
return &appsv1.Deployment{
ObjectMeta: metav1.ObjectMeta{
Name: svc.Name,
Namespace: namespace,
Labels: map[string]string{"app": svc.Name, "managed-by": "sless"},
},
Spec: appsv1.DeploymentSpec{
Replicas: &replicas,
Selector: &metav1.LabelSelector{MatchLabels: map[string]string{"app": svc.Name}},
Template: corev1.PodTemplateSpec{
ObjectMeta: metav1.ObjectMeta{Labels: map[string]string{"app": svc.Name}},
Spec: corev1.PodSpec{
Containers: []corev1.Container{{
Name: svc.Name,
Image: svc.Status.ImageRef,
Env: envVars,
Resources: corev1.ResourceRequirements{
Limits: corev1.ResourceList{
corev1.ResourceMemory: resource.MustParse(fmt.Sprintf("%dMi", svc.Spec.MemoryMB)),
},
},
}},
ImagePullSecrets: func() []corev1.LocalObjectReference {
if r.RegistrySecret != "" {
return []corev1.LocalObjectReference{{Name: r.RegistrySecret}}
}
return nil
}(),
},
},
},
}
}
// ensureServiceRegistrySecret копирует pull-секрет в namespace сервисов.
func (r *ServiceReconciler) ensureServiceRegistrySecret(ctx context.Context, targetNS string) error {
existing := &corev1.Secret{}
if err := r.Get(ctx, client.ObjectKey{Name: r.RegistrySecret, Namespace: targetNS}, existing); err == nil {
return nil
} else if !errors.IsNotFound(err) {
return fmt.Errorf("check secret: %w", err)
}
src := &corev1.Secret{}
if err := r.Get(ctx, client.ObjectKey{Name: r.RegistrySecret, Namespace: r.OperatorNamespace}, src); err != nil {
return fmt.Errorf("get source secret from %s: %w", r.OperatorNamespace, err)
}
copy := &corev1.Secret{
ObjectMeta: metav1.ObjectMeta{
Name: r.RegistrySecret,
Namespace: targetNS,
},
Type: src.Type,
Data: src.Data,
}
if err := r.Create(ctx, copy); err != nil {
if !errors.IsAlreadyExists(err) {
return fmt.Errorf("create secret in %s: %w", targetNS, err)
}
}
return nil
}
// handleServiceDeletion удаляет Deployment, k8s Service, Ingress и убирает finalizer.
func (r *ServiceReconciler) handleServiceDeletion(ctx context.Context, svc *slessv1alpha1.Service) (ctrl.Result, error) {
deployNS := "sless-fn-" + svc.Namespace
dep := &appsv1.Deployment{}
if err := r.Get(ctx, client.ObjectKey{Name: svc.Name, Namespace: deployNS}, dep); err == nil {
_ = r.Delete(ctx, dep)
}
// Убиваем kaniko Job если сборка шла в момент удаления
if jobName := svc.Annotations["sless.kube5s.ru/build-job"]; jobName != "" {
_ = r.Builder.Cleanup(ctx, jobName)
}
k8sSvc := &corev1.Service{}
if err := r.Get(ctx, client.ObjectKey{Name: svc.Name, Namespace: deployNS}, k8sSvc); err == nil {
_ = r.Delete(ctx, k8sSvc)
}
ing := &netv1.Ingress{}
if err := r.Get(ctx, client.ObjectKey{Name: svc.Name, Namespace: deployNS}, ing); err == nil {
_ = r.Delete(ctx, ing)
}
svc.Finalizers = removeString(svc.Finalizers, serviceFinalizerName)
if err := r.Update(ctx, svc); err != nil {
return ctrl.Result{}, fmt.Errorf("remove service finalizer: %w", err)
}
return ctrl.Result{}, nil
}
// setServiceFailed переводит сервис в фазу Failed.
func (r *ServiceReconciler) setServiceFailed(ctx context.Context, svc *slessv1alpha1.Service, msg string) (ctrl.Result, error) {
svc.Status.Phase = slessv1alpha1.ServicePhaseFailed
svc.Status.Message = msg
if err := r.Status().Update(ctx, svc); err != nil {
return ctrl.Result{}, fmt.Errorf("update service status to failed: %w", err)
}
return ctrl.Result{}, nil
}
// getServiceBuildPodLogs читает логи kaniko пода (последние 50 строк).
// Идентична getBuildPodLogs из function_controller.go, но вынесена в service_controller
// чтобы не создавать shared-помощника ради двух вызовов.
func getServiceBuildPodLogs(ctx context.Context, kube kubernetes.Interface, namespace, jobName string) string {
if kube == nil {
return ""
}
pods, err := kube.CoreV1().Pods(namespace).List(ctx, metav1.ListOptions{
LabelSelector: "job-name=" + jobName,
})
if err != nil || len(pods.Items) == 0 {
return ""
}
req := kube.CoreV1().Pods(namespace).GetLogs(pods.Items[0].Name, &corev1.PodLogOptions{})
stream, err := req.Stream(ctx)
if err != nil {
return ""
}
defer stream.Close()
buf := new(bytes.Buffer)
_, _ = io.Copy(buf, stream)
raw := strings.TrimSpace(buf.String())
if raw == "" {
return ""
}
lines := strings.Split(raw, "\n")
if len(lines) > 50 {
lines = lines[len(lines)-50:]
}
return strings.Join(lines, "\n")
}
// SetupWithManager sets up the controller with the Manager.
func (r *ServiceReconciler) SetupWithManager(mgr ctrl.Manager) error {
return ctrl.NewControllerManagedBy(mgr).
For(&slessv1alpha1.Service{}).
Complete(r)
}
-44
View File
@@ -124,9 +124,6 @@ func (r *TriggerReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ct
case slessv1alpha1.TriggerTypeCron:
logger.Info("reconcile cron trigger", "trigger", tr.Name)
return r.reconcileCron(ctx, tr, fn)
case slessv1alpha1.TriggerTypeEvent:
logger.Info("reconcile event trigger", "trigger", tr.Name)
return r.reconcileEvent(ctx, tr, fn)
}
return ctrl.Result{}, nil
@@ -328,44 +325,3 @@ func (r *TriggerReconciler) SetupWithManager(mgr ctrl.Manager) error {
For(&slessv1alpha1.Trigger{}).
Complete(r)
}
// reconcileEvent обрабатывает Trigger{type:event}.
// Оператор не управляет AMQP напрямую — это задача event-dispatcher.
// Здесь: убеждаемся что Service функции существует (dispatcher использует его для POST),
// обновляем статус триггера.
func (r *TriggerReconciler) reconcileEvent(ctx context.Context, tr *slessv1alpha1.Trigger, fn *slessv1alpha1.Function) (ctrl.Result, error) {
if tr.Spec.Queue == "" {
tr.Status.Active = false
tr.Status.Message = "queue is required for type=event"
_ = r.Status().Update(ctx, tr)
return ctrl.Result{}, nil
}
deployNS := "sless-fn-" + tr.Namespace
// Service нужен event-dispatcher для доставки сообщений в функцию по HTTP.
// Имя Service совпадает с именем Function — dispatcher строит URL как
// http://{functionRef}.{deployNS}.svc.cluster.local:8080/
wantSvc := &corev1.Service{
ObjectMeta: metav1.ObjectMeta{Name: fn.Name, Namespace: deployNS},
Spec: corev1.ServiceSpec{
Selector: map[string]string{"app": fn.Name},
Ports: []corev1.ServicePort{{Port: 8080, Protocol: corev1.ProtocolTCP}},
},
}
existingSvc := &corev1.Service{}
if err := r.Get(ctx, client.ObjectKey{Name: fn.Name, Namespace: deployNS}, existingSvc); err != nil {
if errors.IsNotFound(err) {
if err := r.Create(ctx, wantSvc); err != nil {
return ctrl.Result{}, fmt.Errorf("create service for event trigger: %w", err)
}
} else {
return ctrl.Result{}, fmt.Errorf("get service: %w", err)
}
}
tr.Status.Active = true
tr.Status.Message = fmt.Sprintf("listening on queue %q via event-dispatcher", tr.Spec.Queue)
_ = r.Status().Update(ctx, tr)
return ctrl.Result{}, nil
}
-77
View File
@@ -1,77 +0,0 @@
# Изменено: 2026-03-19
# event-dispatcher — отдельный сервис для обработки event-триггеров.
# Следит за Trigger CRD{type:event}, подписывается на AMQP очереди,
# при сообщении делает POST на внутренний HTTP endpoint функции.
#
# Требует:
# - SecretRef: sless-operator-secret (RABBITMQ_URL)
# - ClusterRole: event-dispatcher-role (чтение Trigger CRD, Namespace)
---
apiVersion: v1
kind: ServiceAccount
metadata:
name: event-dispatcher
namespace: sless
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
name: event-dispatcher-role
rules:
# Нужно читать Trigger CRD по всем namespace (event-dispatcher глобальный)
- apiGroups: ["sless.kube5s.ru"]
resources: ["triggers"]
verbs: ["get", "list", "watch"]
# Нужно читать namespace для построения URLs функций
- apiGroups: [""]
resources: ["namespaces"]
verbs: ["get", "list", "watch"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
name: event-dispatcher-rolebinding
subjects:
- kind: ServiceAccount
name: event-dispatcher
namespace: sless
roleRef:
kind: ClusterRole
name: event-dispatcher-role
apiGroup: rbac.authorization.k8s.io
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: event-dispatcher
namespace: sless
labels:
app: event-dispatcher
spec:
replicas: 1
selector:
matchLabels:
app: event-dispatcher
template:
metadata:
labels:
app: event-dispatcher
spec:
serviceAccountName: event-dispatcher
containers:
- name: event-dispatcher
image: naeel/sless-event-dispatcher:v0.1.0
imagePullPolicy: Always
env:
- name: RABBITMQ_URL
valueFrom:
secretKeyRef:
name: sless-operator-secret
key: RABBITMQ_URL
resources:
requests:
cpu: 50m
memory: 64Mi
limits:
cpu: 200m
memory: 128Mi
-109
View File
@@ -1,109 +0,0 @@
# 2026-03-18
# funcs-service.yaml — глобальный сервис листинга функций для всех пользователей.
# Развёртывается ОДИН РАЗ в namespace sless рядом с оператором.
# Доступен по: https://sless.kube5s.ru/funcs (с Bearer токеном пользователя)
#
# Обновить образ и применить:
# docker push naeel/sless-funcs-service:v0.1.0
# kubectl apply -f deployments/k8s/funcs-service.yaml
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: sless-funcs-service
namespace: sless
labels:
app: sless-funcs-service
spec:
replicas: 1
selector:
matchLabels:
app: sless-funcs-service
template:
metadata:
labels:
app: sless-funcs-service
spec:
imagePullSecrets:
- name: sless-registry-auth
containers:
- name: funcs
image: pearlharbor.registryk8s.services.ngcloud.ru/naeel/sless-funcs-service:v0.2.2
ports:
- containerPort: 8090
env:
- name: SLESS_OPERATOR_URL
value: "http://sless-operator.sless.svc.cluster.local:9090"
- name: SLESS_EXTERNAL_URL
value: "https://sless.kube5s.ru"
# Системные функции, скрытые из листинга
- name: SLESS_EXCLUDE
value: "event-writer,event-monitor,event-cleaner"
# Токен сервиса задаётся через kubectl set env или Secret — не хранится в репо
# kubectl set env deployment/sless-funcs-service -n sless SLESS_SERVICE_TOKEN="$(cat secrets/test.token)"
- name: PORT
value: "8090"
livenessProbe:
httpGet:
path: /health
port: 8090
initialDelaySeconds: 5
periodSeconds: 30
readinessProbe:
httpGet:
path: /health
port: 8090
initialDelaySeconds: 3
periodSeconds: 10
resources:
requests:
cpu: 10m
memory: 16Mi
limits:
cpu: 100m
memory: 64Mi
---
apiVersion: v1
kind: Service
metadata:
name: sless-funcs-service
namespace: sless
spec:
selector:
app: sless-funcs-service
ports:
- port: 8090
targetPort: 8090
---
# Отдельный Ingress для /funcs — nginx выбирает более специфичный путь перед /
# Без rewrite: сервис сам обрабатывает /funcs path
# TLS-сертификат sless-operator-tls уже управляется cert-manager через ingress оператора;
# здесь только ссылаемся на существующий секрет без аннотации cert-manager.io/cluster-issuer.
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: sless-funcs-ingress
namespace: sless
annotations:
nginx.ingress.kubernetes.io/force-ssl-redirect: "true"
nginx.ingress.kubernetes.io/ssl-redirect: "true"
spec:
ingressClassName: nginx
rules:
- host: sless.kube5s.ru
http:
paths:
- path: /funcs
pathType: Prefix
backend:
service:
name: sless-funcs-service
port:
number: 8090
tls:
- hosts:
- sless.kube5s.ru
secretName: sless-operator-tls
-122
View File
@@ -1,122 +0,0 @@
# Изменено: 2026-03-14
# Node-RED для визуального управления demo сценарием Event Log.
# Образ: nodered/node-red:4 (официальный, всегда есть на DockerHub)
# UI доступен по http://<ingress-ip>/nodered/
# Для AMQP нужен плагин node-red-contrib-amqp — ставится через initContainer.
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: nodered-data
namespace: sless
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 1Gi
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: nodered
namespace: sless
labels:
app: nodered
spec:
replicas: 1
selector:
matchLabels:
app: nodered
template:
metadata:
labels:
app: nodered
spec:
securityContext:
fsGroup: 1000
# initContainer устанавливает AMQP-плагин в PVC до старта основного контейнера
initContainers:
- name: install-nodes
image: nodered/node-red:latest
securityContext:
runAsUser: 0
runAsGroup: 0
command:
- sh
- -c
- |
chown -R 1000:1000 /data || true
cd /data
npm install --prefix /data node-red-contrib-amqp node-red-dashboard 2>&1 || true
volumeMounts:
- name: data
mountPath: /data
containers:
- name: nodered
image: nodered/node-red:latest
ports:
- containerPort: 1880
env:
- name: NODE_RED_ENABLE_PROJECTS
value: "false"
- name: TZ
value: "Europe/Moscow"
securityContext:
runAsUser: 1000
runAsGroup: 1000
volumeMounts:
- name: data
mountPath: /data
resources:
requests:
memory: "256Mi"
cpu: "100m"
limits:
memory: "512Mi"
cpu: "500m"
readinessProbe:
httpGet:
path: /
port: 1880
initialDelaySeconds: 15
periodSeconds: 10
volumes:
- name: data
persistentVolumeClaim:
claimName: nodered-data
---
apiVersion: v1
kind: Service
metadata:
name: nodered
namespace: sless
spec:
selector:
app: nodered
ports:
- port: 1880
targetPort: 1880
---
# Ingress на Node-RED — доступен снаружи по http://nodered.185.247.187.147.nip.io
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: nodered
namespace: sless
annotations:
nginx.ingress.kubernetes.io/proxy-read-timeout: "3600"
nginx.ingress.kubernetes.io/proxy-send-timeout: "3600"
spec:
ingressClassName: nginx
rules:
- host: nodered.185.247.187.147.nip.io
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: nodered
port:
number: 1880
-125
View File
@@ -1,125 +0,0 @@
# Изменено: 2026-03-14
# Деплой sless оператора на demo-стенде (naeel-test-3, nip.io, без TLS).
# Отличия от production operator.yaml:
# - REGISTRY_HOST=naeel (DockerHub, не Harbor)
# - INGRESS_HOST и EXTERNAL_URL — через nip.io без TLS
# - cert-manager аннотации убраны
# - API_TOKEN берётся из sless-operator-secret (совпадает с secrets/test.token)
#
# Перед apply нужно создать секреты:
# kubectl create secret generic sless-operator-secret -n sless \
# --from-literal=POSTGRES_DSN="postgres://sless:sless-pg-password@postgres.sless.svc.cluster.local:5432/sless?sslmode=disable" \
# --from-literal=S3_ACCESS_KEY="0GLQRD38H4I6RBDB0EWJ" \
# --from-literal=S3_SECRET_KEY="eTFibiHmBd96IApj9PYsboTR6OBoD7osxoarHykw" \
# --from-literal=SLESS_API_TOKEN="<token from secrets/test.token>" \
# --from-literal=HARBOR_PASS=""
#
# kubectl create secret docker-registry sless-registry-auth -n sless \
# --docker-server=https://index.docker.io/v1/ \
# --docker-username=naeel \
# --docker-password=<DOCKERHUB_TOKEN>
---
apiVersion: v1
kind: ConfigMap
metadata:
name: sless-operator-config
namespace: sless
data:
S3_ENDPOINT: "s3.msk-1.ngcloud.ru"
S3_BUCKET: "sless-functions"
S3_USE_SSL: "true"
# Harbor как registry для demo
REGISTRY_HOST: "pearlharbor.registryk8s.services.ngcloud.ru"
REGISTRY_SECRET: "sless-registry-auth"
HARBOR_USER: "admin"
API_PORT: "9090"
# nip.io домен без TLS — работает без настройки DNS
INGRESS_HOST: "fn.185.247.187.147.nip.io"
EXTERNAL_URL: "http://sless-api.185.247.187.147.nip.io"
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: sless-operator
namespace: sless
labels:
app: sless-operator
spec:
replicas: 1
selector:
matchLabels:
app: sless-operator
template:
metadata:
labels:
app: sless-operator
spec:
serviceAccountName: sless-operator
containers:
- name: operator
image: naeel/sless-operator:v0.1.29
imagePullPolicy: Always
ports:
- name: api
containerPort: 9090
- name: metrics
containerPort: 8080
- name: health
containerPort: 8081
envFrom:
- configMapRef:
name: sless-operator-config
- secretRef:
name: sless-operator-secret
readinessProbe:
httpGet:
path: /healthz
port: 8081
initialDelaySeconds: 5
periodSeconds: 10
livenessProbe:
httpGet:
path: /healthz
port: 8081
initialDelaySeconds: 15
periodSeconds: 20
resources:
requests:
memory: "64Mi"
cpu: "50m"
limits:
memory: "256Mi"
cpu: "500m"
---
apiVersion: v1
kind: Service
metadata:
name: sless-operator
namespace: sless
spec:
selector:
app: sless-operator
ports:
- name: api
port: 9090
targetPort: 9090
---
# Ingress без TLS — demo стенд через nip.io
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: sless-operator
namespace: sless
spec:
ingressClassName: nginx
rules:
- host: sless-api.185.247.187.147.nip.io
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: sless-operator
port:
number: 9090
+7 -11
View File
@@ -1,11 +1,11 @@
# Изменено: 2026-03-21
# Изменено: 2026-03-11
# Деплой sless оператора в кластер.
# Состав:
# - ConfigMap: не-секретные env vars (S3_ENDPOINT, REGISTRY_HOST и т.д.)
# - Secret: секретные данные (S3 keys, postgres DSN, API token, Harbor pass)
# - Deployment: оператор naeel/sless-operator:v0.1.46 в namespace sless
# - Deployment: оператор naeel/sless-operator:v0.1.23 в namespace sless
# - Service: ClusterIP :9090 (REST API)
# - Ingress: sless.kube5s.ru → :9090 (внешний доступ с TLS)
# - Ingress: sless-api.kube5s.ru → :9090 (внешний доступ с TLS)
#
# Чтобы сменить registry — менять только REGISTRY_HOST в ConfigMap.
# Чтобы сменить Harbor-аккаунт — менять HARBOR_USER в ConfigMap + HARBOR_PASS в Secret.
@@ -32,7 +32,7 @@ data:
INGRESS_HOST: "fn.kube5s.ru"
# EXTERNAL_URL — если задан, URL функции = EXTERNAL_URL/fn/{namespace}/{name}
# Позволяет обойтись без wildcard DNS *.fn.kube5s.ru
EXTERNAL_URL: "https://sless.kube5s.ru"
EXTERNAL_URL: "https://sless-api.kube5s.ru"
---
# Secret создаётся отдельно через kubectl (не коммитить секреты в git!)
# Описание ключей:
@@ -69,12 +69,10 @@ spec:
app: sless-operator
spec:
serviceAccountName: sless-operator
imagePullSecrets:
- name: sless-registry-auth
containers:
- name: operator
# При обновлении версии оператора — менять тег здесь (не latest!)
image: pearlharbor.registryk8s.services.ngcloud.ru/naeel/sless-operator:v0.1.49
image: naeel/sless-operator:v0.1.28
# Always — чтобы всегда тянуть по точному тегу (не кешировать старый)
imagePullPolicy: Always
ports:
@@ -132,12 +130,10 @@ metadata:
cert-manager.io/cluster-issuer: letsencrypt-prod
nginx.ingress.kubernetes.io/force-ssl-redirect: "true"
nginx.ingress.kubernetes.io/ssl-redirect: "true"
nginx.ingress.kubernetes.io/proxy-read-timeout: "900"
nginx.ingress.kubernetes.io/proxy-send-timeout: "900"
spec:
ingressClassName: nginx
rules:
- host: sless.kube5s.ru
- host: sless-api.kube5s.ru
http:
paths:
- path: /
@@ -149,5 +145,5 @@ spec:
number: 9090
tls:
- hosts:
- sless.kube5s.ru
- sless-api.kube5s.ru
secretName: sless-operator-tls
-73
View File
@@ -1,73 +0,0 @@
# Изменено: 2026-03-14
# RabbitMQ для demo сценария Event Log.
# Используется официальный образ с management-плагином для веб-UI.
# credentials: sless / sless123
# AMQP: amqp://sless:sless123@rabbitmq.sless.svc.cluster.local:5672/
# Management UI: http://rabbitmq.sless.svc.cluster.local:15672/
---
apiVersion: v1
kind: Secret
metadata:
name: rabbitmq-secret
namespace: sless
stringData:
RABBITMQ_DEFAULT_USER: "sless"
RABBITMQ_DEFAULT_PASS: "sless123"
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: rabbitmq
namespace: sless
labels:
app: rabbitmq
spec:
replicas: 1
selector:
matchLabels:
app: rabbitmq
template:
metadata:
labels:
app: rabbitmq
spec:
containers:
- name: rabbitmq
image: rabbitmq:3.13-management-alpine
ports:
- name: amqp
containerPort: 5672
- name: management
containerPort: 15672
envFrom:
- secretRef:
name: rabbitmq-secret
resources:
requests:
memory: "256Mi"
cpu: "100m"
limits:
memory: "512Mi"
cpu: "500m"
readinessProbe:
tcpSocket:
port: 5672
initialDelaySeconds: 40
periodSeconds: 10
timeoutSeconds: 10
---
apiVersion: v1
kind: Service
metadata:
name: rabbitmq
namespace: sless
spec:
selector:
app: rabbitmq
ports:
- name: amqp
port: 5672
targetPort: 5672
- name: management
port: 15672
targetPort: 15672
+4 -4
View File
@@ -1,4 +1,4 @@
# Изменено: 2026-03-20 (добавлен Service CRD sless.kube5s.ru — services + status + finalizers)
# Изменено: 2026-03-09 (добавлен доступ к pods/log для feature B)
# RBAC для sless оператора.
# ServiceAccount + ClusterRole + ClusterRoleBinding.
# ClusterRole нужен (не namespaced Role) потому что оператор создаёт
@@ -17,13 +17,13 @@ metadata:
rules:
# Наши CRD
- apiGroups: ["sless.kube5s.ru"]
resources: ["functions", "triggers", "functionjobs", "services"]
resources: ["functions", "triggers", "functionjobs"]
verbs: ["get", "list", "watch", "create", "update", "patch", "delete"]
- apiGroups: ["sless.kube5s.ru"]
resources: ["functions/status", "triggers/status", "functionjobs/status", "services/status"]
resources: ["functions/status", "triggers/status", "functionjobs/status"]
verbs: ["get", "update", "patch"]
- apiGroups: ["sless.kube5s.ru"]
resources: ["functions/finalizers", "triggers/finalizers", "functionjobs/finalizers", "services/finalizers"]
resources: ["functions/finalizers", "triggers/finalizers", "functionjobs/finalizers"]
verbs: ["update"]
# Deployments для функций
- apiGroups: ["apps"]
+8 -92
View File
@@ -1,7 +1,5 @@
# API Design
Последнее обновление: 2026-03-21
## Базовый URL
```
@@ -9,50 +7,15 @@ http://<operator-host>:9090/v1
```
Локально: `http://localhost:9090/v1`
В кластере: `http://sless-operator.sless.svc.cluster.local:9090/v1`
Публично: `https://sless.kube5s.ru/v1/...` (через Ingress)
В кластере (будущее): `http://sless-operator.sless.svc.cluster.local:9090/v1`
**Реализованные эндпоинты:**
**Реализовано** (текущий namespace-aware формат):
```
GET /v1/namespaces/{ns}/functions
POST /v1/namespaces/{ns}/functions
GET /v1/namespaces/{ns}/functions/{name}
PUT /v1/namespaces/{ns}/functions/{name}
DELETE /v1/namespaces/{ns}/functions/{name}
POST /v1/namespaces/{ns}/functions/{name}/upload
GET /v1/namespaces/{ns}/functions/{name}/source ← файлы кода из S3 tar.gz (JSON)
GET /v1/namespaces/{ns}/functions/{name}/invocations
GET /v1/namespaces/{ns}/services
POST /v1/namespaces/{ns}/services
GET /v1/namespaces/{ns}/services/{name}
PUT /v1/namespaces/{ns}/services/{name}
DELETE /v1/namespaces/{ns}/services/{name}
GET /v1/namespaces/{ns}/services/{name}/source ← файлы кода из S3 tar.gz (JSON)
GET /v1/namespaces/{ns}/triggers
POST /v1/namespaces/{ns}/triggers
GET /v1/namespaces/{ns}/triggers/{name}
PATCH /v1/namespaces/{ns}/triggers/{name} ← {"enabled": bool}
DELETE /v1/namespaces/{ns}/triggers/{name}
POST /v1/namespaces/{ns}/jobs
GET /v1/namespaces/{ns}/jobs/{name}
DELETE /v1/namespaces/{ns}/jobs/{name}
```
**Вызов функций (публичный, без auth):**
```
POST https://sless.kube5s.ru/fn/{namespace}/{service-name} ← прокси к Deployment
```
**Глобальный сервис funcs (не оператор):**
```
GET https://sless.kube5s.ru/funcs/<namespace> ← plain text (курл) / HTML (браузер)
GET https://sless.kube5s.ru/funcs?token=<jwt> ← редирект по namespace
GET https://sless.kube5s.ru/funcs/<namespace>/source/<fn> ← прокси к GET /source
PATCH https://sless.kube5s.ru/funcs/<namespace>/triggers/<name> ← прокси к PATCH /triggers
GET https://sless.kube5s.ru/health ← liveness probe
/v1/namespaces/{namespace}/functions[/{name}]
/v1/namespaces/{namespace}/functions/{name}/upload
/v1/namespaces/{namespace}/triggers[/{name}]
/v1/namespaces/{namespace}/functions/{name}/invocations
```
## Аутентификация
@@ -61,11 +24,6 @@ GET https://sless.kube5s.ru/health ← liveness
Authorization: Bearer <cloud-token>
```
Токен — JWT от `auth-api`. Middleware в операторе:
1. Извлекает `sub` из payload (без проверки подписи — доверяет Ingress)
2. Вычисляет namespace: `SHA256(sub)[:8]` hex → `sless-{16 hex символов}`
3. Проверяет что запрошенный `{namespace}` совпадает с вычисленным
## Ресурсы
### Functions
@@ -129,8 +87,8 @@ field: code = <zip-file>
## Поддерживаемые runtime (v1)
- `python3.11` — реализован и протестирован
- `nodejs20` — реализован и протестирован
- `go1.23` — реализован
- `go1.21` — планируется
- `nodejs20` — планируется
## Модель Function
@@ -170,45 +128,3 @@ field: code = <zip-file>
"created_at": "..."
}
```
## Модель Service (sless_service — always-on Deployment)
`sless_service` — долгоживущая функция. Деплоится как Kubernetes Deployment + Service + Ingress.
Вызывается через `POST /fn/{namespace}/{name}` без авторизации (прокси напрямую к поду).
```json
{
"name": "pg-info",
"display_name": "PostgreSQL Info",
"description": "Возвращает список таблиц",
"runtime": "python3.11",
"entrypoint": "handler.handle",
"memory_mb": 128,
"timeout_sec": null,
"env_vars": {"DB_HOST": "..."},
"status": "Ready",
"image_ref": "pearlharbor.../naeel/pg-info:abc123",
"invoke_url": "https://sless.kube5s.ru/fn/sless-ffd1f598c169b0ae/pg-info"
}
```
### Поле `timeout_sec`
| Значение | Поведение |
|----------|-----------|
| `null` / не задано | Без ограничений — функция выполняется любое время |
| `1900` | Таймаут в секундах (+ 5s grace на стороне прокси) |
| `< 0` или `> 900` | HTTP 400 Bad Request |
> **Примечание:** Поле опциональное (Optional в Terraform). Не указывать = без лимита.
> В Terraform state значение `null` означает "лимит не задан" (не путать с `0`).
> В Kubernetes CRD `TimeoutSec: 0` → лимита нет (поле omitempty).
### Invoke прокси (как работает timeout_sec)
Оператор принимает `POST /fn/{ns}/{name}`, находит Service CRD, проксирует запрос
к `http://{name}.sless-fn-{ns}.svc.cluster.local:8080`.
Если `TimeoutSec > 0` — создаёт `http.Client{Timeout: TimeoutSec*s + 5s}`.
Если `TimeoutSec == 0``http.Client{}` (Go: Timeout=0 → отсутствие дедлайна).
@@ -1,368 +0,0 @@
# Agent Handoff — 2026-03-18 (финальное состояние сессии)
Этот файл — полный срез для нового агента: что сделано, как устроено, как работать.
---
## 1. Идентификация проекта
- **Репозиторий:** `gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless`
- **Локальная копия:** `/home/naeel/remote_dev/sless/`
- **Remote server:** `naeel@5.172.178.213` (workspace: `~/terra/sless/`)
- **SSH ключ:** `/home/naeel/.ssh/naeel_vm_id_ed25519`
- **SSH команда:** `ssh -i <ключ> -o StrictHostKeyChecking=no naeel@5.172.178.213`
- **Активная ветка:** `feat/web-console` (последний коммит `a04dfb2`)
- **Git origin:** `https://gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless.git`
### Важно про git
Git **не работает локально** (зависает при записи объектов из-за NFS-подобного поведения volume).
Все `git add / commit / push`**только через SSH на remote machine**.
`scp` для копирования файлов → `ssh` для git-операций.
---
## 2. Что такое проект
Managed Serverless Functions Service для облачного провайдера **nubes.ru**.
Пользователь пишет `main.tf` с ресурсами `sless_function`, `sless_trigger`, `sless_job`.
Terraform провайдер собирает zip → загружает в оператор → оператор запускает kaniko → Docker образ → Deployment в k8s.
**Внешнее API оператора:** `https://sless.kube5s.ru`
**Ingress IP:** `185.247.187.147`
**Namespace оператора в k8s:** `sless`
---
## 3. Стек и компоненты
| Компонент | Технология | Namespace / где |
|-----------|-----------|-----------------|
| Operator (API + Controllers) | Go (controller-runtime) | k8s namespace `sless` |
| funcs-service (web-консоль) | Go (net/http) | k8s namespace `sless` |
| PostgreSQL | PostgreSQL 16 | k8s namespace `sless` |
| S3 | Ceph (облачный) | `s3.msk-1.ngcloud.ru` |
| Container Registry | DockerHub (`naeel/`) | внешний |
| Builder | kaniko Job | namespace пользователя |
| Function (HTTP trigger) | k8s Deployment + Service | namespace пользователя |
| Function (one-shot) | k8s Job | namespace пользователя |
| Function (cron) | k8s CronJob | namespace пользователя |
| Terraform Provider | Go (plugin-framework v6) | localhost/CI |
---
## 4. Текущие версии образов
| Образ | Версия | Что внутри |
|-------|--------|-----------|
| `naeel/sless-operator` | **v0.1.34** | REST API + k8s controllers; GET /source; proxy-готовый PATCH /triggers |
| `naeel/sless-funcs-service` | **v0.2.0** | HTML web-консоль + plain text (backward compat) |
| `naeel/sless-runtime-python3.11` | **v0.1.3** | str return → text/plain |
| `naeel/sless-runtime-nodejs20` | **v0.1.2** | без изменений |
| `naeel/sless-runtime-go1.23` | **v0.1.0** | без изменений |
---
## 5. Структура директорий (актуальная)
```
sless/
├── main.go # точка входа оператора (controller-runtime + HTTP сервер)
├── Dockerfile # сборка оператора
├── go.mod # module: gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless
├── api/v1alpha1/ # CRD типы: Function, FunctionJob, Trigger
│ ├── function_types.go
│ ├── job_types.go
│ └── trigger_types.go
├── controllers/ # k8s reconcilers
│ ├── function_controller.go # Function CRD → kaniko → Deployment/Service
│ ├── functionjob_controller.go # FunctionJob CRD → k8s Job → собирает stdout/stderr
│ └── trigger_controller.go # Trigger CRD → Deployment scale / CronJob
├── internal/
│ ├── api/
│ │ ├── router.go # gorilla/mux: все REST маршруты (актуальный)
│ │ ├── middleware/ # Auth (JWT→namespace), Logging
│ │ └── handler/
│ │ ├── handler.go # Handler struct (K8s, S3, PG, Log)
│ │ ├── functions.go # CRUD Functions
│ │ ├── triggers.go # CRUD Triggers + UpdateTrigger (PATCH enabled)
│ │ ├── upload.go # POST /upload — zip → tar.gz → S3 → Function CRD patch
│ │ ├── source.go # GET /source — tar.gz из S3 → JSON файлы (НОВЫЙ)
│ │ ├── jobs.go # CRUD FunctionJobs
│ │ ├── invocations.go # logs из Postgres
│ │ ├── invoke.go # прокси вызова HTTP функций
│ │ └── namespace.go # EnsureNamespace
│ ├── builder/
│ │ └── context.go # zip + runtime → tar.gz + Dockerfile для kaniko
│ ├── storage/
│ │ ├── s3/client.go # minio-go: Upload, UploadContext, Download, Delete
│ │ └── postgres/ # хранение invocation logs
│ └── config/ # env vars конфиг
├── services/
│ └── funcs/
│ ├── main.go # web-консоль сервис (v0.2.0)
│ ├── index.html # HTML шаблон (embed)
│ ├── Dockerfile # multi-stage Go → alpine
│ └── funcs-service.yaml # (дубль, не деплоится отсюда)
├── deployments/k8s/
│ ├── operator.yaml # ConfigMap + Secret + Deployment + Service + Ingress оператора
│ ├── funcs-service.yaml # Deployment + Service + Ingress funcs-service
│ ├── postgres.yaml # PostgreSQL
│ └── rbac.yaml # ClusterRole для оператора
├── terraform/provider/ # terraform-provider-sless
│ ├── main.go
│ └── internal/
│ ├── client/client.go # HTTP клиент к оператору
│ └── resources/
│ ├── function_resource.go # sless_function: source_dir→zip, code_hash, ModifyPlan
│ ├── trigger_resource.go # sless_trigger
│ └── job_resource.go # sless_job + ErrJobAlreadyExists handling
├── runtimes/
│ ├── python3.11/server.py # HTTP wrapper (str → text/plain)
│ ├── nodejs20/ # HTTP wrapper
│ └── go1.23/ # multi-stage builder образ
├── examples/
│ ├── POSTGRES/ # pg функции: create-table, pg-info, pg-table-reader
│ ├── hello-go/
│ ├── hello-node/
│ └── ...
├── migrations/001_initial.sql # PostgreSQL схема
└── doc/ # ← ты здесь
├── architecture/
│ └── agent-handoff-2026-03-18.md ← ЭТОТ ФАЙЛ
├── api/design.md
├── decisions/log.md
├── errors/log.md
└── progress.md
```
---
## 6. REST API оператора — полный список маршрутов
Все `/v1/` защищены JWT (middleware.Auth проверяет Bearer токен + namespace).
`/fn/` — публичный прокси для HTTP-триггеров (без auth).
```
POST /v1/namespaces/{ns}/ensure # создать namespace (идемпотентно)
GET /v1/namespaces/{ns}/functions # список функций
POST /v1/namespaces/{ns}/functions # создать функцию
GET /v1/namespaces/{ns}/functions/{name} # получить функцию
PUT /v1/namespaces/{ns}/functions/{name} # обновить функцию
DELETE /v1/namespaces/{ns}/functions/{name} # удалить функцию
POST /v1/namespaces/{ns}/functions/{name}/upload # загрузить zip → S3 → kaniko
GET /v1/namespaces/{ns}/functions/{name}/source # НОВЫЙ: файлы кода из S3 (JSON)
GET /v1/namespaces/{ns}/functions/{name}/invocations # логи вызовов
GET /v1/namespaces/{ns}/triggers # список триггеров
POST /v1/namespaces/{ns}/triggers # создать триггер
GET /v1/namespaces/{ns}/triggers/{name} # получить триггер
PATCH /v1/namespaces/{ns}/triggers/{name} # enable/disable: {"enabled": bool}
DELETE /v1/namespaces/{ns}/triggers/{name} # удалить триггер
POST /v1/namespaces/{ns}/jobs # создать FunctionJob
GET /v1/namespaces/{ns}/jobs/{name} # получить FunctionJob
DELETE /v1/namespaces/{ns}/jobs/{name} # удалить FunctionJob
GET/POST/... /fn/{namespace}/{name}[/...] # вызов HTTP функции (без auth)
```
---
## 7. funcs-service — маршруты
Сервис `sless-funcs-service`, namespace `sless`, порт 8090.
Ingress: `sless.kube5s.ru/funcs``sless-funcs-service:8090`.
```
GET /health # liveness/readiness probe (без auth)
GET /funcs # usage hint (нет токена → 401 с подсказкой)
GET /funcs?token=<jwt> # листинг через JWT
GET /funcs/<namespace> # листинг по namespace (браузер→HTML, curl→plain text)
GET /funcs/<namespace>/source/<fn> # прокси → оператор GET /source (serviceToken)
PATCH /funcs/<namespace>/triggers/<name> # прокси → оператор PATCH /triggers (serviceToken)
```
Логика переключения HTML/plain text: `strings.Contains(Accept header, "text/html")`.
Браузер всегда шлёт `text/html` в Accept → HTML консоль.
`curl` без `-H "Accept: text/html"` → plain text (совместимость с v0.1.x).
**Env vars funcs-service:**
```
SLESS_OPERATOR_URL = http://sless-operator.sless.svc.cluster.local:9090
SLESS_EXTERNAL_URL = https://sless.kube5s.ru
SLESS_EXCLUDE = (список функций скрытых из листинга, через запятую)
SLESS_SERVICE_TOKEN = <JWT> (задаётся через kubectl set env, НЕ в git)
PORT = 8090
```
---
## 8. Namespace пользователя
```
JWT.sub (UUID) → SHA256(sub)[:8] → hex → "sless-" + 16 hex символов
```
Пример: sub `019cc268-6c6a-781e-8613-4bed4ec7cd20` → namespace `sless-ffd1f598c169b0ae`
Эта логика **одинакова** в трёх местах:
- `internal/api/middleware/auth.go` (оператор)
- `services/funcs/main.go` (funcs-service)
- `terraform/provider/internal/client/client.go` (провайдер)
---
## 9. S3 хранение кода — ключи
При `POST /upload` создаются **два объекта:**
```
functions/{ns}/{name}/{timestamp}.zip ← исходный код (zip от пользователя)
contexts/{ns}/{name}/{timestamp}.tar.gz ← build context для kaniko (zip + Dockerfile)
```
`Function.Spec.S3Key` хранит путь к `contexts/...`.
`GET /source` читает `Function.Spec.S3Key`, скачивает tar.gz, извлекает файлы без Dockerfile.
**Важно:** zip исходника (`functions/...`) отдельно не хранится в CRD.
Код источника берётся из tar.gz контекста — там те же файлы пользователя.
---
## 10. Terraform провайдер — sless_function
```hcl
resource "sless_function" "my_func" {
name = "my-func"
runtime = "python3.11" # python3.11 | nodejs20 | go1.23
entrypoint = "handler.handle"
source_dir = "${path.module}/code/my-func" # директория → провайдер делает zip сам
# ИЛИ:
# code_path = "./handler.zip" # готовый zip
# code_hash = filesha256("./handler.zip") # для детекции изменений
memory_mb = 128
timeout_sec = 30
env_vars = { KEY = "value" }
build_timeout_sec = 300 # ожидание kaniko (дефолт 300 сек)
}
```
При изменении файлов в `source_dir`:
- `terraform plan` → пересчитывает `code_hash` (ModifyPlan), показывает diff
- `terraform apply` → загружает новый zip, ждёт сборки → `phase = Ready`
- Новый код виден в браузере сразу после apply
---
## 11. Где что запущено (kubectl)
```bash
# Проверить поды оператора
kubectl get pods -n sless
# Проверить версию образа оператора
kubectl get deployment sless-operator -n sless -o jsonpath='{.spec.template.spec.containers[0].image}'
# Посмотреть логи оператора
kubectl logs -n sless -l app=sless-operator --tail=50
# Посмотреть логи funcs-service
kubectl logs -n sless -l app=sless-funcs-service --tail=50
# Обновить образ оператора
kubectl set image deployment/sless-operator operator=naeel/sless-operator:vX.X.X -n sless
kubectl rollout status deployment/sless-operator -n sless --timeout=90s
# Обновить образ funcs-service
kubectl set image deployment/sless-funcs-service funcs=naeel/sless-funcs-service:vX.X.X -n sless
# Посмотреть функции пользователя
kubectl get functions -n sless-ffd1f598c169b0ae
# Посмотреть триггеры
kubectl get triggers -n sless-ffd1f598c169b0ae
# Обновить SLESS_SERVICE_TOKEN (не хранится в git!)
kubectl set env deployment/sless-funcs-service -n sless SLESS_SERVICE_TOKEN=<jwt>
```
---
## 12. Тестовые данные
- **Тестовый токен:** `/home/naeel/remote_dev/sless/secrets/test.token`
- **Namespace тест-пользователя:** `sless-ffd1f598c169b0ae`
- **Рабочие функции:**
- `pg-info` (nodejs20) — читает версию PostgreSQL и счётчик строк
- `pg-table-reader` (python3.11) — читает строки из таблицы
- `pg-create-table-runner` (python3.11) — job: создаёт таблицу
- **Быстрый тест:**
```bash
# plain text список (curl)
curl https://sless.kube5s.ru/funcs/sless-ffd1f598c169b0ae
# HTML консоль (браузер или curl с Accept)
curl -H "Accept: text/html" https://sless.kube5s.ru/funcs/sless-ffd1f598c169b0ae
# исходный код функции
curl https://sless.kube5s.ru/funcs/sless-ffd1f598c169b0ae/source/pg-info
# вызов функции
curl https://sless.kube5s.ru/fn/sless-ffd1f598c169b0ae/pg-info
```
---
## 13. Деплой нового образа — стандартный workflow
```bash
SSH="ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no naeel@5.172.178.213"
SCP="scp -i /home/naeel/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no"
# 1. Скопировать изменённые файлы оператора на remote
$SCP /home/naeel/remote_dev/sless/path/to/file.go naeel@5.172.178.213:~/terra/sless/path/to/file.go
# 2. Собрать образ на remote
$SSH "cd ~/terra/sless && docker build -t naeel/sless-operator:vX.X.X . 2>&1 | tail -5"
# 3. Запушить
$SSH "docker push naeel/sless-operator:vX.X.X 2>&1 | tail -3"
# 4. Задеплоить
$SSH "kubectl set image deployment/sless-operator operator=naeel/sless-operator:vX.X.X -n sless && kubectl rollout status deployment/sless-operator -n sless --timeout=90s"
# 5. Коммит (через SSH! не локально)
$SSH "cd ~/terra/sless && git add <файлы> && git commit -m 'msg' && git push origin feat/web-console"
```
Для funcs-service: путь `~/terra/sless/services/funcs/`, контейнер называется `funcs`.
---
## 14. Известные проблемы / особенности
| Проблема | Решение |
|---------|---------|
| `git` зависает локально | Только через SSH на remote machine |
| `SLESS_SERVICE_TOKEN` не в git | Задан через `kubectl set env`, при пересоздании пода — пропадёт! Нужно переставить вручную |
| `job-name=` label удалён в k8s 1.27+ | Используем свой label `functionjob=<name>` на PodTemplate (исправлено в v0.1.34) |
| S3 endpoint с SSL | `useSSL=false` для внутреннего s3, `useSSL=true` для облачного `s3.msk-1.ngcloud.ru` |
| `python3.11`: str return → text/plain | Начиная с `naeel/sless-runtime-python3.11:v0.1.3` |
---
## 15. Следующие возможные задачи (не начаты)
| Задача | Сложность | Заметки |
|--------|-----------|---------|
| Слияние `feat/web-console` в `main` (или базовую ветку) | низкая | Ветка стабильная, все тесты проходят |
| Кнопка "Обновить код" в HTML консоли (upload из браузера) | средняя | Drag&drop zip или указать source_dir |
| Обратная синхронизация (скачать код из S3 в source_dir) | средняя | terraform data source или отдельная команда |
| History/versioning (несколько версий кода) | высокая | S3 уже хранит по timestamp — нужен UI |
| SLESS_SERVICE_TOKEN из k8s Secret | низкая | Сейчас задаётся через kubectl set env — надо в YAML (sealed secret) |
| Логи функции в HTML консоли | средняя | GET /invocations уже есть в операторе |
| Публикация terraform провайдера | средняя | Terraform Registry или Gitea Releases |
+1 -40
View File
@@ -1,6 +1,6 @@
# Архитектура системы
Последнее обновление: 2026-03-18 (v0.1.34 + funcs-service v0.2.0)
Последнее обновление: 2026-03-11 (v0.1.22)
## Общее описание
@@ -13,7 +13,6 @@ Managed Serverless Functions Service для облачного провайде
| Компонент | Технология | Где запущен |
|-----------|-----------|-------------|
| Operator (API + Controllers) | Go (controller-runtime) | Kubernetes, namespace `sless` |
| funcs-service (глобальная консоль) | Go (net/http) | Kubernetes, namespace `sless` |
| PostgreSQL | PostgreSQL 16 | Kubernetes, namespace `sless` |
| S3 | Ceph (облачный) | `s3.msk-1.ngcloud.ru` |
| Container Registry | DockerHub (`naeel/`) | внешний |
@@ -26,44 +25,6 @@ Managed Serverless Functions Service для облачного провайде
> Redis и RabbitMQ — отложены до v2.
## Компонент: funcs-service
Глобальный HTTP сервис — **одна копия** на весь кластер, для всех пользователей.
```
User Browser / curl
└─► https://sless.kube5s.ru/funcs/<namespace>
└─► nginx Ingress (sless-funcs-ingress)
└─► sless-funcs-service:8090 (namespace sless)
└─► http://sless-operator.sless.svc.cluster.local:9090/v1/...
```
**Файлы:**
- `services/funcs/main.go` — логика
- `services/funcs/Dockerfile` — multi-stage Go → alpine
- `deployments/k8s/funcs-service.yaml` — Deployment + Service + Ingress
**Env vars сервиса:**
| Переменная | Значение |
|-----------|---------|
| `SLESS_OPERATOR_URL` | `http://sless-operator.sless.svc.cluster.local:9090` |
| `SLESS_EXTERNAL_URL` | `https://sless.kube5s.ru` |
| `SLESS_EXCLUDE` | `event-writer,event-monitor,event-cleaner` |
| `SLESS_SERVICE_TOKEN` | JWT токен (задаётся через `kubectl set env`, не в git) |
## Хранение кода функций в S3
```
Terraform source_dir (локально)
└─► zip → POST /upload → builder.PrepareContext()
├─► functions/{ns}/{name}/{ts}.zip ← ИСХОДНЫЙ КОД пользователя
└─► contexts/{ns}/{name}/{ts}.tar.gz ← BUILD CONTEXT для kaniko
└─► Function CRD: spec.s3Key = "contexts/..."
└─► контроллер → kaniko Job → Docker image
```
Для web-консоли: `GET /source` читает `contexts/{ns}/{name}/{ts}.tar.gz` (из `Function.Spec.S3Key`), распаковывает tar.gz, фильтрует Dockerfile, возвращает пользовательские файлы.
## Изоляция пользователей — Namespace per user
Каждый пользователь облака получает **отдельный k8s namespace**.
+33 -90
View File
@@ -1,106 +1,49 @@
# Структура проекта
Последнее обновление: 2026-03-18 (v0.1.34)
## Репозиторий
`gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless`
## Директории (актуальное состояние)
## Директории
```
sless/
├── main.go # точка входа оператора (controller-runtime + HTTP сервер)
├── Dockerfile # multi-stage сборка оператора
├── go.mod # module: gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless
├── Makefile
├── api/
│ └── v1alpha1/ # CRD типы для controller-gen
│ ├── function_types.go # Function CRD: spec, status
│ ├── job_types.go # FunctionJob CRD
│ ├── trigger_types.go # Trigger CRD
│ └── zz_generated.deepcopy.go # автогенерация DeepCopy
├── controllers/
│ ├── function_controller.go # Function → kaniko Job → Deployment/Service
│ ├── functionjob_controller.go # FunctionJob → k8s Job → stdout/stderr → status
│ └── trigger_controller.go # Trigger → Deployment scale / CronJob
├── cmd/
│ └── api/
│ └── main.go # точка входа API сервера
├── internal/
│ ├── api/
│ │ ├── router.go # gorilla/mux: регистрация всех маршрутов
│ │ ├── middleware/
│ │ │ ├── auth.go # JWT Bearer → namespace (SHA256)
└── logging.go # access log
│ │ └── handler/
│ │ ├── handler.go # Handler struct (K8s, S3, PG, Log)
│ │ ├── functions.go # GET/POST/PUT/DELETE функций
│ │ ├── triggers.go # GET/POST/PATCH/DELETE триггеров
│ │ ├── upload.go # POST /upload: zip → tar.gz → S3 → CRD patch
│ │ ├── source.go # GET /source: S3 tar.gz → JSON файлы (НОВЫЙ v0.1.34)
│ │ ├── jobs.go # GET/POST/DELETE FunctionJob
│ │ ├── invocations.go # GET /invocations: логи из Postgres
│ │ ├── invoke.go # прокси HTTP вызовов функций
│ │ └── namespace.go # POST /ensure: создать k8s namespace
│ ├── builder/
│ │ └── context.go # zip + runtime → tar.gz + Dockerfile для kaniko
│ │ ├── handler/ # HTTP хендлеры (functions, versions, triggers)
│ │ ├── middleware/ # auth, logging, rate limit
│ │ └── router.go # регистрация маршрутов
├── model/ # доменные модели: Function, Version, Trigger, Invocation
│ ├── storage/
│ │ ├── s3/client.go # minio-go: Upload, UploadContext, Download, Delete
│ │ └── postgres/ # хранение invocation logs
── config/ # конфиг из env переменных
├── services/
│ └── funcs/ # отдельный HTTP сервис (web-консоль)
│ ├── main.go # v0.2.0: HTML+plain text+proxy к оператору
│ ├── index.html # dark-themed HTML консоль (go:embed)
├── Dockerfile # multi-stage Go → alpine (копирует main.go + index.html)
│ └── go.mod # отдельный Go модуль
├── migrations/
│ └── 001_initial.sql # схема PostgreSQL (invocation logs)
── deployments/k8s/
│ ├── operator.yaml # ConfigMap + Deployment + Service + Ingress оператора
│ ├── funcs-service.yaml # Deployment + Service + Ingress funcs-service
│ ├── postgres.yaml # PostgreSQL
│ └── rbac.yaml # ClusterRole + ClusterRoleBinding для оператора
├── runtimes/
│ ├── python3.11/server.py # HTTP wrapper (str → text/plain начиная с v0.1.3)
│ ├── nodejs20/server.js # HTTP wrapper
│ └── go1.23/ # multi-stage builder образ
├── terraform/
│ └── provider/ # terraform-provider-sless (отдельный Go модуль)
│ ├── main.go
│ └── internal/
│ ├── client/client.go # REST клиент к оператору
│ ├── resources/
│ │ ├── function_resource.go # sless_function: source_dir, code_hash, ModifyPlan
│ │ ├── trigger_resource.go # sless_trigger
│ │ └── job_resource.go # sless_job + ErrJobAlreadyExists
│ └── provider/provider.go
├── examples/
│ ├── POSTGRES/ # pg функции: create-table, pg-info, pg-table-reader
│ ├── hello-go/
│ ├── hello-node/
│ └── simple-python/
├── config/ # kustomize конфиги (controller-gen артефакты)
│ ├── crd/ # CRD манифесты (автогенерация)
│ ├── rbac/
│ └── samples/
├── hack/
│ └── boilerplate.go.txt # шаблон заголовков файлов
└── doc/ # документация проекта
├── architecture/
│ ├── agent-handoff-2026-03-18.md # полный контекст для нового агента
│ ├── overview.md # архитектура системы
│ └── project-structure.md # этот файл
├── api/design.md # дизайн REST API
├── decisions/log.md # журнал архитектурных решений
├── errors/log.md # известные ошибки и решения
└── progress.md # трекер задач
│ │ ├── postgres/ # CRUD функций, версий, логов вызовов
│ │ └── s3/ # загрузка/скачивание zip архивов кода
── builder/ # сборка Docker образа из кода пользователя
│ ├── runner/ # запуск функций в k8s (Jobs / Deployments)
│ └── config/ # конфиг из env переменных
├── migrations/ # SQL миграции (numbered: 001_, 002_, ...)
├── deployments/
└── k8s/ # манифесты: Deployment, Service, Ingress, RBAC
├── api/
│ └── openapi.yaml # OpenAPI 3.0 спецификация
├── doc/ # документация проекта (эта папка)
── docker-compose.yml # локальная разработка: postgres, redis, minio
```
## Go модули
## Go module
Два независимых Go модуля в одном репозитории:
```
module gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless
```
| Модуль | Путь | Назначение |
|--------|------|-----------|
| `gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless` | `/` | Оператор + API |
| `gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless/services/funcs` | `services/funcs/` | Web-консоль сервис |
| `terra.k8c.ru/naeel/sless` | `terraform/provider/` | Terraform провайдер |
## Порядок разработки
1. `internal/config` + `internal/model` — базовые структуры данных
2. `migrations/` + `internal/storage/postgres` — схема БД и CRUD
3. `internal/api` — HTTP хендлеры, роутер, middleware
4. `internal/storage/s3` — загрузка кода функций
5. `internal/builder` — сборка Docker образов
6. `internal/runner` — запуск функций в k8s
7. `deployments/k8s` — манифесты для деплоя
+269
View File
@@ -0,0 +1,269 @@
# План: AI-анализ terraform plan (уровни 05)
Дата: 2026-03-12
Статус: черновик / на согласование
---
## 1. Суть задачи
После выполнения `terraform plan` отправлять вывод на анализ в LLM.
Глубина анализа управляется переменной `ai_hint_level` (05) в Terraform-конфигурации.
Сейчас — Google AI (Gemini API). В будущем — собственный облачный LLM (drop-in замена).
---
## 2. Уровни подсказок (`ai_hint_level`)
| Уровень | Название | Что делает |
|---------|----------------|-------------------------------------------------------------------|
| 0 | OFF | Ничего. AI не вызывается. `terraform plan` работает как обычно. |
| 1 | SYNTAX | Проверка синтаксиса: ошибки в HCL, опечатки, невалидные блоки. |
| 2 | BASIC | + базовый анализ: неиспользуемые ресурсы, пустые значения. |
| 3 | MODERATE | + анализ зависимостей, потенциальные конфликты, порядок apply. |
| 4 | DETAILED | + best practices, безопасность (открытые порты, широкие IAM). |
| 5 | FULL | Полные рекомендации: оптимизация, рефакторинг, альтернативы. |
---
## 3. Как задаётся уровень
**По умолчанию AI не активен и ничего не показывает.** Если `ai_hint_level` нигде не задан — уровень 0, `sless plan` работает как обычный `terraform plan`, без единого упоминания об AI.
Уровень задаётся **только явно**, одним из способов (приоритет сверху вниз):
1. Env-переменная (рекомендуется):
```bash
export TF_VAR_ai_hint_level=3
```
2. В `variables.tf` пользовательского проекта (опционально, только если нужно зафиксировать уровень в коде):
```hcl
variable "ai_hint_level" {
description = "Уровень AI-анализа terraform plan (0=off, 5=full)"
type = number
default = 0
validation {
condition = var.ai_hint_level >= 0 && var.ai_hint_level <= 5
error_message = "ai_hint_level должен быть от 0 до 5"
}
}
```
3. CLI-флаг напрямую:
```bash
sless plan --ai-level=3
```
**Важно:** CLI сам читает уровень из env `TF_VAR_ai_hint_level` или флага `--ai-level`. Если ни того ни другого нет — молча применяет уровень 0. Никакой переменной в манифестах не требуется. Пользователь не видит AI, пока не включит его явно.
---
## 4. Архитектура решения
```
┌─────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ terraform │────>│ wrapper-скрипт │────>│ AI Analyzer │
│ plan │ │ (bash/Go CLI) │ │ (Go сервис) │
│ (вывод JSON)│ │ │ │ │
└─────────────┘ └──────────────────┘ └────────┬────────┘
┌────────▼────────┐
│ LLM Backend │
│ (Google Gemini) │
│ → Cloud LLM │
└─────────────────┘
```
### Компоненты:
1. **Wrapper-скрипт / CLI** — вызывает `terraform plan -json`, читает `ai_hint_level`, передаёт вывод в анализатор.
2. **AI Analyzer (Go)** — формирует промпт по уровню, отправляет в LLM, форматирует ответ.
3. **LLM Backend** — подключаемый через интерфейс (сначала Google, потом облачный).
---
## 5. Реализация по шагам
### Шаг 1: CLI-обёртка (`sless-plan`)
Новый бинарник или shell-скрипт, который:
- Запускает `terraform plan -json -out=plan.bin`
- Читает `ai_hint_level` из state/variables (через `terraform output` или парсинг .tf)
- Если level > 0, передаёт JSON-вывод плана в AI Analyzer
- Выводит стандартный plan + AI-рекомендации ниже
```bash
# Пользователь вызывает:
sless plan # вместо terraform plan
# или:
terraform plan && sless analyze --level=3
```
### Шаг 2: AI Analyzer сервис (Go)
Расположение: `internal/ai/` или отдельный `cmd/ai-analyzer/`
```
internal/ai/
├── analyzer.go # основная логика: формирование промпта, парсинг ответа
├── provider.go # интерфейс LLM-провайдера
├── google_gemini.go # реализация для Google Gemini API
├── cloud_llm.go # (заглушка) реализация для будущего облачного LLM
└── prompts.go # шаблоны промптов по уровням 1–5
```
Ключевой интерфейс:
```go
// LLMProvider — абстракция над любым LLM-бэкендом.
// Сейчас: Google Gemini. В будущем: облачный LLM (drop-in замена).
type LLMProvider interface {
Analyze(ctx context.Context, prompt string) (string, error)
Name() string
}
```
### Шаг 3: Промпты по уровням
Каждый уровень = свой system prompt + ограничения:
| Уровень | System prompt (суть) |
|---------|-----------------------------------------------------------|
| 1 | "Проверь только синтаксис HCL. Ничего лишнего." |
| 2 | "Синтаксис + базовые проблемы (unused, empty values)." |
| 3 | "Анализ зависимостей, порядок, потенциальные конфликты." |
| 4 | "Best practices, безопасность, IAM, открытые порты." |
| 5 | "Полный аудит: оптимизация, рефакторинг, альтернативы." |
### Шаг 4: Google Gemini интеграция
- API: `generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent`
- Авторизация: API key (хранить в env `GOOGLE_AI_API_KEY`, не в коде)
- SDK: `github.com/google/generative-ai-go` (официальный Go SDK)
- Модель: `gemini-pro` или `gemini-1.5-pro`
```go
// google_gemini.go — реализует LLMProvider
type GeminiProvider struct {
client *genai.Client
model string
}
```
### Шаг 5: Конфигурация
Через env-переменные (не хардкод):
```bash
# Какой LLM-провайдер использовать
export AI_PROVIDER=google # google | cloud (в будущем)
# Google Gemini
export GOOGLE_AI_API_KEY=AIza... # API ключ
# Будущий облачный LLM
export CLOUD_LLM_ENDPOINT=https://llm.cloud.example.com/v1/analyze
export CLOUD_LLM_TOKEN=...
```
---
## 6. Миграция на облачный LLM
Когда облако предоставит свой LLM:
1. Создать `cloud_llm.go` — реализация `LLMProvider` для нового API
2. Переключить `AI_PROVIDER=cloud` в env
3. Код анализатора НЕ меняется — интерфейс `LLMProvider` тот же
4. Google Gemini остаётся как fallback (опционально)
```go
// Фабрика провайдеров — выбор по переменной окружения
func NewProvider(cfg Config) (LLMProvider, error) {
switch cfg.Provider {
case "google":
return NewGeminiProvider(cfg.GoogleAPIKey)
case "cloud":
return NewCloudLLMProvider(cfg.CloudEndpoint, cfg.CloudToken)
default:
return nil, fmt.Errorf("unknown AI provider: %s", cfg.Provider)
}
}
```
---
## 7. Безопасность
- API-ключи — только в env/secrets, никогда в коде или .tf файлах
- `terraform plan -json` может содержать sensitive data → фильтровать перед отправкой в LLM
- Ограничить размер payload (большие планы обрезать/суммаризировать)
- Логировать факт вызова AI, но НЕ содержимое запроса/ответа в production
---
## 8. Структура файлов (итого)
```
sless/
├── cmd/
│ └── sless-plan/ # CLI-обёртка для terraform plan + AI
│ └── main.go
├── internal/
│ └── ai/
│ ├── analyzer.go # логика анализа
│ ├── provider.go # интерфейс LLMProvider
│ ├── google_gemini.go # Google Gemini реализация
│ ├── cloud_llm.go # заглушка для облачного LLM
│ └── prompts.go # промпты по уровням 1–5
├── terraform/
│ └── provider/ # (существующий провайдер — без изменений)
└── examples/
└── */
└── variables.tf # добавить ai_hint_level variable
```
---
## 9. Порядок реализации
| # | Задача | Приоритет |
|----|------------------------------------------------|-----------|
| 1 | Создать `internal/ai/provider.go` (интерфейс) | HIGH |
| 2 | Реализовать `google_gemini.go` | HIGH |
| 3 | Написать промпты по уровням (`prompts.go`) | HIGH |
| 4 | Создать `analyzer.go` (оркестрация) | HIGH |
| 5 | CLI-обёртка `cmd/sless-plan/main.go` | HIGH |
| 6 | Добавить `ai_hint_level` в examples | MEDIUM |
| 7 | Тесты (unit + integration с mock LLM) | MEDIUM |
| 8 | Заглушка `cloud_llm.go` для будущей миграции | LOW |
| 9 | Документация для пользователей | MEDIUM |
---
## 10. Пример использования (целевой UX)
```bash
# В terraform проекте пользователя:
$ export TF_VAR_ai_hint_level=3
$ export GOOGLE_AI_API_KEY=AIza...
$ sless plan
# Terraform Plan output (стандартный)
# ...
# ──────────────── AI Analysis (level 3: MODERATE) ────────────────
# ⚠ Resource "kubernetes_deployment.func" зависит от "kubernetes_namespace.ns"
# но namespace создаётся в другом модуле — возможен race condition.
# ⚠ Порядок destroy может вызвать проблемы: trigger удалится раньше function.
# ✓ Синтаксис корректен, конфликтов не обнаружено.
# ─────────────────────────────────────────────────────────────────
```
---
## Решение зафиксировано
Подход: **интерфейс LLMProvider** → сначала Google Gemini → потом drop-in замена на облачный LLM.
Уровень задаётся через обычную Terraform variable. Никаких изменений в самом провайдере sless.
-359
View File
@@ -1,359 +0,0 @@
# Build & Deploy Pipeline — Terraform Provider + Operator
Дата: 2026-03-20
---
## Контекст
Этот документ описывает **полный цикл** внесения изменений в систему:
от правки Go-кода до работающего `terraform apply` в продакшен-примере.
Охватывает:
- как изменять/добавлять ресурсы в terraform-провайдере
- как собирать и публиковать провайдер
- как собирать Docker-образ оператора
- как деплоить оператор в кластер
- как всё связано
---
## 1. Архитектура компонентов
```
┌──────────────────────────────────────────────────────┐
│ Пользователь пишет Terraform код (functions.tf) │
│ resource "sless_job" {...} / "sless_service" {...} │
└───────────────────┬──────────────────────────────────┘
│ terraform apply
┌──────────────────────────────────────────────────────┐
│ Terraform Provider (terraform-provider-sless) │
│ Go бинарник в /tmp/sless-provider-dev/ │
│ Исходники: sless/terraform/provider/ │
│ Публикуется на: terra.k8c.ru/naeel/sless │
└───────────────────┬──────────────────────────────────┘
│ HTTP REST API
┌──────────────────────────────────────────────────────┐
│ sless-operator (Kubernetes Deployment) │
│ Namespace: sless │
│ Image: pearlharbor.registryk8s.services.ngcloud.ru/ │
│ naeel/sless-operator:v0.1.xx │
│ Исходники: sless/ (корень репо) │
│ Управляет CRD: sless_function, sless_job, │
│ sless_service, sless_trigger │
└──────────────────────────────────────────────────────┘
```
---
## 2. Где что хранится
| Компонент | Путь на удалённой машине | Путь на редактирование (sshfs) |
|-----------|--------------------------|-------------------------------|
| Оператор (Go) | `/home/naeel/terra/sless/` | `/home/naeel/remote_dev/sless/` |
| Terraform provider | `/home/naeel/terra/sless/terraform/provider/` | `/home/naeel/remote_dev/sless/terraform/provider/` |
| Пример POSTGRES | `/home/naeel/terra/sless/examples/POSTGRES/` | `/home/naeel/remote_dev/sless/examples/POSTGRES/` |
| Dev override provider | `/tmp/sless-provider-dev/` | только на удалённой машине |
**Правило:** файлы редактируются через sshfs (`/home/naeel/remote_dev/`),
команды выполняются только на удалённой машине `5.172.178.213` через SSH.
---
## 3. Как изменить ресурс в terraform-провайдере
### 3.1 Структура провайдера
```
terraform/provider/
├── main.go # точка входа, регистрация провайдера
├── go.mod
├── internal/
│ ├── client/
│ │ └── client.go # REST-клиент к sless API (типы запросов/ответов)
│ ├── resources/
│ │ ├── job_resource.go # ресурс sless_job
│ │ ├── service_resource.go # ресурс sless_service
│ │ ├── function_resource.go # ресурс sless_function
│ │ └── trigger_resource.go # ресурс sless_trigger
│ └── provider/
│ └── provider.go # конфигурация провайдера (endpoint, token)
└── hack/
└── build-and-publish.sh # скрипт сборки + публикации в S3
```
### 3.2 Добавить новый атрибут к существующему ресурсу
Пример: добавить `timeout_sec` к `sless_job`.
**Шаг 1 — client.go**: добавить поле в `JobRequest` и `JobResponse`:
```go
type JobRequest struct {
// ... существующие поля
TimeoutSec int32 `json:"timeout_sec,omitempty"`
}
```
**Шаг 2 — job_resource.go**: добавить поле в `JobModel`:
```go
type JobModel struct {
// ... существующие поля
TimeoutSec types.Int64 `tfsdk:"timeout_sec"`
}
```
**Шаг 3 — job_resource.go**: добавить в `Schema()`:
```go
"timeout_sec": schema.Int64Attribute{
Optional: true,
Computed: true,
Default: int64default.StaticInt64(30),
MarkdownDescription: "Таймаут выполнения в секундах.",
},
```
**Шаг 4 — job_resource.go**: использовать в `Create()` при формировании запроса:
```go
req := client.JobRequest{
// ...
TimeoutSec: int32(plan.TimeoutSec.ValueInt64()),
}
```
### 3.3 Создать новый ресурс
1. Создать файл `terraform/provider/internal/resources/myresource_resource.go`
2. Реализовать интерфейс `resource.Resource` (минимум: `Metadata`, `Schema`, `Create`, `Read`, `Update`, `Delete`)
3. Зарегистрировать в `provider/provider.go`:
```go
func (p *SlessProvider) Resources(ctx context.Context) []func() resource.Resource {
return []func() resource.Resource{
resources.NewJobResource,
resources.NewMyResource, // добавить сюда
}
}
```
### 3.4 Что НЕ делать
- Не добавлять поле в `Schema()` без добавления его в `Model` struct — паника при `terraform plan`
- Не забыть `tfsdk:"..."` тег — без него поле невидимо
- При `RequiresReplace`: если ресурс immutable по этому полю, добавить `planmodifier.RequiresReplace()`
---
## 4. Как изменить CRD (API типы) в операторе
### 4.1 Файлы
```
api/v1alpha1/
├── job_types.go # FunctionJobSpec / FunctionJobStatus / FunctionJobPhase
├── function_types.go # FunctionSpec / FunctionStatus
├── service_types.go # ServiceSpec / ServiceStatus
└── zz_generated.deepcopy.go # ГЕНЕРИРУЕТСЯ АВТОМАТИЧЕСКИ — не трогать вручную
```
### 4.2 Добавить поле в Spec
1. Добавить в `job_types.go`:
```go
type FunctionJobSpec struct {
// +kubebuilder:validation:Required
NewField string `json:"newField"`
}
```
2. Регенерировать deepcopy:
```bash
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213 \
'cd /home/naeel/terra/sless && bin/controller-gen object paths="./api/..."'
```
3. Регенерировать CRD YAML:
```bash
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213 \
'cd /home/naeel/terra/sless && bin/controller-gen crd paths="./api/..." \
output:crd:artifacts:config=config/crd/bases'
```
4. Применить CRD в кластер:
```bash
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213 \
'kubectl apply -f /home/naeel/terra/sless/config/crd/bases/'
```
**Важно:** CRD нужно обновлять в кластере **до** деплоя оператора, иначе контроллер
не сможет читать/записывать новые поля из etcd.
---
## 5. Как собрать и задеплоить оператор
### 5.1 Полная последовательность
```bash
# Переменные
REGISTRY="pearlharbor.registryk8s.services.ngcloud.ru"
IMAGE="$REGISTRY/naeel/sless-operator"
VERSION="v0.1.42" # следующий тег
# 1. Логин в registry (один раз, credentials сохраняются)
echo "ieNocheiphaipheep1lie5johl7aqu" | docker login $REGISTRY -u admin --password-stdin
# 2. Сборка образа
docker build -t $IMAGE:$VERSION /home/naeel/terra/sless
# 3. Push
docker push $IMAGE:$VERSION
# 4. Обновить тег в operator.yaml (в файле sless/deployments/k8s/operator.yaml)
# Поле: image: pearlharbor.../naeel/sless-operator:v0.1.41 → v0.1.42
# 5. Apply в кластер
kubectl apply -f /home/naeel/terra/sless/deployments/k8s/operator.yaml
# 6. Дождаться rollout
kubectl rollout status deployment/sless-operator -n sless --timeout=180s
```
### 5.2 Что обязательно в operator.yaml
```yaml
spec:
template:
spec:
imagePullSecrets:
- name: sless-registry-auth # Secret должен существовать в namespace sless
containers:
- name: operator
image: pearlharbor.registryk8s.services.ngcloud.ru/naeel/sless-operator:v0.1.42
imagePullPolicy: Always # Always — иначе k8s возьмёт старый кеш
```
**Секрет `sless-registry-auth`** — содержит docker credentials для pearlharbor.
Если его нет: `kubectl create secret docker-registry sless-registry-auth -n sless ...`
### 5.3 Создать Harbor-проект (если нет)
Harbor требует чтобы проект существовал **до** первого push:
```bash
curl -X POST "https://pearlharbor.registryk8s.services.ngcloud.ru/api/v2.0/projects" \
-u admin:ieNocheiphaipheep1lie5johl7aqu \
-H "Content-Type: application/json" \
-d '{"project_name":"naeel","public":false}'
# Ожидаем: 201 Created
```
---
## 6. Как собрать и опубликовать terraform-провайдер
### 6.1 Быстрая версия (dev override — для локального теста)
Собирает бинарник прямо в `/tmp/sless-provider-dev/` — terraform подберёт его автоматически:
```bash
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213 \
'cd /home/naeel/terra/sless/terraform/provider && \
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 \
go build -ldflags "-X main.version=0.1.19" \
-o /tmp/sless-provider-dev/terraform-provider-sless_v0.1.19 . && echo OK'
```
**Важно:** в `/tmp/sless-provider-dev/` должен быть только ОДИН бинарник — удалить старый!
```bash
rm /tmp/sless-provider-dev/terraform-provider-sless_v0.1.18
```
Dev override настроен в `~/.terraformrc`:
```hcl
provider_installation {
dev_overrides {
"terra.k8c.ru/naeel/sless" = "/tmp/sless-provider-dev"
}
direct {}
}
```
### 6.2 Полная публикация в S3-registry (для продакшена)
Скрипт `hack/build-and-publish.sh` собирает бинарники для всех платформ,
вычисляет SHA256, подписывает GPG и загружает в S3:
```bash
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213 \
'cd /home/naeel/terra/sless/terraform/provider && \
S3CFG=/home/naeel/terra/terraform/secrets/.s3cfg_registry \
GPG_KEY_FILE=/home/naeel/terra/sless/secrets/private_key.asc \
bash hack/build-and-publish.sh 0.1.19'
```
После публикации проверить:
```bash
curl -sk https://terra.k8c.ru/v1/providers/naeel/sless/versions
```
### 6.3 Обновить версию в примерах
В `examples/POSTGRES/main.tf` (и других примерах):
```hcl
sless = {
source = "terra.k8c.ru/naeel/sless"
version = "~> 0.1.19" # обновить тут
}
```
Затем `terraform init -upgrade` — скачает новую версию.
---
## 7. Полный цикл: от изменения кода до terraform apply
```
1. Правка кода (локально через sshfs /home/naeel/remote_dev/sless/)
2. git add + git commit + git push
(локально или через SSH)
3. [если изменились api/v1alpha1/*.go]
controller-gen object → zz_generated.deepcopy.go
controller-gen crd → config/crd/bases/*.yaml
kubectl apply -f config/crd/bases/
4. [если изменился operator Go-код]
docker build → docker push → kubectl apply operator.yaml
kubectl rollout status deployment/sless-operator -n sless
5. [если изменился terraform/provider/]
go build → /tmp/sless-provider-dev/terraform-provider-sless_vX.X.X
(удалить старый бинарник из /tmp/sless-provider-dev/)
6. terraform apply в examples/POSTGRES/
cd /home/naeel/terra/sless/examples/POSTGRES && terraform apply -auto-approve
```
---
## 8. Типичные ошибки и решения
| Ошибка | Причина | Решение |
|--------|---------|---------|
| `unknown field FunctionRef` при `docker build` | Остарелая ссылка на удалённое поле CRD | Найти и заменить все вхождения `FunctionRef` в Go-коде |
| `Unsupported argument "timeout_sec"` при `terraform apply` | Провайдер не пересобран / старый бинарник в dev override | Пересобрать и удалить старый файл из `/tmp/sless-provider-dev/` |
| `ImagePullBackOff` при деплое оператора | Нет `imagePullSecrets` или secret не содержит credentials для registry | Добавить `imagePullSecrets: [{name: sless-registry-auth}]` в operator.yaml |
| `project naeel not found` при `docker push` | Проект в Harbor не создан | POST к Harbor API (см. раздел 5.3) |
| `no route to host` при SSH | Машина недоступна напрямую | Подключаться через 5.172.178.213 с SSH-ключом |
| CRD имеет старые поля (`functionRef` вместо `runtime`) | CRD не обновлён в кластере после правки types.go | `kubectl apply -f config/crd/bases/` после регенерации |
---
## 9. Связанные файлы документации
- [doc/run_and_logs.md](../run_and_logs.md) — шаблоны SSH-команд, реквизиты машин
- [doc/decisions/log.md](log.md) — обоснование архитектурных решений
- [doc/infrastructure/overview.md](../infrastructure/overview.md) — инфраструктура кластера
- [doc/progress.md](../progress.md) — трекер задач
-232
View File
@@ -1,232 +0,0 @@
# План: веб-редактор функций в funcs-console
Создано: 2026-03-22
---
## Что добавляем
Три фичи в `https://sless.kube5s.ru/funcs/<namespace>`:
1. **Создание функции** — кнопка «+ Новая функция», форма, сохранение
2. **Редактирование кода** — встроенный редактор (CodeMirror), сохранение = загрузка нового кода
3. **Запуск функции** — кнопка «▶ Запустить», поле ввода JSON event, вывод ответа
---
## Текущее состояние (что уже есть)
| Компонент | Есть |
|-----------|------|
| Листинг функций | ✅ |
| Просмотр кода (read-only) | ✅ |
| Enable/disable триггера | ✅ |
| Invoke | ❌ |
| Редактирование | ❌ |
| Создание | ❌ |
---
## Архитектура
### Проблема аутентификации
`/funcs/<ns>` не требует токена пользователя — использует `SLESS_SERVICE_TOKEN`.
Создание/редактирование — **операции записи**, должны быть защищены.
**Решение:** токен передаётся через форму логина:
- При открытии `/funcs/<ns>` без токена → кнопка «Войти», поле ввода токена
- Токен сохраняется в `localStorage` / `sessionStorage`
- Все write-запросы от frontend идут с `Authorization: Bearer <token>` к proxy в funcs-service
- funcs-service proxy **проксирует токен пользователя** к оператору (не serviceToken)
Почему так: оператор уже проверяет JWT структуру. Токен не верифицируется по подписи — это существующее ограничение (trusted perimeter).
---
## Новые маршруты в funcs-service (Go, main.go)
```
POST /funcs/{ns}/api/services — создать сервис (proxy → оператор)
POST /funcs/{ns}/api/services/{name}/code — загрузить код (принимает файлы, делает zip → оператор)
POST /funcs/{ns}/api/services/{name}/invoke — вызвать функцию (proxy → /fn/{ns}/{name})
DELETE /funcs/{ns}/api/services/{name} — удалить сервис (proxy → оператор)
```
Все `/api/` маршруты проксируют **токен из Authorization header** к оператору.
---
## Изменения в Go (main.go)
### 1. Новый handler: `proxyServiceCreate`
```go
// POST /funcs/{ns}/api/services
// Принимает JSON {name, runtime, entrypoint, memory_mb, env_vars}
// Проксирует токен из Authorization header → оператор
```
### 2. Новый handler: `proxyCodeUpload`
```go
// POST /funcs/{ns}/api/services/{name}/code
// Принимает multipart: несколько файлов (name + content)
// Создаёт zip в памяти → POST /v1/namespaces/{ns}/services/{name}/upload
// Проксирует токен из Authorization header
```
Почему zip в памяти: браузер не может создать zip напрямую без JSZip.
Альтернатива: использовать JSZip на фронте → отправить binary zip → проще.
**Выбор: JSZip на фронте** — проще proxy (просто forward binary), меньше Go кода.
### 3. Новый handler: `proxyInvoke`
```go
// POST /funcs/{ns}/api/services/{name}/invoke
// Тело: JSON event от пользователя
// Проксирует → POST /fn/{ns}/{name} (публичный endpoint, без токена)
// Возвращает ответ функции
```
### 4. Расширение роутера в `handleFuncsNS`
```go
case "api":
handleAPI(w, r, operatorURL, externalURL, ns, parts[2:])
```
---
## Изменения в HTML/JS (index.html)
### Зависимости (CDN, добавить в `<head>`)
```html
<!-- CodeMirror 6 — легковесный редактор -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/codemirror/6.65.7/codemirror.min.js"></script>
<!-- JSZip — создание zip в браузере -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/jszip/3.10.1/jszip.min.js"></script>
```
Почему CodeMirror а не Monaco: Monaco тяжёлый (~3MB), подключается через AMD loader.
CodeMirror 6 — лёгкий, простой CDN, достаточен для подсветки Python/JS/Go.
### Фича 1: Авторизация
```
[header] sless / sless-mu01 [⚙ Токен: ________] [Войти] [↻ обновить]
```
- Если токен в localStorage → подставляем в заголовок сразу
- Иначе — поле ввода видно
- Токен валидируется структурно на JS (3 части, exp > now)
### Фича 2: Кнопка «+ Сервис»
```
[header] ... [+ Сервис] [↻ обновить]
```
Клик → **модальное окно**:
```
Имя: [____________]
Runtime: [python3.11 ▾]
Entrypoint: [handler.handle]
Memory (MB): [128]
Env vars: [KEY=VALUE, по одной строке]
[+ ещё одна строка]
[Отмена] [Создать]
```
После создания (201) → открывается редактор кода для этой функции.
### Фича 3: Редактор кода
На каждой карточке функции — кнопка «✎ Редактировать» (рядом с expand).
При клике:
1. Загружается текущий код через `/funcs/{ns}/source/{fn}?kind=service`
2. Открывается **inline-редактор** под карточкой (или modal — обсудить)
3. CodeMirror с подсветкой по runtime
Интерфейс редактора:
```
┌─ handler.py ──────────────────────────── [+ файл] [✕] ─┐
│ def handle(event): │
│ return {"ok": True} │
│ │
│ │
└──────────────────────────────────────────────────────────┘
┌─ requirements.txt ─────────────────────── [✕] ──────────┐
│ psycopg2-binary==2.9.9 │
└──────────────────────────────────────────────────────────┘
[Сохранить и пересобрать] [Отмена]
```
Сохранение:
1. JSZip.file(name, content) для каждого открытого файла
2. zip.generateAsync({type:"blob"}) → FormData → POST `/funcs/{ns}/api/services/{name}/code`
3. Proxy → оператор upload → kaniko re-build
4. После 200 → карточка показывает "Building..."
### Фича 4: Запуск функции
На каждой карточке сервиса (kind=service, phase=Ready) — кнопка «▶ Запустить».
Клик → **inline панель** под карточкой:
```
Event JSON:
┌──────────────────────────────────────────────────────────┐
│ {"name": "world"} │
└──────────────────────────────────────────────────────────┘
[▶ Отправить]
Ответ (200, 34ms):
┌──────────────────────────────────────────────────────────┐
│ {"hello": "world"} │
└──────────────────────────────────────────────────────────┘
```
Запрос идёт напрямую с браузера на `/fn/{ns}/{name}` (публичный endpoint, без токена).
Ответ показывается с highlight.js.
---
## Порядок реализации
| # | Шаг | Файл | Сложность |
|---|-----|------|-----------|
| 1 | Добавить `/api/` роуты в `handleFuncsNS` | `main.go` | низкая |
| 2 | `proxyServiceCreate` handler | `main.go` | низкая |
| 3 | `proxyCodeUploadForward` handler (forward binary zip) | `main.go` | низкая |
| 4 | `proxyInvoke` handler | `main.go` | минимальная |
| 5 | Форма авторизации (localStorage токен) | `index.html` | низкая |
| 6 | Кнопка + Сервис + модальное окно создания | `index.html` | средняя |
| 7 | Встроенный редактор CodeMirror + JSZip upload | `index.html` | средняя |
| 8 | Панель invoke | `index.html` | низкая |
| 9 | Пересобрать образ funcs-service + деплой | Makefile/deploy | ~5 мин |
| 10 | Smoke-test: создать → редактировать → запустить | браузер | ~5 мин |
**Порядок важен:** сначала backend proxy (1-4), потом UI (5-8).
---
## Что НЕ делаем (scope)
- Удаление функции через UI — не заявлено, пропускаем
- Редактирование job-style функций (FunctionJob) — только sless_service
- История версий кода — S3 уже хранит последнюю, версионирование не реализовано
- Управление триггерами (создание/удаление) — уже есть enable/disable, этого достаточно
- Real-time логи — отдельная задача
---
## Связанные файлы
- `services/funcs/main.go`
- `services/funcs/index.html`
- `services/funcs/Dockerfile`
- `deployments/k8s/funcs-service.yaml`
-262
View File
@@ -1,262 +0,0 @@
# Решение: поддержка пользовательских go.mod в Go runtime
Создано: 2026-03-22
---
## Проблема
Сейчас Go runtime (`runtimes/go1.23/`) устроен так:
```
/app/ ← корень модуля sless/fn
├── go.mod ← module sless/fn
├── go.sum
├── server.go ← package main, import "sless/fn/handler"
└── handler/ ← пользовательский код (копируется kaniko)
└── handler.go ← package handler, func Handle(...)
```
`server.go` импортирует `sless/fn/handler` — это просто **поддиректория** внутри
того же модуля `sless/fn`. Go собирает всё как единый модуль.
Если пользователь кладёт в zip свой `go.mod` — он попадает в `/app/handler/go.mod`.
Go не допускает вложенные модули (nested modules в одной сборке), поэтому:
- `go build` игнорирует `handler/go.mod`
- пользовательские `require` не работают
- пользователь может использовать ТОЛЬКО зависимости из runtime-образа (`pgx/v5`)
---
## Анализ вариантов
### Вариант A: Go Workspaces + replace (выбранный)
```
/app/
├── go.work ← генерируется в Dockerfile (kaniko)
├── server/ ← in base image
│ ├── go.mod ← module sless/fn/server
│ ├── go.sum
│ └── server.go ← package main, import "sless/fn/handler"
└── handler/ ← user code (copied by kaniko)
├── go.mod ← ЛЮБОЙ module name (или генерируем если нет)
├── go.sum ← пользовательский
└── handler.go ← package handler, func Handle(...)
```
`go.work`:
```
go 1.23
use ./server
use ./handler
replace sless/fn/handler => ./handler
```
**Ключевое:** `replace sless/fn/handler => ./handler` в go.work позволяет `server.go`
импортировать `sless/fn/handler` **независимо от того как пользователь назвал свой модуль**.
`go build ./server` компилирует всё через workspace.
**Плюсы:** идиоматичный Go; минимальные изменения в server.go; пользователь не обязан
соблюдать соглашение по имени модуля.
**Минусы:** go.work нужно генерировать в Dockerfile; нельзя тривиально кешировать слои.
---
### Вариант B: Слияние go.mod
Во время `PrepareContext` парсим go.mod пользователя, берём из него `require`-строки,
добавляем их в runtime go.mod, при билде `go get` стягивает зависимости.
**Минус:** `go get` в kaniko требует сетевого доступа к proxy.golang.org (возможно
ограничен); сложный парсинг go.mod вручную; риск конфликтов версий.
---
### Вариант C: Server.go копируется В модуль пользователя
Пользователь предоставляет полноценный модуль, kaniko копирует `server.go` внутрь,
вызывает `go build`. Пользователь объявляет package `handler` сам.
**Минус:** ломает текущий интерфейс; пользователь должен знать детали runtime.
---
## Выбранное решение: Вариант A (go.work + replace)
---
## Что нужно изменить
### 1. `runtimes/go1.23/` — реструктуризация
**Сейчас:**
```
runtimes/go1.23/
├── Dockerfile
├── go.mod ← module sless/fn
├── go.sum
└── server.go
```
**Станет:**
```
runtimes/go1.23/
├── Dockerfile ← unchanged: собирает base image
├── server/
│ ├── go.mod ← module sless/fn/server (БЫЛО: sless/fn)
│ ├── go.sum
│ └── server.go ← unchanged: import "sless/fn/handler"
└── README.md ← описание интерфейса для пользователей
```
Изменения:
- Создать папку `server/`, перенести `go.mod`, `go.sum`, `server.go`
- В `go.mod` переименовать модуль: `sless/fn``sless/fn/server`
- `Dockerfile` базового образа: копировать `server/` в образ целиком
---
### 2. `internal/builder/context.go` — функция `generateDockerfile`
**Сейчас** (go1.23):
```dockerfile
FROM naeel/sless-runtime-go1.23:v0.1.2 AS builder
WORKDIR /app
COPY . /app/handler/
RUN CGO_ENABLED=0 go build -o /server .
FROM alpine:3.20
COPY --from=builder /server /server
EXPOSE 8080
CMD ["/server"]
```
**Станет** (go1.23):
```dockerfile
FROM naeel/sless-runtime-go1.23:v0.1.3 AS builder
WORKDIR /app
COPY . /app/handler/
# Генерируем go.mod для handler если его нет (стандартное имя нужно для go.work)
RUN [ -f /app/handler/go.mod ] || (echo 'module sless/fn/handler\n\ngo 1.23' > /app/handler/go.mod)
# Генерируем go.work: use ./server + use ./handler + replace
RUN printf 'go 1.23\n\nuse ./server\nuse ./handler\n\nreplace sless/fn/handler => ./handler\n' > /app/go.work
RUN CGO_ENABLED=0 GOFLAGS=-mod=mod go build -o /server ./server
FROM alpine:3.20
COPY --from=builder /server /server
EXPOSE 8080
CMD ["/server"]
```
Изменения в `generateDockerfile()` для `case "go1.23"`:
- Обновить referencer базового образа на `v0.1.3`
- Добавить RUN-шаги: генерация `go.mod` (если нет), генерация `go.work`
- `go build` теперь ссылается на `./server` а не на `.`
При наличии у пользователя `go.mod`: используем его (любое имя модуля),
`replace` в `go.work` обеспечит resolve import `sless/fn/handler``./handler`.
Флаг `hasGoMod` в `PrepareContext` остаётся — влияет только на то, нужен ли RUN для
генерации `go.mod` в Dockerfile.
---
### 3. Базовый образ `naeel/sless-runtime-go1.23` — v0.1.3
Образ изменится: теперь он содержит `server/` с `go.mod`, `go.sum`, `server.go`
вместо этих файлов в корне `/app/`.
Сборка образа:
```
cd runtimes/go1.23
docker build -t naeel/sless-runtime-go1.23:v0.1.3 .
docker push naeel/sless-runtime-go1.23:v0.1.3
```
**Важно:** `go.sum` для `server/` нужно обновить под новый `go.mod`.
Зависимости `server/go.mod` от pgx остаются — это зависимости runtime, не пользователя.
Пользователь может добавить pgx в свой go.mod или не добавлять.
---
### 4. Обновить пример `examples/hello-go` (когда будет воссоздан)
Два варианта пользовательского кода:
**Без зависимостей** (go.mod не нужен):
```go
// handler.go
package handler
func Handle(event map[string]interface{}) interface{} {
return map[string]interface{}{"hello": "world"}
}
```
→ builder сам сгенерирует минимальный `go.mod`
**С зависимостями** (например, pgx напрямую):
```
zip:
├── handler.go
├── go.mod ← module myfunction (любое имя!)
└── go.sum
```
```go
// go.mod
module myfunction
go 1.23
require github.com/jackc/pgx/v5 v5.7.2
```
`go.work` с `replace` подхватит этот модуль как `sless/fn/handler`
---
## Порядок выполнения
| # | Шаг | Файл | Сложность |
|---|-----|------|-----------|
| 1 | Создать `runtimes/go1.23/server/`, перенести файлы | `runtimes/go1.23/` | низкая |
| 2 | Переименовать модуль в go.mod: `sless/fn``sless/fn/server` | `runtimes/go1.23/server/go.mod` | минимальная |
| 3 | Обновить `Dockerfile` базового образа | `runtimes/go1.23/Dockerfile` | минимальная |
| 4 | Собрать и запушить base image `v0.1.3` | docker push | ~5 мин |
| 5 | Обновить `generateDockerfile` go1.23 case | `internal/builder/context.go` | средняя |
| 6 | Обновить `runtimeBaseImage` на `v0.1.3` | `internal/builder/context.go` | минимальная |
| 7 | Написать unit-тест для нового Dockerfile | `internal/builder/context_test.go` | низкая |
| 8 | Обновить `Makefile` / `hack/` если есть правила сборки runtime | `Makefile` | проверить |
| 9 | Собрать и выкатить новый operator image | docker build + push | ~10 мин |
| 10 | Smoke-test: загрузить zip с `require pgx/v5` → Ready → invoke | bash | ~5 мин |
---
## Что НЕ меняется
- Интерфейс пользователя: `func Handle(event map[string]interface{}) interface{}`
- `server.go` (package main) — не трогаем
- `SLESS_MODE=job` логика — не трогаем
- Python 3.11, Node.js 20 runtime — не трогаем
- Operator API, контроллеры — не трогаем
- Текущая версия образа v0.1.2 продолжает работать для существующих сборок (если не пересобирать)
---
## Риски
| Риск | Вероятность | Митигация |
|------|-------------|-----------|
| `go build` не находит зависимости (нет сети в kaniko) | Средняя | GOPROXY=proxy.golang.org доступен; pgx уже в go.sum сервера |
| Конфликт версий (пользователь требует другую версию pgx) | Низкая | Workspace не разделяет зависимости; конфликт только при прямом импорте из server/ |
| `go.sum` user кода отсутствует (нет go.sum при commit) | Высокая | Использовать `GONOSUMCHECK=*` или `GOFLAGS=-mod=mod` в Dockerfile |
| Увеличение времени сборки (go mod download) | Средняя | Первые сборки медленнее; кеш proxy.golang.org помогает |
---
## Связанные файлы
- `runtimes/go1.23/server.go`
- `runtimes/go1.23/go.mod`
- `runtimes/go1.23/Dockerfile`
- `internal/builder/context.go` (функции `generateDockerfile`, `runtimeBaseImage`)
- `internal/builder/context_test.go`
+67 -459
View File
@@ -1,369 +1,5 @@
# Решения и обоснования
---
## 2026-03-21 — Оценка трудозатрат на проект
| Компонент | Оценка |
|-----------|--------|
| Go operator — CRD (Function, Trigger, Job), 3 контроллера, reconcile loops, self-healing | 80-100 ч |
| REST API — router, middleware, 8 handlers, namespace lifecycle | 40-50 ч |
| Terraform провайдер — provider, client, 4 ресурса | 40-60 ч |
| Builder — kaniko, S3 upload, context tar | 20-30 ч |
| Runtimes — Go/Node/Python базовые образы | 20-30 ч |
| Инфраструктура — k8s manifests, kustomize, Harbor, Postgres | 20-30 ч |
| Тесты — lifecycle (47) + survival (34), ~1900 строк bash | 40-60 ч |
| Документация — architecture, decisions, errors, API, handoffs | 20-30 ч |
**Итого: ~280-390 человеко-часов** (7-10 недель одного разработчика в нормальном темпе).
С AI-ассистентом в паре реальное живое время ~80-120 часов (30-50% от полного объёма).
---
## 2026-03-21 — timeout_sec для sless_service: 0 = нет лимита (не 30s по умолчанию)
### Контекст
В `api/v1alpha1/service_types.go` поле `TimeoutSec` имело `+kubebuilder:default=30`.
В `invoke.go` при `TimeoutSec == 0` был хардкод `35 * time.Second` как дефолтный клиент.
Пользователь хотел ввести таймаут как **опциональный** параметр: если не указан — длинные/бесконечные функции работают без ограничений. Дефолт 30s ломал это намерение.
### Решение
`TimeoutSec = 0` → «нет ограничения». Убраны все механизмы дефолтного таймаута:
1. `+kubebuilder:default=30` удалён из CRD — поле 0 по умолчанию в Go (zero value)
2. `invoke.go`: `if timeoutSec <= 0 { return &http.Client{} }` — Go Timeout=0 = нет дедлайна
3. `services.go`: валидация `< 0 || > 900` → 400 Bad Request (0 разрешён)
4. Terraform schema: убрано `Computed: true`; `svcToModel`: `0 → Int64Null()` (null в state)
### Почему именно так
- **0 = нет лимита** — стандарт в Go для http.Client.Timeout (явно задокументировано в stdlib)
- **null в Terraform** вместо 0 — чтобы пользователь видел "не задано", а не "0 секунд"
- **Computed убрано** — поле не знает своего значения пока пользователь не задал явно; Computed означало бы "оператор сам решит" что неверно
- **Диапазон 1–900** — верхний предел защищает от бесконечных зависших запросов в Production (15 минут достаточно для любой serverless задачи)
### Затронутые файлы
| Файл | Что изменено |
|------|-------------|
| `api/v1alpha1/service_types.go` | Убран `+kubebuilder:default=30`, добавлен комментарий |
| `internal/api/handler/invoke.go` | `invokeHTTPClient(0)``&http.Client{}` |
| `internal/api/handler/services.go` | Валидация в CreateService и UpdateService |
| `terraform/provider/internal/resources/service_resource.go` | Schema + svcToModel |
---
## 2026-03-21 — Объединить sless_function и sless_service в единый пользовательский листинг
### Контекст
`/funcs/{namespace}` (web-консоль) показывал только `sless_function` ресурсы (Kind=Function).
`sless_service` ресурсы (`pg-info`, `pg-table-reader`, `pg-table-writer`) были скрыты — пользователь не видел часть своих развёрнутых функций.
Первоначальный вопрос: почему `https://sless.kube5s.ru/funcs/sless-ffd1f598c169b0ae` пуст?
Ответ: там были `sless_service`, а не `sless_function` — их не рендерили.
### Решение
Пользователю всё равно какой тип ресурса лежит под капотом — для него это просто «функция».
Объединить оба типа в один список с визуальным маркером типа:
- `sless_function` → бейдж `job`
- `sless_service` → бейдж `always-on`
Добавить поля `Kind` и `URL` в `fnResponse`. `fetchAndRender` теперь делает два запроса:
1. `GET /v1/namespaces/{ns}/functions` — sless_function (job-style)
2. `GET /v1/namespaces/{ns}/services` — sless_service (always-on Deployment)
Оба списка объединяются, фильтруются и сортируются единообразно.
### Почему НЕ делаем единый endpoint на операторе
Не усложняем оператор ради UI. Агрегацию делает funcs-service — он уже служит «фасадом» между браузером и оператором. Оператор остаётся строго CRUD.
### Имплементация
- `services/funcs/main.go`: `svcResponse`, объединение в `fetchAndRender`
- `services/funcs/index.html`: `badge-kind-service/function`, счётчик типов
- Коммит `683d728`, funcs-service `v0.2.1`
---
## 2026-03-21 — Добавить /services/{name}/source в оператор, не расширять proxySourceGet на API gateway
### Контекст
После объединения листинга возникла 404 при просмотре кода `sless_service` через web-консоль.
`proxySourceGet` передавал запрос на `/functions/{fn}/source`, но оператор маршрута `/services/{fn}/source` не имел.
### Варианты
1. В операторе: один универсальный `/resources/{fn}/source?type=service|function` — усложнит роутинг, нарушит REST-конвенцию.
2. В funcs-service: разветвлять URL по `kind` — но тогда funcs-service должен знать о внутренней топологии.
3. **Выбранный**: добавить отдельный `GET /v1/namespaces/{ns}/services/{name}/source` в оператор — симметрично с `/functions/{name}/source`. funcs-service передаёт `?kind` параметр.
### Почему так
- Симметричность `/functions/…/source` и `/services/…/source` — интуитивный REST.
- Никаких изменений в роутинге оператора — просто новый endpoint с той же логикой.
- `GetServiceSource` — буквально `GetSource` с `Service` CRD вместо `Function`. 30 строк кода.
- Коммит `50f2456`, оператор `v0.1.45`
---
## 2026-03-20 — Merge: убрать sless_function как обязательный prerequisite для sless_job
### Контекст
`sless_job` ранее требовал `FunctionRef` — имя существующего `sless_function` из которого брался `ImageRef`.
Это создавало два отдельных ресурса для одной задачи (запустить код один раз):
```hcl
resource "sless_function" "f" { ... } # build
resource "sless_job" "j" { function = sless_function.f.name ... } # run
```
### Решение
Сделать `FunctionJobSpec` самодостаточным: встроить `Runtime/Entrypoint/Env/S3Key` и запускать
kaniko сборку непосредственно из FunctionJob-контроллера (новая фаза `Building`).
```hcl
resource "sless_job" "j" {
runtime = "python3.11"
source_dir = "./code/fn"
...
}
```
### Почему НЕ удаляем sless_function
`sless_function` нужен для `sless_trigger` (type=cron/http) — они ссылаются на функцию.
Для триггеров образ должен жить вечно (не удаляться после запуска), и за ним следит Function CRD.
`sless_job` же — разовый запуск; после завершения Job удаляется, образ остаётся в registry.
### Изменения в State Machine FunctionJobReconciler
```
Было: Pending → (ждать Function.Ready) → Running → Succeeded/Failed
Стало: Pending → Building (kaniko) → Pending + ImageRef → Running → Succeeded/Failed
```
Фаза `Building` охраняется аннотацией `sless.kube5s.ru/build-job` — идемпотентна при рестарте.
---
## 2026-03-19 — Go runtime v0.1.1: внешние зависимости через go.mod/go.sum
### Контекст
Go runtime `naeel/sless-runtime-go1.23:v0.1.0` содержал `go.mod` только с `module sless/fn` и `go 1.23`.
Никаких `require` — пользовательский код мог использовать только stdlib.
При попытке добавить `pgxpool` в handler.go функция не собиралась (зависимость не найдена).
### Решение
Добавить `require github.com/jackc/pgx/v5 v5.7.2` в `runtimes/go1.23/go.mod`.
Сгенерировать `go.sum` через `go mod tidy` (stub `.go` файл с импортом нужен — иначе tidy удалит deps).
Обновить `Dockerfile` — добавить `COPY go.sum` + `RUN go mod download` **до** копирования пользовательского кода → зависимости кешируются в слое Docker, не скачиваются при каждой сборке функции.
### Почему pgx/v5, а не lib/pq
- `pgx/v5` — современный нативный PG-драйвер, `pgxpool` встроен, не нужен отдельный `database/sql`
- `lib/pq` — legacy, минимальный API, отсутствует connection pool
- `jackc/pgx/v5 v5.7.2` — последний стабильный тег на момент решения
### Что стало возможным
Любая Go функция в платформе может импортировать `pgxpool` и работать с PG напрямую:
```go
import "github.com/jackc/pgx/v5/pgxpool"
```
### Версионирование образа
`v0.1.0``v0.1.1` — изменение breaking: бинарник пересобирается с новыми deps.
Base image в `context.go` обновляется с `v0.1.0` на `v0.1.1`, оператор бампится.
---
## 2026-03-19 — Архитектура event-trigger (Вариант A: отдельный event-dispatcher)
### Контекст
До этого event-monitor/writer/cleaner работали как пользовательские sless-функции
в namespace юзера — это неправильно: они ходили в операторскую Postgres напрямую,
создавали таблицы без миграций, зависели от self-hosted rabbitmq.
Всё это удалено из кластера (audit 2026-03-19).
### Варианты которые рассматривались
**Вариант A: отдельный event-dispatcher сервис** ← ВЫБРАН
**Вариант B: dispatcher встроен горутиной в оператор**
**Вариант C: CronJob polling из очереди**
### Решение: Вариант A
**Почему не B:** AMQP-соединения внутри operator reconciler усложняют lifecycle
и тестирование. Падение AMQP затронет весь оператор.
**Почему не C:** polling — не realtime, не масштабируется, неловкий ACK.
**Почему A:** чистое разделение ответственности. Оператор управляет CRD,
dispatcher управляет AMQP. Независимые restart/deploy. Легко тестировать отдельно.
### Поток данных
```
Пользователь:
kubectl apply — Trigger{type:event, queue:"orders", functionRef:"my-func"}
sless-operator (trigger_controller.go):
reconcileEvent → валидирует что Function существует
→ устанавливает status.active = true
event-dispatcher (services/event-dispatcher/):
k8s informer наблюдает Trigger CRD по всем namespace
При type=event → amqp.Channel.Consume(spec.queue)
При сообщении → POST http://<fn-svc>.<fn-ns>.svc.cluster.local:8080/
→ 2xx → ack
→ не 2xx / timeout → nack (requeue)
При удалении Trigger → закрыть consumer
```
### Что меняется в коде
| Файл | Изменение |
|------|-----------|
| `api/v1alpha1/trigger_types.go` | +TriggerTypeEvent, +Queue в TriggerSpec |
| `controllers/trigger_controller.go` | +reconcileEvent (валидация + status) |
| `internal/config/config.go` | +RabbitMQURL |
| `services/event-dispatcher/` | новый Go-сервис (main + dispatcher + watcher) |
| `deployments/k8s/event-dispatcher.yaml` | Deployment + ServiceAccount + ClusterRole |
### Инфраструктура
RabbitMQ: managed через Nubes (Вариант A требует стабильного брокера).
- Управляется rabbitmq-operator в namespace `operators`
- namespace: `1dbfe9da-ce1c-4958-b359-d016a4b455c8`
- host: `rabbitmqk8s.1dbfe9da-ce1c-4958-b359-d016a4b455c8.svc.cluster.local`
- credentials: в `sless-operator-secret` (RABBITMQ_URL) — добавить при деплое
## 2026-03-18 — Архитектура: funcs как глобальный сервис, web-консоль
### Хранение кода функций
S3 (minio внутри кластера) хранит **два артефакта** на каждый upload:
```
functions/{namespace}/{name}/{timestamp}.zip ← ИСХОДНЫЙ КОД (zip пользователя)
contexts/{namespace}/{name}/{timestamp}.tar.gz ← BUILD CONTEXT для kaniko (zip + Dockerfile)
```
Function CRD хранит `spec.s3Key` — указывает на `contexts/...` (build context).
Из него можно восстановить путь к исходному zip:
`contexts/{ns}/{name}/{ts}.tar.gz``functions/{ns}/{name}/{ts}.zip`
Поэтому для отображения кода в веб-консоли **не нужно ничего менять в CRD**:
достаточно нового эндпоинта `GET /source` который читает zip из S3.
### Решение: funcs как глобальный Go сервис вместо per-user terraform
**Было:** `sless_function.funcs_list` + `sless_trigger.funcs_list_http` в `examples/POSTGRES/resources.tf`
— Для каждого пользователя terraform создавал отдельный pod функции
— Требовал `api_token`, `SLESS_NAMESPACE` как env vars в terraform
— Не масштабируется: N пользователей = N лишних pod'ов
**Стало:** `services/funcs/main.go` — один Go HTTP сервис в namespace `sless`
— Деплоится один раз через `deployments/k8s/funcs-service.yaml`
— Принимает JWT токен → извлекает `sub``SHA256[:8]` → namespace
— URL без токена: `/funcs/<namespace>` (namespace не секрет — виден в URL каждой функции)
`SLESS_SERVICE_TOKEN` задаётся через `kubectl set env` (не хранится в git)
### Про будущую синхронизацию terraform-папок с кластером
Terraform уже работает по схеме: `source_dir` → zip → `POST /upload` → S3.
Обратная синхронизация (кластер → локальная папка): скачать zip из S3 → распаковать в `source_dir`.
Никаких структурных изменений не потребует. Реализовывать ПОСЛЕ web-консоли.
### Архитектура web-консоли (реализовано, ветка feat/web-console, оператор v0.1.34 + funcs-service v0.2.0)
**Принцип:** минимум изменений в операторе, максимум логики в `sless-funcs-service`.
**Два новых эндпоинта в операторе:**
| Метод | Путь | Что делает |
|-------|------|-----------|
| GET | `/v1/namespaces/{ns}/functions/{name}/source` | Читает tar.gz из S3 (`Function.Spec.S3Key`) → JSON `[{name, content}]`, без Dockerfile |
| PATCH | `/v1/namespaces/{ns}/triggers/{name}` | `{"enabled": bool}` → обновляет Trigger CRD |
**`sless-funcs-service` — HTML режим:**
- Если запрос из браузера (`Accept: text/html`) → отдаёт HTML страницу
- Список функций — аккордеон; при раскрытии `fetch(/funcs/{ns}/source/{fn})` подгружает файлы
- Подсветка синтаксиса: `highlight.js` с CDN (не требует сборки)
- Кнопки ▶ Старт / ■ Стоп → `PATCH /funcs/{ns}/triggers/{name}` через fetch
- HTML шаблон `index.html` встроен в бинарник через `//go:embed index.html`
- `text/plain` ответ для curl/CLI остаётся без изменений (браузер шлёт `Accept: text/html`, curl — нет)
---
## 2026-03-18 — Смена sless API endpoint: sless-api.kube5s.ru → sless.kube5s.ru
**Решение:** Оператор sless доступен по `https://sless.kube5s.ru` (не `sless-api.kube5s.ru`). Все examples, deployments и ConfigMap обновлены.
**Причина:** При пересоздании кластера DNS-запись `sless-api.kube5s.ru` не была обновлена — она указывала на IP `5.172.178.182` (старый, мёртвый кластер). Ingress нового кластера закреплён на `185.247.187.147`. Отдельная запись `sless.kube5s.ru` уже корректно указывала на `185.247.187.147`.
TLS handshake timeout возникал потому что старый IP принимал TCP:443, но не завершал TLS (nginx жив, бэкенд мёртв). Go HTTP клиент ждал системный таймаут (~90s) и повторял бесконечно.
**Изменения:**
- `deployments/k8s/operator.yaml`: `EXTERNAL_URL`, `INGRESS_HOST`, ingress host → `sless.kube5s.ru`
- ConfigMap `sless-operator-config` в кластере: `EXTERNAL_URL` обновлён через `kubectl patch`
- Ingress `sless-operator` в кластере: host + TLS secret → `sless.kube5s.ru`
- Все `examples/**/main.tf`: `endpoint = "https://sless.kube5s.ru"`
**Правило:** При пересоздании кластера — первым делом проверять соответствие DNS → ingress IP.
---
## 2026-03-17 — Разделение prod/test endpoint'ов в examples/
**Решение:** Все `examples/` ОБЯЗАНЫ использовать `deck-api-test.ngcloud.ru` для обоих провайдеров: `nubes` и `sless` (`nubes_endpoint`). Продовый `deck-api.ngcloud.ru` — только для реальных клиентов.
**Причина:** Смешивание prod и test endpoint'ов в одном `terraform apply` приводит к тому что ресурсы создаются в разных средах. `sless_function`/`sless_job` могут получать данные (PGHOST, credentials) из прода, а pod запускается в тест-кластере — и не может достучаться до хоста.
**Правило для `main.tf` в examples:**
```hcl
provider "nubes" {
api_endpoint = "https://deck-api-test.ngcloud.ru/api/v1/index.cfm"
}
provider "sless" {
nubes_endpoint = "https://deck-api-test.ngcloud.ru/api/v1"
}
```
---
## 2026-03-17 — terraform apply только на удалённом сервере
**Решение:** `terraform init/plan/apply/destroy` для `examples/` — исключительно через SSH на сервере `naeel@5.172.178.213`. Локальный запуск запрещён.
**Причина:**
1. Провайдер `terra.k8c.ru/naeel/sless` кэширован только на удалённом сервере
2. Локальный terraform не имеет сетевого доступа к k8s кластеру и внутренним кластерным адресам (например PGHOST вида `*.svc.cluster.local`)
3. Случайный локальный запуск с prod токенами может затронуть боевую среду
**Как запускать:**
```bash
# Сначала синхронизировать изменения:
rsync -av -e "ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519" \
/home/naeel/remote_dev/sless/examples/<example>/ \
naeel@5.172.178.213:/home/naeel/terra/sless/examples/<example>/
# Затем запускать на remote:
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213 \
'cd /home/naeel/terra/sless/examples/<example> && terraform apply -auto-approve -no-color'
```
---
## 2026-03-06 — Отдельная репа для сервиса
**Решение:** Serverless service в отдельной репе, не вместе с Terraform provider.
@@ -1013,113 +649,85 @@ for _, k := range keys { envVars = append(envVars, corev1.EnvVar{Name: k, Value:
---
## 2026-03-19pgx/v5 как PG-драйвер для Go функций (vs database/sql + lib/pq)
## 2026-03-12AI-анализ terraform plan через Google Gemini
**Контекст:** Go runtime v0.1.1 — добавляем прямой доступ к PostgreSQL из функций.
Нужно выбрать: database/sql + lib/pq, или чистый pgx/v5?
**Решение:** Добавлен необязательный AI-анализ вывода `terraform plan` с уровнями детализации 0–5.
АI невидим по умолчанию — не влияет на существующие `.tf` файлы и workflow.
**Решение:** Использовать `github.com/jackc/pgx/v5` напрямую, без обёртки database/sql.
**Причина:**
- Разработчики хотят понимать что именно изменится в инфраструктуре перед применением.
- Уровни позволяют самостоятельно выбирать глубину анализа (от краткого обзора до полного аудита).
- Не ломает backward compatibility: `ai_hint_level` не указан → поведение идентично прежнему.
**Причины:**
1. **pgxpool из коробки**`pgxpool.New()` без дополнительных пакетов. lib/pq требует `sql.Open` + настройку пула через `db.SetMaxOpenConns` и т.д.
2. **Нативный протокол PostgreSQL** — pgx реализует wire protocol напрямую, без CGO.
lib/pq тоже pure Go, но pgx быстрее (~20% в бенчмарках) и активнее поддерживается.
3. **Контекст-нативность**`pgxpool.Pool.Query(ctx, ...)` — context как первый аргумент везде.
В database/sql контекст пришёл только в Go 1.8 как `QueryContext` — неудобный retrofit.
4. **Сканирование строк**`pgx.CollectRows`, `pgx.ForEachRow` — удобнее чем `rows.Scan`.
5. **Экосистема** — pgx — де-факто стандарт в Go+PG проектах (используется в pgx, pgvector, ent).
**Что добавлено в рантайм:**
**Архитектура:**
```
github.com/jackc/pgx/v5 v5.7.2
github.com/jackc/pgpassfile v1.0.0 // indirect
github.com/jackc/pgservicefile v0.0.0-... // indirect
github.com/jackc/puddle/v2 v2.2.2 // indirect (connection pool)
golang.org/x/crypto v0.31.0 // indirect (scram auth)
golang.org/x/sync v0.10.0 // indirect
golang.org/x/text v0.21.0 // indirect
provider "sless" { ai_hint_level = 3 }
↓ os.Setenv("AI_HINT_LEVEL", "3") (в provider.Configure)
sless-plan ← CLI обёртка над terraform plan
↓ запускает terraform plan, захватывает вывод
↓ если AI_HINT_LEVEL > 0 → internal/ai/analyzer.go
↓ POST к Gemini REST API (net/http)
↓ выводит анализ пользователю
```
**go mod download** добавлен в Dockerfile до COPY server.go — слой с зависимостями кешируется отдельно.
Пересборка функции (только изменение handler.go) не перекачивает ~15MB зависимостей.
**Новые файлы:**
| Файл | Назначение |
|------|------------|
| `internal/ai/provider.go` | `LLMProvider` interface + `Config` struct + `NewProvider` фабрика |
| `internal/ai/google_gemini.go` | Gemini 2.0 Flash через `net/http` (без внешних зависимостей) |
| `internal/ai/prompts.go` | Системные промпты для уровней 1–5, `BuildPrompt(level, plan)`, `LevelName(level)` |
| `internal/ai/analyzer.go` | Оркестратор: `NewAnalyzer`, `Analyze`, `FormatResult`, `truncatePlan(8000)` |
| `internal/ai/cloud_llm.go` | Заглушка: миграционный путь на облачный LLM в будущем |
| `cmd/sless-plan/main.go` | CLI: запускает `terraform plan`, читает уровень, вызывает AI |
**Изменённые файлы:**
- `terraform/provider/internal/provider/provider.go` — добавлен атрибут `ai_hint_level` (Optional Int64)
**Уровни анализа (env: `AI_HINT_LEVEL`):**
| Уровень | Описание |
|---------|----------|
| 0 | Выключен (default) — AI не вызывается |
| 1 | Только синтаксические ошибки и опечатки |
| 2 | Базовый обзор изменений |
| 3 | Умеренный: потенциальные проблемы + рекомендации |
| 4 | Детальный: security review + best practices |
| 5 | Полный аудит: всё включая compliance |
**Как передаётся уровень (приоритет по убыванию):**
1. `--ai-level` флаг CLI
2. `AI_HINT_LEVEL` env var (выставляется провайдером через `os.Setenv` в `Configure`)
3. `TF_VAR_ai_hint_level` env var
4. Дефолт: 0
**Почему `net/http` без Google SDK:**
Gemini SDK требует внешней зависимости → `go.mod` провайдера должен оставаться неизменным.
REST API Gemini достаточен: один endpoint, один JSON запрос/ответ.
**Backward compatibility:**
- Провайдер без `ai_hint_level``config.AIHintLevel.IsNull() == true``os.Setenv` не вызывается.
- `sless-plan` без `AI_HINT_LEVEL` → уровень 0 → AI не вызывается → вывод идентичен `terraform plan`.
- Существующие `.tf` файлы изменять не нужно.
**Коммиты:** `d5ce8c2` (internal/ai + cmd/sless-plan), `582b589` (provider schema)
---
## 2026-03-19Динамический таймаут в invoke.go из Function.Spec.TimeoutSec
## 2026-03-12Groq/OpenAI-compat как default AI провайдер, self-hosted LLM не поднимаем
**Контекст:** invoke.go проксирует HTTP-запросы к подам функций. До этого — глобальный `http.Client{Timeout: 30s}`.
**Решение:** Groq — default AI провайдер (через OpenAI-compat API). Google Gemini — альтернатива (env `AI_PROVIDER=google`). Self-hosted LLM (ollama) — не устанавливаем на VM.
**Проблема:** 30s — константа времени написания кода. Функции с `timeout_sec=700` (stress-тесты, batch-задачи) падают с `context deadline exceeded` раньше чем успевают завершиться.
**Причина:**
- `sless-plan`**клиентский инструмент**. Запускается на машине разработчика, не на сервере оператора. Разработчик сам отвечает за наличие доступа к AI API.
- Self-hosted LLM на VM облака — чужая инфраструктура, нецелевое использование ресурсов, потенциальные трения с облачной командой.
- Groq — бесплатный tier, OpenAI-compat API (минимальный код), модель `llama-3.3-70b-versatile` достаточна для code review.
**Решение:** Перед каждым вызовом читать `Function.Spec.TimeoutSec` из k8s и создавать `http.Client` с таймаутом = `TimeoutSec + 5s`.
**Будущее:** когда облако запустит свой LLM endpoint — добавить case `"cloud"` в `NewProvider`, endpoint из env. Stub `internal/ai/cloud_llm.go` уже есть.
**Почему +5s буфер:**
- Нельзя ставить ровно `TimeoutSec` — есть сетевые задержки, TLS handshake, время на DNS резолв внутри кластера.
- 5s достаточно для любых сетевых задержек в локальном k8s кластере.
- Если функция реально завис на TimeoutSec — runtime сам должен прервать работу (это ответственность функции, не прокси).
**Почему не кешировать http.Client:**
- Каждый вызов может прийти к разной функции с разным TimeoutSec.
- http.Client создаётся дёшево — только структура с одним полем Timeout.
- Кеш потребовал бы sync.Map или mutex — лишняя сложность без измеримой пользы.
**Деградация при недоступности k8s:**
```go
if err := h.K8s.Get(r.Context(), client.ObjectKey{...}, fn); err == nil {
timeoutSec = fn.Spec.TimeoutSec
}
// если Get упал — timeoutSec=0 → invokeHTTPClient вернёт 30s (дефолт)
**Переменные окружения для разработчика:**
```bash
export GROQ_API_KEY=gsk_... # обязательно для Groq
export AI_PROVIDER=groq # default, можно опустить
export GROQ_MODEL=llama-3.3-70b-versatile # default, можно опустить
```
Это осознанный выбор: если мы не можем прочитать функцию — мы не знаем её таймаут,
используем разумный дефолт вместо возврата ошибки.
**Коммит:** `d7fda15`, оператор `v0.1.40`
---
## 2026-03-22 — Стратегия тестирования: G13 / G14 / G15
### Решение: разделить тесты на три группы
**Контекст:** После G12 failure test (45/45) нужно было покрыть оставшиеся сценарии.
**Варианты:**
1. Один большой тест-файл со всеми сценариями
2. Три отдельных группы по типу
**Выбрано:** Три отдельных файла:
- `operator_edge_cases_test.sh` (G13) — пользовательские ошибки и граничные случаи
- `operator_chaos_test.sh` (G14) — кластерный хаос (удаление ресурсов, kill pods)
- `operator_combined_test.sh` (G15) — комбинированный: хаос + пользовательские ошибки одновременно
**Почему:** Разные группы можно запускать независимо; G14 требует прав `kubectl` на деструктивные операции — отдельный файл делает намерение явным; время прогона ~25-50 мин каждый.
---
### Решение: `GET /fn/` разрешает все HTTP методы
**Контекст:** Тест G13D-3 ожидал 405 при GET на invoke-endpoint.
**Факт:** `router.go` строка 25: `r.PathPrefix("/fn/{namespace}/{name}").HandlerFunc(h.InvokeFunction)` — PathPrefix без `.Methods()` принимает ВСЕ методы.
**Решение:** Это архитектурный выбор: runtime-функция сама решает что делать с методом. Endpoint `/fn/` — это прокси, не контроллируемый API.
**Задокументировано:** В тесте G13D-3 как by-design поведение.
---
### Решение: G15D тест принимает 503 как transient
**Контекст:** При `kubectl delete pod` operator pod — API server временно недоступен.
**Факт:** Operator pod содержит и API-server и controller в одном бинарнике. Время перезапуска pod ~5-15s, в это время nginx/ingress отдаёт 503.
**Решение:** Тест документирует это как ожидаемое поведение (NOTE), передаёт как PASS. Если нужна HA — требуется multi-replica оператор (отдельное решение).
**Gap:** Для production нужен отдельный API-deployment с ≥2 replicas.
**Коммит:** `11b484e`
-159
View File
@@ -1,159 +0,0 @@
# API Design
Последнее обновление: 2026-03-18
## Базовый URL
```
http://<operator-host>:9090/v1
```
Локально: `http://localhost:9090/v1`
В кластере: `http://sless-operator.sless.svc.cluster.local:9090/v1`
Публично: `https://sless.kube5s.ru/v1/...` (через Ingress)
**Реализованные эндпоинты:**
```
GET /v1/namespaces/{ns}/functions
POST /v1/namespaces/{ns}/functions
GET /v1/namespaces/{ns}/functions/{name}
DELETE /v1/namespaces/{ns}/functions/{name}
POST /v1/namespaces/{ns}/functions/{name}/upload
GET /v1/namespaces/{ns}/triggers
POST /v1/namespaces/{ns}/triggers
GET /v1/namespaces/{ns}/triggers/{name}
DELETE /v1/namespaces/{ns}/triggers/{name}
GET /v1/namespaces/{ns}/functions/{name}/invocations
```
**Запланированные эндпоинты (ветка feat/web-console):**
```
GET /v1/namespaces/{ns}/functions/{name}/source ← НОВЫЙ: код из S3 zip
PATCH /v1/namespaces/{ns}/triggers/{name} ← НОВЫЙ: enable/disable триггера
```
**Глобальный сервис funcs (не оператор):**
```
GET https://sless.kube5s.ru/funcs/<namespace> ← без токена, plain text / HTML
GET https://sless.kube5s.ru/funcs?token=<jwt> ← с токеном
GET https://sless.kube5s.ru/health ← liveness probe
```
## Аутентификация
```
Authorization: Bearer <cloud-token>
```
Токен — JWT от `auth-api`. Middleware в операторе:
1. Извлекает `sub` из payload (без проверки подписи — доверяет Ingress)
2. Вычисляет namespace: `SHA256(sub)[:8]` hex → `sless-{16 hex символов}`
3. Проверяет что запрошенный `{namespace}` совпадает с вычисленным
## Ресурсы
### Functions
| Метод | Путь | Описание |
|-------|------|----------|
| GET | /functions | Список функций |
| POST | /functions | Создать функцию |
| GET | /functions/{id} | Получить функцию |
| PUT | /functions/{id} | Обновить функцию |
| DELETE | /functions/{id} | Удалить функцию |
### Versions (код функции)
| Метод | Путь | Описание |
|-------|------|----------|
| GET | /functions/{id}/versions | Список версий |
| POST | /functions/{id}/versions | Загрузить новый код (multipart zip) |
| GET | /functions/{id}/versions/{ver} | Получить версию |
| POST | /functions/{id}/versions/{ver}/activate | Активировать версию |
### Triggers
| Метод | Путь | Описание |
|-------|------|----------|
| GET | /functions/{id}/triggers | Список триггеров |
| POST | /functions/{id}/triggers | Создать триггер (HTTP/Cron) |
| DELETE | /functions/{id}/triggers/{tid} | Удалить триггер |
### Invocations (вызов и логи)
| Метод | Путь | Описание |
|-------|------|----------|
| POST | /functions/{id}/invoke | Синхронный вызов |
| GET | /functions/{id}/invocations | История вызовов |
| GET | /functions/{id}/invocations/{iid} | Детали вызова + логи |
## Upload endpoint
```
POST /v1/namespaces/{namespace}/functions/{name}/upload
Content-Type: multipart/form-data
Authorization: Bearer <token>
field: code = <zip-file>
```
Процесс:
1. Принимает zip (max 32MB)
2. Распаковывает zip
3. Генерирует `Dockerfile` (`FROM naeel/sless-runtime-{runtime}:latest\nCOPY . /app/function/`)
4. Перепаковывает в `tar.gz` (kaniko требует tar format)
5. Загружает в S3: `contexts/{ns}/{name}/{timestamp}.tar.gz`
6. Обновляет `fn.Spec.S3Key` → контроллер видит изменение и запускает kaniko Job
Ответ `200 OK`:
```json
{"message": "build queued", "phase": "Pending", "s3_key": "contexts/..."}
```
## Поддерживаемые runtime (v1)
- `python3.11` — реализован и протестирован
- `go1.21` — планируется
- `nodejs20` — планируется
## Модель Function
```json
{
"id": "fn-uuid",
"name": "my-function",
"description": "...",
"runtime": "python3.11",
"entrypoint": "handler.handle",
"memory_mb": 128,
"timeout_sec": 30,
"env_vars": {"KEY": "value"},
"active_version": "1",
"status": "active",
"created_at": "...",
"updated_at": "..."
}
```
## Модель Trigger
```json
{
"id": "tr-uuid",
"type": "http",
"url": "https://sless.api.ngcloud.ru/invoke/fn-uuid",
"created_at": "..."
}
```
```json
{
"id": "tr-uuid",
"type": "cron",
"schedule": "0 * * * *",
"created_at": "..."
}
```
-746
View File
@@ -2,541 +2,6 @@
> Сюда записываем проблемы с которыми столкнулись и как их решили.
---
## 2026-03-22 — БАГ: CreateService/CreateFunction возвращает 409 при `terraform apply -replace` (ИСПРАВЛЕН)
### Симптом
```
terraform apply -replace=sless_service.pg_info
sless_service.pg_info: Destroying... [name=pg-info]
sless_service.pg_info: Destruction complete
sless_service.pg_info: Creating...
Error: create service: status 409: {"error":"service already exists"}
```
Все 22+ сервиса из `-replace` падают с 409 при пересоздании.
### Точная причина
**Цепочка событий** (воспроизводится только при наличии finalizer):
1. `terraform` вызывает `DELETE /services/pg-info`
2. API делает `h.K8s.Delete(svc)` → k8s **НЕ удаляет объект** немедленно.
Вместо этого — выставляет `DeletionTimestamp` на объекте и ждёт.
3. `service_controller.go` (асинхронно!) обрабатывает удаление:
- сносит Deployment, k8s Service, Ingress
- затем вызывает `svc.Finalizers = removeString(svc.Finalizers, serviceFinalizerName)`
- только после этого k8s реально удаляет CRD объект из etcd
- **латентность: 1–5 секунд**
4. `terraform` **немедленно** вызывает `POST /services/pg-info`
5. API делает `h.K8s.Create(svc)` → etcd возвращает `IsAlreadyExists`
6. Старый код проверял: `phase == Failed`? → нет, было `Ready``shouldRecreate=false`**409**
**Ключевое: объект существует с `DeletionTimestamp != zero`, то есть он уже "мёртвый", но finalizer ещё не снят. Старый код этого не проверял.**
### Файл с багом
`internal/api/handler/services.go``CreateService()` — строка `shouldRecreate`
`internal/api/handler/functions.go``CreateFunction()` — аналогичная логика
### Исправление
В обоих файлах добавлена проверка `!existing.DeletionTimestamp.IsZero()` **до** проверки `shouldRecreate`:
```go
if getErr == nil && !existing.DeletionTimestamp.IsZero() {
// Объект удаляется: polling каждую секунду до 30 сек
for i := 0; i < 30; i++ {
time.Sleep(1 * time.Second)
if errors.IsNotFound(h.K8s.Get(...)) {
// исчez — создаём
}
}
// таймаут — возвращаем 409 с "try again later"
}
```
### Почему именно polling, а не Watch
`http.ResponseWriter` не поддерживает long-poll без дополнительного механизма.
Watch на объект внутри HTTP handler — антипаттерн (использует goroutine leak при отмене).
30 × 1s — достаточно для любого разумного кластера; terraform имеет свой retry.
---
## 2026-03-22 — ПОВЕДЕНИЕ: оператор выставляет Ready до готовности pod (known limitation)
### Симптом
```
GET /v1/namespaces/sless-xxx/services/my-svc → { phase: "Ready" }
POST /fn/sless-xxx/my-svc → HTTP 502
# Через 15-30 секунд — 200 OK
```
### Причина
`service_controller.go` выставляет `phase=Ready` когда Deployment **создан** в k8s
(успешный `client.Create` / `client.Update`), но **не дожидается** пока pod пройдёт
readiness check и начнёт принимать трафик.
Pod startup (скачать образ + старт nodejs/python) занимает 5-30 секунд после Deployment.
### Это не баг — known limitation
Kubernetes Deployment не даёт синхронного ответа о готовности pod.
Оператор выставляет Ready через `RequeueAfter: 60s`, ожидание pod-ready потребует
Watch на Deployment.Status.ReadyReplicas — усложняет reconcile loop.
### Правило для тестов
Все invoke-тесты **обязаны** включать:
1. `sleep 15-30` после `wait_phase(..., "Ready")`
2. retry (≥3-5 попыток с интервалом 15с) перед `[FAIL]`
### Обнаружено
G17 (nodejs20), G18 (env_vars), G22D (invoke isolation), G20C (multi-svc load).
---
## 2026-03-21 — БАГ: memory_mb через PUT не применяется в k8s Deployment (ИСПРАВЛЕН v0.1.49)
### Симптом
```
PUT /v1/namespaces/sless-xxx/services/my-svc
{ "memory_mb": 256, ... }
→ HTTP 200 OK
kubectl get deployment my-svc -n sless-fn-xxx
containers[0].resources.limits.memory: 128Mi ← было 128, осталось 128
```
### Причина
`controllers/service_controller.go:ensureServiceDeployment` при UPDATE существующего Deployment обновляет только два поля:
```go
existing.Spec.Template.Spec.Containers[0].Image = svc.Status.ImageRef
existing.Spec.Template.Spec.Containers[0].Env = desired.Spec.Template.Spec.Containers[0].Env
// Resources (memory limit) НЕ обновляется!
```
`desired` Deployment строится с правильным `memory_mb`, но в `existing` он не копируется.
### Фикс (применён в v0.1.49)
```go
// В ensureServiceDeployment, блок else (UPDATE):
existing.Spec.Template.Spec.Containers[0].Image = svc.Status.ImageRef
existing.Spec.Template.Spec.Containers[0].Env = desired.Spec.Template.Spec.Containers[0].Env
existing.Spec.Template.Spec.Containers[0].Resources = desired.Spec.Template.Spec.Containers[0].Resources // ← ДОБАВЛЕНО
existing.Spec.Template.Spec.ImagePullSecrets = desired.Spec.Template.Spec.ImagePullSecrets
```
### Проверка
`operator_lifecycle_test.sh` тест 2.13 → PASS (47/47)
### Файл
`controllers/service_controller.go` ~ строка 241
### Обнаружен
`operator_lifecycle_test.sh`, тест 2.13
---
## 2026-03-21 — БАГ: нет self-healing — ручное удаление Deployment не восстанавливается (ИСПРАВЛЕН v0.1.49)
### Симптом
```
kubectl delete deployment my-svc -n sless-fn-sless-xxx
# Deployment исчез.
# Ждём 90s — контроллер не пересоздаёт.
# GET /fn/sless-xxx/my-svc → 502 (pod отсутствует, CRD=Ready)
```
### Причина
`ServiceReconciler` реагирует только на изменения объектов типа `Service` (sless CRD) в namespace `sless`.
Deployment живёт в `sless-fn-sless-xxx` — другой namespace. controller-runtime не допускает `Owns()` для cross-namespace ресурсов.
`ensureServiceDeployment` вызывается только когда `phase=Ready` И пришёл reconcile event (=изменение CRD). Просто удалённый Deployment event не генерирует.
### Фикс (применён в v0.1.49)
Добавлен `RequeueAfter: 60s` в конец `ensureServiceDeployment`:
```go
// Периодический requeue — self-healing: если Deployment/Service/Ingress удалены вручную, контроллер их пересоздаст
return ctrl.Result{RequeueAfter: 60 * time.Second}, nil
```
### Проверка
`operator_lifecycle_test.sh` тест 3.2 → PASS (47/47)
### Файл
`controllers/service_controller.go` ~ строка 340
### Обнаружен
`operator_lifecycle_test.sh`, тест 3.2
---
## 2026-03-21 — Баг: DELETE несуществующего ресурса → HTTP 204 вместо 404
### Симптом
```
DELETE /v1/namespaces/sless-xxx/functions/not-exists
→ HTTP 204 (пустой ответ, как будто удаление прошло успешно)
```
Аналогично для services, triggers, jobs.
### Причина
Все четыре `Delete*` хендлера при `errors.IsNotFound(err)` выполняли `w.WriteHeader(http.StatusNoContent)` вместо возврата 404.
```go
// БЫЛО (ошибочно):
if errors.IsNotFound(err) {
w.WriteHeader(http.StatusNoContent)
return
}
// СТАЛО (правильно):
if errors.IsNotFound(err) {
writeJSON(w, http.StatusNotFound, errResp("function not found"))
return
}
```
### Затронутые файлы
- `internal/api/handler/functions.go``DeleteFunction`
- `internal/api/handler/services.go``DeleteService`
- `internal/api/handler/triggers.go``DeleteTrigger`
- `internal/api/handler/jobs.go``DeleteJob`
### Фикс
Коммит `e8d0d78`, оператор `v0.1.44`.
---
## 2026-03-21 — Баг: funcs-service pod в ImagePullBackOff после обновления образа
### Симптом
После `kubectl set image deployment/sless-funcs-service funcs=pearlharbor…/sless-funcs-service:v0.2.1`:
```
Events:
Warning Failed kubelet Failed to pull image "...v0.2.1":
authorization failed: no basic auth credentials
```
Новый под застрял в `ImagePullBackOff`. Старый под продолжал работать с v0.2.0 (без services).
### Причина
`deployments/k8s/funcs-service.yaml` не содержал `imagePullSecrets`, а образ находится в приватном реестре Harbor (`pearlharbor.registryk8s.services.ngcloud.ru`).
Старый под (v0.2.0) работал с другой нодой, где уже был cached образ с credentials.
### Фикс
```yaml
spec:
imagePullSecrets:
- name: sless-registry-auth
containers:
- name: funcs
image: pearlharbor.registryk8s.services.ngcloud.ru/naeel/sless-funcs-service:v0.2.2
```
Коммит `09b3588`. Правило: все образы из pearlharbor требуют `imagePullSecrets: sless-registry-auth`.
---
## 2026-03-21 — Баг: /funcs/{ns}/source/{fn} → 404 для sless_service ресурсов
### Симптом
Клик на карточку `pg-info` (sless_service) в web-консоли → ошибка 404 при загрузке кода.
```
GET /funcs/sless-ffd1f598c169b0ae/source/pg-info → HTTP 404
{"error":"function not found"}
```
### Причина
`proxySourceGet` в funcs-service всегда обращался к оператору по пути:
```
/v1/namespaces/{ns}/functions/{fn}/source
```
`pg-info` — это `sless_service` (Kind=Service), а не `sless_function`. У оператора не было эндпоинта `/services/{name}/source`.
### Фикс
1. **Оператор** (`internal/api/handler/source.go`): добавлен `GetServiceSource` — делает то же что `GetSource`, но читает `Service` CRD вместо `Function`.
2. **Оператор** (`internal/api/router.go`): зарегистрирован маршрут `GET /v1/namespaces/{ns}/services/{name}/source`.
3. **funcs-service** (`services/funcs/main.go`): `proxySourceGet` принимает параметр `kind`; при `kind=service` обращается к `/services/…/source`.
4. **funcs-service** (`services/funcs/index.html`): `loadSource(body, ns, fnName, fnKind)` добавляет `?kind=service` в fetch URL для сервисов.
Коммит `50f2456`, оператор `v0.1.45`, funcs-service `v0.2.2`.
---
## 2026-03-20 — Баг: неверный hostname в api_endpoint провайдера nubes
### Симптом
`terraform apply` на `examples/POSTGRES` падал с HTTP 404 на обоих ресурсах: `nubes_postgres.npg` и `nubes_s3bucket.baba_bucket`.
### Причина
В `examples/POSTGRES/main.tf` был указан UI-домен вместо API-домена:
```hcl
# НЕПРАВИЛЬНО (UI облака, не API):
api_endpoint = "https://deck-test.ngcloud.ru/api/v1"
# ПРАВИЛЬНО (API Dashboard):
api_endpoint = "https://deck-api-test.ngcloud.ru/api/v1/index.cfm"
```
Аналогично для `nubes_endpoint` в провайдере `sless`.
### Фикс
`deck-test``deck-api-test` в обоих провайдерах, добавлен `/index.cfm`.
Найдено через `git show cca3a8c:examples/POSTGRES/main.tf`.
### Правило
> `deck-api-test.ngcloud.ru` — API (для Terraform)
> `deck-test.ngcloud.ru` — UI облака (только браузер)
---
## 2026-03-20 — Баг платформы: nubes_postgres_user/database зависают при destroy
### Симптом
`terraform destroy` завершается, но в UI облака операция `delete_user` возвращает:
> "Не удалось удалить пользователя из CRD. Производится откат"
После этого повторный `terraform apply` падает с:
> "Нарушена консистентность: Операция вернула duplicate/exist, но объект не найден в state_out"
### Причина
Платформенный баг: delete_user не удаляет CRD в кластере Kubernetes PG-оператора.
База `db0` остаётся "мёртвой" — API не видит, но в кластере CRD есть.
`adopt_existing_on_create = true` не помогает — провайдер получает `duplicate` но не может прочитать объект обратно.
### Решение (workaround)
Удалить PG-инстанс вручную через UI облака → почистить state → пересоздать через `terraform apply`.
```bash
cd ~/terra/sless/examples/POSTGRES
terraform state rm nubes_postgres_database.db
terraform state rm nubes_postgres_user.pg_user
terraform state rm nubes_postgres.npg
terraform apply -auto-approve
```
### Статус
Зафиксировано как баг платформы. Передано девопсам для исправления в CRD-операторе PG.
---
## 2026-03-20 — Invalid index: vault_secrets["users"] на первом apply
### Симптом
```
Error: Invalid index
on postgres.tf line 7, in locals:
7: pg_creds_map = jsondecode(nubes_postgres.npg.vault_secrets["users"])
The given key does not identify an element in this collection value.
```
### Причина
`vault_secrets["users"]` появляется только **после** создания первого пользователя.
На первом `plan/apply` ключ ещё не существует.
### Фикс
```hcl
pg_creds_map = try(jsondecode(lookup(nubes_postgres.npg.vault_secrets, "users", "{}")), {})
pg_password = try(local.pg_creds_map[local.pg_username]["password"], "")
```
Пароль подтягивается при следующем `apply` после создания пользователя.
---
## 2026-03-17 — Баг 3: PodLogOptions compile error (v0.1.31)
**Проблема:** Оператор не компилировался. Ошибка:
```
controllers/functionjob_controller.go: unknown field Stdout in corev1.PodLogOptions
controllers/functionjob_controller.go: unknown field Stderr in corev1.PodLogOptions
```
**Причина:** `corev1.PodLogOptions{}` в k8s API не имеет полей `Stdout` и `Stderr` — это поля из `corev1.ContainerState`. Код выглядел так:
```go
req := kube.CoreV1().Pods(namespace).GetLogs(pods.Items[0].Name, &corev1.PodLogOptions{
Stdout: true, // не существует
Stderr: true, // не существует
})
```
**Решение:** Убрать несуществующие поля. `GetLogs` по умолчанию возвращает stdout+stderr без дополнительных флагов:
```go
req := kube.CoreV1().Pods(namespace).GetLogs(pods.Items[0].Name, &corev1.PodLogOptions{})
```
**Файл:** `controllers/functionjob_controller.go`, функция `getJobPodOutput`
**Версия:** исправлено в `naeel/sless-operator:v0.1.31`
---
## 2026-03-17 — Главная причина провала POSTGRES example: неправильный nubes_endpoint
### Симптом
`terraform apply` для `examples/POSTGRES` падал с `"job failed, check pod logs"`. При этом `examples/simple-python` и `examples/hello-node` работали нормально на тест-стенде.
### Корневая причина
В `examples/POSTGRES/main.tf` в блоке `provider "sless"` был указан **продовый** endpoint Nubes API:
```hcl
provider "sless" {
endpoint = "https://sless-api.kube5s.ru"
token = var.api_token
nubes_endpoint = "https://deck-api.ngcloud.ru/api/v1" # ← ПРОД
}
```
При этом `provider "nubes"` уже указывал на тест:
```hcl
provider "nubes" {
api_token = var.api_token
api_endpoint = "https://deck-api-test.ngcloud.ru/api/v1/index.cfm" # ← тест ✓
}
```
Из-за этого `sless_function` и `sless_job` стучались в **продовый** Nubes API, где у тестового пользователя другой namespace и другой кластер. Postgres и pod запускались в контексте прода, а не тест-стенда. Поды не могли подключиться к базе.
### Фикс
```hcl
# examples/POSTGRES/main.tf
provider "sless" {
endpoint = "https://sless-api.kube5s.ru"
token = var.api_token
nubes_endpoint = "https://deck-api-test.ngcloud.ru/api/v1" # ← тест
}
```
Аналогично исправлено в `examples/simple-python/main.tf`.
### Почему долго искали
Долгое расследование ушло на "split-brain" — API-созданные FunctionJob'ы были невидимы через `kubectl get functionjobs -A`. Это объяснялось тем что:
1. Job завершался (Failed) за ~5 секунд
2. Между завершением и опросом kubectl объект уже мог быть очищен
3. Параллельно в кластере фигурировал другой namespace (`sless-ffd1f598c169b0ae` — прод) vs тест-namespace
На самом деле контроллер работал корректно. Проблема была исключительно в `nubes_endpoint`.
### Урок
**Всегда проверять**: когда в `main.tf` два провайдера (`nubes` + `sless`) — у обоих endpoint'ы должны указывать на **одну среду**. Смешивание прод/тест endpoint'ов в одном apply даёт непредсказуемые результаты.
---
## 2026-03-17 — Ошибка агента: локальный запуск terraform
**Проблема:** Агент запускал `terraform apply` **локально** (`/home/naeel/remote_dev/sless/examples/...`) вместо запуска на удалённом сервере `naeel@5.172.178.213`.
**Почему неправильно:**
- Провайдер `terra.k8c.ru/naeel/sless` установлен только на удалённом сервере
- Локальный terraform не имеет доступа к k8s кластеру напрямую
- Потенциально затрагивал продовые API из локальной сети
**Правило:** Все `terraform init/plan/apply/destroy` для `examples/` — только через SSH на `naeel@5.172.178.213`:
```bash
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213 \
'cd /home/naeel/terra/sless/examples/<example> && terraform apply -auto-approve -no-color'
```
---
## 2026-03-17 — FunctionJob всегда "job failed, check pod logs" — расследование и два бага
### Хронология расследования
**Симптом:** `terraform apply` на `examples/POSTGRES` завершается ошибкой:
```
job failed: job failed, check pod logs: kubectl logs -n sless-fn-sless-ffd1f598c169b0ae -l functionjob=pg-create-table-job-main-v12
```
Команда из сообщения — ничего не выдаёт (под не найден).
---
**Ошибка агента №1 — SQL-диагностика вместо анализа кода**
Первая реакция — запустить диагностические поды в кластере с psycopg2 чтобы проверить подключение к PostgreSQL. Это было **неправильно**: проблема не в подключении, а в том что job не запускался вообще. Пользователь остановил — "ПРИ ЧЁМ тут SQL запросы???".
---
**Ошибка агента №2 — не читал собственный код**
Раньше читались логи оператора и kubectl describe — но не исходный код контроллеров. Пользователь указал: "мы пишем ВСЁ сами, смотри в код". После прочтения `functionjob_controller.go` и `functions.go` картина сложилась за одно чтение.
---
### Баг 1 — k8s label `job-name` удалён в 1.27+
**Файл:** `controllers/functionjob_controller.go`, функция `getJobPodOutput`
**Код до:**
```go
pods, err := kube.CoreV1().Pods(namespace).List(ctx, metav1.ListOptions{
LabelSelector: "job-name=" + jobName,
})
if err != nil || len(pods.Items) == 0 {
return "completed successfully" // ← сюда всегда попадали
}
```
**Причина:** В k8s 1.27 лейбл `job-name` на pod-ах был deprecated, в 1.32+ удалён полностью. У нас кластер **1.34.1**. Поэтому `List` возвращал 0 подов всегда → fallback `"completed successfully"` → при `phase=Failed` финальное сообщение `"job failed, check pod logs: ..."`.
Логи реального сбоя никогда не попадали в `status.Message` FunctionJob, поэтому **корневая ошибка Python-функции была невидима**.
**Как нашли:** Проверили `kubectl get pod -l "batch.kubernetes.io/job-name"` — вернул поды. `kubectl get pod -l "job-name"` — не вернул. Версия кластера: `v1.34.1` (kubectl `v1.35.2`).
**Фикс:** Использовать собственный лейбл `functionjob=<fj.Name>`, который мы сами выставляем на PodTemplate и который работает независимо от версии k8s.
---
**Также:** В строке 211 подсказка для пользователя тоже использовала устаревший лейбл:
```go
"job failed, check pod logs: kubectl logs -n " + job.Namespace + " -l job-name=" + job.Name
```
Исправлено на `functionjob=<fj.Name>` — теперь команда реально работает.
---
### Баг 2 — Split-brain cached client при CreateFunction
**Файл:** `internal/api/handler/functions.go`, функция `CreateFunction`
**Проявление:** API возвращает `409 "function already exists"`, а `kubectl get function -A` функцию не видит. `terraform state rm sless_function.*` не помогает — следующий `terraform apply` снова получает 409.
**Причина:** `h.K8s` в handler — это **cached client** controller-runtime. Цепочка:
1. Предыдущий `terraform destroy` вызвал `DELETE /functions/pg-create-table-runner`
2. Handler вызвал `h.K8s.Delete(ctx, fn)` — объект удалён из **etcd**
3. Кеш controller-runtime обновляется асинхронно (informer watch). Несколько секунд объект ещё жив в памяти оператора
4. Следующий `terraform apply``POST /functions``h.K8s.Create(ctx, fn)``IsAlreadyExists` (кеш ещё видит объект)
5. Код проверяет `phase == Failed` — но объект в кеше в фазе `Ready` → уходит в 409 навсегда
`kubectl get function` шёл **мимо кеша** (прямо в k8s API) → NotFound. API handler шёл **через кеш** → AlreadyExists. Поэтому они показывали разные результаты.
**Фикс:** При `IsAlreadyExists` делать `uncached Get` (через `client.ObjectKey` напрямую). Если объект реально не найден в etcd (`IsNotFound`) — значит кеш устарел, смело создаём заново. Если найден — возвращаем 409 как обычно (объект реально существует).
---
### Итог
| # | Баг | Файл | Строка | Тип |
|---|-----|------|--------|-----|
| 1 | `LabelSelector: "job-name="` deprecated k8s 1.27+ | `controllers/functionjob_controller.go` | 311 | Совместимость |
| 1b | Подсказка `kubectl logs -l job-name=` тоже устарела | `controllers/functionjob_controller.go` | 211 | UX |
| 2 | Cached client → perpetual 409 при CreateFunction | `internal/api/handler/functions.go` | 117-133 | Race condition |
## Шаблон записи
```
@@ -982,214 +447,3 @@ Attribute runtime value must be one of: ["nodejs20" "python3.11" "go1.21"], got:
### Версии
- Оператор: `naeel/sless-operator:v0.1.13`
- Провайдер: `terra.k8c.ru/naeel/sless v0.1.7`
---
## 2026-03-19 — Баг 4: Хардкодный 30s таймаут в invoke.go → context deadline exceeded
### Симптом
Вызов функции `stress-go-pgstorm` с `duration_sec=30` возвращал:
```json
{"error": "function unreachable: ... context deadline exceeded"}
```
При этом под был `Running`, логи показывали нормальную работу pgxpool.
### Корневая причина
В `internal/api/handler/invoke.go` (строка 24) был глобальный http.Client:
```go
var httpClient = &http.Client{Timeout: 30 * time.Second}
```
Функция реально отрабатывала ровно 30 секунд (duration_sec=30) + накладные расходы
на pgxpool.New() и первый коннект к БД ≈ 1-2 секунды.
Итого запрос превышал 30s → оператор разрывал соединение раньше чем функция успевала ответить.
### Почему так было написано
При создании invoke.go в марте 2026 таймаут 30s считался "достаточным для холодного
старта". Длительные функции тогда не планировались. Когда появились batch/stress задачи
с timeout_sec=600-700 — баг стал критическим.
### Решение
Убрать глобальный `httpClient`. Перед каждым вызовом:
1. Получить Function CRD из k8s: `h.K8s.Get(ctx, ObjectKey{name, ns}, fn)`
2. Прочитать `fn.Spec.TimeoutSec`
3. Создать `http.Client{Timeout: TimeoutSec*time.Second + 5*time.Second}`
4. Если функция не найдена (Get вернул ошибку) — дефолт 30s
```go
func invokeHTTPClient(timeoutSec int32) *http.Client {
t := time.Duration(timeoutSec)*time.Second + 5*time.Second
if timeoutSec <= 0 {
t = 30 * time.Second
}
return &http.Client{Timeout: t}
}
```
### Файл
`internal/api/handler/invoke.go` — исправлено в коммите `d7fda15`
Оператор пересобран: `naeel/sless-operator:v0.1.40`
### Урок
**Никогда не хардкодить таймауты** в прокси-слое. Таймаут всегда должен браться
из конфигурации вызываемого ресурса. `Function.Spec.TimeoutSec` существует именно для этого.
---
## 2026-03-19 — Баг 5: nginx ingress proxy-read-timeout не задан → 504 Gateway Time-out
### Симптом
После фикса invoke.go (баг 4) — повторный вызов `stress-go-pgstorm` вернул:
```html
<html><head><title>504 Gateway Time-out</title></head>
<body><center><h1>504 Gateway Time-out</h1></center>
<hr><center>nginx</center></body></html>
```
curl exit code 5 (не 0), процесс завершился через ~60 секунд после старта запроса.
### Корневая причина
У ingress `sless-operator` не было аннотации `proxy-read-timeout`.
nginx ingress controller использует дефолт **60 секунд** если аннотация отсутствует.
```yaml
# Было — аннотаций timeout нет вообще:
annotations:
kubernetes.io/ingress.class: nginx
nginx.ingress.kubernetes.io/force-ssl-redirect: "true"
nginx.ingress.kubernetes.io/ssl-redirect: "true"
```
Цепочка: клиент → nginx (60s timeout) → оператор (705s) → функция (600s).
Nginx оборвал соединение на 60-й секунде, хотя и оператор и функция были живы.
### Диагностика
Проверили аннотации всех ingress в ns sless:
- `nodered` ingress: `proxy-read-timeout: "3600"` ✅ (кто-то правильно настроил)
- `sless-funcs-ingress`: нет timeout аннотаций
- `sless-operator`: нет timeout аннотаций ← **виновник**
### Решение
1. `kubectl annotate` для мгновенного применения:
```bash
kubectl annotate ingress sless-operator -n sless \
nginx.ingress.kubernetes.io/proxy-read-timeout="900" \
nginx.ingress.kubernetes.io/proxy-send-timeout="900" --overwrite
```
2. Сохранить в манифест `deployments/k8s/operator.yaml`:
```yaml
nginx.ingress.kubernetes.io/proxy-read-timeout: "900"
nginx.ingress.kubernetes.io/proxy-send-timeout: "900"
```
### Почему 900s
- function timeout_sec = 700 → оператор ждёт 705s
- nginx должен ждать дольше чем оператор → 900s с запасом
- Не ставим 3600s как у nodered — избыточно для функций
### Файл
`deployments/k8s/operator.yaml` — обновлено в коммите `d7fda15`
### Урок
При развёртывании нового ingress **всегда явно задавать** `proxy-read-timeout`
и `proxy-send-timeout`. Nginx дефолт 60s подходит только для быстрых API.
Для любых операций дольше 30s — обязательны явные таймауты.
---
## 2026-03-22 — G13/G14/G15: Баги найденные тестами (v0.1.50 → v0.1.51)
### БАГ-1: CreateService не возвращал 400 при невалидном runtime (ruby3.0)
**Обнаружен:** G12 failure test (43/45), тест G12-F-9
**Симптом:** `POST /services` с `runtime: ruby3.0` → 500 вместо 400
**Причина:** `h.K8s.Create()` вызывает webhook-валидацию CRD; kubernetes возвращает `errors.IsInvalid` при отклонённом значении enum, но в `CreateService` не было обработки этого типа ошибки — она падала в generic 500.
**Исправление:** `internal/api/handler/services.go`, добавлен блок:
```go
if errors.IsInvalid(err) {
writeJSON(w, http.StatusBadRequest, errResp("invalid service spec: "+err.Error()))
return
}
```
**Версия:** v0.1.50
---
### БАГ-2: SLESS_ENTRYPOINT не передавался в Deployment
**Обнаружен:** G12 failure test (43/45), тест G12-F-2
**Симптом:** Функция запускалась, но entrypoint игнорировался — runtime не знал какой handler вызывать
**Причина:** `buildServiceDeployment` строил `envVars` только из `svc.Spec.Env`, переменная `SLESS_ENTRYPOINT` не добавлялась
**Исправление:** `controllers/service_controller.go`, в `buildServiceDeployment`:
```go
envVars = append(envVars, corev1.EnvVar{Name: "SLESS_ENTRYPOINT", Value: svc.Spec.Entrypoint})
```
**Версия:** v0.1.50
---
### БАГ-3: UpdateService не возвращал 400 при невалидном runtime (ruby3.0)
**Обнаружен:** G13 edge cases test (G13E-5), тест: `PUT ruby3.0 → 500`
**Симптом:** `PUT /services/{name}` с `runtime: ruby3.0` → 500 вместо 400
**Причина:** `UpdateService` вызывает `h.K8s.Update()` который тоже возвращает `IsInvalid`, но обработка не была добавлена — только `CreateService` был исправлен в v0.1.50
**Исправление:** `internal/api/handler/services.go`, UpdateService:
```go
if errors.IsInvalid(err) {
writeJSON(w, http.StatusBadRequest, errResp("invalid service spec: "+err.Error()))
return
}
```
**Версия:** v0.1.51
---
### ПСЕВДО-БАГ: G13F-2 upload empty body → 404 (баг теста, не кода)
**Симптом:** POST тест шлёт пустой multipart без `-X POST` → curl делает GET → gorilla/mux возвращает 404
**Причина:** В скрипте не было `-X POST` для curl при тесте пустого тела
**Исправление:** Добавлен `-X POST` в curl-команду теста
---
### ПСЕВДО-БАГ: G13D-3 GET /fn/ → FAIL (not a bug, by design)
**Симптом:** Тест ожидал 405 при GET invoke, но получал 200
**Причина:** `router.go` строка 25 явно комментирует: "Все HTTP методы разрешены (GET/POST/PUT/... — решает сама функция)"
**Исправление:** Тест обновлён — `pass` при любом коде (задокументировано как by design)
---
### ПСЕВДО-БАГ: G15C-2 список сервисов → 0 объектов (баг теста)
**Симптом:** Python-код пытался обратиться к `.get('items', [])` но API возвращает `[]` напрямую (не `{"items": [...]}`)
**Причина:** Неверное предположение о структуре ответа GET /services
**Исправление:** Тест исправлен — обрабатывает и массив и объект с полем items
---
### ПСЕВДО-БАГ: G15E-3 DELETE → 204 (баг теста, не кода)
**Симптом:** Тест ожидал 200, сервер возвращал 204
**Причина:** `DeleteService` правильно возвращает `HTTP 204 No Content` (REST-стандарт для DELETE)
**Исправление:** Тест принимает 204 и 200
---
### ПСЕВДО-БАГ: G15D 503 сразу после kill operator pod (expected behavior)
**Симптом:** После `kubectl delete pod` оператора API возвращает 503 (не 400/404/409)
**Причина:** Operator pod = API server. Пока старый pod завершается и новый не поднялся — ingress/proxy отдаёт 503
**Исправление:** Тест принимает 503/502 как валидный транзиентный ответ с NOTE
-9
View File
@@ -51,15 +51,6 @@
| `naeel/sless-runtime-python3.11:latest` | Base runtime для python3.11 функций |
| `naeel/sless-default-hello:latest` | Пример собранной функции (kaniko) |
## Nubes Cloud endpoints
> **Не путать** — оба домена похожи, но разные назначения:
| URL | Назначение |
|-----|------------|
| `https://deck-api-test.ngcloud.ru/api/v1/index.cfm` | **API Dashboard** — используется в Terraform-провайдерах (`nubes`, `sless → nubes_endpoint`). Без `/index.cfm` — 404. |
| `https://deck-test.ngcloud.ru/` | **UI облака** — только браузер, в Terraform не использовать |
## Мониторинг
- Victoria Metrics — в кластере
+89
View File
@@ -0,0 +1,89 @@
# Работа с удалённой машиной Nubes
Дата: 2026-03-12
## Проблема
Локальный терминал Copilot нестабилен из-за VPN — команды зависают, таймауты.
**Весь код физически живёт на удалённой Ubuntu VM**, доступной по SSH.
## Архитектура
```
Локальная машина (Krupski)
└── SSHFS → /home/naeel/remote_dev → naeel@5.172.178.213:/home/naeel/terra
└── sless/ ← реальный репозиторий
```
## Подключение к VM
```bash
# Хост
VM_HOST=naeel@5.172.178.213
VM_KEY=/home/naeel/.ssh/id_ed25519 # ~/.ssh/id_ed25519 = копия secrets/naeel_vm_id_ed25519
# Проверить подключение
ssh -i /home/naeel/.ssh/id_ed25519 -o StrictHostKeyChecking=no naeel@5.172.178.213 "hostname && whoami"
# Выполнить команду удалённо
ssh -i /home/naeel/.ssh/id_ed25519 -o StrictHostKeyChecking=no naeel@5.172.178.213 "cd /home/naeel/terra/sless && <команда>"
```
## Путь к репозиторию на VM
```
/home/naeel/terra/sless
```
## Git push через SSH (Gitea)
Remote origin использует HTTPS → нужен SSH для беспарольного пуша.
На VM уже лежит ключ `~/.ssh/gitea_key` (тот же ключ, что `id_ed25519`, зарегистрирован в Gitea).
```bash
# Пуш с VM
ssh -i /home/naeel/.ssh/id_ed25519 -o StrictHostKeyChecking=no naeel@5.172.178.213 \
'cd /home/naeel/terra/sless && \
GIT_SSH_COMMAND="ssh -i ~/.ssh/gitea_key -o StrictHostKeyChecking=no" \
git push git@gitea-naeel.giteak8s.services.ngcloud.ru:naeel/sless.git <branch>'
```
## Gitea SSH ключи
Ключ `~/.ssh/id_ed25519` зарегистрирован в Gitea:
- Email: tazet@narod.ru
- Fingerprint: `SHA256:WUAvQXXmRUr6jHHdkMDljKKBUEQ8ot2cTU3YSixqYe4`
## Типовой git workflow (commit + push)
Токен лежит в `secrets/gitea.token` (Gitea PAT, repository read+write).
```bash
TOKEN=$(cat /home/naeel/remote_dev/sless/secrets/gitea.token | tr -d '\n')
ssh -i /home/naeel/.ssh/id_ed25519 -o StrictHostKeyChecking=no naeel@5.172.178.213 "
cd /home/naeel/terra/sless
git add <файлы>
git commit -m '<сообщение>'
git push https://naeel:${TOKEN}@gitea-naeel.giteak8s.services.ngcloud.ru/naeel/sless.git <branch>
"
```
## SSHFS монтирование (восстановить если упало)
```bash
sshfs \
-o IdentityFile=/home/naeel/.ssh/id_ed25519 \
-o StrictHostKeyChecking=no \
-o UserKnownHostsFile=/dev/null \
-o reconnect \
-o ServerAliveInterval=15 \
-o ServerAliveCountMax=3 \
naeel@5.172.178.213:/home/naeel/terra /home/naeel/remote_dev
```
## Примечания
- `secrets/naeel_vm_id_ed25519` и `~/.ssh/id_ed25519` — одинаковые ключи (SHA256 совпадает)
- При зависании локального терминала — выполнять команды через SSH на VM напрямую
- Git config на VM настроен: `user.name=Naeel`, `user.email=naeel@nubes.ru`
-763
View File
@@ -1,763 +0,0 @@
# Решения и обоснования
## 2026-03-18 — Архитектура: funcs как глобальный сервис, web-консоль
### Хранение кода функций
S3 (minio внутри кластера) хранит **два артефакта** на каждый upload:
```
functions/{namespace}/{name}/{timestamp}.zip ← ИСХОДНЫЙ КОД (zip пользователя)
contexts/{namespace}/{name}/{timestamp}.tar.gz ← BUILD CONTEXT для kaniko (zip + Dockerfile)
```
Function CRD хранит `spec.s3Key` — указывает на `contexts/...` (build context).
Из него можно восстановить путь к исходному zip:
`contexts/{ns}/{name}/{ts}.tar.gz``functions/{ns}/{name}/{ts}.zip`
Поэтому для отображения кода в веб-консоли **не нужно ничего менять в CRD**:
достаточно нового эндпоинта `GET /source` который читает zip из S3.
### Решение: funcs как глобальный Go сервис вместо per-user terraform
**Было:** `sless_function.funcs_list` + `sless_trigger.funcs_list_http` в `examples/POSTGRES/resources.tf`
— Для каждого пользователя terraform создавал отдельный pod функции
— Требовал `api_token`, `SLESS_NAMESPACE` как env vars в terraform
— Не масштабируется: N пользователей = N лишних pod'ов
**Стало:** `services/funcs/main.go` — один Go HTTP сервис в namespace `sless`
— Деплоится один раз через `deployments/k8s/funcs-service.yaml`
— Принимает JWT токен → извлекает `sub``SHA256[:8]` → namespace
— URL без токена: `/funcs/<namespace>` (namespace не секрет — виден в URL каждой функции)
`SLESS_SERVICE_TOKEN` задаётся через `kubectl set env` (не хранится в git)
### Про будущую синхронизацию terraform-папок с кластером
Terraform уже работает по схеме: `source_dir` → zip → `POST /upload` → S3.
Обратная синхронизация (кластер → локальная папка): скачать zip из S3 → распаковать в `source_dir`.
Никаких структурных изменений не потребует. Реализовывать ПОСЛЕ web-консоли.
### Архитектура web-консоли (план, ветка feat/web-console)
**Принцип:** минимум изменений в операторе, максимум логики в `sless-funcs-service`.
**Два новых эндпоинта в операторе:**
| Метод | Путь | Что делает |
|-------|------|-----------|
| GET | `/v1/namespaces/{ns}/functions/{name}/source` | Читает zip из S3 → JSON `[{name, content}]` |
| PATCH | `/v1/namespaces/{ns}/triggers/{name}` | `{"enabled": bool}` → обновляет Trigger CRD |
**`sless-funcs-service` — HTML режим:**
- Если запрос из браузера (`Accept: text/html`) → отдаёт HTML страницу
- Список функций — аккордеон; при раскрытии `fetch(/source)` подгружает файлы
- Подсветка синтаксиса: `highlight.js` с CDN (не требует сборки)
- Кнопки ▶ Старт / ■ Стоп → `PATCH /triggers/{name}` через fetch
- `text/plain` ответ для curl/CLI остаётся без изменений
---
## 2026-03-18 — Смена sless API endpoint: sless-api.kube5s.ru → sless.kube5s.ru
**Решение:** Оператор sless доступен по `https://sless.kube5s.ru` (не `sless-api.kube5s.ru`). Все examples, deployments и ConfigMap обновлены.
**Причина:** При пересоздании кластера DNS-запись `sless-api.kube5s.ru` не была обновлена — она указывала на IP `5.172.178.182` (старый, мёртвый кластер). Ingress нового кластера закреплён на `185.247.187.147`. Отдельная запись `sless.kube5s.ru` уже корректно указывала на `185.247.187.147`.
TLS handshake timeout возникал потому что старый IP принимал TCP:443, но не завершал TLS (nginx жив, бэкенд мёртв). Go HTTP клиент ждал системный таймаут (~90s) и повторял бесконечно.
**Изменения:**
- `deployments/k8s/operator.yaml`: `EXTERNAL_URL`, `INGRESS_HOST`, ingress host → `sless.kube5s.ru`
- ConfigMap `sless-operator-config` в кластере: `EXTERNAL_URL` обновлён через `kubectl patch`
- Ingress `sless-operator` в кластере: host + TLS secret → `sless.kube5s.ru`
- Все `examples/**/main.tf`: `endpoint = "https://sless.kube5s.ru"`
**Правило:** При пересоздании кластера — первым делом проверять соответствие DNS → ingress IP.
---
## 2026-03-17 — Разделение prod/test endpoint'ов в examples/
**Решение:** Все `examples/` ОБЯЗАНЫ использовать `deck-api-test.ngcloud.ru` для обоих провайдеров: `nubes` и `sless` (`nubes_endpoint`). Продовый `deck-api.ngcloud.ru` — только для реальных клиентов.
**Причина:** Смешивание prod и test endpoint'ов в одном `terraform apply` приводит к тому что ресурсы создаются в разных средах. `sless_function`/`sless_job` могут получать данные (PGHOST, credentials) из прода, а pod запускается в тест-кластере — и не может достучаться до хоста.
**Правило для `main.tf` в examples:**
```hcl
provider "nubes" {
api_endpoint = "https://deck-api-test.ngcloud.ru/api/v1/index.cfm"
}
provider "sless" {
nubes_endpoint = "https://deck-api-test.ngcloud.ru/api/v1"
}
```
---
## 2026-03-17 — terraform apply только на удалённом сервере
**Решение:** `terraform init/plan/apply/destroy` для `examples/` — исключительно через SSH на сервере `naeel@5.172.178.213`. Локальный запуск запрещён.
**Причина:**
1. Провайдер `terra.k8c.ru/naeel/sless` кэширован только на удалённом сервере
2. Локальный terraform не имеет сетевого доступа к k8s кластеру и внутренним кластерным адресам (например PGHOST вида `*.svc.cluster.local`)
3. Случайный локальный запуск с prod токенами может затронуть боевую среду
**Как запускать:**
```bash
# Сначала синхронизировать изменения:
rsync -av -e "ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519" \
/home/naeel/remote_dev/sless/examples/<example>/ \
naeel@5.172.178.213:/home/naeel/terra/sless/examples/<example>/
# Затем запускать на remote:
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213 \
'cd /home/naeel/terra/sless/examples/<example> && terraform apply -auto-approve -no-color'
```
---
## 2026-03-06 — Отдельная репа для сервиса
**Решение:** Serverless service в отдельной репе, не вместе с Terraform provider.
**Причина:** Разные зоны ответственности, разные релизы, потенциально разные команды.
---
## 2026-03-06 — Один бинарник для v1
**Решение:** Один Go бинарник вместо микросервисов.
**Причина:** Нагрузки изначально нет. Проще деплоить, проще отлаживать. Разделим при необходимости.
---
## 2026-03-06 — Аутентификация через облачный токен
**Решение:** Использовать Bearer token облака, без Keycloak.
**Причина:** Terraform provider уже работает с токенами облака. Keycloak — лишняя зависимость для v1.
---
## 2026-03-06 — S3 облачный, остальное в кубере
**Решение:** S3 (Ceph) использовать облачный (`ceph.tst.nubes.ru`), PostgreSQL/Redis — в кластере.
**Причина:** S3 имеет внешний доступ и уже готов. Для PostgreSQL/Redis сетевого связывания с облаком пока нет — настраивается через devops облака.
---
## 2026-03-06 — Текущий кластер для разработки
**Решение:** Использовать существующий k8s кластер (namespace `sless`), потом перенести на новый.
**Причина:** Новый кластер ещё не готов. Изоляция через namespace — безопасно для существующих сервисов.
---
## 2026-03-06 — RabbitMQ откладываем
**Решение:** В v1 только HTTP и Cron триггеры. RabbitMQ/event triggers — в v2.
**Причина:** Упрощение первой итерации.
---
## 2026-03-07 — DockerHub вместо внутреннего registry
**Решение:** Образы функций и runtime базовые образы публикуются на DockerHub (user `naeel`).
**Причина:** Namespace `registry` в кластере — это Apache NiFi Registry (NOT Docker). Отдельный Docker registry не поднят. DockerHub доступен и достаточен для разработки.
---
## 2026-03-07 — Terraform провайдер sless — отдельный модуль в той же репе
**Решение:** `terraform/provider/` — независимый Go-модуль внутри репы `sless`.
**Причина:** Удобно держать рядом с кодом оператора во время разработки.
**Важно:** `provider "sless"` и `provider "nubes"` — это **два отдельных независимых провайдера**. Объединять их нельзя:
- разные зоны ответственности (`nubes` — облачная инфраструктура, `sless` — serverless функции)
- разные релизные циклы
- разные команды в будущем
Пользователь использует оба провайдера вместе в одном `.tf` файле, но это не означает что они должны быть одним бинарником.
---
## 2026-03-07 — WaitReady в Terraform провайдере при создании функции
**Решение:** После `UploadCode` провайдер ждёт `phase=Ready` (polling каждые 5 сек, таймаут 5 мин).
**Причина:** Kaniko-сборка занимает ~1 минуту. Без ожидания `terraform apply` завершился бы с `phase=Building` в state, что неверно отображало бы реальное состояние ресурса.
---
## 2026-03-07 — code_hash для детектирования изменений кода функции
**Решение:** Атрибут `code_hash` в `sless_function` — пользователь задаёт через `filemd5("./handler.zip")`. Изменение hash → провайдер перезагружает zip и запускает пересборку.
**Причина:** Terraform не отслеживает содержимое файлов автоматически. Это стандартный паттерн (аналогично `aws_lambda_function.source_code_hash`).
---
## 2026-03-07 — Scale-to-zero откладываем до v2
**Решение:** В v1 функции работают как Deployment с постоянно живым подом (always-on). Scale-to-zero — в v2 через KEDA HTTP Add-on.
**Причина:** Scale-to-zero меняет архитектуру контроллера и routing. Для MVP это несоразмерная сложность. Пользователь может управлять ресурсами вручную через `replicas = 0/1/N` (планируется в v1.1).
**v2 план:** Заменить Deployment на `HTTPScaledObject` (KEDA), минимальные реплики = 0. KEDA буферизует запросы во время cold start (~1-3 сек).
---
## 2026-03-07 — replicas как ручное управление масштабом (TODO v1.1)
**Решение:** Добавить поле `replicas *int32` в `FunctionSpec`. Пользователь задаёт через Terraform: `replicas = 0` (выключить), `replicas = 1` (включить), `replicas = N` (масштабировать).
**Причина:** Без этого функция жрёт ресурсы 24/7 даже если не нужна. Это минимальный механизм контроля потребления до реализации scale-to-zero.
---
## 2026-03-07 — PostgreSQL опционален для базового Function Hosting
**Решение:** 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
---
## 2026-03-07 — FunctionJob CRD: одноразовые запуски функций
**Решение:** Добавлен `FunctionJob` CRD для одноразового запуска функции с произвольным JSON-событием.
**Причина:** Нужны sync-вызовы без HTTP — для батч-обработки, миграций, крон-задач через Terraform.
**Реализация:**
- `api/v1alpha1/job_types.go` — CRD: `FunctionRef`, `EventJSON`, phases: Pending/Running/Succeeded/Failed
- `controllers/functionjob_controller.go` — создаёт k8s Job, ждёт завершения, синхронизирует статус
- `internal/api/handler/jobs.go` — REST: CreateJob/GetJob/DeleteJob
- `terraform/provider/internal/resources/job_resource.go` — ресурс `sless_job`
- Настраиваемые таймауты: `build_timeout_sec` (sless_function), `wait_timeout_sec` (sless_job)
---
## 2026-03-07 — Прокси /fn/ вместо wildcard Ingress
**Проблема:** wildcard DNS `*.fn.kube5s.ru` недоступен (провайдер не позволяет).
**Решение:** HTTP-прокси внутри оператора — маршрут `GET|POST|... /fn/{namespace}/{name}` на `sless-api.kube5s.ru`.
**Реализация:**
- `internal/api/handler/invoke.go` — форвардит запрос к `http://{fn}.sless-fn-{ns}.svc.cluster.local:8080`
- `internal/api/router.go``/fn/` регистрируется **до** auth middleware, публично доступен; `/v1/` — по-прежнему с Bearer токеном (gorilla `Use()`)
- `internal/config/config.go` — новое поле `ExternalURL` (env `EXTERNAL_URL`)
- `controllers/trigger_controller.go` — если `ExternalURL` задан, `Trigger.Status.URL = ExternalURL/fn/{ns}/{name}`; иначе fallback: создаёт Ingress с поддоменом (прежнее поведение)
- `deployments/k8s/operator.yaml``EXTERNAL_URL=https://sless-api.kube5s.ru`
**URL функции:** `https://sless-api.kube5s.ru/fn/{namespace}/{name}`
**E2E:** `curl https://sless-api.kube5s.ru/fn/default/hello-node``{"message":"Hello, Naeel! (nodejs20)"}`
---
## 2026-03-08 — Lifecycle control: trigger.enabled + job.run_id
**Задача:** управление жизненным циклом ресурсов без удаления.
### trigger.enabled
**Проблема:** нет способа "заморозить" функцию без удаления Trigger/Function (
освобождение ресурсов под праздники, дебаггинг и т.д.).
**Решение:** `enabled bool` (по умолчанию `true`) в `TriggerSpec`.
- `enabled=false` → trigger_controller масштабирует Deployment функции до 0 реплик.
- Функция не принимает запросы, не потребляет CPU (pod не запущен).
- Изменение **не** пересоздаёт ресурс (нет RequiresReplace) — in-place через PATCH.
**Реализация:**
- `api/v1alpha1/trigger_types.go``Enabled bool` в TriggerSpec, `//+kubebuilder:default=true`
- `controllers/trigger_controller.go` — патчит Deployment replicas=0/1 в зависимости от Enabled
- `internal/api/handler/triggers.go``UpdateTrigger` handler (PATCH), поле `enabled` в request/response
- `internal/api/router.go``PATCH /v1/namespaces/{namespace}/triggers/{name}`
- `internal/client/client.go``TriggerUpdateRequest`, `UpdateTrigger()` метод
- `terraform/provider/internal/resources/trigger_resource.go` — атрибут `enabled` (Optional+Computed, default=true), реализован `Update` метод
### job.run_id
**Проблема:** нет способа создать FunctionJob "отложенным" — с явным контролем когда запускать.
Также нет механизма повторного запуска с сохранением структуры ресурса.
**Решение:** `run_id int64` (по умолчанию `0`) в `FunctionJobSpec`.
- `run_id=0` → FunctionJob создаётся в k8s, но k8s Job не запускается (phase=Skipped).
- `run_id>0` → запускает Job. Увеличение значения (1→2→3) = повторный запуск через пересоздание.
**Реализация:**
- `api/v1alpha1/job_types.go``RunID int64` в FunctionJobSpec, `//+kubebuilder:default=0`
- `controllers/functionjob_controller.go` — если RunID==0 → устанавливает phase=Skipped, return
- `internal/api/handler/jobs.go` — поле `run_id` в jobRequest/jobResponse
- `internal/client/client.go``RunID int64` в JobRequest/JobResponse
- `terraform/provider/internal/resources/job_resource.go` — атрибут `run_id` (RequiresReplace, default=0). Если run_id=0 → не ждёт завершения, phase=Skipped сразу в state.
**Версии:**
- operator: `naeel/sless-operator:v0.1.6`
- provider: `terra.k8c.ru/naeel/sless v0.1.4`
---
## 2026-03-08 — Переключение registry с Harbor на DockerHub
**Проблема:** Harbor (`pearlharbor.registryk8s.services.ngcloud.ru`) — внешний сервис облачного провайдера. Нестабилен: `/v2/` периодически зависает на 10+ секунд или возвращает 504. Kaniko не мог завершить push образа.
**Решение:** `REGISTRY_HOST=naeel` (DockerHub namespace). Образы функций пушатся как `naeel/sless-default-{namespace}-{name}:latest`.
**Реализация:**
- `deployments/k8s/operator.yaml` — configmap `REGISTRY_HOST: "naeel"`
- Secret `sless-registry-auth` уже содержал DockerHub credentials → дополнительных изменений не потребовалось
**Компромисс:** DockerHub — публичный registry. Образы функций пользователей публично видимы. Для production нужен приватный registry (Harbor, ECR, GCR и т.д.).
**Версии:**
- operator: оператор не пересобирался, только configmap
- commit: `b69f795`
---
## 2026-03-08 — FunctionJob polling вместо Owns watch
**Проблема:** `Owns(&batchv1.Job{})` в `SetupWithManager` не работает cross-namespace. Job создаётся в `sless-fn-{ns}`, FunctionJob — в user namespace. Watch никогда не срабатывал.
**Решение:** Убрать `Owns`. В `syncJobStatus` при Running статусе возвращать `ctrl.Result{RequeueAfter: 5 * time.Second}` — контроллер сам поллит k8s Job каждые 5 сек.
**Версии:**
- operator: `naeel/sless-operator:v0.1.10`
- commit: `461ac09`
---
## 2026-03-08 — code_hash: filesha256 вместо output_md5
**Проблема:** `hashicorp/archive v2.7.x` имеет баг: `output_md5` возвращает MD5 предыдущей версии zip. `output_sha` и `output_sha256` обновляются корректно.
**Решение:** `code_hash = filesha256("${path.module}/code/handler.js")` — хэшируется исходный файл напрямую.
**Правило проекта:** В `sless_function.code_hash` всегда использовать `filesha256(source_file)`, не `archive_file.output_md5`.
---
## 2026-03-08 — Rollout restart после kaniko build (imagePullPolicy + :latest)
**Проблема:** После успешной kaniko сборки pod не перезапускался — kubelet брал кешированный образ `:latest` (imagePullPolicy: IfNotPresent). Функция возвращала старый код.
**Решение:** В `ensureDeployment` при обновлении существующего Deployment проставляем аннотацию:
```go
existing.Spec.Template.Annotations["kubectl.kubernetes.io/restartedAt"] = fn.Status.LastBuiltAt.Time.Format(time.RFC3339)
```
Значение привязано к `fn.Status.LastBuiltAt` → меняется при каждой сборке → Kubernetes делает rolling restart → свежий образ гарантированно пул-ится.
**Правило проекта:** При использовании `:latest` tag всегда явно проставлять `restartedAt` annotation при обновлении кода.
**Версия:** operator `naeel/sless-operator:v0.1.11`
---
## 2026-03-10 — LLM-валидация кода при upload (pre-build security gate)
**Решение:** Интегрировать вызов облачного LLM в pipeline upload кода. LLM анализирует исходники пользователя **до** отправки в S3 и запуска kaniko. Если код подозрительный — upload отклоняется с HTTP 400 и причиной.
**Причина:**
1. LLM уже развёрнут (или скоро будет) в облаке nubes.ru — его нужно загрузить реальной работой.
2. Dogfooding: облачный провайдер использует собственный сервис ИИ в своём же продукте serverless.
3. Маркетинг: "ваш код проверяется ИИ перед деплоем" — реальная продающая фича.
4. Security: защита от криптомайнеров, ботнетов, DDoS-агентов, port scanners в пользовательских функциях.
**Точка интеграции:** `internal/api/handler/upload.go` — между распаковкой zip и упаковкой tar.gz.
**Pipeline с LLM:**
```
POST /upload (zip)
→ распаковка zip
→ извлечение текстовых файлов (.py, .js, .ts, .json, .sh, .sql ...)
→ POST к облачному LLM API с исходниками + системным промптом
→ safe=true → Dockerfile + tar.gz → S3 → CRD patch (обычный путь)
→ safe=false → HTTP 400 {"error": "code validation failed: <reason>"}
→ LLM error → warning в лог, upload продолжается (soft-fail)
```
**Режим работы: blocking + soft-fail**
- `safe=false` → upload отклоняется (HTTP 400), код не попадает в S3, сборка не начинается.
- LLM недоступен (timeout, 5xx) → upload **пропускается** (soft-fail), логируется warning.
Причина: недоступность LLM не должна ломать весь pipeline деплоя.
**Новый пакет:** `internal/validator/`
**Интерфейс:**
```go
// internal/validator/validator.go
type CodeValidator interface {
// Validate проверяет код функции перед сборкой.
// files — map[filename]content (текстовые файлы из zip).
// Возвращает (true, "") если код safe, (false, reason) если нет.
// При ошибке связи с LLM — возвращает (true, "") + логирует warning (soft-fail).
Validate(ctx context.Context, files map[string]string, runtime string) (safe bool, reason string, err error)
}
```
**LLM-реализация:**
```go
// internal/validator/llm.go
type LLMValidator struct {
endpoint string // URL облачного LLM API (OpenAI-compatible)
apiKey string // токен доступа
timeout time.Duration // default: 15s
log *slog.Logger
}
```
**Конфигурация (env vars):**
| Переменная | Default | Описание |
|------------|---------|----------|
| `LLM_ENABLED` | `false` | Включатель. false → NoopValidator (всегда safe) |
| `LLM_ENDPOINT` | — | URL LLM API, например `https://llm.nubes.ru/v1/chat/completions` |
| `LLM_API_KEY` | — | Bearer-токен для LLM API |
| `LLM_TIMEOUT` | `15s` | Максимальное время ожидания ответа |
`LLM_ENABLED=false` → оператор работает без LLM зависимости. По умолчанию выключено.
**Prompt-стратегия:**
Промпт НЕ хардкодится в Go — выносится в константу с возможностью override через ConfigMap.
```
You are a security reviewer for a serverless cloud platform.
Analyze the following {runtime} code deployed as a cloud function.
Check for:
1. Cryptocurrency mining (crypto hash algorithms, pool connections, stratum protocol)
2. DDoS/botnet behavior (mass outbound HTTP/UDP, connection floods)
3. Port scanning / network reconnaissance
4. Reverse shells, backdoors, C2 communication
5. Attempts to escape container (access host filesystem, /proc, /sys)
6. Obfuscated code designed to hide malicious intent
Files:
{files_content}
Respond ONLY with valid JSON, no other text:
{"safe": true} or {"safe": false, "reason": "brief explanation"}
```
**Что НЕ проверяем через LLM (не его задача):**
- Качество кода, стиль, best practices
- Уязвимости в зависимостях (это Trivy/npm audit, потом)
- Бизнес-логику пользователя
**Ограничения по размеру:**
- Суммарный размер текстовых файлов > 100KB → skip LLM (дорого, context window). Деплой проходит.
- Бинарные файлы (.pyc, .so, node_modules/) → не отправляются в LLM.
- Только расширения: `.py`, `.js`, `.ts`, `.json`, `.yaml`, `.yml`, `.txt`, `.sh`, `.sql`, `.go`.
**Встраивание в upload.go:**
```go
// После распаковки zip, до generateDockerfile
if h.Validator != nil {
files := extractTextFiles(zipData)
safe, reason, err := h.Validator.Validate(r.Context(), files, fn.Spec.Runtime)
if err != nil {
h.Log.Warn("llm validation error (soft-fail)", "err", err)
} else if !safe {
writeJSON(w, http.StatusBadRequest, errResp("code validation failed: "+reason))
return
}
}
```
**Terraform provider:** Получит `status 400: code validation failed: <reason>` — пользователь видит причину в `terraform apply` output.
**Файлы для реализации:**
1. `internal/validator/validator.go` — интерфейс CodeValidator + NoopValidator
2. `internal/validator/llm.go` — LLMValidator с HTTP client к OpenAI-compatible API
3. `internal/validator/extract.go` — extractTextFiles: zip → map[string]string
4. `internal/config/config.go` — добавить LLM_ENABLED, LLM_ENDPOINT, LLM_API_KEY, LLM_TIMEOUT
5. `internal/api/handler/handler.go` — добавить Validator поле
6. `internal/api/handler/upload.go` — вызов Validator между zip и tar.gz
7. `main.go` — wire: if LLM_ENABLED → LLMValidator, else → NoopValidator
**Компромиссы:**
- +5-15 секунд к каждому деплою (зависит от скорости LLM).
- False positives: пользователь получит 400 с причиной, может обратиться в support.
- Soft-fail при недоступности LLM: security degraded, но деплой работает.
- Prompt не идеален: LLM не ловит всё. Это дополнительный слой, не единственный.
---
## 2026-03-11 — Два провайдера: sless и nubes — нельзя объединять
**Решение:** Провайдеры `sless` и `nubes`**два отдельных независимых провайдера**.
Объединять их в один бинарник нельзя.
**Причина:**
- Разные зоны ответственности: `nubes` — облачная инфраструктура (ВМ, сети, объектное хранилище),
`sless` — serverless функции.
- Разные релизные циклы.
- В будущем — разные команды.
Пользователь использует оба в одном `.tf` файле — это нормально, это не значит что они один бинарник.
---
## 2026-03-11 — Namespace-per-user через JWT sub → SHA256
**Решение:** Каждый пользователь облака получает отдельный k8s namespace.
Namespace вычисляется детерминированно из JWT sub.
**Алгоритм:**
```
namespace = "sless-" + hex(SHA256(JWT.sub)[:8])
```
Итоговая длина: 22 символа. Пример: `sless-cdd874dfa31ba6ca`.
**Почему SHA256, а не UUID напрямую:**
- UUID (sub) напрямую в имени namespace — раскрывает внутренний ID пользователя.
- SHA256 — необратим, namespace не позволяет восстановить sub.
**Реализация:**
- `client.SubFromJWT(token)` — декодирует JWT payload → возвращает sub
- `client.NamespaceFromSub(sub)` — SHA256(sub)[:8] → hex → "sless-{hex16}"
- Вычисляется в `provider.Configure()` до создания Client
---
## 2026-03-11 — EnsureNamespace как отдельный endpoint (SoC)
**Проблема:** Создание namespace было в resource-хендлерах (CreateFunction, CreateTrigger, CreateJob).
Это нарушение разделения ответственностей: ресурс должен заниматься только тем, для чего предназначен.
**Решение:**
- Создан отдельный endpoint `POST /v1/namespaces/{namespace}/ensure`
- Хендлер вынесен в отдельный файл `internal/api/handler/namespace.go`
- Провайдер вызывает его **один раз** в `Configure()` до создания любых ресурсов
- `handler.go` очищен от k8s-типов (corev1, k8serrors, metav1) — только инфраструктура
**Поведение endpoint:**
- 200 OK `{"namespace": "...", "status": "exists"}` — namespace уже был
- 201 Created `{"namespace": "...", "status": "created"}` — namespace создан
- Идемпотентен: параллельные запросы не падают (IsAlreadyExists обработан)
**Кто отвечает за namespace:**
Только `EnsureNamespace`. Ни один другой хендлер namespace не трогает.
---
## 2026-03-11 — JWT validation в операторе вместо статического токена
**Проблема:** Оператор сравнивал Bearer токен со статическим `apiToken` из конфига.
JWT-токены облака не совпадали → все запросы от провайдера отклонялись с 401.
**Решение:** `internal/api/middleware/auth.go` — заменена проверка:
- Было: `token == cfg.APIToken` (строковое сравнение)
- Стало: `validateJWT(token)` — проверяет структуру JWT (3 части), наличие `sub`, срок действия `exp`
**Почему подпись не проверяется:**
Оператор находится за Ingress в закрытом кластере (trusted perimeter).
Проверка подписи требует публичный ключ issuer — усложнение без реальной пользы в данной топологии.
Подпись проверяется косвенно через `PingNubesAPI` в провайдере при `terraform init`.
**Версия:** operator v0.1.20
---
## 2026-03-11 — Валидация токена через nubes API при Configure
**Решение:** При `terraform init` / `terraform apply` провайдер пингует nubes API
для подтверждения что токен действителен.
**Реализация:** `client.PingNubesAPI(ctx, endpoint, token)`:
- `GET <nubes_endpoint>` с Bearer токеном
- 401/403 → токен отклонён → ошибка инициализации провайдера
- Ошибка соединения → ошибка инициализации
- Любой другой статус (200, 404, 500...) → токен не декларирован невалидным → OK
**Конфигурация:**
```hcl
provider "sless" {
endpoint = "https://sless-api.kube5s.ru"
token = file("./secrets/prod.token")
nubes_endpoint = "https://deck-api.ngcloud.ru/api/v1"
}
```
Env-альтернативы: SLESS_ENDPOINT, SLESS_API_TOKEN, NUBES_ENDPOINT.
---
## 2026-03-11 — SoC рефакторинг handler.go
**Решение:** Файл `handler.go` — чистая инфраструктура.
Бизнес-логика по доменам — в отдельных файлах одного package.
**Структура handler/ package:**
```
handler.go — Handler struct + helpers (writeJSON, errResp, pathVar, namespace)
namespace.go — EnsureNamespace (k8s namespace lifecycle)
functions.go — CRUD Function
triggers.go — CRUD Trigger
jobs.go — CRUD FunctionJob
upload.go — zip -> tar.gz -> S3 -> CRD patch
invoke.go — прокси /fn/ -> in-cluster
invocations.go — 501 stub
```
**Принцип:** каждый файл отвечает за один домен.
`handler.go` не импортирует `corev1/k8serrors/metav1` — эти зависимости только в `namespace.go`.
---
## 2026-03-11 — Namespace пользователя никогда не удаляется
**Решение:** User namespace (`sless-{hex16}`) **не удаляется** ни при каких обстоятельствах.
**Причина:**
- Namespace вычисляется из `JWT.sub` — неизменяемого идентификатора пользователя.
- Namespace = "home directory" пользователя в кластере: `terraform destroy` удаляет
функции/триггеры/джобы, но не сам контейнер для ресурсов.
- Удаление namespace уничтожило бы все CRD объекты пользователя.
- Повторный `terraform apply` (после destroy) нашёл бы свой ns живым — правильное поведение.
**Верификация (проверено):**
- В API нет маршрута `DELETE /v1/namespaces/{namespace}`.
- `handleDeletion` в `function_controller.go` удаляет: Deployment, Service, Ingress, kaniko Job.
- `handleTriggerDeletion` в `trigger_controller.go` удаляет: CronJob (в deployNS), Service, Ingress.
- Оба контроллера содержат явный комментарий: "Namespace sless-fn-{userNS} НЕ удаляется — он принадлежит пользователю".
- Тест: `kubectl get ns sless-cdd874dfa31ba6ca` — namespace жив через 93 минуты после `terraform destroy`.
**Оба namespace предохраняются:**
- `sless-{hex16}` — user namespace (хранит CRD объекты Function/Trigger/FunctionJob)
- `sless-fn-{hex16}` — deploy namespace (хранит Deployment/Service/Ingress/CronJob)
---
## 2026-03-11 — Builder SoC: context.go отделён от upload.go
**Проблема:** `generateDockerfile`, `runtimeBaseImage`, `zipToTarGz` жили в `handler/upload.go`.
Знание о runtime образах и структуре build context — детали **сборки**, не HTTP-хендлера.
Нарушение SoC: HTTP-файл знал о Docker, kaniko, tar.gz, zip-разборе.
**Решение:** Перенести в `internal/builder/context.go`, единственный публичный API:
```go
func PrepareContext(zipData []byte, runtime string) (*bytes.Buffer, error)
```
**Результат:**
- `upload.go`: ~200 LOC → ~60 LOC (только HTTP: принять zip, вызвать PrepareContext, сохранить в S3)
- `context.go`: всё знание о runtime образах, zip→tar, Dockerfile генерации
**Детали реализации:**
- `zipToTarGz` принимает `*zip.Reader` вместо `[]byte` — zip парсится один раз в `PrepareContext`
- `PrepareContext` сама сканирует zip-архив (requirements.txt, package.json) — хендлер не знает об этом
- `runtimeBaseImage` возвращает ошибку для неизвестного runtime — ранний fail до kaniko
**Тесты:** 4 теста в `internal/builder/context_test.go` (python+requirements, node без package.json, unsupported runtime, Dockerfile-first в tar).
---
## 2026-03-11 — Фильтрация hop-by-hop headers в /fn/ прокси
**Проблема:** `invoke.go` пробрасывал все заголовки ответа функции клиенту, включая hop-by-hop.
`Transfer-Encoding: chunked` особенно опасен: Go `http.ResponseWriter` не умеет его воспроизводить,
клиент получал некорректное тело ответа (или ошибку framing).
**Решение:** Фильтровать по RFC 2616 §13.5.1 перед записью в `w`:
```go
var hopByHopHeaders = map[string]bool{
"Connection": true, "Keep-Alive": true, "Proxy-Authenticate": true,
"Proxy-Authorization": true, "Te": true, "Trailers": true,
"Transfer-Encoding": true, "Upgrade": true,
}
// В цикле:
if hopByHopHeaders[k] { continue }
```
**Почему map[string]bool:** O(1) lookup, ключи в canonical form (`http.CanonicalHeaderKey`),
совпадает с форматом ключей в `http.Header` — нет нужды нормализовывать.
**Тесты:** 3 теста в `internal/api/handler/invoke_test.go`
(filtered from response, map contains all RFC2616, canonical key form).
---
## 2026-03-11 — JWKS insertion point stub в auth.go
**Контекст:** v1 auth — `validateJWT` проверяет структуру токена (sub, exp) без проверки подписи.
Это допустимо в trusted perimeter (оператор в k8s, доступен только изнутри).
**Решение:** Добавлена `verifySignature()` как закомментированная заготовка в `auth.go`.
**v2 план (когда nubes даст JWKS endpoint):**
1. `GET {NUBES_JWKS_URL}/.well-known/jwks.json`
2. Найти ключ по `kid` из JWT header
3. Проверить подпись RS256/ES256 через `github.com/lestrrat-go/jwx/v2`
4. Добавить вызов `verifySignature(token)` в `validateJWT` после проверки структуры.
**Зачем stub:** любой агент или разработчик видит точную строку для вставки. Нет риска забыть.
---
## 2026-03-11 — CronJob перенесён в deployNS
**Проблема:** CronJob для HTTP-триггеров создавался в `tr.Namespace` (user namespace: `sless-{hex16}`).
При применении NetworkPolicy (каждый namespace изолирован) — CronJob не мог бы дотянуться до API.
**Решение:** CronJob создаётся в `deployNS` = `"sless-fn-" + tr.Namespace`,
где живут Deployment/Service — NetworkPolicy там уже правильная.
**Затронутые места в trigger_controller.go:**
- `buildCronJob` — namespace в ObjectMeta
- `r.Client.Create` — нет изменений (namespace из объекта)
- `r.Client.Get` в reconcile — `deployNS` вместо ns
- `handleTriggerDeletion` — удаление CronJob из `deployNS`
**Дополнительно:** `curlimages/curl:latest``curlimages/curl:8.5.0` (pin версии).
---
## 2026-03-11 — Sort env vars в buildDeployment
**Проблема:** `fn.Spec.Env` — это `map[string]string`. Итерация по map в Go недетерминирована.
Каждый reconcile мог генерировать Pod spec с другим порядком env vars → лишние rollout'ы.
**Решение:**
```go
keys := make([]string, 0, len(fn.Spec.Env))
for k := range fn.Spec.Env { keys = append(keys, k) }
sort.Strings(keys)
for _, k := range keys { envVars = append(envVars, corev1.EnvVar{Name: k, Value: fn.Spec.Env[k]}) }
```
**Тесты:** 2 теста в `controllers/function_controller_unit_test.go`
(4 env vars → алфавитный порядок после SLESS_ENTRYPOINT; пустой Env → только SLESS_ENTRYPOINT).
-204
View File
@@ -1,204 +0,0 @@
# Архитектура системы
Последнее обновление: 2026-03-18 (v0.1.33 + funcs-service v0.1.3)
## Общее описание
Managed Serverless Functions Service для облачного провайдера nubes.ru.
Пользователь загружает код через Terraform, сервис его собирает (kaniko) и запускает
по HTTP-триггеру, расписанию (cron) или вручную через one-shot Job.
## Стек
| Компонент | Технология | Где запущен |
|-----------|-----------|-------------|
| Operator (API + Controllers) | Go (controller-runtime) | Kubernetes, namespace `sless` |
| funcs-service (глобальная консоль) | Go (net/http) | Kubernetes, namespace `sless` |
| PostgreSQL | PostgreSQL 16 | Kubernetes, namespace `sless` |
| S3 | Ceph (облачный) | `s3.msk-1.ngcloud.ru` |
| Container Registry | DockerHub (`naeel/`) | внешний |
| Builder | kaniko (k8s Job) | namespace пользователя |
| Функции (HTTP) | k8s Deployment + Service | namespace пользователя |
| Функции (one-shot) | k8s Job | namespace пользователя |
| Функции (cron) | k8s CronJob | namespace пользователя |
| Terraform Provider | Go (plugin framework v6) | localhost/CI |
| nubes API | REST (облако) | `deck-api.ngcloud.ru` |
> Redis и RabbitMQ — отложены до v2.
## Компонент: funcs-service
Глобальный HTTP сервис — **одна копия** на весь кластер, для всех пользователей.
```
User Browser / curl
└─► https://sless.kube5s.ru/funcs/<namespace>
└─► nginx Ingress (sless-funcs-ingress)
└─► sless-funcs-service:8090 (namespace sless)
└─► http://sless-operator.sless.svc.cluster.local:9090/v1/...
```
**Файлы:**
- `services/funcs/main.go` — логика
- `services/funcs/Dockerfile` — multi-stage Go → alpine
- `deployments/k8s/funcs-service.yaml` — Deployment + Service + Ingress
**Env vars сервиса:**
| Переменная | Значение |
|-----------|---------|
| `SLESS_OPERATOR_URL` | `http://sless-operator.sless.svc.cluster.local:9090` |
| `SLESS_EXTERNAL_URL` | `https://sless.kube5s.ru` |
| `SLESS_EXCLUDE` | `event-writer,event-monitor,event-cleaner` |
| `SLESS_SERVICE_TOKEN` | JWT токен (задаётся через `kubectl set env`, не в git) |
## Хранение кода функций в S3
```
Terraform source_dir (локально)
└─► zip → POST /upload → builder.PrepareContext()
├─► functions/{ns}/{name}/{ts}.zip ← ИСХОДНЫЙ КОД пользователя
└─► contexts/{ns}/{name}/{ts}.tar.gz ← BUILD CONTEXT для kaniko
└─► Function CRD: spec.s3Key = "contexts/..."
└─► контроллер → kaniko Job → Docker image
```
Для web-консоли: `GET /source` читает `functions/{ns}/{name}/{ts}.zip` напрямую.
## Изоляция пользователей — Namespace per user
Каждый пользователь облака получает **отдельный k8s namespace**.
```
JWT токен (Bearer)
└─► JWT.sub (строка "0199e325-1cdf-7cda-9319-e5302a85e291")
└─► SHA256(sub) → первые 8 байт → hex → "sless-{16 hex символов}"
└─► namespace = "sless-cdd874dfa31ba6ca"
```
- Namespace детерминирован: один sub → всегда один namespace.
- sub не раскрывается в имени namespace (SHA256 необратим).
- Длина 22 символа — укладывается в лимит k8s (63).
**Кто создаёт namespace:**
Terraform провайдер при Configure() вызывает POST /v1/namespaces/{ns}/ensure
**один раз**, до любых ресурсных операций.
Resource-хендлеры (Function, Trigger, Job) namespace **не создают** — это не их ответственность.
## Аутентификация
### Оператор (REST API)
- Bearer JWT в заголовке Authorization
- Проверяется структура JWT (3 части), наличие sub claim, срок действия exp
- Подпись **не проверяется** — trusted perimeter (оператор за Ingress)
### Terraform Provider (при Configure)
1. Декодирует JWT → sub
2. Вычисляет namespace через SHA256
3. Если задан nubes_endpoint — пингует nubes API (GET <nubes_endpoint>) с тем же токеном
- HTTP 401/403 → ошибка инициализации провайдера
- Недоступен → ошибка инициализации
4. Вызывает POST /v1/namespaces/{ns}/ensure (создаёт namespace если нет)
## Схема вызова
```
Пользователь (curl / браузер)
|
v GET|POST|... /fn/{namespace}/{name}/*
sless-api Ingress -> Operator /fn/ прокси
|
v HTTP forward -> http://{name}.{namespace}.svc.cluster.local:8080
k8s Service -> Deployment/Pod функции
```
```
terraform apply
|
v provider Configure()
1. JWT -> sub -> namespace
2. PingNubesAPI (валидация токена)
3. POST /v1/namespaces/{ns}/ensure <- создаёт k8s namespace
|
+-> POST /v1/namespaces/{ns}/functions <- создаёт Function CRD
| +-> POST /upload (zip) <- загружает код -> S3 -> kaniko Job
| +-> polling phase=Ready
|
+-> POST /v1/namespaces/{ns}/triggers <- создаёт Trigger CRD
| +-> controller: Deployment + Service + (CronJob для cron)
|
+-> POST /v1/namespaces/{ns}/jobs <- создаёт FunctionJob CRD
+-> controller: k8s Job -> result в status
```
## Структура кода
```
sless/
|-- main.go точка входа: k8s manager + REST API сервер (goroutine)
|-- internal/
| |-- api/
| | |-- router.go gorilla/mux: /fn/ (публичный), /v1/ (auth + middleware)
| | |-- handler/
| | | |-- handler.go Handler struct + helpers (writeJSON, namespace(), pathVar())
| | | |-- namespace.go EnsureNamespace (POST /v1/namespaces/{ns}/ensure)
| | | |-- functions.go CRUD Function
| | | |-- triggers.go CRUD Trigger
| | | |-- jobs.go CRUD FunctionJob
| | | |-- upload.go zip -> Dockerfile -> tar.gz -> S3 -> CRD patch
| | | |-- invoke.go прокси /fn/{ns}/{name} -> in-cluster DNS
| | | +-- invocations.go 501 stub (реализация отложена)
| | +-- middleware/
| | |-- auth.go JWT validation (struct + sub + exp, подпись не проверяется)
| | +-- logging.go slog request logger
| |-- builder/
| | |-- builder.go kaniko Job lifecycle (Build, JobStatus, Cleanup)
| | +-- context.go PrepareContext: zip+runtime → tar.gz+Dockerfile для kaniko
| |-- config/config.go Load() из env vars
| +-- storage/
| |-- postgres/store.go SaveInvocation, ListInvocations, RunMigrations
| +-- s3/client.go Upload, Download, UploadContext (tar.gz для kaniko)
|-- controllers/
| |-- function_controller.go Reconcile: Pending->Building->Ready/Failed + Deployment
| |-- trigger_controller.go Reconcile: Service+Ingress (http) / CronJob (cron)
| +-- functionjob_controller.go Reconcile: k8s Job -> Succeeded/Failed + output capture
|-- api/v1alpha1/
| |-- function_types.go Function CRD
| |-- trigger_types.go Trigger CRD
| +-- job_types.go FunctionJob CRD
|-- deployments/k8s/
| |-- operator.yaml Deployment + Service + Ingress
| +-- rbac.yaml ClusterRole + ClusterRoleBinding + ServiceAccount
|-- terraform/provider/ независимый Go-модуль
| +-- internal/
| |-- client/client.go SubFromJWT, NamespaceFromSub, PingNubesAPI + CRUD
| |-- provider/provider.go Configure(): JWT->NS->ping->EnsureNamespace
| +-- resources/
| |-- function_resource.go sless_function
| |-- trigger_resource.go sless_trigger
| +-- job_resource.go sless_job
+-- runtimes/
|-- python3.11/ server.py + Dockerfile -> naeel/sless-runtime-python3.11:v0.1.1
+-- nodejs20/ server.js + Dockerfile -> naeel/sless-runtime-nodejs20:v0.1.2
```
## Kubernetes кластер
Сейчас используется существующий кластер (временный).
Планируется переезд на новый кластер — манифесты переносятся без изменений.
Ноды:
- wheel-control-plane-fm9sr — control-plane
- wheel-workers-tv4qr-r45xs — worker
- wheel-workers-tv4qr-x8xw7 — worker
Ingress: nginx, external IP 5.172.178.182
API endpoint: https://sless-api.kube5s.ru
## Версии в production
| Артефакт | Тег/Версия |
|---------|-----------|
| naeel/sless-operator | v0.1.22 |
| terra.k8c.ru/naeel/sless провайдер | v0.1.13 |
| naeel/sless-runtime-python3.11 | v0.1.1 |
| naeel/sless-runtime-nodejs20 | v0.1.2 |
+34 -967
View File
File diff suppressed because it is too large Load Diff
+18 -18
View File
@@ -9,12 +9,12 @@
- `terraform apply` — TLS timeout при скачивании провайдера
- HTTP-запросы к `sless-api.kube5s.ru` — иногда падают
**Решение:** удалённая машина `5.172.178.213` имеет **прямой выход в интернет без VPN**.
**Решение:** удалённая машина `192.168.1.220` имеет **прямой выход в интернет без VPN**.
Все долгие операции нужно запускать **там через SSH**, а не локально.
Агент Copilot делает это автоматически: пишет команду через `ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519`, читает вывод/логи.
Агент Copilot делает это автоматически: пишет команду через `sshpass ssh`, читает вывод/логи.
### Что запускаем на удалённой машине (5.172.178.213):
### Что запускаем на удалённой машине (192.168.1.220):
- `terraform init / apply / destroy` — все E2E и стресс-тесты
- `git pull / push`
- `docker build / push`
@@ -29,17 +29,17 @@
### Шаблон: запустить команду на удалённой машине
```bash
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no naeel@5.172.178.213 '<команда>'
sshpass -p 'p' ssh -o StrictHostKeyChecking=no naeel@192.168.1.220 '<команда>'
```
### Шаблон: запустить долгий скрипт в фоне и смотреть лог
```bash
# Запуск в фоне:
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no naeel@5.172.178.213 \
'cd /home/naeel/terra/sless && nohup bash run_stress_test.sh > /tmp/stress.log 2>&1 & echo PID=$!'
sshpass -p 'p' ssh -o StrictHostKeyChecking=no naeel@192.168.1.220 \
'cd /home/naeel/dev/sless && nohup bash run_stress_test.sh > /tmp/stress.log 2>&1 & echo PID=$!'
# Следить за логом:
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no naeel@5.172.178.213 'tail -30 /tmp/stress.log'
sshpass -p 'p' ssh -o StrictHostKeyChecking=no naeel@192.168.1.220 'tail -30 /tmp/stress.log'
```
---
@@ -50,14 +50,14 @@ ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no naeel@5.
- Если нужен неинтерактивный ввод пароля, установите `sshpass`.
**Реквизиты удалённой машины:**
- Host: `5.172.178.213`
- Host: `192.168.1.220`
- User: `naeel`
- SSH ключ: `/home/naeel/.ssh/naeel_vm_id_ed25519`
- Repo path: `/home/naeel/terra/sless`
- Password: `p`
- Repo path: `/home/naeel/dev/sless`
Пример подключения:
```bash
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no naeel@5.172.178.213 'echo OK'
sshpass -p 'p' ssh -o StrictHostKeyChecking=no naeel@192.168.1.220 'echo OK'
```
2) Скрипты (подготовленные в репо)
@@ -70,14 +70,14 @@ ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no naeel@5.
Если `sshpass` установлен, запустить локально и направить вывод в файл на локальной машине:
```bash
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no naeel@5.172.178.213 'bash -s' < .tmp/ssh_diag.sh > /tmp/ssh_diag_output.txt 2>&1
scp -i /home/naeel/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no naeel@5.172.178.213:/tmp/ssh_diag_output.txt ./
sshpass -p 'p' ssh -o StrictHostKeyChecking=no naeel@192.168.1.220 'bash -s' < .tmp/ssh_diag.sh > /tmp/ssh_diag_output.txt 2>&1
scp -o StrictHostKeyChecking=no naeel@192.168.1.220:/tmp/ssh_diag_output.txt ./
```
Или интерактивно:
Или интерактивно (ввести пароль вручную):
```bash
ssh -i /home/naeel/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no naeel@5.172.178.213 'bash -s' < .tmp/ssh_diag.sh
ssh -o StrictHostKeyChecking=no naeel@192.168.1.220 'bash -s' < .tmp/ssh_diag.sh
```
4) Сбор системных логов вручную (на хосте)
@@ -109,9 +109,9 @@ cat /tmp/pearlharbor_bg.log > /tmp/pearlharbor_bg.log.copy || true
5) Забрать логи на локальную машину
```bash
scp -i /home/naeel/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213:/tmp/ssh_journal.log ./
scp -i /home/naeel/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213:/tmp/auth.log ./
scp -i /home/naeel/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213:/tmp/docker_ps.txt ./
scp naeel@192.168.1.220:/tmp/ssh_journal.log ./
scp naeel@192.168.1.220:/tmp/auth.log ./
scp naeel@192.168.1.220:/tmp/docker_ps.txt ./
```
6) Запуск `test_pearlharbor_push.sh` (мультипуш тест)
+96
View File
@@ -0,0 +1,96 @@
# Инструкции: монтирование удалённой папки через SSHFS
Дата: 2026-03-12
Кратко: эти команды повторяют текущее у вас подключение, где
источник: `naeel@5.172.178.213:/home/naeel/terra`, и точка монтирования — `/home/<user>/remote_dev`.
1) Установка `sshfs` (Debian/Ubuntu):
```bash
sudo apt update
sudo apt install -y sshfs
```
2) Подготовка приватного ключа:
- Скопируйте приватный ключ на целевую машину или загрузите его безопасным способом.
- Пример копирования с локальной машины на целевой хост:
```bash
scp /home/naeel/remote_dev/sless/secrets/naeel_vm_id_ed25519 user@target:/home/user/.ssh/id_ed25519_sless
ssh user@target 'chmod 600 /home/user/.ssh/id_ed25519_sless'
```
(Оригинал ключа в репозитории: `secrets/naeel_vm_id_ed25519`)
3) Создать точку монтирования на целевом хосте:
```bash
mkdir -p /home/user/remote_dev
chown user:user /home/user/remote_dev
```
4) Команда монтирования (пример, повторяет ваше текущее подключение):
```bash
sshfs -o IdentityFile=/home/user/.ssh/id_ed25519_sless \
-o StrictHostKeyChecking=no \
-o UserKnownHostsFile=/dev/null \
-o reconnect \
-o ServerAliveInterval=15 \
-o ServerAliveCountMax=3 \
naeel@5.172.178.213:/home/naeel/terra /home/user/remote_dev
```
5) Проверка статуса монтирования и содержимого:
```bash
findmnt /home/user/remote_dev
ls -la /home/user/remote_dev
```
6) Отключение:
```bash
fusermount -u /home/user/remote_dev
```
7) (Опционально) systemd unit для автоподключения при старте:
Создайте файл `/etc/systemd/system/remote_dev.mount` со следующим содержимым (отредактируйте путь к ключу и `Where`):
```ini
[Unit]
Description=SSHFS mount for /home/user/remote_dev
After=network-online.target
Wants=network-online.target
[Mount]
What=naeel@5.172.178.213:/home/naeel/terra
Where=/home/user/remote_dev
Type=fuse.sshfs
Options=IdentityFile=/home/user/.ssh/id_ed25519_sless,allow_other,reconnect,ServerAliveInterval=15,ServerAliveCountMax=3,StrictHostKeyChecking=no,UserKnownHostsFile=/dev/null
[Install]
WantedBy=multi-user.target
```
Затем выполнить:
```bash
sudo systemctl daemon-reload
sudo systemctl enable --now remote_dev.mount
```
8) Заметки по безопасности и надёжности:
- Храните приватный ключ с правами `600` и ограниченным доступом.
- Рассмотрите использование `ssh-agent` вместо копирования ключа.
- Опция `StrictHostKeyChecking=no` ослабляет проверку host key — используйте осознанно.
- Для массовой настройки можете создать скрипт установки и unit-файл через Ansible/Cloud-init.
---
Файл создан автоматически по запросу пользователя. Если хотите, могу:
- добавить инструкции для `macOS` или `CentOS`/`RHEL`;
- создать такой же unit-файл и загрузить его на целевой хост (при доступе по SSH).
+1 -1
View File
@@ -16,7 +16,7 @@ crash.log
# Provider plugins / caches
.terraform.d/
*.tfvars
#*.tfvars
# Archives and build artifacts
*.zip
-100
View File
@@ -1,100 +0,0 @@
# POSTGRES — Пример: Serverless-функции с Managed PostgreSQL
Демонстрирует интеграцию sless (serverless functions) с управляемым PostgreSQL (nubes_postgres).
## Что делает этот пример
1. **Создаёт Managed PostgreSQL** через Terraform (nubes_postgres + nubes_postgres_user + nubes_postgres_database)
2. **Инициализирует БД**: одноразовый `sless_job` создаёт таблицу `terraform_demo_table`
3. **Запускает 3 HTTP-сервиса**:
- `pg-info` (Node.js 20) — версия PostgreSQL-сервера + количество строк в таблице
- `pg-table-reader` (Python 3.11) — чтение всех строк из таблицы
- `pg-table-writer` (Python 3.11) — добавление новой строки
## Структура файлов
```
POSTGRES/
├── main.tf # terraform + провайдеры (sless, nubes_cloud)
├── postgres.tf # Managed PostgreSQL: DB, пользователь, locals с credentials
├── resources.tf # Namespace и сетевые ресурсы
├── functions.tf # sless_job (init) + 3 x sless_service
├── terraform.tfvars # Переменные: realm, s3_uid, token
├── stress_test.sh # Стресс-тест функций (не трогает PG lifecycle)
├── stress_destroy_apply.sh.disabled # ОТКЛЮЧЁН — стресс-тест PG lifecycle
├── code/
│ ├── sql-runner/ # Python: одноразовое выполнение SQL (CREATE TABLE)
│ ├── pg-info/ # Node.js: версия PG + строки
│ ├── table-rw/ # Python: list_rows + add_row
│ ├── pg-stats/ # Python: расширенная статистика PG
│ ├── funcs-list/ # Утилита: листинг функций
│ └── stress-*/ # Функции для стресс-тестирования
└── scripts/ # Вспомогательные скрипты
```
## Как запустить
### Предварительные требования
- Terraform >= 1.3
- Токен sless: `SLESS_TOKEN` (или в `terraform.tfvars`)
- Токен nubes_cloud: `NUBES_TOKEN`
- Доступ к realm (например, `ffd1f598c169b0ae`)
### Запуск
```bash
# 1. Инициализация
terraform init
# 2. Проверка плана
terraform plan
# 3. Применение (создаст PG + сервисы, запустит init job)
terraform apply
```
> Первый `apply` может занять 10–15 минут: создание PG-инстанса + kaniko-сборка образов.
### Переменные (`terraform.tfvars`)
```hcl
realm = "ffd1f598c169b0ae" # Реалм (namespace в sless)
s3_uid = "s01234" # S3 bucket для nubes_postgres бэкапов
sless_token = "..." # Bearer-токен для sless API
nubes_token = "..." # Bearer-токен для nubes_cloud API
```
### Вывод после apply
```
Outputs:
table_reader_url = "https://sless.kube5s.ru/v1/namespaces/.../services/pg-table-reader/invoke"
table_writer_url = "https://sless.kube5s.ru/v1/namespaces/.../services/pg-table-writer/invoke"
```
### Вызов функций
```bash
# Информация о PG (Node.js)
curl https://.../services/pg-info/invoke
# Список строк таблицы (Python)
curl https://.../services/pg-table-reader/invoke
# Добавить строку (Python)
curl -X POST https://.../services/pg-table-writer/invoke \
-H "Content-Type: application/json" \
-d '{"title": "Hello from sless!"}'
```
## Стресс-тест
`stress_test.sh` — нагружает функции HTTP-запросами. Запускать после `terraform apply`:
```bash
./stress_test.sh
```
> `stress_destroy_apply.sh.disabled` — ранний тест PG lifecycle (destroy+apply цикл).
> **Отключён** из-за проблем с удалением postgres_user в определённых сценариях.
-650
View File
@@ -1,650 +0,0 @@
#!/usr/bin/env bash
# 2026-03-21 — bug_hunter.sh: охота за багами во всех POSTGRES-функциях.
# Цель: найти bugs типа "ложный 200", "должен 500 но 200", неверные данные.
# Логика принципиально отличается от chaos_marathon — здесь акцент на семантике и data integrity.
# Запускать ТОЛЬКО на VM через SSH.
set -euo pipefail
BASE_URL="${BASE_URL:-https://sless.kube5s.ru}"
NAMESPACE="${NAMESPACE:-sless-ffd1f598c169b0ae}"
TOKEN_FILE="${TOKEN_FILE:-$HOME/terra/sless/test.token}"
TOKEN=$(cat "$TOKEN_FILE")
RED="\033[0;31m"; GREEN="\033[0;32m"; YELLOW="\033[1;33m"; CYAN="\033[0;36m"; NC="\033[0m"
PASS=0; FAIL=0; TOTAL=0
BUGS_FOUND=()
ts() { date '+%H:%M:%S'; }
# ── Хелперы ──────────────────────────────────────────────────────────────────
raw() {
local svc="$1" payload="$2"
curl -sf -X POST -H "Content-Type: application/json" \
-d "$payload" "${BASE_URL}/fn/${NAMESPACE}/${svc}" 2>/dev/null || echo "__CURL_FAIL__"
}
http_code() {
local svc="$1" payload="$2"
curl -s -o /dev/null -w "%{http_code}" -X POST -H "Content-Type: application/json" \
-d "$payload" "${BASE_URL}/fn/${NAMESPACE}/${svc}" 2>/dev/null || echo "000"
}
# Проверяем что HTTP-код РАВЕН ожидаемому
check_http() {
local label="$1" got="$2" want="$3"
TOTAL=$((TOTAL+1))
if [[ "$got" == "$want" ]]; then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] $label"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] $label (got HTTP $got, want HTTP $want)"
FAIL=$((FAIL+1))
BUGS_FOUND+=("$label → HTTP $got$want")
fi
}
# Проверяем что JSON содержит строку
check_has() {
local label="$1" body="$2" substr="$3"
TOTAL=$((TOTAL+1))
if echo "$body" | grep -q "$substr" 2>/dev/null; then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] $label"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] $label (key/substr '$substr' not found in: ${body:0:120})"
FAIL=$((FAIL+1))
BUGS_FOUND+=("$label → '$substr' not in response")
fi
}
# Проверяем что JSON НЕ содержит строку
check_not() {
local label="$1" body="$2" substr="$3"
TOTAL=$((TOTAL+1))
if echo "$body" | grep -q "$substr" 2>/dev/null; then
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] $label (found '$substr' but should NOT be there: ${body:0:120})"
FAIL=$((FAIL+1))
BUGS_FOUND+=("$label → '$substr' should NOT be in response")
else
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] $label"
PASS=$((PASS+1))
fi
}
# Проверяем числовое равенство: jq вытаскивает значение и сравниваем
check_val() {
local label="$1" body="$2" jq_expr="$3" want="$4"
local got
got=$(echo "$body" | python3 -c "
import json,sys
try:
d=json.load(sys.stdin)
expr='$jq_expr'.lstrip('.')
parts=expr.split('.')
val=d
for p in parts:
val=val[p] if isinstance(val,dict) else val[int(p)]
print(val)
except Exception as e:
print('__ERR__:'+str(e))
" 2>/dev/null || echo "__ERR__")
TOTAL=$((TOTAL+1))
if [[ "$got" == "$want" ]]; then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] $label"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] $label (got '$got', want '$want')"
FAIL=$((FAIL+1))
BUGS_FOUND+=("$label → got '$got' want '$want'")
fi
}
# Проверяем что числовое значение >= порога
check_gte() {
local label="$1" got="$2" min_val="$3"
TOTAL=$((TOTAL+1))
if [[ "$got" =~ ^[0-9]+$ ]] && (( got >= min_val )); then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] $label (got $got >= $min_val)"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] $label (got '$got', want >= $min_val)"
FAIL=$((FAIL+1))
BUGS_FOUND+=("$label$got < $min_val")
fi
}
section() {
echo ""
echo -e "${CYAN}════════════════════════════════════════════════════════════${NC}"
echo -e "${CYAN} $1${NC}"
echo -e "${CYAN}════════════════════════════════════════════════════════════${NC}"
}
echo -e "${YELLOW}"
echo "╔══════════════════════════════════════════════════════════╗"
echo "║ BUG HUNTER — $(date '+%Y-%m-%d %H:%M:%S')"
echo "║ Ищем: ложные 200, неверные данные, скрытые баги ║"
echo "╚══════════════════════════════════════════════════════════╝"
echo -e "${NC}"
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 1 — Тест на Missing Input Validation (должно быть 200, НО БУДЕТ 500 если баг есть)"
# ═══════════════════════════════════════════════════════════════════════════════
echo " Каждая функция должна СТОЙКО обрабатывать строку вместо числа."
echo " Если возвращает 500 — это BUG: не хватает try/except."
c=$(http_code "chaos-slowquery" '{"sleep_sec": "не_число"}')
check_http "BUG1: chaos-slowquery sleep_sec=string → должен 200" "$c" "200"
c=$(http_code "chaos-bigpayload" '{"size_kb": "не_число"}')
check_http "BUG2: chaos-bigpayload size_kb=string → должен 200" "$c" "200"
c=$(http_code "py-retry-writer" '{"n": "не_число"}')
check_http "BUG3: py-retry-writer n=string → должен 200" "$c" "200"
c=$(http_code "pg-delete-old" '{"older_than_min": "не_число"}')
check_http "BUG4: pg-delete-old older_than_min=string → должен 200" "$c" "200"
c=$(http_code "chaos-slowquery" '{"sleep_sec": null}')
check_http "BUG5: chaos-slowquery sleep_sec=null → должен 200" "$c" "200"
c=$(http_code "chaos-bigpayload" '{"size_kb": null}')
check_http "BUG6: chaos-bigpayload size_kb=null → должен 200" "$c" "200"
c=$(http_code "chaos-bigpayload" '{"size_kb": -999}')
check_http "BUG7: chaos-bigpayload size_kb=-999 (negative) → должен 200" "$c" "200"
c=$(http_code "chaos-slowquery" '{"sleep_sec": -5}')
check_http "BUG8: chaos-slowquery sleep_sec=-5 → должен 200" "$c" "200"
c=$(http_code "chaos-slowquery" '{"sleep_sec": 99999}')
check_http "BUG9: chaos-slowquery sleep_sec=99999 (huge) → должен 200" "$c" "200"
c=$(http_code "py-retry-writer" '{"n": -1}')
check_http "BUG10: py-retry-writer n=-1 (negative) → должен 200" "$c" "200"
c=$(http_code "py-retry-writer" '{"n": 99999}')
check_http "BUG11: py-retry-writer n=99999 (huge, capped) → должен 200" "$c" "200"
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 2 — Data Integrity: реальное значение vs ожидаемое"
# ═══════════════════════════════════════════════════════════════════════════════
# js-pg-batch: n=0 должен вернуть inserted=0, а не 20 (баг: 0||20=20)
r=$(raw "js-pg-batch" '{"n": 0, "prefix": "bughunt-zero"}')
check_val "BUG12: js-pg-batch n=0 → inserted должен быть 0" "$r" ".inserted" "0"
# js-pg-batch: n=1 → ровно 1 строка
r=$(raw "js-pg-batch" '{"n": 1, "prefix": "bughunt-one"}')
check_val "SAFE: js-pg-batch n=1 → inserted=1" "$r" ".inserted" "1"
# js-pg-batch: n=200 (cap) → не больше 200
r=$(raw "js-pg-batch" '{"n": 9999, "prefix": "bughunt-cap"}')
i=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin)['inserted'])" 2>/dev/null || echo "-1")
check_gte "SAFE: js-pg-batch n=9999 → capped (inserted > 0)" "$i" 1
# inserted должно быть <= 200
TOTAL=$((TOTAL+1))
if (( i <= 200 )); then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: js-pg-batch n=9999 → capped <= 200 (got $i)"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] BUG: js-pg-batch n=9999 → вставил $i строк (ожидали <= 200)"
FAIL=$((FAIL+1))
BUGS_FOUND+=("js-pg-batch n=9999 → inserted=$i > 200")
fi
# pg-bulk-insert: точное соответствие n → inserted
for n_val in 1 10 100 499 500; do
r=$(raw "pg-bulk-insert" "{\"n\": $n_val, \"prefix\": \"bughunt-n$n_val\"}")
check_val "SAFE: pg-bulk-insert n=$n_val → inserted=$n_val" "$r" ".inserted" "$n_val"
done
# py-retry-writer с simulate_error: должен вернуть ok:true (retry работает)
r=$(raw "py-retry-writer" '{"n": 5, "simulate_error": true, "prefix": "bughunt-retry"}')
check_has "SAFE: py-retry-writer simulate_error=true → ok:true" "$r" '"ok": true'
attempts=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('attempts',0))" 2>/dev/null || echo "0")
check_gte "SAFE: py-retry-writer simulate_error=true → attempts >= 2" "$attempts" 2
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 3 — Semantic / Logic Bugs (ложный 200, неверные данные)"
# ═══════════════════════════════════════════════════════════════════════════════
# BUG: pg-search с "_" в query — _ это LIKE wildcard, не экранируется.
# Вставляем уникальную строку без подчёркивания, ищем с _ → не должна найтись.
UNIQUE_NOUNDERSCORE="bughunt-no-underscore-$(date +%s%N)"
raw "pg-bulk-insert" "{\"n\": 1, \"prefix\": \"$UNIQUE_NOUNDERSCORE\"}" >/dev/null
# Поиск exact строки — должна найтись
r=$(raw "pg-search" "{\"query\": \"$UNIQUE_NOUNDERSCORE\", \"limit\": 10}")
cnt=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('count',0))" 2>/dev/null || echo "0")
check_gte "SAFE: pg-search exact match найдена" "$cnt" 1
# Теперь создаём строку с дефисом в mid позиции: "aXb" где X — любой char.
# Ищем с _ (wildcard): "a_b" должно совпадать. Это НЕ баг если мы ищем wildcard.
# Реальный баг: ESCAPE не поддерживается, пользователь не может искать literal "_".
# Проверяем: строка "test-literal-underscore_here" ищем по query="literal_underscore_here"
# Без экраниравания: _ = любой символ → совпадёт AND с "literaXunderscoreYhere" тоже.
EXACT_TITLE="bughunt-exact-$(date +%s%N)"
raw "pg-upsert" "{\"title\": \"${EXACT_TITLE}\"}" >/dev/null
# Поиск с подчёркиванием вместо дефиса в этой строке — совпадать НЕ должно с точным матчем
# но совпадёт из-за ILIKE wildcard `_`
UNDER_QUERY="${EXACT_TITLE//-/_}" # заменяем дефисы на подчёркивания
r=$(raw "pg-search" "{\"query\": \"$UNDER_QUERY\", \"limit\": 100}")
underscore_count=$(echo "$r" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('count',0))" 2>/dev/null || echo "0")
# Если count >> 1, значит _ матчит что попало (wildcard)
echo " pg-search с query='${UNDER_QUERY:0:30}...' вернул $underscore_count строк (если > 1 — это баг wildcard)"
TOTAL=$((TOTAL+1))
# Должен найти ТОЛЬКО нашу строку (count=1), но без экранирования найдёт много
if (( underscore_count == 1 )); then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: pg-search underscore matches only exact row"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] BUG13: pg-search '_' is unescaped LIKE wildcard → matches $underscore_count rows instead of 1"
FAIL=$((FAIL+1))
BUGS_FOUND+=("pg-search: '_' is unescaped LIKE wildcard (got $underscore_count rows)")
fi
# BUG: pg-delete-old — параметр НАЗЫВАЕТСЯ older_than_min, но в chaos_marathon шлём older_than_minutes.
# Шлём неправильный ключ и правильный — результаты должны различаться.
# older_than_minutes=1 → функция игнорирует, использует default (60 мин) → ничего не удалится из только что вставленных
# older_than_min=0 → capped to 1 → удалит строки старше 1 мин (ну, только что вставленные > 1 мин назад)
# Проверяем: older_than_minutes=0 → использует default 60 → параметр проигнорирован → bug
# Вставляем свежую строку, пытаемся удалить с older_than_minutes=0 (неверный ключ)
FRESH_TITLE="bughunt-del-$(date +%s%N)"
ins_r=$(raw "pg-bulk-insert" "{\"n\": 3, \"prefix\": \"$FRESH_TITLE\"}")
# Ждём немного, затем пытаемся удалить по неправильному ключу
sleep 1
r=$(raw "pg-delete-old" "{\"older_than_minutes\": 0}")
deleted_wrong_key=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('deleted',0))" 2>/dev/null || echo "?")
r2=$(raw "pg-delete-old" "{\"older_than_min\": 99999}")
deleted_right_key=$(echo "$r2" | python3 -c "import json,sys; print(json.load(sys.stdin).get('deleted',0))" 2>/dev/null || echo "?")
echo " pg-delete-old older_than_minutes=0: deleted=$deleted_wrong_key (использовался default 60min)"
echo " pg-delete-old older_than_min=99999: deleted=$deleted_right_key (правильный ключ — удалило всё старое)"
# Если с неверным ключом deleted > 0 при очень маленьком значении — значит параметр работает.
# Если с right key deleted больше — это подтверждает что wrong key игнорировался.
TOTAL=$((TOTAL+1))
if [[ "$deleted_right_key" =~ ^[0-9]+$ ]] && (( deleted_right_key >= 0 )); then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] INFO: pg-delete-old right key works (deleted=$deleted_right_key)"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] pg-delete-old right key failed: got $deleted_right_key"
FAIL=$((FAIL+1))
fi
# BUG: pg-counter prefix="%" → LIKE "%%%" → считает все строки (wildcard leak)
r_all=$(raw "pg-counter" '{}')
total_all=$(echo "$r_all" | python3 -c "import json,sys; print(json.load(sys.stdin).get('total',0))" 2>/dev/null || echo "0")
r_pct=$(raw "pg-counter" '{"prefix": "%"}')
total_pct=$(echo "$r_pct" | python3 -c "import json,sys; print(json.load(sys.stdin).get('total',0))" 2>/dev/null || echo "0")
echo " pg-counter prefix='': total=$total_all | pg-counter prefix='%': total=$total_pct"
TOTAL=$((TOTAL+1))
# Если оба возвращают одно число — значит % матчит все строки → баг wildcard
if [[ "$total_all" == "$total_pct" ]] && (( total_all > 0 )); then
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] BUG14: pg-counter prefix='%' counts ALL rows ($total_pct) — % is unescaped LIKE wildcard"
FAIL=$((FAIL+1))
BUGS_FOUND+=("pg-counter: prefix='%' is unescaped LIKE wildcard (same as no prefix)")
else
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: pg-counter prefix='%' gives different count than no-prefix"
PASS=$((PASS+1))
fi
# BUG: pg-search limit=0 — clamp max(1, min(0,100)) = 1, не 0.
# Юзер просит 0 строк но получает 1.
r=$(raw "pg-search" '{"query": "", "limit": 0}')
limit_got=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('limit',0))" 2>/dev/null || echo "-1")
echo " pg-search limit=0 → вернул limit=$limit_got в ответе"
TOTAL=$((TOTAL+1))
if [[ "$limit_got" == "0" ]]; then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: pg-search limit=0 → limit=0 in response"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] INFO15: pg-search limit=0 → silently changed to $limit_got (min clamp = 1, not 0)"
FAIL=$((FAIL+1))
BUGS_FOUND+=("pg-search: limit=0 silently becomes $limit_got (user wants 0 rows, gets $limit_got)")
fi
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 4 — pg-upsert: idempotency + action field correctness"
# ═══════════════════════════════════════════════════════════════════════════════
# Первый вызов → action=inserted
UPSERT_KEY="bughunt-upsert-$(date +%s%N)"
r1=$(raw "pg-upsert" "{\"title\": \"$UPSERT_KEY\"}")
action1=$(echo "$r1" | python3 -c "import json,sys; print(json.load(sys.stdin).get('action','?'))" 2>/dev/null || echo "?")
check_val "SAFE: pg-upsert первый вызов → action=inserted" "$r1" ".action" "inserted"
# Второй вызов → action=updated
r2=$(raw "pg-upsert" "{\"title\": \"$UPSERT_KEY\"}")
action2=$(echo "$r2" | python3 -c "import json,sys; print(json.load(sys.stdin).get('action','?'))" 2>/dev/null || echo "?")
check_val "SAFE: pg-upsert второй вызов (same title) → action=updated" "$r2" ".action" "updated"
# ID должен совпадать
id1=$(echo "$r1" | python3 -c "import json,sys; print(json.load(sys.stdin).get('id','?'))" 2>/dev/null || echo "?1")
id2=$(echo "$r2" | python3 -c "import json,sys; print(json.load(sys.stdin).get('id','?'))" 2>/dev/null || echo "?2")
TOTAL=$((TOTAL+1))
if [[ "$id1" == "$id2" ]] && [[ "$id1" != "?" ]]; then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: pg-upsert same title → same id ($id1)"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] BUG16: pg-upsert same title → different ids ($id1 vs $id2)"
FAIL=$((FAIL+1))
BUGS_FOUND+=("pg-upsert: same title yields different ids ($id1 vs $id2)")
fi
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 5 — js-idempotent: concurrent same key"
# ═══════════════════════════════════════════════════════════════════════════════
# 5 параллельных вызовов с одним ключом → должен быть 1 created, 4 existing
IDEM_KEY="bughunt-idem-concurrent-$(date +%s%N)"
declare -a IDEM_RESULTS=()
for i in 1 2 3 4 5; do
r=$(raw "js-idempotent" "{\"idempotency_key\": \"$IDEM_KEY\"}") &
IDEM_RESULTS+=($!)
done
wait
# Перезапустим последовательно чтобы собрать результаты
actions=()
for i in 1 2 3 4 5; do
r=$(raw "js-idempotent" "{\"idempotency_key\": \"$IDEM_KEY\"}")
a=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('action','?'))" 2>/dev/null || echo "?")
actions+=("$a")
done
created_count=0; existing_count=0
for a in "${actions[@]}"; do
[[ "$a" == "created" ]] && created_count=$((created_count+1))
[[ "$a" == "existing" ]] && existing_count=$((existing_count+1))
done
echo " js-idempotent key же 5× последовательно: created=$created_count, existing=$existing_count"
TOTAL=$((TOTAL+1))
# Первый должен быть created, остальные existing (с учётом что первый вызов в параллельном блоке уже создал)
# Теперь все 5 последовательных должны быть existing
if (( existing_count == 5 )); then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: js-idempotent 5× same key → все existing"
PASS=$((PASS+1))
elif (( created_count == 1 && existing_count == 4 )); then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: js-idempotent 5× same key → 1 created + 4 existing"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] BUG17: js-idempotent same key → created=$created_count existing=$existing_count (ожидали 0-1 created, 4-5 existing)"
FAIL=$((FAIL+1))
BUGS_FOUND+=("js-idempotent: 5× same key → created=$created_count, existing=$existing_count")
fi
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 6 — go-pg-race: workers=0 div-by-zero"
# ═══════════════════════════════════════════════════════════════════════════════
r=$(raw "go-pg-race" '{"workers": 0, "n_per_worker": 5}')
c=$(http_code "go-pg-race" '{"workers": 0, "n_per_worker": 5}')
check_http "SAFE: go-pg-race workers=0 → 200 (не div-by-zero)" "$c" "200"
# ops_per_sec при workers=0 inserted=0 должен быть 0 или Inf — проверяем что не NaN/invalid JSON
TOTAL=$((TOTAL+1))
if echo "$r" | python3 -c "import json,sys; json.load(sys.stdin); print('valid_json')" 2>/dev/null | grep -q valid_json; then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: go-pg-race workers=0 → valid JSON"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] BUG18: go-pg-race workers=0 → invalid JSON (div-by-zero → Inf/NaN)"
FAIL=$((FAIL+1))
BUGS_FOUND+=("go-pg-race: workers=0 → invalid JSON response")
fi
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 7 — Crash functions: параметры управляют crash-ом"
# ═══════════════════════════════════════════════════════════════════════════════
# stress-go-nil: crash=false → 200 (не должен падать)
c=$(http_code "stress-go-nil" '{"crash": false}')
check_http "SAFE: stress-go-nil crash=false → 200" "$c" "200"
# stress-go-nil: crash=true (default) → 500
c=$(http_code "stress-go-nil" '{"crash": true}')
check_http "SAFE: stress-go-nil crash=true → 500" "$c" "500"
# stress-divzero: d=0 → 500
c=$(http_code "stress-divzero" '{"n": 10, "d": 0}')
check_http "SAFE: stress-divzero d=0 → 500" "$c" "500"
# stress-divzero: d=2 → 200
c=$(http_code "stress-divzero" '{"n": 10, "d": 2}')
check_http "SAFE: stress-divzero d=2 → 200" "$c" "200"
r=$(raw "stress-divzero" '{"n": 10, "d": 2}')
check_has "SAFE: stress-divzero d=2 → result in response" "$r" "result"
# stress-bigloop: n=1000000 (большое) → должен вернуть 200
c=$(http_code "stress-bigloop" '{"n": 1000000}')
check_http "SAFE: stress-bigloop n=1000000 → 200" "$c" "200"
# stress-go-fast: n=0 → должен вернуть 200 (factorial(0) = 1)
c=$(http_code "stress-go-fast" '{"n": 0}')
check_http "SAFE: stress-go-fast n=0 → 200" "$c" "200"
# stress-go-fast: n=20 (cap) → factorial(20) не переполнение?
r=$(raw "stress-go-fast" '{"n": 20}')
check_has "SAFE: stress-go-fast n=20 → factorial in response" "$r" "factorial"
# stress-go-fast: n=21 → capped to 20 (проверяем что cap работает)
r=$(raw "stress-go-fast" '{"n": 21}')
n_got=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('n',0))" 2>/dev/null || echo "-1")
TOTAL=$((TOTAL+1))
if (( n_got <= 20 )); then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: stress-go-fast n=21 → capped to $n_got (<= 20)"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] BUG: stress-go-fast n=21 → not capped (n=$n_got)"
FAIL=$((FAIL+1))
BUGS_FOUND+=("stress-go-fast: n=21 not capped (got n=$n_got)")
fi
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 8 — pg-counter: счёт соответствует реально inserted"
# ═══════════════════════════════════════════════════════════════════════════════
PREFIX_TEST="bughunt-count-$(date +%s%N)"
# Получаем текущий счётчик с этим prefix
r_before=$(raw "pg-counter" "{\"prefix\": \"$PREFIX_TEST\"}")
cnt_before=$(echo "$r_before" | python3 -c "import json,sys; print(json.load(sys.stdin).get('total',0))" 2>/dev/null || echo "0")
# Вставляем ровно 7 строк
raw "pg-bulk-insert" "{\"n\": 7, \"prefix\": \"$PREFIX_TEST\"}" >/dev/null
# Считаем снова
r_after=$(raw "pg-counter" "{\"prefix\": \"$PREFIX_TEST\"}")
cnt_after=$(echo "$r_after" | python3 -c "import json,sys; print(json.load(sys.stdin).get('total',0))" 2>/dev/null || echo "0")
inserted_delta=$(( cnt_after - cnt_before ))
echo " pg-counter prefix='$PREFIX_TEST': before=$cnt_before, after=$cnt_after, delta=$inserted_delta (ожидаем 7)"
TOTAL=$((TOTAL+1))
if (( inserted_delta == 7 )); then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: pg-counter правильно считает: delta=$inserted_delta"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] BUG19: pg-counter delta=$inserted_delta ≠ 7 (prefix wildcard или баг в счёте)"
FAIL=$((FAIL+1))
BUGS_FOUND+=("pg-counter: inserted 7, delta=$inserted_delta")
fi
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 9 — pg-search: pagination correctness"
# ═══════════════════════════════════════════════════════════════════════════════
PREFIX_SEARCH="bughunt-search-$(date +%s%N)"
# Вставляем ровно 25 строк
raw "pg-bulk-insert" "{\"n\": 25, \"prefix\": \"$PREFIX_SEARCH\"}" >/dev/null
sleep 0.5
# Page 1: offset=0 limit=10 → count=10
r=$(raw "pg-search" "{\"query\": \"$PREFIX_SEARCH\", \"limit\": 10, \"offset\": 0}")
count_p1=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('count',0))" 2>/dev/null || echo "-1")
total_p1=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('total',0))" 2>/dev/null || echo "-1")
check_val "SAFE: pg-search page1 count=10" "$r" ".count" "10"
check_gte "SAFE: pg-search total >= 25" "$total_p1" 25
# Page 3: offset=20 limit=10 → count=5 (строк 21-25)
r=$(raw "pg-search" "{\"query\": \"$PREFIX_SEARCH\", \"limit\": 10, \"offset\": 20}")
count_p3=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('count',0))" 2>/dev/null || echo "-1")
echo " pg-search page3 (offset=20, limit=10): count=$count_p3 (ожидаем 5)"
TOTAL=$((TOTAL+1))
# Учитываем что могут быть другие строки с этим prefix
if [[ "$count_p3" =~ ^[0-9]+$ ]] && (( count_p3 > 0 && count_p3 <= 10 )); then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: pg-search page3 count=$count_p3 (допустимо)"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] BUG20: pg-search page3 count=$count_p3 (expected 1-10)"
FAIL=$((FAIL+1))
BUGS_FOUND+=("pg-search: page3 count=$count_p3 out of range")
fi
# offset > total → count=0
r=$(raw "pg-search" "{\"query\": \"$PREFIX_SEARCH\", \"limit\": 10, \"offset\": 999999}")
count_over=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('count',0))" 2>/dev/null || echo "-1")
check_val "SAFE: pg-search offset>total → count=0" "$r" ".count" "0"
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 10 — pg-dedup: idempotency (повторный вызов безопасен)"
# ═══════════════════════════════════════════════════════════════════════════════
# Сначала удаляем все дубли
raw "pg-dedup" '{"dry_run": false}' >/dev/null
# dry_run=true → deleted всегда = 0
r=$(raw "pg-dedup" '{"dry_run": true}')
check_val "SAFE: pg-dedup dry_run=true → deleted=0" "$r" ".deleted" "0"
# Создаём дублей: вставляем одно и то же через bulk (уникальные title), затем уpsert одно и то же
DUP_TITLE="bughunt-dup-$(date +%s%N)"
raw "pg-upsert" "{\"title\": \"${DUP_TITLE}\"}" >/dev/null
# INSERT прямой дубль через bulk — но у него нет механизма вставки дублей...
# Используем pg-counter + pg-search чтобы найти дубли что уже есть от других тестов
r=$(raw "pg-dedup" '{"dry_run": true}')
dupes=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('duplicates_found',0))" 2>/dev/null || echo "0")
echo " pg-dedup dry_run: duplicates_found=$dupes"
# Запускаем dedup дважды — второй раз должен найти 0 дублей
raw "pg-dedup" '{"dry_run": false}' >/dev/null
r2=$(raw "pg-dedup" '{"dry_run": false}')
dupes2=$(echo "$r2" | python3 -c "import json,sys; print(json.load(sys.stdin).get('duplicates_found',0))" 2>/dev/null || echo "0")
TOTAL=$((TOTAL+1))
if [[ "$dupes2" == "0" ]]; then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: pg-dedup повторный вызов → duplicates_found=0 (идемпотентен)"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] BUG21: pg-dedup повторный вызов → duplicates_found=$dupes2 ≠ 0"
FAIL=$((FAIL+1))
BUGS_FOUND+=("pg-dedup: не идемпотентен — второй вызов нашёл $dupes2 дублей")
fi
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 11 — chaos-echo: крайние случаи"
# ═══════════════════════════════════════════════════════════════════════════════
# Пустой JSON {} → echo должен вернуть echo:{}, keys:[], size_bytes:2
r=$(raw "chaos-echo" '{}')
check_has "SAFE: chaos-echo {} → echo in response" "$r" '"echo"'
check_val "SAFE: chaos-echo {} → keys=[](empty_list len=0)" "$r" ".size_bytes" "2"
# Очень глубоко вложенный JSON
r=$(raw "chaos-echo" '{"a": {"b": {"c": {"d": {"e": "deep"}}}}}')
c=$(http_code "chaos-echo" '{"a": {"b": {"c": {"d": {"e": "deep"}}}}}')
check_http "SAFE: chaos-echo deeply nested → 200" "$c" "200"
# Массив вместо объекта (некоторые функции падают)
c=$(http_code "chaos-echo" '[1, 2, 3]')
check_http "SAFE: chaos-echo array input → 200" "$c" "200"
# Булево значение вместо объекта
c=$(http_code "chaos-echo" 'true')
check_http "SAFE: chaos-echo true input → 200" "$c" "200"
# Число вместо объекта
c=$(http_code "chaos-echo" '42')
check_http "SAFE: chaos-echo number input → 200" "$c" "200"
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 12 — go-counter-atomic: invocation_n растёт"
# ═══════════════════════════════════════════════════════════════════════════════
r1=$(raw "go-counter-atomic" '{}')
n1=$(echo "$r1" | python3 -c "import json,sys; print(json.load(sys.stdin).get('invocation_n','?'))" 2>/dev/null || echo "?")
r2=$(raw "go-counter-atomic" '{}')
n2=$(echo "$r2" | python3 -c "import json,sys; print(json.load(sys.stdin).get('invocation_n','?'))" 2>/dev/null || echo "?")
echo " go-counter-atomic: call1 invocation_n=$n1, call2 invocation_n=$n2"
TOTAL=$((TOTAL+1))
if [[ "$n1" =~ ^[0-9]+$ ]] && [[ "$n2" =~ ^[0-9]+$ ]] && (( n2 > n1 )); then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: go-counter-atomic invocation_n растёт ($n1$n2)"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] BUG22: go-counter-atomic invocation_n НЕ растёт ($n1$n2)"
FAIL=$((FAIL+1))
BUGS_FOUND+=("go-counter-atomic: invocation_n не растёт ($n1$n2)")
fi
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 13 — go-pg-race: все inserted = workers × n_per_worker"
# ═══════════════════════════════════════════════════════════════════════════════
r=$(raw "go-pg-race" '{"workers": 4, "n_per_worker": 10}')
ins=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('inserted',0))" 2>/dev/null || echo "0")
errs=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('errors',0))" 2>/dev/null || echo "-1")
echo " go-pg-race workers=4 n_per_worker=10: inserted=$ins, errors=$errs (ожидаем inserted=40, errors=0)"
TOTAL=$((TOTAL+1))
if [[ "$ins" == "40" ]] && [[ "$errs" == "0" ]]; then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: go-pg-race 4×10 = 40 inserted, 0 errors"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] BUG23: go-pg-race 4×10: inserted=$ins (≠40), errors=$errs"
FAIL=$((FAIL+1))
BUGS_FOUND+=("go-pg-race: workers=4 n_per_worker=10 → inserted=$ins errors=$errs")
fi
# ═══════════════════════════════════════════════════════════════════════════════
section "БЛОК 14 — pg-bulk-insert: first_id реально существует в БД"
# ═══════════════════════════════════════════════════════════════════════════════
PREFIX_VER="bughunt-verify-$(date +%s%N)"
r=$(raw "pg-bulk-insert" "{\"n\": 5, \"prefix\": \"$PREFIX_VER\"}")
first_id=$(echo "$r" | python3 -c "import json,sys; print(json.load(sys.stdin).get('first_id','null'))" 2>/dev/null || echo "null")
echo " pg-bulk-insert n=5 → first_id=$first_id"
# Проверяем что эта строка находится через pg-search
sleep 0.3
r_search=$(raw "pg-search" "{\"query\": \"$PREFIX_VER\", \"limit\": 10}")
found_count=$(echo "$r_search" | python3 -c "import json,sys; print(json.load(sys.stdin).get('count',0))" 2>/dev/null || echo "0")
TOTAL=$((TOTAL+1))
if (( found_count >= 5 )); then
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] SAFE: pg-bulk-insert n=5 → pg-search находит $found_count строк"
PASS=$((PASS+1))
else
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] BUG24: pg-bulk-insert n=5 → pg-search нашёл только $found_count строк"
FAIL=$((FAIL+1))
BUGS_FOUND+=("pg-bulk-insert: inserted 5 but pg-search found only $found_count")
fi
# ═══════════════════════════════════════════════════════════════════════════════
section "ИТОГИ BUG HUNTER"
# ═══════════════════════════════════════════════════════════════════════════════
echo ""
echo -e "${YELLOW}PASS: $PASS / $TOTAL FAIL: $FAIL${NC}"
echo ""
if (( ${#BUGS_FOUND[@]} > 0 )); then
echo -e "${RED}╔══════════════════════════════════════════════════════════════╗${NC}"
echo -e "${RED}║ НАЙДЕНО БАГОВ: ${#BUGS_FOUND[@]}${NC}"
echo -e "${RED}╚══════════════════════════════════════════════════════════════╝${NC}"
for bug in "${BUGS_FOUND[@]}"; do
echo -e " ${RED}${NC} $bug"
done
else
echo -e "${GREEN}╔══════════════════════════════════════╗${NC}"
echo -e "${GREEN}║ БАГОВ НЕ НАЙДЕНО. Всё чисто. ✓ ║${NC}"
echo -e "${GREEN}╚══════════════════════════════════════╝${NC}"
fi
echo ""
exit $(( FAIL > 0 ? 1 : 0 ))
-668
View File
@@ -1,668 +0,0 @@
#!/usr/bin/env bash
# 2026-03-21 — chaos_marathon.sh
# Часовой хаос-марафон: 15 сервисов, dumb-user simulation, PG stress, CRUD lifecycle.
# Запуск: bash chaos_marathon.sh 2>&1 | tee /tmp/chaos_marathon_$(date +%Y%m%d_%H%M).log
#
# Предполагает: terraform apply chaos_marathon.tf уже выполнен, все 15 Ready.
# Зависимости: curl, jq, terraform (init выполнен).
# -e намеренно НЕ установлен — падение одного вызова не убивает марафон.
# -u: незаданные переменные = ошибка. -o pipefail: ошибка в пайпе видна.
set -uo pipefail
# ── Config ────────────────────────────────────────────────────────────────────
BASE_URL="${SLESS_BASE_URL:-https://sless.kube5s.ru}"
TOKEN_FILE="${SLESS_TOKEN_FILE:-/home/naeel/terra/sless/test.token}"
NAMESPACE="${SLESS_NAMESPACE:-sless-ffd1f598c169b0ae}"
TF_DIR="/home/naeel/terra/sless/examples/POSTGRES"
LOG_DIR="/tmp/chaos_$(date +%Y%m%d_%H%M%S)"
mkdir -p "$LOG_DIR"
# ── Helpers ───────────────────────────────────────────────────────────────────
TOKEN=$(cat "$TOKEN_FILE")
PASS=0
FAIL=0
TOTAL=0
# Цветной вывод — для удобства чтения длинного лога.
RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; CYAN='\033[0;36m'; NC='\033[0m'
ts() { date '+%H:%M:%S'; }
# invoke SERVICE_NAME PAYLOAD — вызывает сервис через публичный /fn/ proxy, возвращает тело.
# Публичный endpoint не требует токена (используется для вызова функций).
# Никогда не падает — ошибки пишутся в лог-файл.
invoke() {
local svc="$1" payload="$2"
curl -sf -X POST \
-H "Content-Type: application/json" \
-d "$payload" \
"${BASE_URL}/fn/${NAMESPACE}/${svc}" \
2>"$LOG_DIR/err_${svc}_$(date +%s%N).log" || true
}
# invoke_raw — как invoke, но никогда не бросает non-zero exit.
invoke_raw() {
local svc="$1" payload="$2"
curl -s -X POST \
-H "Content-Type: application/json" \
-d "$payload" \
"${BASE_URL}/fn/${NAMESPACE}/${svc}" || true
}
# invoke_with_status SERVICE PAYLOAD — возвращает HTTP код, никогда не падает.
invoke_with_status() {
local svc="$1" payload="$2"
curl -s -o /dev/null -w "%{http_code}" -X POST \
-H "Content-Type: application/json" \
-d "$payload" \
"${BASE_URL}/fn/${NAMESPACE}/${svc}" || echo "000"
}
# check TEST_NAME CONDITION [msg] — вердикт по условию (expect 0-exit или строковую проверку).
check() {
local name="$1" result="$2" expected="${3:-0}"
TOTAL=$((TOTAL + 1))
if [[ "$result" == "$expected" ]]; then
PASS=$((PASS + 1))
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] $name"
else
FAIL=$((FAIL + 1))
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] $name (got='$result' want='$expected')"
fi
}
# check_contains TEST_NAME HAYSTACK NEEDLE
check_contains() {
local name="$1" hay="$2" needle="$3"
TOTAL=$((TOTAL + 1))
if echo "$hay" | grep -q "$needle"; then
PASS=$((PASS + 1))
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] $name"
else
FAIL=$((FAIL + 1))
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] $name (needle='$needle' not found)"
fi
}
# check_not_contains TEST_NAME HAYSTACK NEEDLE
check_not_contains() {
local name="$1" hay="$2" needle="$3"
TOTAL=$((TOTAL + 1))
if ! echo "$hay" | grep -q "$needle"; then
PASS=$((PASS + 1))
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] $name"
else
FAIL=$((FAIL + 1))
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] $name (unexpected needle='$needle' found)"
fi
}
# check_http TEST_NAME CODE EXPECTED
check_http() {
local name="$1" code="$2" expected="${3:-200}"
TOTAL=$((TOTAL + 1))
if [[ "$code" == "$expected" ]]; then
PASS=$((PASS + 1))
echo -e "$(ts) ${GREEN}PASS${NC} [$TOTAL] $name → HTTP $code"
else
FAIL=$((FAIL + 1))
echo -e "$(ts) ${RED}FAIL${NC} [$TOTAL] $name → HTTP $code (want $expected)"
fi
}
section() {
echo ""
echo -e "${CYAN}════════════════════════════════════════════════════════════${NC}"
echo -e "${CYAN} $1${NC}"
echo -e "${CYAN}════════════════════════════════════════════════════════════${NC}"
}
# ── Wait helpers ──────────────────────────────────────────────────────────────
# wait_service_ready NAME — ждём до 2 мин пока GET /services/{name} вернёт phase=Ready.
# Проверяет статус через API (не invoke), чтобы не запускать функцию при старте.
wait_service_ready() {
local svc="$1" max_attempts=24 attempt=0
echo " Ожидаем готовности $svc..."
while (( attempt < max_attempts )); do
phase=$(curl -sf \
-H "Authorization: Bearer $TOKEN" \
"${BASE_URL}/v1/namespaces/${NAMESPACE}/services/${svc}" \
2>/dev/null | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('phase',''))" 2>/dev/null || true)
if [[ "$phase" == "Ready" ]]; then
echo "$svc Ready (attempt $((attempt+1)))"
return 0
fi
sleep 5
attempt=$((attempt + 1))
done
echo -e " ${RED}TIMEOUT: $svc не стал Ready за 2 мин${NC}"
return 1
}
# ── Parallel invoker ──────────────────────────────────────────────────────────
# parallel_invoke COUNT SERVICE PAYLOAD LOG_PREFIX — запускает COUNT вызовов параллельно.
parallel_invoke() {
local count="$1" svc="$2" payload="$3" prefix="$4"
local pids=() results_dir="$LOG_DIR/par_${prefix}_$(date +%s)"
mkdir -p "$results_dir"
for i in $(seq 1 "$count"); do
(
code=$(invoke_with_status "$svc" "$payload")
echo "$code" > "$results_dir/$i"
) &
pids+=($!)
done
# Ждём все фоновые задачи.
for pid in "${pids[@]}"; do wait "$pid" || true; done
# Счёт 200-х.
local ok=0 bad=0
for f in "$results_dir"/*; do
code=$(cat "$f")
if [[ "$code" == "200" ]]; then ok=$((ok+1)); else bad=$((bad+1)); fi
done
echo "$ok/$count OK, $bad FAIL"
}
echo ""
echo -e "${YELLOW}╔══════════════════════════════════════════════════════════╗${NC}"
echo -e "${YELLOW}║ CHAOS MARATHON — $(date '+%Y-%m-%d %H:%M:%S')${NC}"
echo -e "${YELLOW}╚══════════════════════════════════════════════════════════╝${NC}"
echo ""
# ═══════════════════════════════════════════════════════════════════════════════
section "ФАЗА 0 — Ожидание готовности всех 15 сервисов"
# ═══════════════════════════════════════════════════════════════════════════════
SERVICES=(
pg-counter pg-dedup pg-search pg-bulk-insert pg-delete-old pg-upsert
chaos-echo chaos-badparams chaos-slowquery chaos-bigpayload
go-pg-race go-counter-atomic
js-pg-batch js-idempotent
py-retry-writer
)
failed_ready=0
for svc in "${SERVICES[@]}"; do
if ! wait_service_ready "$svc"; then
failed_ready=$((failed_ready + 1))
fi
done
if (( failed_ready > 0 )); then
echo -e "${YELLOW}ВНИМАНИЕ: $failed_ready сервисов не стали Ready. Продолжаем — они будут FAIL в тестах.${NC}"
# НЕ выходим — дальше тесты сами покажут что сломалось.
fi
echo -e "${GREEN}Все 15 сервисов Ready. Начинаем марафон.${NC}"
START_TIME=$(date +%s)
MARATHON_DURATION=${MARATHON_DURATION_SEC:-3600} # по умолчанию 1 час
ROUND=0
echo -e "${CYAN}Длительность марафона: ${MARATHON_DURATION}с ($(( MARATHON_DURATION / 60 )) мин)${NC}"
# ── Основной цикл: крутим фазы 1–11 пока не истечёт время ───────────────────
while true; do
NOW=$(date +%s)
ELAPSED_TOTAL=$(( NOW - START_TIME ))
if (( ELAPSED_TOTAL >= MARATHON_DURATION )); then
echo -e "\n${YELLOW}Время марафона истекло (${ELAPSED_TOTAL}с). Переходим к финальной проверке.${NC}"
break
fi
ROUND=$((ROUND + 1))
MINS_LEFT=$(( (MARATHON_DURATION - ELAPSED_TOTAL) / 60 ))
echo -e "\n${YELLOW}═══ РАУНД $ROUND | прошло $(( ELAPSED_TOTAL / 60 ))м, осталось ${MINS_LEFT}м ═══${NC}"
# ═══════════════════════════════════════════════════════════════════════════════
section "ФАЗА 1 — Базовый smoke-test (1 вызов каждого сервиса)"
# ═══════════════════════════════════════════════════════════════════════════════
# pg-counter: простой счёт всех строк.
r=$(invoke_raw "pg-counter" '{}')
check_contains "pg-counter smoke" "$r" "total"
# pg-dedup: dry_run — ничего не удаляем, проверяем связность.
r=$(invoke_raw "pg-dedup" '{"dry_run": true}')
check_contains "pg-dedup smoke (dry_run)" "$r" "duplicates_found"
# pg-search: самый простой запрос.
r=$(invoke_raw "pg-search" '{"query": "a"}')
check_contains "pg-search smoke" "$r" "rows"
# pg-bulk-insert: 5 строк.
r=$(invoke_raw "pg-bulk-insert" '{"n": 5, "prefix": "smoke"}')
check_contains "pg-bulk-insert smoke" "$r" "inserted"
# pg-delete-old: смотрим что вернёт, не упадёт.
r=$(invoke_raw "pg-delete-old" '{"older_than_minutes": 99999}')
check_contains "pg-delete-old smoke" "$r" "deleted"
# pg-upsert: вставляем одну строку.
r=$(invoke_raw "pg-upsert" '{"title": "smoke-test-upsert-01"}')
check_contains "pg-upsert smoke" "$r" "action"
# chaos-echo: простое отражение.
r=$(invoke_raw "chaos-echo" '{"hello": "world"}')
check_contains "chaos-echo smoke" "$r" "echo"
# chaos-badparams: валидный вызов.
r=$(invoke_raw "chaos-badparams" '{"n": 5, "name": "test", "flag": true}')
check_contains "chaos-badparams smoke" "$r" "n"
# chaos-slowquery: sleep 1s.
r=$(invoke_raw "chaos-slowquery" '{"seconds": 1}')
check_contains "chaos-slowquery smoke" "$r" "slept"
# chaos-bigpayload: 16KB.
r=$(invoke_raw "chaos-bigpayload" '{"size_kb": 16}')
check_contains "chaos-bigpayload smoke" "$r" "items"
# go-pg-race: 2 горутины × 3 INSERT.
r=$(invoke_raw "go-pg-race" '{"workers": 2, "n_per_worker": 3}')
check_contains "go-pg-race smoke" "$r" "inserted"
# go-counter-atomic: один вызов.
r=$(invoke_raw "go-counter-atomic" '{}')
check_contains "go-counter-atomic smoke" "$r" "invocation"
# js-pg-batch: 5 строк.
r=$(invoke_raw "js-pg-batch" '{"n": 5, "prefix": "smoke-js"}')
check_contains "js-pg-batch smoke" "$r" "inserted"
# js-idempotent: новый уникальный ключ.
r=$(invoke_raw "js-idempotent" '{"idempotency_key": "smoke-key-001"}')
check_contains "js-idempotent smoke" "$r" "action"
# py-retry-writer: 3 строки без simulate_error.
r=$(invoke_raw "py-retry-writer" '{"n": 3, "prefix": "smoke"}')
check_contains "py-retry-writer smoke" "$r" "inserted"
# ═══════════════════════════════════════════════════════════════════════════════
section "ФАЗА 2 — Dumb User Simulation (тупой юзер ломает всё)"
# ═══════════════════════════════════════════════════════════════════════════════
echo " Тест: передаём мусор в каждый сервис — никто не должен вернуть 500."
# chaos-echo: пустой объект.
c=$(invoke_with_status "chaos-echo" '{}')
check_http "dumb: chaos-echo empty" "$c"
# chaos-echo: огромный unicode payload.
big_unicode=$(python3 -c "import json; print(json.dumps({'text': '中文テスト🎉' * 500}))")
c=$(invoke_with_status "chaos-echo" "$big_unicode")
check_http "dumb: chaos-echo unicode×500" "$c"
# chaos-echo: числа вместо строк.
c=$(invoke_with_status "chaos-echo" '{"key": 99999999, "nested": {"a": null, "b": [1,2,3]}}')
check_http "dumb: chaos-echo nested nulls" "$c"
# chaos-badparams: n="строка" вместо числа — должен survive.
c=$(invoke_with_status "chaos-badparams" '{"n": "сто пятьдесят", "name": null, "flag": "yes please"}')
check_http "dumb: badparams n=string flag=string" "$c"
# chaos-badparams: n=-999999.
c=$(invoke_with_status "chaos-badparams" '{"n": -999999}')
check_http "dumb: badparams n negative huge" "$c"
# chaos-badparams: полностью пустой payload.
c=$(invoke_with_status "chaos-badparams" '{}')
check_http "dumb: badparams empty payload" "$c"
# chaos-badparams: n=Infinity (JSON не поддерживает, строка).
c=$(invoke_with_status "chaos-badparams" '{"n": "Infinity"}')
check_http "dumb: badparams n=Infinity" "$c"
# pg-counter: prefix = 2000 символов — должен обрезать, а не упасть.
long_prefix=$(python3 -c "print('x' * 2000)")
c=$(invoke_with_status "pg-counter" "{\"prefix\": \"$long_prefix\"}")
check_http "dumb: pg-counter prefix 2000 chars" "$c"
# pg-search: SQL injection attempt.
c=$(invoke_with_status "pg-search" '{"query": "a OR 1=1; DROP TABLE terraform_demo_table; --"}')
check_http "dumb: pg-search SQL injection attempt" "$c"
# pg-search: query пустая строка.
c=$(invoke_with_status "pg-search" '{"query": ""}')
check_http "dumb: pg-search empty query" "$c"
# pg-search: limit=-1.
c=$(invoke_with_status "pg-search" '{"query": "a", "limit": -1}')
check_http "dumb: pg-search limit=-1" "$c"
# pg-search: offset="много" (строка).
c=$(invoke_with_status "pg-search" '{"query": "a", "offset": "много"}')
check_http "dumb: pg-search offset=string" "$c"
# pg-bulk-insert: n=99999 — должен cap до 500.
c=$(invoke_with_status "pg-bulk-insert" '{"n": 99999, "prefix": "dumb"}')
check_http "dumb: pg-bulk-insert n=99999 (capped)" "$c"
# pg-bulk-insert: n=0 — граничный случай.
c=$(invoke_with_status "pg-bulk-insert" '{"n": 0, "prefix": "dumb"}')
check_http "dumb: pg-bulk-insert n=0" "$c"
# pg-upsert: title null.
c=$(invoke_with_status "pg-upsert" '{"title": null}')
# null title — можно вернуть 400 или 200 с ошибкой — главное не 500.
r=$(invoke_raw "pg-upsert" '{"title": null}')
check_not_contains "dumb: pg-upsert title=null no 500 in body" "$r" '"error"' || true
# Просто проверяем что не упает с 5xx.
[[ "$c" != "5"* ]] && check "dumb: pg-upsert title=null not 5xx" "ok" "ok" \
|| check "dumb: pg-upsert title=null not 5xx" "fail" "ok"
# pg-delete-old: older_than_minutes=0 (граничный).
c=$(invoke_with_status "pg-delete-old" '{"older_than_minutes": 0}')
check_http "dumb: pg-delete-old older_than=0" "$c"
# go-pg-race: workers=0.
c=$(invoke_with_status "go-pg-race" '{"workers": 0, "n_per_worker": 10}')
check_http "dumb: go-pg-race workers=0" "$c"
# go-pg-race: workers=9999 — должен cap до 20.
c=$(invoke_with_status "go-pg-race" '{"workers": 9999, "n_per_worker": 1}')
check_http "dumb: go-pg-race workers=9999 (capped)" "$c"
# chaos-slowquery: seconds=-5 — отрицательное (должен cap до 0 или 1).
c=$(invoke_with_status "chaos-slowquery" '{"seconds": -5}')
check_http "dumb: chaos-slowquery seconds=-5" "$c"
# chaos-slowquery: seconds=9999 — должен cap до 8, выполниться за ~8s.
c=$(invoke_with_status "chaos-slowquery" '{"seconds": 9999}')
check_http "dumb: chaos-slowquery seconds=9999 (capped)" "$c"
# chaos-bigpayload: size_kb=0.
c=$(invoke_with_status "chaos-bigpayload" '{"size_kb": 0}')
check_http "dumb: chaos-bigpayload size_kb=0" "$c"
# chaos-bigpayload: size_kb=9999 — должен cap до 256.
c=$(invoke_with_status "chaos-bigpayload" '{"size_kb": 9999}')
check_http "dumb: chaos-bigpayload size_kb=9999 (capped)" "$c"
# js-pg-batch: n="много" — строка вместо числа.
c=$(invoke_with_status "js-pg-batch" '{"n": "много", "prefix": "dumb"}')
check_http "dumb: js-pg-batch n=string" "$c"
# js-idempotent: idempotency_key отсутствует.
c=$(invoke_with_status "js-idempotent" '{}')
[[ "$c" != "5"* ]] && check "dumb: js-idempotent no key not 5xx" "ok" "ok" \
|| check "dumb: js-idempotent no key not 5xx" "fail" "ok"
# py-retry-writer: simulate_error=true и n=1.
r=$(invoke_raw "py-retry-writer" '{"n": 1, "simulate_error": true}')
check_contains "dumb: py-retry-writer simulate_error n=1" "$r" "attempts"
# ═══════════════════════════════════════════════════════════════════════════════
section "ФАЗА 3 — Idempotency Suite"
# ═══════════════════════════════════════════════════════════════════════════════
echo " Тест: повторные вызовы с одинаковыми ключами дают предсказуемый результат."
# pg-upsert: вызываем 20× с одним title — в таблице должна быть одна строка.
UPSERT_TITLE="idempotent-title-$(date +%s)"
for i in $(seq 1 20); do
invoke_raw "pg-upsert" "{\"title\": \"$UPSERT_TITLE\"}" >/dev/null 2>&1 || true
done
# Проверяем через pg-counter + pg-search.
r=$(invoke_raw "pg-search" "{\"query\": \"$UPSERT_TITLE\", \"limit\": 100}")
count=$(echo "$r" | jq -r '.rows | length' 2>/dev/null || echo "0")
check "idempotency: pg-upsert 20× same title = 1 row" "$count" "1"
# js-idempotent: 10× одинаковый ключ — должно быть action=existing после первого вызова.
IDEM_KEY="js-idempotent-key-$(date +%s)"
# Первый вызов.
r=$(invoke_raw "js-idempotent" "{\"idempotency_key\": \"$IDEM_KEY\"}")
check_contains "idempotency: js-idempotent first call=created" "$r" "created"
# Следующие 5 вызовов.
for i in $(seq 2 6); do
r=$(invoke_raw "js-idempotent" "{\"idempotency_key\": \"$IDEM_KEY\"}")
check_contains "idempotency: js-idempotent call $i=existing" "$r" "existing"
done
# pg-dedup: вставляем дубли, затем проверяем что dedup убирает лишние.
DUP_TITLE="dedup-test-$(date +%s)"
invoke_raw "pg-bulk-insert" "{\"n\": 10, \"prefix\": \"$DUP_TITLE\"}" >/dev/null
# Не все строки будут дупликатами (prefix ≠ title), вставляем явно через upsert без конфликта.
# Вставляем одно и то же 5 раз через pg-upsert (он обновляет → НЕ дубль).
# Для настоящих дублей вставляем через bulk-insert с одинаковым prefix (title = prefix_N).
# dry_run у dedup должен показать 0 дублей (bulk-insert генерирует уникальные titles).
r=$(invoke_raw "pg-dedup" '{"dry_run": true}')
check_contains "idempotency: pg-dedup dry_run returns json" "$r" "duplicates_found"
# py-retry-writer: записываем 5 строк с retry, без ошибок.
r=$(invoke_raw "py-retry-writer" '{"n": 5, "prefix": "retry-idem"}')
inserted=$(echo "$r" | jq -r '.inserted' 2>/dev/null || echo "0")
check "idempotency: py-retry-writer inserts 5" "$inserted" "5"
# ═══════════════════════════════════════════════════════════════════════════════
section "ФАЗА 4 — PG Parallel Stress"
# ═══════════════════════════════════════════════════════════════════════════════
echo " Нагрузка: параллельные вызовы к PG-функциям."
# pg-counter: 30 параллельных чтений.
echo -n " pg-counter ×30: "
parallel_invoke 30 "pg-counter" '{"prefix": ""}' "counter30"
# pg-bulk-insert: 10 параллельных × 200 строк.
echo -n " pg-bulk-insert ×10 (n=200): "
parallel_invoke 10 "pg-bulk-insert" '{"n": 200, "prefix": "par-bulk"}' "bulk10"
# go-pg-race: 5 параллельных × (10 горутин × 10 INSERT).
echo -n " go-pg-race ×5 (workers=10 n=10): "
parallel_invoke 5 "go-pg-race" '{"workers": 10, "n_per_worker": 10}' "race5"
# go-counter-atomic: 50 параллельных.
echo -n " go-counter-atomic ×50: "
parallel_invoke 50 "go-counter-atomic" '{}' "atomic50"
# js-pg-batch: 10 параллельных × 50 строк.
echo -n " js-pg-batch ×10 (n=50): "
parallel_invoke 10 "js-pg-batch" '{"n": 50, "prefix": "par-js"}' "jsbatch10"
# pg-search: 40 параллельных с разными запросами.
echo -n " pg-search ×40: "
parallel_invoke 40 "pg-search" '{"query": "par", "limit": 10}' "search40"
# Проверяем что после нагрузки счётчик всё ещё работает.
r=$(invoke_raw "pg-counter" '{}')
check_contains "pg stress: counter still returns total" "$r" "total"
# ═══════════════════════════════════════════════════════════════════════════════
section "ФАЗА 5 — Chaos Payload & Echo Storm"
# ═══════════════════════════════════════════════════════════════════════════════
# chaos-bigpayload: 20 параллельных 64KB.
echo -n " chaos-bigpayload ×20 (64KB): "
parallel_invoke 20 "chaos-bigpayload" '{"size_kb": 64}' "big20"
# chaos-echo: 30 параллельных с 1KB payload.
medium_payload=$(python3 -c "import json; print(json.dumps({'data': 'x' * 1000}))")
echo -n " chaos-echo ×30 (1KB): "
parallel_invoke 30 "chaos-echo" "$medium_payload" "echo30"
# chaos-bigpayload: один раз 256KB.
r=$(invoke_raw "chaos-bigpayload" '{"size_kb": 256}')
check_contains "chaos-bigpayload 256KB single" "$r" "items"
# ═══════════════════════════════════════════════════════════════════════════════
section "ФАЗА 6 — Slow Query Handling"
# ═══════════════════════════════════════════════════════════════════════════════
# Один медленный запрос 8 секунд — ожидаем 200.
c=$(invoke_with_status "chaos-slowquery" '{"seconds": 8}')
check_http "slowquery: sleep 8s = 200" "$c"
# 5 параллельных запросов 3s.
echo -n " chaos-slowquery ×5 (3s each): "
parallel_invoke 5 "chaos-slowquery" '{"seconds": 3}' "slow5"
# ═══════════════════════════════════════════════════════════════════════════════
section "ФАЗА 7 — Search Storm (special chars)"
# ═══════════════════════════════════════════════════════════════════════════════
special_queries=(
'{"query": "%"}'
'{"query": "_"}'
'{"query": "'"'"'"}'
'{"query": "\\"}'
'{"query": "<script>alert(1)</script>"}'
'{"query": "union select"}'
'{"query": "★ ☆ ♡"}'
'{"query": " "}'
'{"query": "а б в г д е ё ж з и й к л м н"}'
'{"query": "你好世界"}'
)
for q in "${special_queries[@]}"; do
c=$(invoke_with_status "pg-search" "$q")
check_http "search: special chars $(echo "$q" | cut -c1-40)" "$c"
done
# ═══════════════════════════════════════════════════════════════════════════════
section "ФАЗА 8 — Dedup & Delete-Old Cycle"
# ═══════════════════════════════════════════════════════════════════════════════
# Считаем строки до.
r_before=$(invoke_raw "pg-counter" '{"prefix": "lifecycle-"}')
total_before=$(echo "$r_before" | jq -r '.total' 2>/dev/null || echo "0")
echo " Строк до цикла: $total_before"
# Вставляем 300 строк с prefix lifecycle-.
invoke_raw "pg-bulk-insert" '{"n": 300, "prefix": "lifecycle-"}' >/dev/null || true
# Считаем после вставки.
r_after=$(invoke_raw "pg-counter" '{"prefix": "lifecycle-"}')
total_after=$(echo "$r_after" | jq -r '.total' 2>/dev/null || echo "0")
echo " После bulk-insert lifecycle-: $total_after"
# Ищем lifecycle строки.
r=$(invoke_raw "pg-search" '{"query": "lifecycle-", "limit": 5}')
check_contains "dedup-cycle: search finds lifecycle rows" "$r" "lifecycle-"
# Dry-run dedup — смотрим сколько дублей нашлось.
r=$(invoke_raw "pg-dedup" '{"dry_run": true}')
dups=$(echo "$r" | jq -r '.duplicates_found' 2>/dev/null || echo "?")
echo " Дублей найдено (dry_run): $dups"
check_contains "dedup-cycle: dedup dry_run ok" "$r" "duplicates_found"
# Настоящий dedup (выполняем).
r=$(invoke_raw "pg-dedup" '{"dry_run": false}')
check_contains "dedup-cycle: real dedup ok" "$r" "deleted"
# delete-old: удаляем строки старше 99999 минут (практически всё старое).
r=$(invoke_raw "pg-delete-old" '{"older_than_minutes": 99999}')
check_contains "dedup-cycle: delete-old returns deleted" "$r" "deleted"
# Считаем финальный total.
r_final=$(invoke_raw "pg-counter" '{}')
total_final=$(echo "$r_final" | jq -r '.total' 2>/dev/null || echo "?")
echo " Финальный total строк: $total_final"
check_contains "dedup-cycle: counter after cleanup" "$r_final" "total"
# ═══════════════════════════════════════════════════════════════════════════════
section "ФАЗА 9 — Retry Writer Stress"
# ═══════════════════════════════════════════════════════════════════════════════
# Retry с simulate_error — проверяем что retry отрабатывает и данные записаны.
r=$(invoke_raw "py-retry-writer" '{"n": 10, "simulate_error": true, "prefix": "retry-err"}')
check_contains "retry: simulate_error=true returns attempts" "$r" "attempts"
attempts=$(echo "$r" | jq -r '.attempts' 2>/dev/null || echo "0")
echo " Retry attempts: $attempts"
[[ "$attempts" -ge 2 ]] && check "retry: минимум 2 попытки при simulate_error" "ok" "ok" \
|| check "retry: минимум 2 попытки при simulate_error" "fail" "ok"
# 5 параллельных py-retry-writer с simulate_error.
echo -n " py-retry-writer ×5 (simulate_error): "
parallel_invoke 5 "py-retry-writer" '{"n": 5, "simulate_error": true}' "retry5err"
# 10 параллельных без ошибок.
echo -n " py-retry-writer ×10 (no error): "
parallel_invoke 10 "py-retry-writer" '{"n": 5, "prefix": "par-retry"}' "retry10"
# ═══════════════════════════════════════════════════════════════════════════════
section "ФАЗА 10 — Mixed Concurrent Load (пиковый тест)"
# ═══════════════════════════════════════════════════════════════════════════════
echo " Запускаем все сервисы одновременно..."
pids_mixed=()
results_mixed="$LOG_DIR/mixed"
mkdir -p "$results_mixed"
# Запускаем 3–5 параллельных вызовов каждого сервиса одновременно.
for svc in "${SERVICES[@]}"; do
for i in 1 2 3; do
(
code=$(invoke_with_status "$svc" '{"n": 2, "workers": 2, "n_per_worker": 2, "size_kb": 8, "seconds": 1, "query": "x", "prefix": "mixed", "idempotency_key": "mixed-'$RANDOM'", "title": "mixed-'$RANDOM'"}' 2>/dev/null || true)
echo "${svc}:${i}:${code}" >> "$results_mixed/results.txt"
) &
pids_mixed+=($!)
done
done
echo " Ждём завершения всех ${#pids_mixed[@]} параллельных вызовов..."
for pid in "${pids_mixed[@]}"; do wait "$pid" || true; done
total_mixed=$(wc -l < "$results_mixed/results.txt")
ok_mixed=$(grep -c ":200$" "$results_mixed/results.txt" || true)
bad_mixed=$(( total_mixed - ok_mixed ))
echo " Mixed: $ok_mixed/$total_mixed OK, $bad_mixed FAIL"
check "mixed: >90% success rate" "$(( ok_mixed * 100 / total_mixed ))" \
"$(( ok_mixed * 100 / total_mixed ))" # Всегда pass — выводим статистику
# ═══════════════════════════════════════════════════════════════════════════════
section "ФАЗА 11 — Проверка уже существующих crash-сервисов (регрессия)"
# ═══════════════════════════════════════════════════════════════════════════════
# Убеждаемся что старые crash-сервисы из stress.tf всё ещё возвращают 500.
CRASH_SERVICES=("stress-go-nil" "stress-divzero")
for svc in "${CRASH_SERVICES[@]}"; do
c=$(invoke_with_status "$svc" '{}' 2>/dev/null || echo "000")
if [[ "$c" == "500" ]]; then
check "regression: $svc returns 500" "ok" "ok"
elif [[ "$c" == "000" ]]; then
echo -e "$(ts) ${YELLOW}SKIP${NC} $svc недоступен ($(( TOTAL+1 )))"
TOTAL=$((TOTAL+1))
else
check "regression: $svc returns 500" "$c" "500"
fi
done
done # конец основного цикла while true (фазы 111)
# ═══════════════════════════════════════════════════════════════════════════════
section "ФАЗА 12 — Финальная проверка всех 15 сервисов"
# ═══════════════════════════════════════════════════════════════════════════════
for svc in "${SERVICES[@]}"; do
c=$(invoke_with_status "$svc" '{"n": 1, "prefix": "final", "query": "f", "size_kb": 1, "title": "final-check-'$(date +%s%N)'", "idempotency_key": "final-'$(date +%s%N)'"}')
check_http "final: $svc still responds 200" "$c"
done
# ═══════════════════════════════════════════════════════════════════════════════
section "ИТОГИ МАРАФОНА"
# ═══════════════════════════════════════════════════════════════════════════════
END_TIME=$(date +%s)
DURATION=$(( END_TIME - START_TIME ))
MINUTES=$(( DURATION / 60 ))
SECONDS_REM=$(( DURATION % 60 ))
echo ""
echo -e "${YELLOW}Время выполнения: ${MINUTES}м ${SECONDS_REM}с${NC}"
echo ""
if (( FAIL == 0 )); then
echo -e "${GREEN}╔══════════════════════════════════════╗${NC}"
echo -e "${GREEN}║ ВСЕ ${TOTAL} ТЕСТОВ ПРОШЛИ ✓ ║${NC}"
echo -e "${GREEN}╚══════════════════════════════════════╝${NC}"
else
echo -e "${RED}╔══════════════════════════════════════╗${NC}"
echo -e "${RED}║ PASS: ${PASS}/${TOTAL} FAIL: ${FAIL}${NC}"
echo -e "${RED}╚══════════════════════════════════════╝${NC}"
fi
echo ""
echo "Логи: $LOG_DIR"
exit $(( FAIL > 0 ? 1 : 0 ))
-257
View File
@@ -1,257 +0,0 @@
// 2026-03-21 — chaos_marathon.tf: 15 новых сервисов для часового хаос-марафона.
// Два рантайма: python3.11 (9), nodejs20 (2).
// Все зависят от sless_job.postgres_table_init_job.
# ── Python: работа с таблицей ─────────────────────────────────────────────────
# Считает строки по prefix — тест concurrent reads + COUNT агрегации.
resource "sless_service" "pg_counter" {
name = "pg-counter"
runtime = "python3.11"
entrypoint = "pg_counter.count"
memory_mb = 128
timeout_sec = 15
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
source_dir = "${path.module}/code/pg-counter"
depends_on = [sless_job.postgres_table_init_job]
}
# DELETE дублей по title — идемпотентный, повторный вызов безопасен.
resource "sless_service" "pg_dedup" {
name = "pg-dedup"
runtime = "python3.11"
entrypoint = "pg_dedup.dedup"
memory_mb = 128
timeout_sec = 30
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
source_dir = "${path.module}/code/pg-dedup"
depends_on = [sless_job.postgres_table_init_job]
}
# Поиск по title с ILIKE + пагинация — тест спецсимволов и SQL injection safety.
resource "sless_service" "pg_search" {
name = "pg-search"
runtime = "python3.11"
entrypoint = "pg_search.search"
memory_mb = 128
timeout_sec = 15
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
source_dir = "${path.module}/code/pg-search"
depends_on = [sless_job.postgres_table_init_job]
}
# Bulk INSERT через execute_values — до 500 строк за раз.
resource "sless_service" "pg_bulk_insert" {
name = "pg-bulk-insert"
runtime = "python3.11"
entrypoint = "pg_bulk_insert.bulk_insert"
memory_mb = 256
timeout_sec = 30
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
source_dir = "${path.module}/code/pg-bulk-insert"
depends_on = [sless_job.postgres_table_init_job]
}
# DELETE строк старше N минут — идемпотентный.
resource "sless_service" "pg_delete_old" {
name = "pg-delete-old"
runtime = "python3.11"
entrypoint = "pg_delete_old.delete_old"
memory_mb = 128
timeout_sec = 30
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
source_dir = "${path.module}/code/pg-delete-old"
depends_on = [sless_job.postgres_table_init_job]
}
# INSERT ON CONFLICT DO UPDATE — повторный вызов с тем же title безопасен.
resource "sless_service" "pg_upsert" {
name = "pg-upsert"
runtime = "python3.11"
entrypoint = "pg_upsert.upsert"
memory_mb = 128
timeout_sec = 15
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
source_dir = "${path.module}/code/pg-upsert"
depends_on = [sless_job.postgres_table_init_job]
}
# ── Python: chaos ─────────────────────────────────────────────────────────────
# Echo: принимает любой ввод и отражает обратно — проверка на мусорный input.
resource "sless_service" "chaos_echo" {
name = "chaos-echo"
runtime = "python3.11"
entrypoint = "chaos_echo.echo"
memory_mb = 128
timeout_sec = 10
source_dir = "${path.module}/code/chaos-echo"
depends_on = [sless_job.postgres_table_init_job]
}
# Валидация плохих параметров — тупой юзер не может уронить сервис.
resource "sless_service" "chaos_badparams" {
name = "chaos-badparams"
runtime = "python3.11"
entrypoint = "chaos_badparams.validate"
memory_mb = 128
timeout_sec = 10
source_dir = "${path.module}/code/chaos-badparams"
depends_on = [sless_job.postgres_table_init_job]
}
# Медленный pg_sleep — тест timeout enforcement.
resource "sless_service" "chaos_slowquery" {
name = "chaos-slowquery"
runtime = "python3.11"
entrypoint = "chaos_slowquery.slowquery"
memory_mb = 128
timeout_sec = 12
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
source_dir = "${path.module}/code/chaos-slowquery"
depends_on = [sless_job.postgres_table_init_job]
}
# Большой JSON response — тест памяти и серилизации.
resource "sless_service" "chaos_bigpayload" {
name = "chaos-bigpayload"
runtime = "python3.11"
entrypoint = "chaos_bigpayload.bigpayload"
memory_mb = 256
timeout_sec = 15
source_dir = "${path.module}/code/chaos-bigpayload"
depends_on = [sless_job.postgres_table_init_job]
}
# ── Node.js ───────────────────────────────────────────────────────────────────
# Bulk INSERT через параметризованный multi-value query.
resource "sless_service" "js_pg_batch" {
name = "js-pg-batch"
runtime = "nodejs20"
entrypoint = "js_pg_batch.run"
memory_mb = 128
timeout_sec = 30
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
source_dir = "${path.module}/code/js-pg-batch"
depends_on = [sless_job.postgres_table_init_job]
}
# Идемпотентный INSERT — повторный вызов с тем же key = existing, не дубль.
resource "sless_service" "js_idempotent" {
name = "js-idempotent"
runtime = "nodejs20"
entrypoint = "js_idempotent.run"
memory_mb = 128
timeout_sec = 15
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
source_dir = "${path.module}/code/js-idempotent"
depends_on = [sless_job.postgres_table_init_job]
}
# ── Python: retry ─────────────────────────────────────────────────────────────
# Запись с retry при transient PG error — тест устойчивости к сбоям.
resource "sless_service" "py_retry_writer" {
name = "py-retry-writer"
runtime = "python3.11"
entrypoint = "py_retry_writer.retry_write"
memory_mb = 128
timeout_sec = 30
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
source_dir = "${path.module}/code/py-retry-writer"
depends_on = [sless_job.postgres_table_init_job]
}
@@ -1,40 +0,0 @@
# 2026-03-21 — chaos-badparams: проверяет что функция не падает на мусорных входных данных.
# Принимает type=missing|wrong_type|huge|negative|zero и возвращает safe-ответ.
# Тестирует: устойчивость к "тупому юзеру" — никакого 500 на плохих входных данных.
import json
_MAX_N = 10_000
def validate(event):
errors = []
results = {}
# n: должно быть int от 1 до MAX_N
raw_n = event.get("n")
try:
n = int(raw_n)
if n <= 0:
errors.append(f"n must be > 0, got {n}")
n = 1
elif n > _MAX_N:
errors.append(f"n capped from {n} to {_MAX_N}")
n = _MAX_N
except (TypeError, ValueError):
errors.append(f"n is not a valid int: {repr(raw_n)}, using default 1")
n = 1
results["n"] = n
# name: обрезаем до 100 символов
raw_name = event.get("name", "")
if not isinstance(raw_name, str):
raw_name = str(raw_name)
errors.append("name was not a string, converted")
name = raw_name[:100]
results["name"] = name
# flag: любое "truthy" значение
raw_flag = event.get("flag", False)
flag = raw_flag in (True, "true", "1", 1, "yes")
results["flag"] = flag
return {"ok": len(errors) == 0, "errors": errors, "results": results}
@@ -1,27 +0,0 @@
# 2026-03-21 — chaos-bigpayload: генерирует/принимает большой JSON.
# Тестирует: большие ответы (64KB+), память рантайма.
import json, time
def bigpayload(event):
size_kb = min(int(event.get("size_kb", 16)), 256) # cap 256KB
word = str(event.get("word", "x"))[:32]
# Генерируем список строк нужного размера
chunk = word * 32 # ~32+ байт на запись
items = []
total = 0
target = size_kb * 1024
i = 0
while total < target:
entry = f"{chunk}-{i}"
items.append(entry)
total += len(entry) + 3 # 3 байта JSON overhead
i += 1
return {
"items_count": len(items),
"size_kb_approx": round(total / 1024, 1),
"first": items[0] if items else "",
"last": items[-1] if items else "",
"ts": int(time.time()),
}
@@ -1,19 +0,0 @@
# 2026-03-21 — chaos-echo: отражает входные данные обратно.
# Тестирует: большие payload, unicode, null, вложенные структуры, спецсимволы.
# "Тупой юзер" шлёт всё что угодно — функция должна вернуть это обратно без падения.
import json
def echo(event):
# Пытаемся сериализовать обратно — выловит непериализуемые типы
try:
size = len(json.dumps(event))
except Exception:
size = -1
keys = list(event.keys()) if isinstance(event, dict) else []
return {
"echo": event,
"keys": keys,
"size_bytes": size,
"type": type(event).__name__,
}
@@ -1,19 +0,0 @@
# 2026-03-21 — chaos-slowquery: намеренно медленный запрос через pg_sleep.
# Тестирует: timeout enforcement — платформа должна прервать запрос если > timeout_sec.
# sleep_sec cap = 8 (меньше timeout_sec=10 сервиса → успех; >10 → таймаут платформы).
import os, psycopg2
def slowquery(event):
sleep_sec = min(float(event.get("sleep_sec", 2.0)), 8.0)
conn = psycopg2.connect(
host=os.environ["PGHOST"], port=int(os.environ.get("PGPORT", 5432)),
dbname=os.environ["PGDATABASE"], user=os.environ["PGUSER"],
password=os.environ["PGPASSWORD"], sslmode=os.environ.get("PGSSLMODE", "require"),
)
try:
with conn.cursor() as cur:
cur.execute("SELECT pg_sleep(%s), now()::text", (sleep_sec,))
result = cur.fetchone()
return {"slept_sec": sleep_sec, "pg_now": result[1]}
finally:
conn.close()
@@ -1,94 +0,0 @@
# 2026-03-18 (обновлено: plain text вывод; фильтрация SLESS_EXCLUDE)
# funcs_list.py — HTTP-функция: список пользовательских функций, человекочитаемый plain text.
# Вызывает внутренний REST API оператора (ClusterIP, без TLS).
# Возвращает str → python runtime отдаёт text/plain напрямую без json.dumps.
#
# Env vars:
# SLESS_API_URL — URL оператора (http://sless-operator.sless.svc.cluster.local:9090)
# SLESS_NAMESPACE — namespace пользователя (sless-{hex16})
# SLESS_TOKEN — JWT токен для /v1/ API
# SLESS_EXTERNAL_URL — публичный базовый URL (https://sless.kube5s.ru)
# SLESS_EXCLUDE — comma-separated имена функций, которые не показывать
import os
import requests
SEP = "" * 52
def _comment(fn, http_trigs, cron_trigs):
phase = fn.get("phase", "?")
runtime = fn.get("runtime", "?")
if http_trigs:
active = "активна" if http_trigs[0].get("active") else "неактивна"
return f"HTTP endpoint ({runtime}) — {phase}, {active}"
elif cron_trigs:
schedule = cron_trigs[0].get("schedule", "?")
active = "активна" if cron_trigs[0].get("active") else "неактивна"
return f"Cron '{schedule}' ({runtime}) — {phase}, {active}"
else:
return f"Job/runner без триггера ({runtime}) — {phase}"
def list_all(event):
api_url = os.environ["SLESS_API_URL"].rstrip("/")
namespace = os.environ["SLESS_NAMESPACE"]
token = os.environ["SLESS_TOKEN"]
ext_url = os.environ.get("SLESS_EXTERNAL_URL", "").rstrip("/")
exclude = {n.strip() for n in os.environ.get("SLESS_EXCLUDE", "").split(",") if n.strip()}
headers = {"Authorization": f"Bearer {token}"}
fns = requests.get(f"{api_url}/v1/namespaces/{namespace}/functions", headers=headers, timeout=10)
trs = requests.get(f"{api_url}/v1/namespaces/{namespace}/triggers", headers=headers, timeout=10)
fns.raise_for_status()
trs.raise_for_status()
trig_idx = {}
for tr in trs.json():
fn_name = tr.get("function") or tr.get("functionRef")
if fn_name:
trig_idx.setdefault(fn_name, []).append(tr)
items = []
for fn in fns.json():
name = fn["name"]
if name in exclude:
continue
http_t = [t for t in trig_idx.get(name, []) if t.get("type") == "http"]
cron_t = [t for t in trig_idx.get(name, []) if t.get("type") == "cron"]
is_active = any(t.get("enabled", True) and t.get("active", False) for t in trig_idx.get(name, []))
items.append((fn, http_t, cron_t, is_active))
# Сортировка: активные вверх, затем по имени
items.sort(key=lambda x: (not x[3], x[0]["name"]))
lines = []
for fn, http_t, cron_t, is_active in items:
name = fn["name"]
lines.append(SEP)
lines.append(f" {_comment(fn, http_t, cron_t)}")
lines.append(f" name: {name}")
lines.append(f" runtime: {fn.get('runtime', '?')}")
lines.append(f" phase: {fn.get('phase', '?')}")
lines.append(f" active: {'да' if is_active else 'нет'}")
if http_t:
url = f"{ext_url}/fn/{namespace}/{name}" if ext_url else http_t[0].get("url", "")
lines.append(f" url: {url}")
if cron_t:
lines.append(f" cron: {cron_t[0].get('schedule', '?')}")
if fn.get("created_at"):
lines.append(f" created: {fn['created_at']}")
if fn.get("last_built_at"):
lines.append(f" built: {fn['last_built_at']}")
if fn.get("message"):
lines.append(f" message: {fn['message']}")
lines.append(SEP)
lines.append(f" namespace: {namespace} | total: {len(items)}")
lines.append(SEP)
# Возвращаем str — python runtime отдаст text/plain напрямую
return "\n".join(lines) + "\n"
@@ -1 +0,0 @@
requests==2.31.0
@@ -1,58 +0,0 @@
// 2026-03-21 — js-idempotent: INSERT с проверкой по idempotency_key.
// Повторный вызов с тем же key НЕ создаёт дубль — возвращает существующую запись.
// Тестирует: идемпотентность через SELECT ... FOR UPDATE + условный INSERT.
const { Client } = require('pg');
async function run(event) {
const key = String(event.idempotency_key ?? `auto-${Date.now()}`).slice(0, 200);
const title = String(event.title ?? key).slice(0, 255);
const client = new Client({
host: process.env.PGHOST,
port: parseInt(process.env.PGPORT ?? '5432'),
database: process.env.PGDATABASE,
user: process.env.PGUSER,
password: process.env.PGPASSWORD,
ssl: { rejectUnauthorized: false },
});
await client.connect();
try {
await client.query('BEGIN');
// Ищем существующую запись по title (используем как idempotency key)
const existing = await client.query(
'SELECT id, title, created_at FROM terraform_demo_table WHERE title = $1 LIMIT 1 FOR UPDATE',
[key]
);
let action, row;
if (existing.rows.length > 0) {
action = 'existing';
row = existing.rows[0];
} else {
const ins = await client.query(
'INSERT INTO terraform_demo_table (title) VALUES ($1) RETURNING id, title, created_at',
[key]
);
action = 'created';
row = ins.rows[0];
}
await client.query('COMMIT');
return {
action,
id: row.id,
title: row.title,
created_at: row.created_at,
idempotency_key: key,
};
} catch (e) {
await client.query('ROLLBACK');
throw e;
} finally {
await client.end();
}
}
module.exports = { run };
@@ -1,7 +0,0 @@
{
"name": "js-idempotent",
"version": "1.0.0",
"dependencies": {
"pg": "^8.11.3"
}
}
@@ -1,43 +0,0 @@
// 2026-03-21 — js-pg-batch: вставляет N строк через parameterized bulk query.
// Тестирует: async/await PG с пакетной вставкой, Node.js под нагрузкой.
const { Client } = require('pg');
async function run(event) {
const n = Math.min(parseInt(event.n ?? 20, 10) || 20, 200);
const prefix = String(event.prefix ?? 'js-batch').slice(0, 40);
const client = new Client({
host: process.env.PGHOST,
port: parseInt(process.env.PGPORT ?? '5432'),
database: process.env.PGDATABASE,
user: process.env.PGUSER,
password: process.env.PGPASSWORD,
ssl: { rejectUnauthorized: false },
});
await client.connect();
try {
const ts = Date.now();
// Строим multi-value INSERT: INSERT INTO ... VALUES ($1), ($2), ...
const placeholders = [];
const values = [];
for (let i = 0; i < n; i++) {
placeholders.push(`($${i + 1})`);
values.push(`${prefix}-${ts}-${i}`);
}
const sql = `INSERT INTO terraform_demo_table (title) VALUES ${placeholders.join(',')} RETURNING id`;
const t0 = Date.now();
const res = await client.query(sql, values);
const elapsed = (Date.now() - t0) / 1000;
return {
inserted: res.rowCount,
first_id: res.rows[0]?.id ?? null,
elapsed_sec: elapsed,
};
} finally {
await client.end();
}
}
module.exports = { run };
@@ -1,7 +0,0 @@
{
"name": "js-pg-batch",
"version": "1.0.0",
"dependencies": {
"pg": "^8.11.3"
}
}
@@ -1,38 +0,0 @@
# 2026-03-21 — pg-bulk-insert: bulk INSERT через execute_values.
# Тестирует: большие батчи (до 500 строк), производительность, память.
import os, time, psycopg2, psycopg2.extras
def bulk_insert(event):
try:
n = max(0, min(int(event.get("n", 50)), 500)) # cap 500, min 0
except (TypeError, ValueError):
n = 50
prefix = str(event.get("prefix", "bulk"))[:50]
ts = int(time.time() * 1000)
# n=0 — граничный случай: вернуть сразу без обращения к PG.
if n == 0:
return {"inserted": 0, "first_id": None, "elapsed_sec": 0.0}
rows = [(f"{prefix}-{ts}-{i}",) for i in range(n)]
conn = psycopg2.connect(
host=os.environ["PGHOST"], port=int(os.environ.get("PGPORT", 5432)),
dbname=os.environ["PGDATABASE"], user=os.environ["PGUSER"],
password=os.environ["PGPASSWORD"], sslmode=os.environ.get("PGSSLMODE", "require"),
)
try:
t0 = time.time()
with conn.cursor() as cur:
psycopg2.extras.execute_values(
cur,
"INSERT INTO terraform_demo_table (title) VALUES %s RETURNING id",
rows,
page_size=100,
)
ids = [r[0] for r in cur.fetchall()]
conn.commit()
elapsed = round(time.time() - t0, 3)
return {"inserted": len(ids), "first_id": ids[0] if ids else None, "elapsed_sec": elapsed}
finally:
conn.close()
@@ -1,23 +0,0 @@
# 2026-03-21 — pg-counter: считает строки по prefix, возвращает статистику.
# Тестирует: SELECT COUNT с WHERE LIKE, агрегация, concurrent reads.
import os, psycopg2
def count(event):
prefix = event.get("prefix", "")
conn = psycopg2.connect(
host=os.environ["PGHOST"], port=int(os.environ.get("PGPORT", 5432)),
dbname=os.environ["PGDATABASE"], user=os.environ["PGUSER"],
password=os.environ["PGPASSWORD"], sslmode=os.environ.get("PGSSLMODE", "require"),
)
try:
with conn.cursor() as cur:
if prefix:
cur.execute("SELECT COUNT(*) FROM terraform_demo_table WHERE title LIKE %s", (f"{prefix}%",))
else:
cur.execute("SELECT COUNT(*) FROM terraform_demo_table")
total = cur.fetchone()[0]
cur.execute("SELECT COUNT(*) FROM terraform_demo_table WHERE created_at > now() - interval '1 hour'")
last_hour = cur.fetchone()[0]
return {"total": total, "last_hour": last_hour, "prefix": prefix or "*"}
finally:
conn.close()
@@ -1,38 +0,0 @@
# 2026-03-21 — pg-dedup: удаляет дубликаты по title, оставляет первый (min id).
# Тестирует: DELETE с subquery, CTE, idempotency (повторный вызов безопасен).
import os, psycopg2
def dedup(event):
dry_run = str(event.get("dry_run", "false")).lower() in ("true", "1", "yes")
conn = psycopg2.connect(
host=os.environ["PGHOST"], port=int(os.environ.get("PGPORT", 5432)),
dbname=os.environ["PGDATABASE"], user=os.environ["PGUSER"],
password=os.environ["PGPASSWORD"], sslmode=os.environ.get("PGSSLMODE", "require"),
)
try:
with conn.cursor() as cur:
# Считаем сколько дублей есть
cur.execute("""
SELECT COUNT(*) FROM terraform_demo_table t1
WHERE EXISTS (
SELECT 1 FROM terraform_demo_table t2
WHERE t2.title = t1.title AND t2.id < t1.id
)
""")
dupes_count = cur.fetchone()[0]
if not dry_run and dupes_count > 0:
cur.execute("""
DELETE FROM terraform_demo_table
WHERE id NOT IN (
SELECT MIN(id) FROM terraform_demo_table GROUP BY title
)
""")
deleted = cur.rowcount
conn.commit()
else:
deleted = 0
return {"duplicates_found": dupes_count, "deleted": deleted, "dry_run": dry_run}
finally:
conn.close()
@@ -1,33 +0,0 @@
# 2026-03-21 — pg-delete-old: удаляет строки старше N минут (default 60).
# Тестирует: DELETE с RETURNING, идемпотентность (повторный вызов = 0 удалений если нет старых).
import os, psycopg2, psycopg2.extras
def delete_old(event):
older_than_min = max(int(event.get("older_than_min", 60)), 1)
prefix_filter = event.get("prefix", "")
conn = psycopg2.connect(
host=os.environ["PGHOST"], port=int(os.environ.get("PGPORT", 5432)),
dbname=os.environ["PGDATABASE"], user=os.environ["PGUSER"],
password=os.environ["PGPASSWORD"], sslmode=os.environ.get("PGSSLMODE", "require"),
)
try:
with conn.cursor(cursor_factory=psycopg2.extras.RealDictCursor) as cur:
if prefix_filter:
cur.execute(
"DELETE FROM terraform_demo_table "
"WHERE created_at < now() - interval '1 minute' * %s "
"AND title LIKE %s RETURNING id, title",
(older_than_min, f"{prefix_filter}%"),
)
else:
cur.execute(
"DELETE FROM terraform_demo_table "
"WHERE created_at < now() - interval '1 minute' * %s RETURNING id, title",
(older_than_min,),
)
deleted = [dict(r) for r in cur.fetchall()]
conn.commit()
return {"deleted": len(deleted), "older_than_min": older_than_min, "sample": deleted[:5]}
finally:
conn.close()
@@ -1 +0,0 @@
psycopg2-binary
@@ -1,8 +0,0 @@
{
"name": "pg-info",
"version": "1.0.0",
"description": "sless nodejs20 function: pg version + table info",
"dependencies": {
"pg": "8.11.0"
}
}
-44
View File
@@ -1,44 +0,0 @@
// 2026-03-18
// pg_info.js — NodeJS-функция: проверка работы JS runtime + чтение мета-данных БД.
// Подключается к PostgreSQL через пакет pg, возвращает версию сервера и счётчик строк.
// Демонстрирует: nodejs20 runtime, npm-зависимость (package.json), PG из JS.
//
// ENV (те же что у python-функций):
// PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD, PGSSLMODE
//
// Entrypoint: pg_info.info
'use strict';
const { Client } = require('pg');
exports.info = async (event) => {
const client = new Client({
host: process.env.PGHOST,
port: parseInt(process.env.PGPORT || '5432'),
database: process.env.PGDATABASE,
user: process.env.PGUSER,
password: process.env.PGPASSWORD,
// pg-пакет требует явного ssl-объекта; rejectUnauthorized: false — т.к.
// self-signed cert на nubes managed PG, но канал всё равно шифруется.
ssl: process.env.PGSSLMODE === 'require' ? { rejectUnauthorized: false } : false,
});
await client.connect();
try {
const [versionRes, countRes] = await Promise.all([
client.query('SELECT version() AS v'),
client.query('SELECT COUNT(*) AS cnt FROM terraform_demo_table'),
]);
return {
runtime: 'nodejs20',
node_version: process.version,
pg_version: versionRes.rows[0].v,
table_rows: parseInt(countRes.rows[0].cnt, 10),
code_version: 'v2-agent-test',
};
} finally {
await client.end();
}
};
@@ -1,36 +0,0 @@
# 2026-03-21 — pg-search: полнотекстовый поиск по title через ILIKE + LIMIT/OFFSET.
# Тестирует: пагинацию, спецсимволы в input (XSS, SQL injection attempt → безопасно через параметры).
import os, psycopg2, psycopg2.extras
def search(event):
# «query» — основной параметр (user-friendly), «q» — алиас для совместимости.
query = str(event.get("query") or event.get("q") or "")[:200]
# int() может упасть если юзер прислал строку — защищаем try/except.
try:
limit = max(1, min(int(event.get("limit", 20)), 100))
except (TypeError, ValueError):
limit = 20
try:
offset = max(0, int(event.get("offset", 0)))
except (TypeError, ValueError):
offset = 0
conn = psycopg2.connect(
host=os.environ["PGHOST"], port=int(os.environ.get("PGPORT", 5432)),
dbname=os.environ["PGDATABASE"], user=os.environ["PGUSER"],
password=os.environ["PGPASSWORD"], sslmode=os.environ.get("PGSSLMODE", "require"),
)
try:
with conn.cursor(cursor_factory=psycopg2.extras.RealDictCursor) as cur:
pattern = f"%{query}%" if query else "%"
cur.execute(
"SELECT id, title, created_at::text FROM terraform_demo_table "
"WHERE title ILIKE %s ORDER BY id DESC LIMIT %s OFFSET %s",
(pattern, limit, offset),
)
rows = [dict(r) for r in cur.fetchall()]
cur.execute("SELECT COUNT(*) FROM terraform_demo_table WHERE title ILIKE %s", (pattern,))
total = cur.fetchone()["count"]
return {"rows": rows, "count": len(rows), "total": total, "q": query, "limit": limit, "offset": offset}
finally:
conn.close()
@@ -1 +0,0 @@
psycopg2-binary
@@ -1,38 +0,0 @@
# 2026-03-19
# pg_stats.py — тестовая функция (Test 7): возвращает агрегированную статистику
# по таблице terraform_demo_table: кол-во строк, дата первой и последней записи.
# Создаётся и удаляется в рамках тестового прогона.
#
# Entrypoint: pg_stats.get_stats
import os
import psycopg2
import json
_CODE_VERSION = "v1-test7"
def get_stats(event):
conn = psycopg2.connect(
host=os.environ["PGHOST"],
port=int(os.environ.get("PGPORT", "5432")),
dbname=os.environ["PGDATABASE"],
user=os.environ["PGUSER"],
password=os.environ["PGPASSWORD"],
sslmode=os.environ.get("PGSSLMODE", "require"),
)
try:
with conn.cursor() as cur:
cur.execute(
"SELECT COUNT(*) AS cnt, MIN(created_at) AS first, MAX(created_at) AS last "
"FROM terraform_demo_table"
)
row = cur.fetchone()
return {
"version": _CODE_VERSION,
"total_rows": row[0],
"first_row_at": str(row[1]) if row[1] else None,
"last_row_at": str(row[2]) if row[2] else None,
}
finally:
conn.close()
@@ -1 +0,0 @@
psycopg2-binary==2.9.9
@@ -1,36 +0,0 @@
# 2026-03-21 — pg-upsert: INSERT ... ON CONFLICT (title) DO UPDATE.
# Тестирует: идемпотентность вставки — один и тот же title можно вызывать 100 раз подряд.
# Требует уникального индекса на title — создаётся при первом вызове (CREATE UNIQUE INDEX IF NOT EXISTS).
import os, psycopg2
def upsert(event):
title = str(event.get("title", "upsert-default"))[:255]
payload = str(event.get("payload", ""))[:500]
conn = psycopg2.connect(
host=os.environ["PGHOST"], port=int(os.environ.get("PGPORT", 5432)),
dbname=os.environ["PGDATABASE"], user=os.environ["PGUSER"],
password=os.environ["PGPASSWORD"], sslmode=os.environ.get("PGSSLMODE", "require"),
)
try:
with conn.cursor() as cur:
# Создаём уникальный индекс если нет — для поддержки ON CONFLICT
cur.execute(
"CREATE UNIQUE INDEX IF NOT EXISTS terraform_demo_table_title_uniq "
"ON terraform_demo_table (title)"
)
cur.execute(
"INSERT INTO terraform_demo_table (title) VALUES (%s) "
"ON CONFLICT (title) DO UPDATE SET created_at = now() "
"RETURNING id, title, created_at::text, xmax",
(title,),
)
row = cur.fetchone()
was_insert = row[3] == 0 # xmax=0 означает INSERT, иначе UPDATE
conn.commit()
return {
"id": row[0], "title": row[1], "created_at": row[2],
"action": "inserted" if was_insert else "updated",
}
finally:
conn.close()
@@ -1 +0,0 @@
psycopg2-binary
@@ -1,54 +0,0 @@
# 2026-03-21 — py-retry-writer: пишет N строк с retry при PG ошибке.
# Тестирует: устойчивость к transient PG errors (simulate_error=true), retry logic,
# корректный rollback при частичном сбое.
import os, time, psycopg2, random
_MAX_RETRIES = 3
def retry_write(event):
n = min(int(event.get("n", 5)), 100)
prefix = str(event.get("prefix", "retry"))[:40]
# simulate_error: с вероятностью 30% кидает OperationalError на 2-й попытке
simulate = str(event.get("simulate_error", "false")).lower() in ("true", "1")
attempt = 0
last_err = None
while attempt < _MAX_RETRIES:
attempt += 1
try:
conn = psycopg2.connect(
host=os.environ["PGHOST"], port=int(os.environ.get("PGPORT", 5432)),
dbname=os.environ["PGDATABASE"], user=os.environ["PGUSER"],
password=os.environ["PGPASSWORD"], sslmode=os.environ.get("PGSSLMODE", "require"),
)
inserted = []
try:
with conn.cursor() as cur:
for i in range(n):
# Симуляция: на первой попытке падаем с вероятностью 50%
if simulate and attempt == 1 and i == n // 2:
raise psycopg2.OperationalError("simulated transient error")
title = f"{prefix}-{int(time.time()*1000)}-{i}-a{attempt}"
cur.execute(
"INSERT INTO terraform_demo_table (title) VALUES (%s) RETURNING id",
(title,),
)
inserted.append(cur.fetchone()[0])
conn.commit()
return {
"ok": True, "inserted": len(inserted),
"attempts": attempt, "first_id": inserted[0] if inserted else None,
}
except Exception as e:
conn.rollback()
raise
finally:
conn.close()
except psycopg2.OperationalError as e:
last_err = str(e)
if attempt < _MAX_RETRIES:
time.sleep(0.3 * attempt) # exponential backoff
continue
return {"ok": False, "attempts": attempt, "last_error": last_err}
@@ -1 +0,0 @@
psycopg2-binary
@@ -1,3 +0,0 @@
# 2026-03-17 00:00
# requirements.txt — зависимости для функции запуска SQL.
psycopg2-binary==2.9.9
@@ -1,39 +0,0 @@
# 2026-03-17 00:00
# sql_runner.py — функция для выполнения SQL-операторов из входного события.
import os
import psycopg2
def run_sql(event):
# Выполняет список SQL-операторов в одной транзакции для атомарной инициализации схемы.
# Параметры подключения передаются раздельно, чтобы избежать ошибок парсинга DSN при спецсимволах.
pg_host = os.environ["PGHOST"]
pg_port = os.environ.get("PGPORT", "5432")
pg_database = os.environ["PGDATABASE"]
pg_user = os.environ["PGUSER"]
pg_password = os.environ["PGPASSWORD"]
pg_sslmode = os.environ.get("PGSSLMODE", "require")
statements = event.get("statements", [])
if not statements:
return {"error": "no statements provided"}
connection = psycopg2.connect(
host=pg_host,
port=pg_port,
dbname=pg_database,
user=pg_user,
password=pg_password,
sslmode=pg_sslmode,
)
try:
cursor = connection.cursor()
for statement in statements:
cursor.execute(statement)
connection.commit()
return {"ok": True, "executed": len(statements)}
except Exception as error:
connection.rollback()
return {"error": str(error)}
finally:
connection.close()
@@ -1,20 +0,0 @@
# 2026-03-19
# stress_bigloop.py — CPU-интенсивная функция: считает сумму квадратов N чисел.
# Проверяет поведение под нагрузкой (большая и средняя итерация).
import time
_VERSION = "v1"
def run(event):
n = int(event.get("n", 500_000))
start = time.monotonic()
total = sum(i * i for i in range(n))
elapsed = round(time.monotonic() - start, 4)
return {
"version": _VERSION,
"n": n,
"sum_of_squares": total,
"elapsed_sec": elapsed,
}
@@ -1,13 +0,0 @@
# 2026-03-19
# stress_divzero.py — намеренно делит на ноль (ZeroDivisionError).
# Проверяет: платформа перехватывает панику, возвращает HTTP 500, не роняет под.
_VERSION = "v1"
def run(event):
numerator = int(event.get("n", 42))
denominator = int(event.get("d", 0)) # по умолчанию 0 — намеренный краш
# ZeroDivisionError: проверяем что платформа обрабатывает исключения
result = numerator / denominator
return {"version": _VERSION, "result": result}
@@ -1,7 +0,0 @@
{
"name": "stress-js-async",
"version": "1.0.0",
"dependencies": {
"pg": "^8.11.0"
}
}
@@ -1,37 +0,0 @@
// 2026-03-19
// stress_js_async.js — делает 3 параллельных запроса к PG через Promise.all.
// Проверяет nodejs20 runtime под умеренной нагрузкой и async/await.
//
// Entrypoint: stress_js_async.run
'use strict';
const { Client } = require('pg');
exports.run = async (event) => {
const client = new Client({
host: process.env.PGHOST,
port: parseInt(process.env.PGPORT || '5432'),
database: process.env.PGDATABASE,
user: process.env.PGUSER,
password: process.env.PGPASSWORD,
ssl: process.env.PGSSLMODE === 'require' ? { rejectUnauthorized: false } : false,
});
await client.connect();
try {
const [ver, cnt, max] = await Promise.all([
client.query('SELECT version() AS v'),
client.query('SELECT COUNT(*) AS cnt FROM terraform_demo_table'),
client.query('SELECT MAX(id) AS max_id FROM terraform_demo_table'),
]);
return {
runtime: 'nodejs20',
version: 'v1',
pg_version: ver.rows[0].v.split(' ').slice(0, 2).join(' '),
total_rows: parseInt(cnt.rows[0].cnt, 10),
max_id: max.rows[0].max_id,
};
} finally {
await client.end();
}
};
@@ -1,5 +0,0 @@
{
"name": "stress-js-badenv",
"version": "1.0.0",
"dependencies": {}
}
@@ -1,17 +0,0 @@
// 2026-03-19
// stress_js_badenv.js — читает несуществующую переменную env и падает.
// Проверяет: платформа перехватывает TypeError/undefined, возвращает 500.
//
// Entrypoint: stress_js_badenv.run
'use strict';
exports.run = async (event) => {
const crash = event.crash !== false; // по умолчанию crash=true
if (crash) {
// Читаем несуществующий env, пытаемся вызвать .toUpperCase() на undefined
const val = process.env.THIS_VAR_DOES_NOT_EXIST_AT_ALL;
return { shout: val.toUpperCase() }; // TypeError: Cannot read properties of undefined
}
return { runtime: 'nodejs20', version: 'v1', crashed: false };
};
@@ -1,18 +0,0 @@
# 2026-03-19
# stress_slow.py — долгая функция: спит N секунд (по умолчанию 8).
# Проверяет что timeout-механизм и параллельные запросы не блокируют друг друга.
import time
import os
_VERSION = "v1"
def run(event):
secs = int(event.get("sleep", 8))
time.sleep(secs)
return {
"version": _VERSION,
"slept_sec": secs,
"pid": os.getpid(),
}
@@ -1 +0,0 @@
psycopg2-binary==2.9.9
@@ -1,39 +0,0 @@
# 2026-03-19
# stress_writer.py — пишет N строк в terraform_demo_table (по умолчанию 5).
# Проверяет параллельные INSERT'ы и устойчивость соединения с PG при нагрузке.
import os
import psycopg2
import time
_VERSION = "v1"
def run(event):
n = int(event.get("rows", 5))
prefix = event.get("prefix", "stress")
conn = psycopg2.connect(
host=os.environ["PGHOST"],
port=int(os.environ.get("PGPORT", "5432")),
dbname=os.environ["PGDATABASE"],
user=os.environ["PGUSER"],
password=os.environ["PGPASSWORD"],
sslmode=os.environ.get("PGSSLMODE", "require"),
)
inserted = []
try:
with conn.cursor() as cur:
for i in range(n):
title = f"{prefix}-{int(time.time()*1000)}-{i}"
cur.execute(
"INSERT INTO terraform_demo_table (title) VALUES (%s) RETURNING id",
(title,),
)
row = cur.fetchone()
inserted.append({"id": row[0], "title": title})
conn.commit()
finally:
conn.close()
return {"version": _VERSION, "inserted": inserted, "count": len(inserted)}
@@ -1 +0,0 @@
psycopg2-binary==2.9.9
-133
View File
@@ -1,133 +0,0 @@
# 2026-03-19 — добавлен version и hostname в ответ list_rows для тестирования обновления кода
# table_rw.py — чтение и запись строк в terraform_demo_table.
# Два entrypoint в одном файле: list_rows (JSON API) и add_row (HTML-страница + POST-обработчик).
# ENV: PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD, PGSSLMODE
import os
import json
import socket
import psycopg2
import psycopg2.extras
_CODE_VERSION = "v2-with-hostname"
def _connect():
return psycopg2.connect(
host=os.environ["PGHOST"],
port=os.environ.get("PGPORT", "5432"),
dbname=os.environ["PGDATABASE"],
user=os.environ["PGUSER"],
password=os.environ["PGPASSWORD"],
sslmode=os.environ.get("PGSSLMODE", "require"),
)
def list_rows(event):
# Возвращает все строки terraform_demo_table, отсортированные по убыванию created_at.
conn = _connect()
try:
cur = conn.cursor(cursor_factory=psycopg2.extras.RealDictCursor)
cur.execute(
"SELECT id, title, created_at::text FROM terraform_demo_table ORDER BY created_at DESC"
)
rows = [dict(r) for r in cur.fetchall()]
return {"rows": rows, "count": len(rows), "version": _CODE_VERSION, "host": socket.gethostname()}
finally:
conn.close()
def _render_page(rows, message=""):
# HTML-страница с формой ввода и таблицей строк.
# message — статус последней операции (успех / ошибка).
rows_html = "".join(
f"<tr><td>{r['id']}</td><td>{r['title']}</td><td>{r['created_at']}</td></tr>"
for r in rows
)
msg_html = f'<p class="msg">{message}</p>' if message else ""
return f"""<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="utf-8">
<title>pg-table-writer</title>
<style>
body {{ font-family: sans-serif; max-width: 700px; margin: 40px auto; background: #111; color: #eee; }}
h1 {{ color: #7dd3fc; }}
form {{ display: flex; gap: 8px; margin-bottom: 24px; }}
input[type=text] {{ flex: 1; padding: 8px 12px; border-radius: 6px; border: 1px solid #444; background: #1e1e1e; color: #eee; font-size: 15px; }}
button {{ padding: 8px 18px; background: #2563eb; color: #fff; border: none; border-radius: 6px; cursor: pointer; font-size: 15px; }}
button:hover {{ background: #1d4ed8; }}
table {{ width: 100%; border-collapse: collapse; }}
th, td {{ padding: 8px 10px; border-bottom: 1px solid #333; text-align: left; }}
th {{ color: #7dd3fc; }}
.msg {{ color: #4ade80; margin-bottom: 12px; }}
</style>
</head>
<body>
<h1>pg-table-writer</h1>
<form method="POST">
<input type="text" name="title" placeholder="Введите строку..." autofocus required>
<button type="submit">Добавить</button>
</form>
{msg_html}
<table>
<thead><tr><th>#</th><th>title</th><th>created_at</th></tr></thead>
<tbody>{rows_html}</tbody>
</table>
</body>
</html>"""
def add_row(event):
# GET → HTML-страница с формой и списком строк.
# POST → вставляет строку из form-поля title или JSON-поля title,
# затем возвращает обновлённую HTML-страницу.
# POST с Content-Type: application/json (curl/API) → возвращает JSON.
method = event.get("_method", "GET")
if method == "GET":
conn = _connect()
try:
cur = conn.cursor(cursor_factory=psycopg2.extras.RealDictCursor)
cur.execute("SELECT id, title, created_at::text FROM terraform_demo_table ORDER BY created_at DESC")
rows = [dict(r) for r in cur.fetchall()]
finally:
conn.close()
return _render_page(rows)
# POST — вставка строки
# Поле title приходит либо из JSON-тела, либо из application/x-www-form-urlencoded.
# Сервер уже распарсил JSON в event; form-данные приходят как event["body"] = "title=...".
title = event.get("title", "").strip()
if not title:
# Попытка распарсить form-encoded body (браузерная форма)
body = event.get("body", "")
if body.startswith("title="):
from urllib.parse import unquote_plus
title = unquote_plus(body[len("title="):].split("&")[0]).strip()
if not title:
return {"ok": False, "error": "title is required"}
conn = _connect()
try:
cur = conn.cursor(cursor_factory=psycopg2.extras.RealDictCursor)
cur.execute(
"INSERT INTO terraform_demo_table (title) VALUES (%s) RETURNING id, title, created_at::text",
(title,),
)
row = dict(cur.fetchone())
conn.commit()
# Если запрос из браузера (form POST) — возвращаем обновлённую страницу.
# Если из curl/API — возвращаем JSON.
accept = event.get("_accept", "")
if "application/json" in accept:
return {"ok": True, "row": row}
# Перечитываем все строки для обновлённой страницы
cur.execute("SELECT id, title, created_at::text FROM terraform_demo_table ORDER BY created_at DESC")
rows = [dict(r) for r in cur.fetchall()]
return _render_page(rows, message=f"Добавлено: «{row['title']}»")
finally:
conn.close()
-39
View File
@@ -1,39 +0,0 @@
#!/usr/bin/env bash
# 2026-03-21 — deploy_and_run_chaos.sh
# ЗАПУСКАТЬ НА VM: ssh naeel@5.172.178.213
# cd /home/naeel/terra/sless/examples/POSTGRES
# bash deploy_and_run_chaos.sh
set -euo pipefail
TF_DIR="/home/naeel/terra/sless/examples/POSTGRES"
cd "$TF_DIR"
echo "=== [1/2] terraform apply chaos_marathon.tf ==="
terraform apply \
-target=sless_service.pg_counter \
-target=sless_service.pg_dedup \
-target=sless_service.pg_search \
-target=sless_service.pg_bulk_insert \
-target=sless_service.pg_delete_old \
-target=sless_service.pg_upsert \
-target=sless_service.chaos_echo \
-target=sless_service.chaos_badparams \
-target=sless_service.chaos_slowquery \
-target=sless_service.chaos_bigpayload \
-target=sless_service.go_pg_race \
-target=sless_service.go_counter_atomic \
-target=sless_service.js_pg_batch \
-target=sless_service.js_idempotent \
-target=sless_service.py_retry_writer \
-auto-approve
echo ""
echo "=== [2/2] Запуск chaos_marathon.sh ==="
LOG="/tmp/chaos_marathon_$(date +%Y%m%d_%H%M).log"
bash chaos_marathon.sh 2>&1 | tee "$LOG"
echo ""
echo "Лог сохранён: $LOG"
-437
View File
@@ -1,437 +0,0 @@
#!/bin/bash
# 2026-03-21 — full_test.sh: комплексный тест всех sless-ресурсов.
#
# Фазы:
# 1. CRUD — проверяем наличие всех сервисов через API
# 2. Функциональные — корректность ответов, правильные значения
# 3. PG-стресс — параллельные write/read, pgstorm (Go), js-async storm
# 4. Краш-шторм — параллельные паники, проверяем что платформа жива после
#
# Запуск: bash full_test.sh
# Зависимости: curl, python3, terraform (для CRUD destroy/create)
#
# Среда: namespace sless-ffd1f598c169b0ae, токен в ~/terra/sless/test.token
set -uo pipefail
TOKEN=$(cat /home/naeel/terra/sless/test.token)
NS="sless-ffd1f598c169b0ae"
BASE="https://sless.kube5s.ru/fn/$NS"
API="https://sless.kube5s.ru/v1/namespaces/$NS"
GREEN='\033[0;32m'
RED='\033[0;31m'
YELLOW='\033[1;33m'
CYAN='\033[0;36m'
NC='\033[0m'
PASS=0
FAIL=0
pass() { echo -e " ${GREEN}[PASS]${NC} $1"; ((PASS++)); }
fail() { echo -e " ${RED}[FAIL]${NC} $1"; ((FAIL++)); }
section() { echo -e "\n${YELLOW}━━━ $1 ━━━${NC}"; }
info() { echo -e " ${CYAN}[INFO]${NC} $1"; }
# Вызвать URL и вернуть JSON (не проверяя код)
call() {
local url="$1" body="${2:-}" extra_headers="${3:-}"
local args=(-s -m 90 -H "Authorization: Bearer $TOKEN")
[[ -n "$body" ]] && args+=(-H "Content-Type: application/json" -d "$body")
[[ -n "$extra_headers" ]] && args+=(-H "$extra_headers")
curl "${args[@]}" "$url"
}
# Проверить HTTP-код (только код, без тела)
check_http() {
local label="$1" url="$2" method="${3:-GET}" body="${4:-}" expect="${5:-200}"
local args=(-s -o /dev/null -w "%{http_code}" -m 90 -H "Authorization: Bearer $TOKEN")
[[ -n "$body" ]] && args+=(-H "Content-Type: application/json" -d "$body")
[[ "$method" != "GET" ]] && args+=(-X "$method")
local code
code=$(curl "${args[@]}" "$url")
if [[ "$code" == "$expect" ]]; then
pass "$label → HTTP $code"
else
fail "$label → HTTP $code (ожидали $expect)"
fi
}
# Вызвать функцию, проверить поле JSON == expected
check_field() {
local label="$1" url="$2" body="$3" field="$4" expected="$5"
local resp
resp=$(call "$url" "$body")
local actual
actual=$(echo "$resp" | python3 -c "
import sys, json
try:
d = json.load(sys.stdin)
v = d.get('$field', '__MISSING__')
print(str(v))
except Exception as e:
print('PARSE_ERROR: ' + str(e))
" 2>/dev/null)
if [[ "$actual" == "$expected" ]]; then
pass "$label"
else
fail "$label → got '$actual' (ожидали '$expected') | resp: $(echo "$resp" | head -c 200)"
fi
}
# Вызвать функцию, проверить что поле JSON > 0 (числовое)
check_field_gt0() {
local label="$1" url="$2" body="$3" field="$4"
local resp
resp=$(call "$url" "$body")
local actual
actual=$(echo "$resp" | python3 -c "
import sys, json
try:
d = json.load(sys.stdin)
v = d.get('$field', 0)
print(1 if float(str(v)) > 0 else 0)
except:
print(0)
" 2>/dev/null)
if [[ "$actual" == "1" ]]; then
pass "$label"
else
fail "$label → resp: $(echo "$resp" | head -c 200)"
fi
}
# ═══════════════════════════════════════════════════════════════
section "ФАЗА 1: CRUD — проверяем что все сервисы существуют"
# ═══════════════════════════════════════════════════════════════
ALL_SERVICES=(
pg-info pg-table-reader pg-table-writer
stress-go-fast stress-go-nil stress-go-pgstorm
stress-js-async stress-js-badenv
stress-slow stress-bigloop stress-divzero stress-writer pg-stats
)
for svc in "${ALL_SERVICES[@]}"; do
code=$(curl -s -o /dev/null -w "%{http_code}" -m 10 \
-H "Authorization: Bearer $TOKEN" "$API/services/$svc")
if [[ "$code" == "200" ]]; then
pass "API GET /services/$svc → 200"
else
fail "API GET /services/$svc$code"
fi
done
info "Проверяем несуществующий сервис → 404"
check_http "GET /services/THIS-SERVICE-DOES-NOT-EXIST → 404" \
"$API/services/this-service-does-not-exist" "GET" "" "404"
info "Проверяем jobs"
code=$(curl -s -o /dev/null -w "%{http_code}" -m 10 \
-H "Authorization: Bearer $TOKEN" "$API/jobs/pg-create-table-job-main-v13")
if [[ "$code" == "200" ]]; then
pass "API GET /jobs/pg-create-table-job-main-v13 → 200"
else
fail "API GET /jobs/pg-create-table-job-main-v13 → $code"
fi
# ═══════════════════════════════════════════════════════════════
section "ФАЗА 2: Функциональные тесты (корректность ответов)"
# ═══════════════════════════════════════════════════════════════
info "── Go 1.23 ──"
# stress-go-fast: factorial(10) = 3628800
check_field "go-fast runtime=go1.23" \
"$BASE/stress-go-fast" '{"n":10}' "runtime" "go1.23"
check_field "go-fast factorial(10)=3628800" \
"$BASE/stress-go-fast" '{"n":10}' "factorial" "3628800"
check_field "go-fast fib(10)=55" \
"$BASE/stress-go-fast" '{"n":10}' "fib" "55"
# n>20 обрезается до 20 — проверяем граничный случай
check_field "go-fast n=21 обрезается до 20: fib(20)=6765" \
"$BASE/stress-go-fast" '{"n":21}' "fib" "6765"
# stress-go-nil crash=false → crashed:false
check_field "go-nil crash=false → crashed=False" \
"$BASE/stress-go-nil" '{"crash":false}' "crashed" "False"
# stress-go-nil crash=true → 500
check_http "go-nil crash=true → HTTP 500" \
"$BASE/stress-go-nil" "POST" '{"crash":true}' "500"
# stress-go-nil default (no body) → 500 (по умолчанию crash=true)
check_http "go-nil без параметров → HTTP 500" \
"$BASE/stress-go-nil" "GET" "" "500"
info "── Node.js 20 ──"
# stress-js-async: чтение PG, возвращает pg_version
check_field "js-async runtime=nodejs20" \
"$BASE/stress-js-async" "" "runtime" "nodejs20"
check_field_gt0 "js-async total_rows > 0" \
"$BASE/stress-js-async" "" "total_rows"
# stress-js-badenv crash=false → ok
check_field "js-badenv crash=false → runtime=nodejs20" \
"$BASE/stress-js-badenv" '{"crash":false}' "runtime" "nodejs20"
# stress-js-badenv crash=true → 500
check_http "js-badenv crash=true → HTTP 500" \
"$BASE/stress-js-badenv" "POST" '{"crash":true}' "500"
info "── Python 3.11 ──"
# stress-slow
check_field "slow: slept_sec=3" \
"$BASE/stress-slow" '{"sleep":3}' "slept_sec" "3"
check_field "slow: version=v1" \
"$BASE/stress-slow" '{"sleep":1}' "version" "v1"
# stress-bigloop: sum(i*i for i in range(10)) = 285
check_field "bigloop n=10 sum_of_squares=285" \
"$BASE/stress-bigloop" '{"n":10}' "sum_of_squares" "285"
# range(100): 0+1+4+...+9801 = sum(i^2,0..99) = 99*100*199/6 = 328350
check_field "bigloop n=100 sum_of_squares=328350" \
"$BASE/stress-bigloop" '{"n":100}' "sum_of_squares" "328350"
# stress-divzero 42/7 = 6.0
check_field "divzero 42/7=6.0" \
"$BASE/stress-divzero" '{"n":42,"d":7}' "result" "6.0"
# divzero d=0 → 500
check_http "divzero d=0 → HTTP 500" \
"$BASE/stress-divzero" "POST" '{"n":1,"d":0}' "500"
# stress-writer: записывает 3 строки
check_field "writer rows=3 → count=3" \
"$BASE/stress-writer" '{"rows":3,"prefix":"functional-test"}' "count" "3"
check_field "writer rows=1 → count=1" \
"$BASE/stress-writer" '{"rows":1,"prefix":"functional-single"}' "count" "1"
# pg-stats
check_field "pg-stats version=v1-test7" \
"$BASE/pg-stats" "" "version" "v1-test7"
check_field_gt0 "pg-stats total_rows > 0" \
"$BASE/pg-stats" "" "total_rows"
# pg-info (nodejs)
check_field "pg-info runtime=nodejs20" \
"$BASE/pg-info" "" "runtime" "nodejs20"
# pg-table-reader
check_http "table-reader HTTP 200" "$BASE/pg-table-reader"
READER_RESP=$(call "$BASE/pg-table-reader")
READER_COUNT=$(echo "$READER_RESP" | python3 -c "
import sys, json
try:
d = json.load(sys.stdin)
print(d.get('count', 0))
except:
print(0)
" 2>/dev/null)
if [[ "$READER_COUNT" -gt 0 ]] 2>/dev/null; then
pass "table-reader count=$READER_COUNT строк"
else
fail "table-reader ожидали >0 строк, получили: $READER_COUNT | $(echo "$READER_RESP" | head -c 200)"
fi
# pg-table-writer: POST JSON должен вставить строку и вернуть JSON
info "pg-table-writer POST (ожидаем JSON если платформа инжектит _method)"
WRITER_RESP=$(curl -s -m 30 -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"title":"full-test-insert-2026"}' \
"$BASE/pg-table-writer")
WRITER_OK=$(echo "$WRITER_RESP" | python3 -c "
import sys, json
try:
d = json.load(sys.stdin)
print(d.get('ok', False))
except:
print('NOT_JSON')
" 2>/dev/null)
if [[ "$WRITER_OK" == "True" ]]; then
pass "table-writer POST → ok=True, строка вставлена"
else
# HTML ответ — платформа не инжектит _method
info "table-writer вернул не JSON (вероятно HTML), ok=$WRITER_OK"
info "resp: $(echo "$WRITER_RESP" | head -c 100)"
# Это не баг, но фиксируем как наблюдение
fi
# ═══════════════════════════════════════════════════════════════
section "ФАЗА 3: PG-стресс (параллельная нагрузка на PostgreSQL)"
# ═══════════════════════════════════════════════════════════════
info "Запуск 40 параллельных stress-writer × 5 строк = 200 INSERT..."
ROWS_BEFORE=$(echo "$READER_COUNT")
WRITER_PIDS=()
for i in $(seq 1 40); do
curl -s -m 60 -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d "{\"rows\":5,\"prefix\":\"pgstorm-w$i\"}" \
"$BASE/stress-writer" > "/tmp/sw_$i.json" 2>&1 &
WRITER_PIDS+=($!)
done
wait "${WRITER_PIDS[@]}"
WRITER_OK=0; WRITER_FAIL=0
for i in $(seq 1 40); do
cnt=$(python3 -c "
import json
try:
d = json.load(open('/tmp/sw_$i.json'))
print(d.get('count', 0))
except:
print(0)
" 2>/dev/null)
if [[ "$cnt" == "5" ]]; then
((WRITER_OK++))
else
((WRITER_FAIL++))
info " writer batch $i: cnt=$cnt | $(cat /tmp/sw_$i.json | head -c 150)"
fi
done
info "writer: $WRITER_OK/40 OK, $WRITER_FAIL failed"
[[ "$WRITER_FAIL" == "0" ]] \
&& pass "40× parallel writer: все 40 вернули count=5 (200 строк)" \
|| fail "40× parallel writer: $WRITER_FAIL пакетов с ошибкой"
# Проверим что строки реально появились в таблице
NEW_COUNT=$(call "$BASE/pg-stats" | python3 -c "
import sys, json
try:
print(json.load(sys.stdin).get('total_rows', 0))
except:
print(0)
")
info "pg-stats: total_rows=$NEW_COUNT (было $ROWS_BEFORE до stress)"
[[ "$NEW_COUNT" -gt "$ROWS_BEFORE" ]] \
&& pass "pg-stats: строки выросли ($ROWS_BEFORE$NEW_COUNT)" \
|| fail "pg-stats: строки не выросли ($ROWS_BEFORE$NEW_COUNT)"
info "Запуск 30 параллельных stress-js-async (3 PG-запроса каждый = 90 одновременных)..."
JS_PIDS=()
for i in $(seq 1 30); do
curl -s -m 30 -H "Authorization: Bearer $TOKEN" \
"$BASE/stress-js-async" > "/tmp/jsa_$i.json" 2>&1 &
JS_PIDS+=($!)
done
wait "${JS_PIDS[@]}"
JS_OK=0; JS_FAIL=0
for i in $(seq 1 30); do
rt=$(python3 -c "
import json
try:
print(json.load(open('/tmp/jsa_$i.json')).get('runtime', 'err'))
except:
print('err')
" 2>/dev/null)
if [[ "$rt" == "nodejs20" ]]; then ((JS_OK++)); else ((JS_FAIL++)); fi
done
[[ "$JS_FAIL" == "0" ]] \
&& pass "30× parallel js-async: все 30 OK" \
|| fail "30× parallel js-async: $JS_OK ok, $JS_FAIL failed"
info "Запуск stress-go-pgstorm workers=50 duration=45s..."
PGSTORM_RESP=$(curl -s -m 120 \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"workers":50,"duration_sec":45,"max_delay_ms":50}' \
"$BASE/stress-go-pgstorm")
PGSTORM_OK=$(echo "$PGSTORM_RESP" | python3 -c "
import sys, json
try:
d = json.load(sys.stdin)
print(d.get('ok_ops', 0))
except:
print(0)
")
PGSTORM_ERR=$(echo "$PGSTORM_RESP" | python3 -c "
import sys, json
try:
d = json.load(sys.stdin)
print(d.get('err_ops', 0))
except:
print(-1)
")
PGSTORM_RPS=$(echo "$PGSTORM_RESP" | python3 -c "
import sys, json
try:
d = json.load(sys.stdin)
print(d.get('ops_per_sec', '?'))
except:
print('?')
")
info "pgstorm: ok=$PGSTORM_OK err=$PGSTORM_ERR ops/s=$PGSTORM_RPS"
[[ "$PGSTORM_OK" -gt 0 ]] 2>/dev/null \
&& pass "stress-go-pgstorm: $PGSTORM_OK ops OK, $PGSTORM_ERR err, $PGSTORM_RPS ops/s" \
|| fail "stress-go-pgstorm: 0 операций | $(echo "$PGSTORM_RESP" | head -c 300)"
# Итоговая статистика таблицы
FINAL_STATS=$(call "$BASE/pg-stats")
FINAL_ROWS=$(echo "$FINAL_STATS" | python3 -c "
import sys, json
try:
print(json.load(sys.stdin).get('total_rows', 0))
except:
print(0)
")
info "Итого строк в terraform_demo_table: $FINAL_ROWS"
# ═══════════════════════════════════════════════════════════════
section "ФАЗА 4: Краш-шторм (параллельные паники — платформа должна жить)"
# ═══════════════════════════════════════════════════════════════
info "25× го-nil crash + 25× divzero + 25× js-badenv = 75 параллельных крашей..."
CRASH_PIDS=()
for i in $(seq 1 25); do
curl -s -o /dev/null -w "%{http_code}" -m 15 \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"crash":true}' "$BASE/stress-go-nil" > "/tmp/c_nil_$i.txt" 2>&1 &
CRASH_PIDS+=($!)
curl -s -o /dev/null -w "%{http_code}" -m 15 \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"n":1,"d":0}' "$BASE/stress-divzero" > "/tmp/c_dz_$i.txt" 2>&1 &
CRASH_PIDS+=($!)
curl -s -o /dev/null -w "%{http_code}" -m 15 \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"crash":true}' "$BASE/stress-js-badenv" > "/tmp/c_js_$i.txt" 2>&1 &
CRASH_PIDS+=($!)
done
wait "${CRASH_PIDS[@]}"
C500=0; CNOT500=0
for i in $(seq 1 25); do
for f in "/tmp/c_nil_$i.txt" "/tmp/c_dz_$i.txt" "/tmp/c_js_$i.txt"; do
code=$(cat "$f" 2>/dev/null || echo "0")
if [[ "$code" == "500" ]]; then ((C500++)); else ((CNOT500++)); info " неожиданный $f: code=$code"; fi
done
done
info "Краши: $C500 × 500, $CNOT500 неожиданных"
[[ "$CNOT500" == "0" ]] \
&& pass "75× краш-шторм: все вернули HTTP 500 (платформа устойчива)" \
|| fail "75× краш-шторм: $CNOT500 ответов не 500"
info "Проверяем что сервисы живы после краш-шторма..."
check_http "go-fast: жив после штормов" "$BASE/stress-go-fast" "GET" "" "200"
check_http "js-async: жив после штормов" "$BASE/stress-js-async" "GET" "" "200"
check_http "pg-table-reader: жив после штормов" "$BASE/pg-table-reader" "GET" "" "200"
check_http "pg-stats: жив после штормов" "$BASE/pg-stats" "GET" "" "200"
# ═══════════════════════════════════════════════════════════════
section "ИТОГИ"
# ═══════════════════════════════════════════════════════════════
echo ""
TOTAL=$((PASS + FAIL))
echo -e " Всего тестов: $TOTAL"
echo -e " ${GREEN}PASS: $PASS${NC}"
echo -e " ${RED}FAIL: $FAIL${NC}"
echo ""
if [[ "$FAIL" == "0" ]]; then
echo -e " ${GREEN}✓ ВСЕ ТЕСТЫ ПРОШЛИ${NC}"
exit 0
else
echo -e " ${RED}✗ ЕСТЬ ПАДЕНИЯ ($FAIL)${NC}"
exit 1
fi
-105
View File
@@ -1,105 +0,0 @@
// 2026-03-20 (merge: sless_function + старый sless_job объединены в один self-contained sless_job)
// Теперь sless_job несёт в себе runtime/entrypoint/source_dir — не нужен отдельный sless_function.
// WaitJobDone таймаут 900s покрывает kaniko сборку (~5 мин) + выполнение SQL (~несколько сек).
# Одноразовый запуск: собирает образ через kaniko, выполняет SQL, завершается.
# Заменяет sless_function.postgres_sql_runner_create_table + sless_job.postgres_table_init_job.
resource "sless_job" "postgres_table_init_job" {
name = "pg-create-table-job-main-v13"
runtime = "python3.11"
entrypoint = "sql_runner.run_sql"
memory_mb = 128
timeout_sec = 30
source_dir = "${path.module}/code/sql-runner"
wait_timeout_sec = 900
run_id = 13
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
event_json = jsonencode({
statements = [
"CREATE TABLE IF NOT EXISTS terraform_demo_table (id serial PRIMARY KEY, title text NOT NULL, created_at timestamp DEFAULT now())"
]
})
depends_on = [nubes_postgres_database.db]
}
# Long-running сервис на NodeJS: возвращает версию PG-сервера и счётчик строк в таблице.
resource "sless_service" "pg_info" {
name = "pg-info"
runtime = "nodejs20"
entrypoint = "pg_info.info"
memory_mb = 128
timeout_sec = 15
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
source_dir = "${path.module}/code/pg-info"
depends_on = [sless_job.postgres_table_init_job]
}
resource "sless_service" "postgres_table_reader" {
name = "pg-table-reader"
runtime = "python3.11"
entrypoint = "table_rw.list_rows"
memory_mb = 128
timeout_sec = 30
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
source_dir = "${path.module}/code/table-rw"
depends_on = [sless_job.postgres_table_init_job]
}
output "table_reader_url" {
value = sless_service.postgres_table_reader.url
}
resource "sless_service" "postgres_table_writer" {
name = "pg-table-writer"
runtime = "python3.11"
entrypoint = "table_rw.add_row"
memory_mb = 256
timeout_sec = 45
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
source_dir = "${path.module}/code/table-rw"
depends_on = [sless_job.postgres_table_init_job]
}
output "table_writer_url" {
value = sless_service.postgres_table_writer.url
}
-64
View File
@@ -1,64 +0,0 @@
// 2026-03-17 17:05
// main.tf — провайдеры и переменные для Nubes + sless.
terraform {
required_providers {
nubes = {
source = "terra.k8c.ru/nubes/nubes"
version = "5.0.19"
}
sless = {
source = "terra.k8c.ru/naeel/sless"
version = "~> 0.1.19"
}
}
}
variable "api_token" {
type = string
sensitive = true
description = "Nubes API token"
}
variable "s3_uid" {
type = string
sensitive = true
description = "Nubes S3 UID"
}
variable "realm" {
type = string
sensitive = true
description = "resource_realm parameter for nubes_postgres resource"
}
// 2026-03-18 — pg_user/pg_password помечены optional (default="") для сверки.
// Реальные credentials берутся из vault_secrets через locals в resources.tf.
variable "pg_user" {
type = string
sensitive = true
default = ""
description = "Только для сверки. Реальный username из nubes_postgres_user.pg_user.username. Должен совпадать с vault."
}
variable "pg_password" {
type = string
sensitive = true
default = ""
description = "Только для сверки. Реальный пароль из vault_secrets. Должен совпадать с tfvars."
}
# Nubes endpoints — не путать:
# API Dashboard (для Terraform-провайдеров): https://deck-api-test.ngcloud.ru/api/v1/index.cfm
# UI облака (только браузер, не для кода): https://deck-test.ngcloud.ru/
# ВАЖНО: nubes и sless провайдеры требуют API endpoint, НЕ UI!
provider "nubes" {
api_token = var.api_token
api_endpoint = "https://deck-api-test.ngcloud.ru/api/v1/index.cfm"
}
provider "sless" {
endpoint = "https://sless.kube5s.ru"
token = var.api_token
nubes_endpoint = "https://deck-api-test.ngcloud.ru/api/v1"
}
-58
View File
@@ -1,58 +0,0 @@
// 2026-03-20 — выделено из resources.tf: только managed PostgreSQL ресурсы.
# Актуальные credentials из vault_secrets (authoritatively) — vault синхронизирован с кластером.
# Структура vault_secrets["users"]: JSON-строка {"username": {"password": "...", "username": "..."}}
locals {
# try() нужен: vault_secrets["users"] появляется только ПОСЛЕ создания первого пользователя.
# На первом apply ключа ещё нет → пустая map. Пароль подтянется при следующем apply.
pg_creds_map = try(jsondecode(lookup(nubes_postgres.npg.vault_secrets, "users", "{}")), {})
pg_username = nubes_postgres_user.pg_user.username
pg_password = try(local.pg_creds_map[local.pg_username]["password"], "")
pg_host = nubes_postgres.npg.state_out_flat["internalConnect.master"]
pg_database = nubes_postgres_database.db.db_name
}
resource "nubes_postgres" "npg" {
resource_name = "pg-sless-demo"
# s3_uid = "s01325"
s3_uid = var.s3_uid
resource_realm = var.realm
resource_instances = 1
resource_memory = 512
resource_c_p_u = 500
resource_disk = "1"
app_version = "17"
json_parameters = jsonencode({
log_connections = "off"
log_disconnections = "off"
})
enable_pg_pooler_master = false
enable_pg_pooler_slave = false
allow_no_s_s_l = false
auto_scale = false
auto_scale_percentage = 10
auto_scale_tech_window = 0
auto_scale_quota_gb = "1"
need_external_address_master = false
# suspend_on_destroy = false
operation_timeout = "11m"
adopt_existing_on_create = true
}
resource "nubes_postgres_user" "pg_user" {
postgres_id = nubes_postgres.npg.id
username = "user0"
role = "ddl_user"
adopt_existing_on_create = true
}
resource "nubes_postgres_database" "db" {
postgres_id = nubes_postgres.npg.id
db_name = "db0"
db_owner = nubes_postgres_user.pg_user.username
adopt_existing_on_create = true
# suspend_on_destroy = false
}
-3
View File
@@ -1,3 +0,0 @@
// 2026-03-20 — содержимое перенесено в два файла:
// postgres.tf — managed PostgreSQL ресурсы (nubes_postgres, user, database, locals)
// functions.tf — sless функции, сервисы, джобы, outputs
@@ -1,51 +0,0 @@
# 2026-03-18 — debug pod для проверки psql-соединения из namespace функций.
# Запускается разово. Подключается к тому же postgres, что и sless_function.
# kubectl apply -f /tmp/pg-debug-pod.yaml
# kubectl logs -n sless-fn-sless-ffd1f598c169b0ae pg-debug-pod
apiVersion: v1
kind: Pod
metadata:
name: pg-debug-pod
namespace: sless-fn-sless-ffd1f598c169b0ae
labels:
purpose: debug-postgres-connectivity
spec:
restartPolicy: Never
containers:
- name: psql
image: postgres:17-alpine
command:
- sh
- -c
- |
echo "=== Testing TCP connectivity to postgres ==="
nc -zv -w5 $PGHOST 5432 && echo "TCP OK" || echo "TCP FAILED"
echo ""
echo "=== Testing psql connection ==="
PGCONNECT_TIMEOUT=10 psql \
"host=$PGHOST port=$PGPORT dbname=$PGDATABASE user=$PGUSER sslmode=$PGSSLMODE" \
--command="SELECT current_user, current_database(), version();" \
2>&1
echo ""
echo "=== Listing tables ==="
PGCONNECT_TIMEOUT=10 psql \
"host=$PGHOST port=$PGPORT dbname=$PGDATABASE user=$PGUSER sslmode=$PGSSLMODE" \
--command="\dt" \
2>&1
env:
- name: PGHOST
value: "postgresqlk8s-master.36875359-dcea-48c4-a593-b4531f20fe96.svc.cluster.local"
- name: PGPORT
value: "5432"
- name: PGDATABASE
value: "db_terra"
- name: PGUSER
value: "u-user0"
- name: PGPASSWORD
# Актуальный пароль из vault_secrets (совпадает с tfvars.pg_password на 2026-03-18)
value: "M03O6fRsngWcVHB2YGivyLfbfxoii2R21nyh2A2r7WSZS5deLwBgLKkc9Wk24Zyl"
- name: PGSSLMODE
value: "require"
@@ -1,40 +0,0 @@
# 2026-03-17 13:05
# read_pg_user_secret.py — читает пароль пользователя managed PostgreSQL из k8s Secret.
# Используется из Terraform external data source, чтобы apply сам получал актуальный пароль
# даже для уже существующего пользователя, созданного вне текущего state.
import base64
import json
import subprocess
import sys
def main():
# Читаем query от Terraform external provider из stdin.
query = json.load(sys.stdin)
namespace = query["namespace"]
secret_name = query["secret"]
# kubectl уже настроен на удалённой машине; читаем ровно поле data.password.
result = subprocess.run(
[
"kubectl",
"get",
"secret",
"-n",
namespace,
secret_name,
"-o",
"jsonpath={.data.password}",
],
check=True,
capture_output=True,
text=True,
)
password = base64.b64decode(result.stdout.strip()).decode()
json.dump({"password": password}, sys.stdout)
if __name__ == "__main__":
main()
-119
View File
@@ -1,119 +0,0 @@
// 2026-03-21 — stress.tf: все стресс-сервисы для комплексного тестирования.
// Два рантайма: nodejs20 (2), python3.11 (5).
// Все depends_on = [sless_job.postgres_table_init_job] — таблица должна существовать.
# ── Node.js 20 ────────────────────────────────────────────────────────────────
# 3 параллельных PG-запроса через Promise.all. Проверяет async/await + nodejs20.
resource "sless_service" "stress_js_async" {
name = "stress-js-async"
runtime = "nodejs20"
entrypoint = "stress_js_async.run"
memory_mb = 128
timeout_sec = 20
source_dir = "${path.module}/code/stress-js-async"
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
depends_on = [sless_job.postgres_table_init_job]
}
# TypeError через undefined.toUpperCase(). Без PG. Проверяет перехват JS-ошибок.
resource "sless_service" "stress_js_badenv" {
name = "stress-js-badenv"
runtime = "nodejs20"
entrypoint = "stress_js_badenv.run"
memory_mb = 128
timeout_sec = 10
source_dir = "${path.module}/code/stress-js-badenv"
depends_on = [sless_job.postgres_table_init_job]
}
# ── Python 3.11 ───────────────────────────────────────────────────────────────
# Спит N секунд. Без PG. Проверяет timeout и сосуществование долгих запросов.
resource "sless_service" "stress_slow" {
name = "stress-slow"
runtime = "python3.11"
entrypoint = "stress_slow.run"
memory_mb = 128
timeout_sec = 35
source_dir = "${path.module}/code/stress-slow"
depends_on = [sless_job.postgres_table_init_job]
}
# CPU-нагрузка: сумма квадратов N чисел. Без PG. Проверяет compute-bound задачи.
resource "sless_service" "stress_bigloop" {
name = "stress-bigloop"
runtime = "python3.11"
entrypoint = "stress_bigloop.run"
memory_mb = 256
timeout_sec = 60
source_dir = "${path.module}/code/stress-bigloop"
depends_on = [sless_job.postgres_table_init_job]
}
# ZeroDivisionError. Без PG. Проверяет перехват Python-исключений → HTTP 500.
resource "sless_service" "stress_divzero" {
name = "stress-divzero"
runtime = "python3.11"
entrypoint = "stress_divzero.run"
memory_mb = 128
timeout_sec = 10
source_dir = "${path.module}/code/stress-divzero"
depends_on = [sless_job.postgres_table_init_job]
}
# Параллельный INSERT в terraform_demo_table через psycopg2. Проверяет PG-write.
resource "sless_service" "stress_writer" {
name = "stress-writer"
runtime = "python3.11"
entrypoint = "stress_writer.run"
memory_mb = 128
timeout_sec = 60
source_dir = "${path.module}/code/stress-writer"
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
depends_on = [sless_job.postgres_table_init_job]
}
# Агрегированная статистика terraform_demo_table (COUNT/MIN/MAX). Для мониторинга.
resource "sless_service" "pg_stats" {
name = "pg-stats"
runtime = "python3.11"
entrypoint = "pg_stats.get_stats"
memory_mb = 128
timeout_sec = 15
source_dir = "${path.module}/code/pg-stats"
env_vars = {
PGHOST = local.pg_host
PGPORT = "5432"
PGDATABASE = local.pg_database
PGUSER = local.pg_username
PGPASSWORD = local.pg_password
PGSSLMODE = "require"
}
depends_on = [sless_job.postgres_table_init_job]
}
@@ -1,46 +0,0 @@
#!/bin/bash
# 2026-03-20
# stress_destroy_apply.sh — 5 итераций terraform destroy + apply для проверки lifecycle PG.
# Запускать вручную с VM: bash stress_destroy_apply.sh
# Логи каждой итерации пишутся в stress_log_N.txt
set -e
ITERATIONS=5
DIR="$(cd "$(dirname "$0")" && pwd)"
cd "$DIR"
echo "=== Старт stress-теста: $ITERATIONS итераций destroy+apply ==="
echo "Workdir: $DIR"
echo ""
for i in $(seq 1 $ITERATIONS); do
LOG="stress_log_${i}.txt"
echo "--- Итерация $i/$ITERATIONS ---"
echo "Лог: $LOG"
echo "[$i] DESTROY — $(date)" | tee "$LOG"
terraform destroy -auto-approve 2>&1 | tee -a "$LOG"
DESTROY_CODE=${PIPESTATUS[0]}
if [ $DESTROY_CODE -ne 0 ]; then
echo "[!] destroy завершился с ошибкой (код $DESTROY_CODE), итерация $i. Прерывание." | tee -a "$LOG"
exit $DESTROY_CODE
fi
echo "" | tee -a "$LOG"
echo "[$i] APPLY — $(date)" | tee -a "$LOG"
terraform apply -auto-approve 2>&1 | tee -a "$LOG"
APPLY_CODE=${PIPESTATUS[0]}
if [ $APPLY_CODE -ne 0 ]; then
echo "[!] apply завершился с ошибкой (код $APPLY_CODE), итерация $i. Прерывание." | tee -a "$LOG"
exit $APPLY_CODE
fi
echo "" | tee -a "$LOG"
echo "[$i] Итерация завершена успешно — $(date)" | tee -a "$LOG"
echo ""
done
echo "=== Все $ITERATIONS итераций прошли успешно ==="
-57
View File
@@ -1,57 +0,0 @@
#!/bin/bash
# 2026-03-19 — stress test script: параллельный запуск всех 8 стресс-функций
BASE="https://sless.kube5s.ru/fn/sless-ffd1f598c169b0ae"
echo "=== РАУНД 1: первый холодный запуск ==="
curl -s -m 35 "$BASE/stress-slow" -d '{"sleep":3}' -H "Content-Type:application/json" > /tmp/r_slow.json &
curl -s -m 10 "$BASE/stress-divzero" > /tmp/r_divzero.json &
curl -s -m 40 "$BASE/stress-bigloop" -d '{"n":1000000}' -H "Content-Type:application/json"> /tmp/r_bigloop.json &
curl -s -m 35 "$BASE/stress-writer" -d '{"rows":3,"prefix":"batch1"}' -H "Content-Type:application/json" > /tmp/r_writer.json &
curl -s -m 15 "$BASE/stress-go-fast" -d '{"n":15}' -H "Content-Type:application/json" > /tmp/r_go_fast.json &
curl -s -m 10 "$BASE/stress-go-nil" > /tmp/r_go_nil.json &
curl -s -m 20 "$BASE/stress-js-async" > /tmp/r_js_async.json &
curl -s -m 10 "$BASE/stress-js-badenv" > /tmp/r_js_badenv.json &
wait
echo "[slow]: $(cat /tmp/r_slow.json)"
echo "[divzero]: $(cat /tmp/r_divzero.json)"
echo "[bigloop]: $(cat /tmp/r_bigloop.json)"
echo "[writer]: $(cat /tmp/r_writer.json)"
echo "[go-fast]: $(cat /tmp/r_go_fast.json)"
echo "[go-nil]: $(cat /tmp/r_go_nil.json)"
echo "[js-async]: $(cat /tmp/r_js_async.json)"
echo "[js-badenv]:$(cat /tmp/r_js_badenv.json)"
echo ""
echo "=== РАУНД 2: повторный (горячий кэш) ==="
curl -s -m 15 "$BASE/stress-bigloop" -d '{"n":2000000}' -H "Content-Type:application/json" > /tmp/r2_bigloop.json &
curl -s -m 10 "$BASE/stress-go-fast" -d '{"n":20}' -H "Content-Type:application/json" > /tmp/r2_go_fast.json &
curl -s -m 20 "$BASE/stress-js-async" > /tmp/r2_async.json &
curl -s -m 35 "$BASE/stress-writer" -d '{"rows":10,"prefix":"batch2"}' -H "Content-Type:application/json" > /tmp/r2_writer.json &
wait
echo "[bigloop-2M]: $(cat /tmp/r2_bigloop.json)"
echo "[go-fast-20]: $(cat /tmp/r2_go_fast.json)"
echo "[js-async-2]: $(cat /tmp/r2_async.json)"
echo "[writer-10]: $(cat /tmp/r2_writer.json)"
echo ""
echo "=== РАУНД 3: crash функции с неверными параметрами ==="
curl -s -m 10 "$BASE/stress-divzero" -d '{"n":100,"d":0}' -H "Content-Type:application/json" > /tmp/r3_dz.json &
curl -s -m 10 "$BASE/stress-go-nil" -d '{"crash":true}' -H "Content-Type:application/json" > /tmp/r3_nil.json &
curl -s -m 10 "$BASE/stress-js-badenv" -d '{"crash":true}' -H "Content-Type:application/json" > /tmp/r3_bad.json &
# divzero с нормальным делителем — должен вернуть результат
curl -s -m 10 "$BASE/stress-divzero" -d '{"n":42,"d":7}' -H "Content-Type:application/json" > /tmp/r3_ok.json &
# go-nil без краша — должен вернуть ok
curl -s -m 10 "$BASE/stress-go-nil" -d '{"crash":false}' -H "Content-Type:application/json" > /tmp/r3_nil_ok.json &
wait
echo "[divzero crash]: $(cat /tmp/r3_dz.json)"
echo "[go-nil crash]: $(cat /tmp/r3_nil.json)"
echo "[js-badenv crash]: $(cat /tmp/r3_bad.json)"
echo "[divzero ok 42/7]: $(cat /tmp/r3_ok.json)"
echo "[go-nil ok]: $(cat /tmp/r3_nil_ok.json)"
echo ""
echo "=== ИТОГ: количество строк в таблице ==="
curl -s -m 15 "$BASE/pg-table-reader"
echo ""
echo "=== DONE ==="
+146 -27
View File
@@ -8,68 +8,187 @@
| Ресурс | Назначение |
|---|---|
| `sless_service` | Long-running HTTP-сервис: всегда активен, отвечает на запросы. Имеет свой URL после деплоя. |
| `sless_job` | Одноразовый запуск функции: собирает образ, выполняет код, завершается. Используется для миграций БД, batch-обработки и т.д. |
| `sless_function` | Описывает функцию: язык, точку входа, лимиты, переменные окружения. При создании загружает код и запускает его сборку в образ. Сама по себе недоступна снаружи — нужен триггер или задание. |
| `sless_trigger` | Публикует функцию: тип `http` создаёт публичный URL, тип `cron` — запуск по расписанию. |
| `sless_job` | Запускает функцию однократно и ожидает завершения. Используется для одноразовых операций: инициализация БД, миграции, пакетная обработка. |
Namespace функций вычисляется автоматически из JWT-токена: `sless-{sha256[:8]}`.
Стандартная связка для HTTP API: `sless_function` + `sless_trigger` с `type = "http"` — в результате функция доступна по URL вида `https://sless-api.kube5s.ru/fn/<namespace>/<имя-функции>`.
---
## Требования
- Terraform >= 1.3
- Terraform >= 1.0
- JWT-токен для аутентификации в sless API
- JWT-токен для Nubes Cloud API (если используются managed-ресурсы: PostgreSQL и т.д.)
- Доступ к `https://sless.kube5s.ru`
- Доступ к `https://sless-api.kube5s.ru`
## Конфигурация провайдера
Во всех примерах файл `main.tf` содержит блок провайдера. Токен передаётся через переменную, значение которой задаётся в `terraform.tfvars`:
```hcl
provider "sless" {
endpoint = "https://sless.kube5s.ru"
token = var.sless_token
}
provider "nubes_cloud" {
base_url = "https://deck-api-test.ngcloud.ru/api/v1"
token = var.nubes_token
endpoint = "https://sless-api.kube5s.ru"
token = var.token
nubes_endpoint = "https://deck-api.ngcloud.ru/api/v1"
}
```
> Токены задаются в `terraform.tfvars` — этот файл добавлен в `.gitignore`.
Namespace функций вычисляется автоматически из JWT-токена: `sless-{sha256[:8]}`.
> **Перед запуском любого примера** откройте файл `terraform.tfvars` в директории примера и впишите свой токен Nubes API:
> ```hcl
> token = "ваш токен Nubes API"
> ```
> Токен выдаётся в личном кабинете Nubes. Файл `terraform.tfvars` добавлен в `.gitignore` — он не попадёт в репозиторий.
---
## Примеры
### `POSTGRES` — Serverless-функции с Managed PostgreSQL
### `hello-node` — минимальный пример на Node.js
Полный пример: managed PostgreSQL + одноразовый init-job + 3 HTTP-сервиса (чтение/запись данных и информация о PG).
Языки: Python 3.11, Node.js 20.
Две независимые функции: HTTP-функция, возвращающая приветствие, и одноразовое задание, суммирующее набор чисел. Хорошая отправная точка для знакомства с платформой.
```bash
cd POSTGRES
cd hello-node
terraform init
terraform apply
terraform apply -auto-approve
# Вызов HTTP-функции с передачей имени:
curl -s -X POST https://sless-api.kube5s.ru/fn/<namespace>/hello-http \
-H 'Content-Type: application/json' -d '{"name":"World"}'
# Результат задания:
terraform output job_message
```
Подробности: [POSTGRES/README.md](POSTGRES/README.md)
---
### `hello-go` — минимальный пример на Go 1.23
Аналог `hello-node`, но на Go. Демонстрирует поддержку Go-рантайма: HTTP-функция и одноразовое задание. Код пользователя оформляется как пакет `handler` с функцией `Handle(event)`.
```bash
cd hello-go
terraform init
terraform apply -auto-approve
terraform output job_message
terraform output trigger_url
```
---
### `pg-list-python` — выборка данных из PostgreSQL (Python)
Минимальный пример работы с базой данных: одна HTTP-функция читает список записей из таблицы PostgreSQL и возвращает их в JSON. Таблица с тестовыми данными создаётся автоматически при первом вызове. Нет заданий, нет инициализации — только функция и триггер.
**Переменные:**
| Переменная | Описание | Значение по умолчанию |
|---|---|---|
| `pg_dsn` | Строка подключения к PostgreSQL | `postgres://sless:sless-pg-password@postgres.sless.svc.cluster.local:5432/sless?sslmode=disable` |
```bash
cd pg-list-python
terraform init
terraform apply -auto-approve
# URL функции выводится после применения:
terraform output catalog_url
# Запрос к функции:
curl -s $(terraform output -raw catalog_url)
```
---
### `simple-python` — одноразовое задание передаёт данные в HTTP-функцию (Python)
При `apply` выполняется задание, которое фиксирует текущее время. Результат передаётся в HTTP-функцию через переменные окружения и отображается при каждом запросе.
```bash
cd simple-python
terraform init
terraform apply -auto-approve
terraform output job_result
curl -s https://sless-api.kube5s.ru/fn/<namespace>/simple-py-time-display
```
---
### `simple-node` — то же самое на Node.js 20
```bash
cd simple-node
terraform init
terraform apply -auto-approve
terraform output job_result
curl -s https://sless-api.kube5s.ru/fn/<namespace>/simple-node-time-display
```
---
### `notes-python` — CRUD API на Python с PostgreSQL
Полноценное приложение: инициализация схемы базы данных через задания, CRUD-функция для работы с записями, отдельная функция для получения списка.
**Переменные:**
| Переменная | Описание | Значение по умолчанию |
|---|---|---|
| `pg_dsn` | Строка подключения к PostgreSQL | `postgres://sless:sless-pg-password@postgres.sless.svc.cluster.local:5432/sless?sslmode=disable` |
```bash
cd notes-python
terraform init
terraform apply -auto-approve
# Статус инициализации базы данных:
terraform output db_init_table_status
terraform output db_init_index_status
# Создать запись:
curl -s -X POST "$(terraform output -raw notes_url)/add?title=Hello&body=World"
# Получить список записей:
curl -s $(terraform output -raw notes_list_url)
# Обновить запись (id из предыдущего ответа):
curl -s -X POST "$(terraform output -raw notes_url)/update?id=1&title=Updated&body=New+body"
# Удалить запись:
curl -s -X POST "$(terraform output -raw notes_url)/delete?id=1"
```
---
## Полезные команды
```bash
# Посмотреть состояние задеплоенных ресурсов:
# Посмотреть текущее состояние задеплоенных ресурсов:
terraform show
# Принудительно пересобрать сервис (после изменения кода):
terraform apply -replace=sless_service.<имя>
# Принудительно пересобрать функцию (например, после изменения кода):
terraform apply -replace=sless_function.<имя> -auto-approve
# Повторно запустить job: увеличить run_id в .tf-файле, затем:
terraform apply
# Повторно запустить задание: увеличить значение run_id в .tf-файле, затем:
terraform apply -auto-approve
# Удалить все ресурсы примера:
terraform destroy
terraform destroy -auto-approve
```
## Структура примера
```
<пример>/
├── main.tf — конфигурация провайдера
├── *.tf — ресурсы: функции, триггеры, задания
├── variables.tf — входные переменные
├── terraform.tfvars — значения переменных (не коммитится в git)
└── code/ — исходный код функций
```
+29
View File
@@ -0,0 +1,29 @@
// Изменено: 2026-03-11
// greeting.go — пример Go функции: возвращает приветствие.
//
// ТРЕБОВАНИЕ РАНТАЙМА: пакет должен называться handler, точка входа — Handle.
// Вся бизнес-логика — в отдельных функциях с нормальными именами.
package handler
import "fmt"
// buildGreeting — формирует текст приветствия для указанного имени гостя.
func buildGreeting(guestName string) string {
return fmt.Sprintf("Hello, %s! (Go 1.23)", guestName)
}
// Handle — точка входа, вызывается рантаймом на каждый запрос/событие.
// Не переименовывать: это жёсткий контракт рантайма (server.go вызывает handler.Handle).
func Handle(event map[string]interface{}) interface{} {
guestName, ok := event["name"].(string)
if !ok || guestName == "" {
guestName = "world"
}
return map[string]interface{}{
"message": buildGreeting(guestName),
"runtime": "go1.23",
"event": event,
}
}

Some files were not shown because too many files have changed in this diff Show More