fission-console/doc/progress.md

Progress Log

2026-04-14

План перед работой

• Зафиксировать, что REST /v2/* недоступен в текущем кластере Fission v1.22.1 и MVP идет через Kubernetes CRD API.
• Реализовать первый рабочий Terraform ресурс fission_environment.
• Добавить минимальный CRUD в клиент для CRD environments.fission.io.
• Проверить сборку go build ./....

Факт выполнения

• Обновлен план в doc/CODEX_PLAN.md: путь реализации переведен на CRD API.
• Создан каркас провайдера и заготовки ресурсов.
• Реализован рабочий fission_environment:
  • schema (name, image, version, poolsize, namespace, id, uid)
  • Configure() с получением клиента из provider
  • Create/Read/Update/Delete через Kubernetes CRD environments.fission.io
• В internal/client/client.go добавлены методы:
  • CreateEnvironment / GetEnvironment / UpdateEnvironment / DeleteEnvironment
  • IsNotFound для обработки удаления/дрейфа state
• Проверка go build ./... проходит успешно.

Следующий шаг

• Реализовать fission_package (zip/base64 -> spec.source.literal) через CRD packages.fission.io.

Обновление этапа (fission_package)

• Реализован CRUD в internal/client/client.go для packages.fission.io:
  • CreatePackage
  • GetPackage
  • UpdatePackage
  • DeletePackage
• Реализован ресурс fission_package в internal/resources/package_resource.go:
  • schema: name, environment, source_dir, code_path, code_hash, build_command, namespace, computed id, uid, build_status, build_log
  • валидация источника кода: задан ровно один из source_dir или code_path
  • упаковка source_dir в zip и кодирование base64 в spec.source.literal
  • Create/Read/Update/Delete через Kubernetes CRD API
• Проверка сборки: go build ./... успешно.

Следующий шаг

• Реализовать fission_function через CRD functions.fission.io.

Обновление этапа (fission_function)

• Реализован CRUD в internal/client/client.go для functions.fission.io:
  • CreateFunction
  • GetFunction
  • UpdateFunction
  • DeleteFunction
• Реализован ресурс fission_function в internal/resources/function_resource.go:
  • schema: name, environment, package_name, entrypoint, namespace, computed id, uid
  • Configure/Create/Read/Update/Delete
  • маппинг в CRD Function (spec.environment, spec.package.packageref, spec.package.functionName)
• Проверка сборки: go build ./... успешно.

Следующий шаг

• Реализовать fission_http_trigger через CRD httptriggers.fission.io.

Обновление этапа (fission_http_trigger)

• Реализован CRUD в internal/client/client.go для httptriggers.fission.io:
  • CreateHTTPTrigger
  • GetHTTPTrigger
  • UpdateHTTPTrigger
  • DeleteHTTPTrigger
• Реализован ресурс fission_http_trigger в internal/resources/http_trigger_resource.go:
  • schema: name, function, url, methods, create_ingress, host, namespace, computed id, uid
  • Configure/Create/Read/Update/Delete
  • маппинг в CRD HTTPTrigger (spec.relativeurl, spec.methods, spec.functionref, spec.createingress)
• Проверка сборки: go build ./... успешно.

Следующий шаг

• Добавить пример examples/hello-python/main.tf и выполнить smoke Terraform apply.

Обновление этапа (пример Terraform)

• Создан пример examples/hello-python/main.tf с использованием ресурсов:
  • fission_environment
  • fission_package
  • fission_function
  • fission_http_trigger
• Добавлен код функции examples/hello-python/code/main.py.

Следующий шаг

• Подготовить локальную установку бинарника провайдера для terraform init и выполнить smoke terraform apply.

Обновление этапа (smoke Terraform apply)

• Собран бинарник провайдера и подключен через Terraform dev_overrides.
• Прогнан terraform plan для examples/hello-python: план успешен, 4 ресурса к созданию.
• Прогнан terraform apply и выполнена функциональная проверка.

Исправленные баги по факту smoke:

• fission_package: после Create computed-поля (build_status, build_log) могли оставаться unknown.
  • Исправлено формирование state в unstructuredToPackageModel.
• fission_function: CRD требовал обязательный spec.InvokeStrategy.
  • Добавлен InvokeStrategy в payload функции.
• fission_http_trigger: несогласованность state (create_ingress null -> false).
  • В schema добавлены Computed + Default(false) для create_ingress.
  • Для methods добавлен Computed.

Дополнительно:

• Для текущего python MVP fission_package переведен на spec.deployment.literal (как у рабочего CLI-пакета).
• Проверка endpoint после apply:
  • GET /tf-hello -> hello from fission via terraform.

Следующий шаг

• Добавить README по запуску dev override и оговорить ограничения текущего MVP (source_dir ожидает main.py).

Обновление этапа (README)

• Добавлен README.md в корень репозитория.
• Описаны:
  • список реализованных ресурсов MVP
  • запуск через Terraform dev override
  • текущие ограничения MVP

Обновление этапа (import + тесты)

• Добавлена поддержка terraform import для всех 4 ресурсов:
  • fission_environment
  • fission_package
  • fission_function
  • fission_http_trigger
• Формат import ID: namespace/name.
• Добавлены unit-тесты в terraform/provider/internal/resources/*_test.go:
  • парсинг import ID
  • конвертация model <-> unstructured
  • валидация package source
  • базовая проверка HTTP trigger round-trip
• Прогон валидации:
  • go test ./... — успешно
  • smoke terraform plan/apply — успешно
  • endpoint GET /tf-hello — hello from fission via terraform

Следующий шаг

• Добавить acceptance-тесты с опциональным запуском по env-флагу.

Обновление этапа (acceptance тест)

• Добавлен acceptance-тест terraform/provider/internal/client/client_acceptance_test.go.
• Тест выполняет живой CRUD в кластере для цепочки:
  • Environment -> Package -> Function -> HTTPTrigger
• Запуск теста:
  • ACCEPTANCE_TEST=1 KUBECONFIG=/home/naeel/.kube/config go test ./internal/client -run TestAcceptanceFissionCRUD -v
• Результат: PASS.

Следующий шаг

• Расширить acceptance-тест проверкой реального HTTP-вызова функции через ingress.

Обновление этапа (много функций + суровая нагрузка)

• Добавлен examples/stress-suite:
  • функции: fast, cpu, json
  • маршруты: /stress/fast, /stress/cpu, /stress/json
  • Terraform-конфиг на 10 ресурсов (env + 3 package + 3 function + 3 trigger)
• Добавлен скрипт examples/stress-suite/scripts/load_test.sh для параллельной нагрузки.
• Реальный прогон после донастройки:
  • 900 запросов на endpoint
  • 90 параллелизм
  • итог: 100% success на всех трех endpoint-ах.

Следующий шаг

• Добавить в acceptance-тест проверку HTTP latency/perf budget и порогов SLO.

Обновление этапа (JS/Go source support)

• В fission_package расширена поддержка source_dir:
  • main.py
  • main.js
  • main.go
• Добавлены unit-тесты на выбор JS/Go исходников в package_resource_test.go.
• Прогон go test ./... — успешно.

Следующий шаг

• Добавить отдельные Terraform примеры для Node.js и Go функций.