Function Env Vars — ПОЛНАЯ ДОКУМЕНТАЦИЯ (v1.3.77+)

ПРОБЛЕМА (обнаружена 2026-05-09)

Env vars хранились только в аннотации fission-console/env-vars на Function CRD. Это работало для UI (хранение/отображение), но переменные не попадали в pod функции.

Почему не попадали

Fission poolmgr создаёт warm pool подов заранее, до того как знает какая функция будет запущена. Pod уже работает в момент первого вызова функции. spec.podspec.containers[].env из Function CRD при poolmgr игнорируется — pod уже запущен.

При специализации (загрузке кода функции) fetcher передаёт в pod только:

путь к файлу с кодом
имя entrypoint функции
секреты и configmaps (как файлы в /userfunc/...)

Переменные окружения через poolmgr можно установить только на уровне Environment deployment — одинаковые для ВСЕХ функций этого окружения. Индивидуально для функции — невозможно.

Отвергнутые варианты

Вариант	Почему нет
`spec.podspec.containers[].env` + poolmgr	Pod уже запущен до специализации
`spec.configmaps` → файлы `/userfunc/configs/`	Нужно читать файл в коде — не универсально
Патч python-env server	Только Python, другие языки сломаны
PostgreSQL/отдельное хранилище	Оверкилл, не официальный путь

РЕШЕНИЕ (v1.3.77+)

Автоматическое переключение ExecutorType в зависимости от наличия env vars.

Функция без env vars → ExecutorType: poolmgr → warm pool, быстрый cold start (~0.5 сек)
Функция с env vars → ExecutorType: newdeploy → dedicated Deployment, env vars в OS (~2-5 сек)

Пользователь ничего не настраивает — переключение происходит автоматически.

Почему newdeploy работает

При newdeploy Fission создаёт отдельный Kubernetes Deployment для функции. В этот Deployment попадает spec.podspec из Function CRD включая containers[0].env. Kubernetes ставит переменные на уровне ОС процесса контейнера при старте пода.

Почему это универсально для всех языков

Переменные окружения ОС — стандарт POSIX. Любой язык читает без изменений в env-сервере:

os.getenv("MY_VAR")          # Python
os.Getenv("MY_VAR")          # Go
ENV["MY_VAR"]                # Ruby
getenv("MY_VAR")             # PHP
process.env.MY_VAR           # Node.js

Нет дублирования подов

Warm pool принадлежит Environment, не функции. Переключение конкретной функции на newdeploy не трогает pool — другие функции без env vars продолжают использовать его.

РЕАЛИЗАЦИЯ

Backend: `handlePutFunctionEnvVars` (function_crud.go)

При PUT /functions/:name/envvars:

Сохраняет env vars в аннотацию fission-console/env-vars (для UI)
Если env vars непустые:
- Выставляет spec.podspec.containers[0].env (стандартный Kubernetes EnvVar)
- Переключает spec.InvokeStrategy.ExecutionStrategy.ExecutorType = "newdeploy"
- MinScale=0, MaxScale=1
Если env vars пустые (очищены):
- Удаляет spec.podspec
- Возвращает ExecutorType = "poolmgr"

Двойное хранение

Где	Зачем
Аннотация `fission-console/env-vars`	UI: отображение, редактирование
`spec.podspec.containers[0].env`	Fission/Kubernetes: реальное применение в pod

Структура Function CRD с env vars

spec:
  InvokeStrategy:
    ExecutionStrategy:
      ExecutorType: newdeploy
      MinScale: 0
      MaxScale: 1
    StrategyType: execution
  podspec:
    containers:
      - name: <env-name>
        env:
          - name: p1
            value: "envv1"
metadata:
  annotations:
    fission-console/env-vars: '[{"name":"p1","value":"envv1"}]'

Структура Function CRD без env vars

spec:
  InvokeStrategy:
    ExecutionStrategy:
      ExecutorType: poolmgr
    StrategyType: execution
  # нет podspec

ОГРАНИЧЕНИЯ

newdeploy медленнее cold start (~2-5 сек vs ~0.5 сек) — выбор пользователя, добавившего env vars
MinScale=0: при отсутствии трафика pod удаляется → cold start при первом вызове
Имена переменных: только [A-Za-z_][A-Za-z0-9_]* — стандарт POSIX, проверяется на UI
TF-функции (tf-*) — env vars read-only, изменение запрещено через UI

5.6 KiB Raw Blame History Unescape Escape