docs: add step-by-step function deploy guide for any model

2026-04-15 08:07:23 +03:00
parent 19bcdc5fc7
commit efa8721c36
1 changed files with 139 additions and 0 deletions
@@ -63,3 +63,142 @@ ssh -i ~/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no -o ConnectTimeout=
 ## Git

 Коммитить и пушить после каждого завершённого этапа.
+
+---
+
+## Как создать и задеплоить новую Fission-функцию через Terraform
+
+### Пошаговая инструкция (ОБЯЗАТЕЛЬНО следовать)
+
+#### Шаг 1: Создать папку с функцией
+
+Создать папку в `examples/` по шаблону. Пример: `examples/my-test/`
+
+Структура:
+```
+examples/my-test/
+├── code/
+│   └── main.py       # Код функции
+└── main.tf            # Terraform манифест
+```
+
+#### Шаг 2: Написать код функции
+
+Файл `code/main.py` — обязательно функция `main()`:
+
+```python
+def main():
+    return "hello from my-test"
+```
+
+Можно сложнее — с аргументами, JSON, вычислениями:
+
+```python
+import json
+
+def main():
+    result = {"status": "ok", "data": [1, 2, 3]}
+    return json.dumps(result)
+```
+
+#### Шаг 3: Написать Terraform манифест
+
+Файл `main.tf` — КОПИРОВАТЬ этот шаблон и менять только имена и URL:
+
+```hcl
+terraform {
+  required_providers {
+    fission = {
+      source  = "nail/fission"
+      version = "~> 0.1.0"
+    }
+  }
+}
+
+provider "fission" {
+  kubeconfig_path = "/home/naeel/.kube/config"
+  namespace       = "default"
+}
+
+resource "fission_environment" "python" {
+  name    = "УНИКАЛЬНОЕ-ИМЯ-env"
+  image   = "ghcr.io/fission/python-env"
+  version = 3
+}
+
+resource "fission_package" "pkg" {
+  name        = "УНИКАЛЬНОЕ-ИМЯ-pkg"
+  environment = fission_environment.python.name
+  source_dir  = "${path.module}/code"
+}
+
+resource "fission_function" "fn" {
+  name         = "УНИКАЛЬНОЕ-ИМЯ-fn"
+  environment  = fission_environment.python.name
+  package_name = fission_package.pkg.name
+  entrypoint   = "main.main"
+}
+
+resource "fission_http_trigger" "route" {
+  name     = "УНИКАЛЬНОЕ-ИМЯ-route"
+  function = fission_function.fn.name
+  url      = "/УНИКАЛЬНЫЙ-URL"
+  methods  = ["GET"]
+}
+```
+
+**ВАЖНО:** Все имена ресурсов (name) должны быть **уникальными** по всему кластеру.
+Используй префикс, например `tf-mytest-env`, `tf-mytest-pkg`, `tf-mytest-fn`, `tf-mytest-route`.
+
+#### Шаг 4: Задеплоить через SSH
+
+```bash
+ssh -i ~/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no -o ConnectTimeout=10 naeel@5.172.178.213 \
+  'cd ~/terra/fission/examples/my-test && TF_CLI_CONFIG_FILE=/tmp/terraformrc-fission terraform apply -auto-approve'
+```
+
+**ОБЯЗАТЕЛЬНО:**
+- Переменная `TF_CLI_CONFIG_FILE=/tmp/terraformrc-fission` — ВСЕГДА нужна (dev override провайдера)
+- `terraform init` НЕ нужен (dev_overrides пропускает init)
+- Выполнять ТОЛЬКО через SSH
+
+#### Шаг 5: Проверить функцию через curl
+
+Роутер требует JWT. Паттерн:
+
+```bash
+ssh -i ~/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no -o ConnectTimeout=10 naeel@5.172.178.213 '
+PASSWORD=$(kubectl -n fission get secret router -o jsonpath={.data.password} | base64 -d)
+TOKEN=$(curl -sk -X POST https://fission.kube5s.ru/auth/login \
+  -H "Content-Type: application/json" \
+  -d "{\"username\":\"admin\",\"password\":\"$PASSWORD\"}" \
+  | python3 -c "import sys,json; print(json.load(sys.stdin)[\"accesstoken\"])")
+curl -sk -H "Authorization: Bearer $TOKEN" https://fission.kube5s.ru/УНИКАЛЬНЫЙ-URL
+'
+```
+
+#### Шаг 6: Удалить (если нужно)
+
+```bash
+ssh -i ~/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no -o ConnectTimeout=10 naeel@5.172.178.213 \
+  'cd ~/terra/fission/examples/my-test && TF_CLI_CONFIG_FILE=/tmp/terraformrc-fission terraform destroy -auto-approve'
+```
+
+### Уже задеплоенные функции (НЕ ТРОГАТЬ без явного указания)
+
+| Папка | Endpoint | Ответ |
+|-------|----------|-------|
+| `examples/hello-python/` | `GET /tf-hello` | `hello from fission via terraform` |
+| `examples/stress-suite/` | `GET /stress/fast` | `fast-ok` |
+| `examples/stress-suite/` | `GET /stress/cpu` | `cpu-ok:NUMBER` |
+| `examples/stress-suite/` | `GET /stress/json` | `{"status":"ok","service":"json"}` |
+
+### Частые ошибки
+
+| Ошибка | Причина | Решение |
+|--------|---------|---------|
+| `unauthorized: malformed token` | curl без JWT | Добавить JWT (см. шаг 5) |
+| `terraform init required` | Забыт `TF_CLI_CONFIG_FILE` | Добавить `TF_CLI_CONFIG_FILE=/tmp/terraformrc-fission` |
+| `resource already exists` | Имя не уникальное | Сменить имена на уникальные с префиксом |
+| `Error: connection refused` | Команда запущена локально | Выполнять ТОЛЬКО через SSH |
+| `package not found` | Опечатка в `source_dir` | Проверить path.module/code и файл main.py |