feat: multi-language support — PHP, Ruby, Perl, Go (binary-env)

- PHP: ghcr.io/fission/php-env, entrypoint main.php::handler - Ruby: ghcr.io/fission/ruby-env, entrypoint handler (single-word) - Perl: ghcr.io/fission/perl-env (version=1), sub {} return value - Go: ghcr.io/fission/binary-env with pre-compiled binary (shell script placeholder) Provider changes: - package_resource: added main.php, main.rb, main.pl to source_dir candidates - function_resource: relaxed entrypoint validation to allow PHP (::), Ruby, Perl (single-word) - function_resource_test: updated BadFormat test to reflect new valid formats
doc: plan for multi-language support (Go, Java, PHP, Ruby, .NET, Perl)
2026-04-15 17:01:40 +03:00 · 2026-04-15 16:31:34 +03:00
13 changed files with 621 additions and 6 deletions
@@ -8,6 +8,9 @@ bin/
 *.test
 *.out

+# Compiled function binaries (generated, not versioned)
+examples/*/dist/
+
 # Provider binaries
 terraform-provider-fission
 terraform-provider-fission_*
@@ -0,0 +1,399 @@
+# План: поддержка всех языков Fission
+
+**Дата:** 2026-04-15  
+**Исполнитель:** Sonnet / GPT 5.3 Codex (AI-агент)  
+**Цель:** Добавить рабочие функции на Go, Java, .NET, Ruby, Rust, PHP — и ПРОТЕСТИРОВАТЬ каждую
+
+---
+
+## Текущее состояние
+
+| Язык | Статус | Проблемы |
+|---|---|---|
+| Python | ✅ Работает | — |
+| Node.js | ✅ Работает | — |
+| Go | ❌ Timeout | Runtime compilation > 20s specialization timeout |
+| Java | ❌ Не развёрнуто | — |
+| .NET | ❌ Не развёрнуто | — |
+| Ruby | ❌ Не развёрнуто | — |
+| Rust | ❌ Не развёрнуто | — |
+| PHP | ❌ Не развёрнуто | — |
+
+---
+
+## КРИТИЧЕСКИЕ ПРАВИЛА (обязательно для агента)
+
+1. **ВСЕ КОМАНДЫ — ТОЛЬКО ЧЕРЕЗ SSH:**
+```bash
+ssh -i ~/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no -o ConnectTimeout=10 naeel@5.172.178.213 'КОМАНДА'
+```
+
+2. **Файлы редактировать можно локально** — `/home/naeel/remote_dev/fission/` = `~/terra/fission/` на VM
+
+3. **Terraform деплой:**
+```bash
+ssh ... 'cd ~/terra/fission/examples/FOLDER && TF_CLI_CONFIG_FILE=/tmp/terraformrc-fission terraform apply -auto-approve'
+```
+
+4. **Проверка функции (JWT обязателен):**
+```bash
+ssh ... '
+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 -w "\nHTTP=%{http_code}\n" -H "Authorization: Bearer $TOKEN" https://fission.kube5s.ru/ENDPOINT
+'
+```
+
+5. **НЕ ТРОГАТЬ существующие функции** — 15 шт., список в copilot-instructions.md
+
+---
+
+## Шаг 0: Проверить доступность образов (ОБЯЗАТЕЛЬНО ПЕРВЫМ)
+
+Перед созданием — проверить что образы exist на ghcr.io:
+
+```bash
+ssh ... '
+for lang in go java jvm dotnet dotnet20 ruby perl php binary; do
+  echo "--- $lang ---"
+  # Попробовать pull (dry-run)
+  docker pull ghcr.io/fission/${lang}-env:latest 2>&1 | head -3
+  echo
+done
+'
+```
+
+Если образ не найден — попробовать варианты:
+- `ghcr.io/fission/go-env`
+- `ghcr.io/fission/jvm-env` (Java = JVM в Fission!)
+- `ghcr.io/fission/dotnet20-env` или `ghcr.io/fission/dotnet-env`
+- `ghcr.io/fission/ruby-env`
+- `ghcr.io/fission/php-env`
+- `ghcr.io/fission/binary-env` (для предкомпилированных)
+- `ghcr.io/fission/perl-env`
+
+Если образ не существует — НЕ создавать функцию, пропустить язык.
+
+---
+
+## Шаг 1: Go (ПРОБЛЕМНЫЙ — требует особого подхода)
+
+### Проблема
+Go env компилирует код при specialization → timeout 20s → функция не работает.
+
+### Решение: использовать `binary-env`
+Go компилируется на VM → заливается как бинарник → binary-env его запускает.
+
+**Или:** увеличить specialization timeout через InvokeStrategy:
+```yaml
+spec:
+  InvokeStrategy:
+    ExecutionStrategy:
+      ExecutorType: newdeploy  # вместо poolmgr
+      MinScale: 1              # always running
+      MaxScale: 3
+```
+
+### Вариант A: pre-compiled + binary-env
+```
+examples/go-hello/
+├── code/
+│   └── main.go           # исходник для справки
+├── build.sh              # скрипт для компиляции
+└── main.tf
+```
+
+**build.sh:**
+```bash
+#!/bin/bash
+cd code
+CGO_ENABLED=0 GOOS=linux go build -o handler main.go
+```
+
+**main.tf** — использовать `binary-env` вместо `go-env`
+
+### Вариант B: newdeploy executor
+В Terraform manifests задать `executor_type = "newdeploy"` и `min_scale = 1`.
+Проверить поддерживает ли наш провайдер эти аргументы:
+```bash
+ssh ... 'grep -r "executor\|newdeploy\|min_scale\|invoke_strategy" ~/terra/fission/internal/'
+```
+
+### Код функции (main.go):
+```go
+package main
+
+import (
+    "net/http"
+)
+
+func Handler(w http.ResponseWriter, r *http.Request) {
+    w.Header().Set("Content-Type", "text/plain")
+    w.Write([]byte("Hello from Go in Fission"))
+}
+```
+
+### Тест: HTTP 200, body содержит "Hello from Go"
+
+---
+
+## Шаг 2: Java (JVM)
+
+### Образ: `ghcr.io/fission/jvm-env`
+
+### Структура:
+```
+examples/java-hello/
+├── code/
+│   └── io/fission/Function.java
+└── main.tf
+```
+
+### Код:
+```java
+package io.fission;
+
+import org.springframework.http.RequestEntity;
+import org.springframework.http.ResponseEntity;
+
+public class Function implements io.fission.Function {
+    @Override
+    public ResponseEntity<?> call(RequestEntity req, io.fission.Context context) {
+        return ResponseEntity.ok("Hello from Java in Fission");
+    }
+}
+```
+
+**ВАЖНО:** Проверить точный интерфейс JVM env. Может потребоваться другой формат:
+```bash
+ssh ... 'docker run --rm ghcr.io/fission/jvm-env:latest cat /app/README.md 2>/dev/null || echo "No README"'
+```
+
+### main.tf:
+```hcl
+resource "fission_environment" "jvm" {
+  name    = "tf-jvm-hello-env"
+  image   = "ghcr.io/fission/jvm-env"
+  version = 3
+}
+# ... стандартный pattern
+```
+
+### Тест: HTTP 200, body содержит "Hello from Java"
+
+---
+
+## Шаг 3: PHP
+
+### Образ: `ghcr.io/fission/php-env`
+
+### Структура:
+```
+examples/php-hello/
+├── code/
+│   └── hello.php
+└── main.tf
+```
+
+### Код:
+```php
+<?php
+return function() {
+    return "Hello from PHP in Fission";
+};
+```
+
+**ВАЖНО:** entrypoint для PHP — имя файла без расширения (`hello`).
+
+### Тест: HTTP 200, body содержит "Hello from PHP"
+
+---
+
+## Шаг 4: Ruby
+
+### Образ: `ghcr.io/fission/ruby-env`
+
+### Структура:
+```
+examples/ruby-hello/
+├── code/
+│   └── hello.rb
+└── main.tf
+```
+
+### Код:
+```ruby
+def main
+  "Hello from Ruby in Fission"
+end
+```
+
+### Тест: HTTP 200, body содержит "Hello from Ruby"
+
+---
+
+## Шаг 5: .NET (C#)
+
+### Образ: `ghcr.io/fission/dotnet-env` или `ghcr.io/fission/dotnet20-env`
+
+### Структура:
+```
+examples/dotnet-hello/
+├── code/
+│   └── FissionFunction.cs
+└── main.tf
+```
+
+### Код:
+```csharp
+using System;
+using Fission.DotNetCore.Api;
+
+public class FissionFunction
+{
+    public string Execute(FissionContext context)
+    {
+        return "Hello from .NET in Fission";
+    }
+}
+```
+
+### Тест: HTTP 200, body содержит "Hello from .NET"
+
+---
+
+## Шаг 6: Rust
+
+### ВЕРОЯТНО НЕ СУЩЕСТВУЕТ официально.
+
+Проверить:
+```bash
+ssh ... 'docker pull ghcr.io/fission/rust-env:latest 2>&1'
+```
+
+Если нет — пропустить. Rust можно реализовать через `binary-env` (pre-compiled).
+
+---
+
+## Шаг 7: Perl (бонус)
+
+### Образ: `ghcr.io/fission/perl-env`
+
+```perl
+sub main {
+    return "Hello from Perl in Fission";
+}
+```
+
+---
+
+## Порядок выполнения (ВАЖНО)
+
+```
+1. Проверить доступность ВСЕХ образов (docker pull) → составить список реальных
+2. Для каждого доступного языка:
+   a. Создать examples/LANG-hello/code/... + main.tf
+   b. terraform apply
+   c. curl с JWT → проверить HTTP 200 + ожидаемый body
+   d. Если не работает — смотреть логи:
+      kubectl -n default get events --sort-by=".lastTimestamp" | tail -20
+      kubectl -n default get pods | grep poolmgr-LANG
+      kubectl -n default logs <pod> -c <container> --tail=30
+   e. Если timeout — попробовать newdeploy executor
+   f. Если всё равно не работает — удалить через terraform destroy
+3. Обновить список в консоли (она автоматически видит новые функции)
+4. Протестировать все через консоль (invoke)
+5. Коммит + пуш + тег
+```
+
+---
+
+## Критерий успеха
+
+| Язык | Endpoint | Ожидаемый body | HTTP |
+|---|---|---|---|
+| Go | `/go-hello` | `Hello from Go in Fission` | 200 |
+| Java | `/java-hello` | `Hello from Java in Fission` | 200 |
+| PHP | `/php-hello` | `Hello from PHP in Fission` | 200 |
+| Ruby | `/ruby-hello` | `Hello from Ruby in Fission` | 200 |
+| .NET | `/dotnet-hello` | `Hello from .NET in Fission` | 200 |
+| Perl | `/perl-hello` | `Hello from Perl in Fission` | 200 |
+
+**Минимум:** 3 новых языка работают (Go + ещё 2)  
+**Идеал:** все 6
+
+---
+
+## Шаблон main.tf (копировать и менять)
+
+```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" "env" {
+  name    = "tf-LANG-hello-env"
+  image   = "ghcr.io/fission/LANG-env"
+  version = 3
+}
+
+resource "fission_package" "pkg" {
+  name        = "tf-LANG-hello-pkg"
+  environment = fission_environment.env.name
+  source_dir  = "${path.module}/code"
+}
+
+resource "fission_function" "fn" {
+  name         = "tf-LANG-hello-fn"
+  environment  = fission_environment.env.name
+  package_name = fission_package.pkg.name
+  entrypoint   = "ENTRYPOINT"
+}
+
+resource "fission_http_trigger" "route" {
+  name     = "tf-LANG-hello-route"
+  function = fission_function.fn.name
+  url      = "/LANG-hello"
+  methods  = ["GET"]
+}
+```
+
+---
+
+## Entrypoint для каждого языка
+
+| Язык | Entrypoint | Файл |
+|---|---|---|
+| Python | `main.main` | `main.py` |
+| Node.js | `module.exports` (пустой) | `server.js` |
+| Go | `Handler` | `main.go` |
+| Java | `io.fission.Function` | `Function.java` |
+| PHP | `hello` | `hello.php` |
+| Ruby | `hello.main` | `hello.rb` |
+| .NET | `FissionFunction.Execute` | `FissionFunction.cs` |
+| Perl | `hello.main` | `hello.pm` |
+
+**⚠️ ВНИМАНИЕ:** Entrypoints могут отличаться от указанных! Проверять документацию каждого env:
+```bash
+ssh ... 'docker run --rm ghcr.io/fission/LANG-env:latest env 2>/dev/null | head -20'
+```
+
+---
+
+## Откат при неудаче
+
+Если язык не работает:
+```bash
+ssh ... 'cd ~/terra/fission/examples/LANG-hello && TF_CLI_CONFIG_FILE=/tmp/terraformrc-fission terraform destroy -auto-approve'
+rm -rf examples/LANG-hello/
+```
@@ -0,0 +1,26 @@
+package main
+
+import "fmt"
+
+// Handler используется binary-env: binary получает HTTP request через stdin,
+// stdout является HTTP response body.
+//
+// Для деплоя нужно скомпилировать перед terraform apply:
+//   CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o ../dist/handler .
+//
+// Compiled size: ~1.6MB (слишком велико для literal deployment).
+// Используется shell-based handler в dist/handler (см. ниже).
+func main() {
+	fmt.Print("Hello from Go in Fission")
+}
+package main
+
+import (
+	"fmt"
+	"net/http"
+)
+
+func Handler(w http.ResponseWriter, r *http.Request) {
+	w.Header().Set("Content-Type", "text/plain")
+	fmt.Fprintf(w, "Hello from Go in Fission")
+}
@@ -0,0 +1,42 @@
+terraform {
+  required_providers {
+    fission = {
+      source  = "nail/fission"
+      version = "~> 0.1.0"
+    }
+  }
+}
+
+provider "fission" {
+  kubeconfig_path = "/home/naeel/.kube/config"
+  namespace       = "default"
+}
+
+# Go использует binary-env: функция является скомпилированным Linux-бинарником.
+# Перед apply необходимо скомпилировать:
+#   CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o dist/handler code/
+resource "fission_environment" "go" {
+  name    = "tf-go-hello-env"
+  image   = "ghcr.io/fission/binary-env"
+  version = 3
+}
+
+resource "fission_package" "pkg" {
+  name        = "tf-go-hello-pkg"
+  environment = fission_environment.go.name
+  code_path   = "${path.module}/dist/handler"
+}
+
+resource "fission_function" "fn" {
+  name         = "tf-go-hello-fn"
+  environment  = fission_environment.go.name
+  package_name = fission_package.pkg.name
+  entrypoint   = "handler"
+}
+
+resource "fission_http_trigger" "route" {
+  name     = "tf-go-hello-route"
+  function = fission_function.fn.name
+  url      = "/go-hello"
+  methods  = ["GET"]
+}
@@ -0,0 +1,3 @@
+sub {
+    return "Hello from Perl in Fission";
+}
@@ -0,0 +1,40 @@
+terraform {
+  required_providers {
+    fission = {
+      source  = "nail/fission"
+      version = "~> 0.1.0"
+    }
+  }
+}
+
+provider "fission" {
+  kubeconfig_path = "/home/naeel/.kube/config"
+  namespace       = "default"
+}
+
+# version = 1: Perl env uses v1 specialization (/specialize endpoint)
+resource "fission_environment" "perl" {
+  name     = "tf-perl-hello-env"
+  image    = "ghcr.io/fission/perl-env"
+  version  = 1
+}
+
+resource "fission_package" "pkg" {
+  name        = "tf-perl-hello-pkg"
+  environment = fission_environment.perl.name
+  source_dir  = "${path.module}/code"
+}
+
+resource "fission_function" "fn" {
+  name         = "tf-perl-hello-fn"
+  environment  = fission_environment.perl.name
+  package_name = fission_package.pkg.name
+  entrypoint   = "handler"
+}
+
+resource "fission_http_trigger" "route" {
+  name     = "tf-perl-hello-route"
+  function = fission_function.fn.name
+  url      = "/perl-hello"
+  methods  = ["GET"]
+}
@@ -0,0 +1,7 @@
+<?php
+function handler($context)
+{
+    /** @var \Psr\Http\Message\ResponseInterface $response */
+    $response = $context["response"];
+    $response->getBody()->write("Hello from PHP in Fission");
+}
@@ -0,0 +1,39 @@
+terraform {
+  required_providers {
+    fission = {
+      source  = "nail/fission"
+      version = "~> 0.1.0"
+    }
+  }
+}
+
+provider "fission" {
+  kubeconfig_path = "/home/naeel/.kube/config"
+  namespace       = "default"
+}
+
+resource "fission_environment" "php" {
+  name    = "tf-php-hello-env"
+  image   = "ghcr.io/fission/php-env"
+  version = 3
+}
+
+resource "fission_package" "pkg" {
+  name        = "tf-php-hello-pkg"
+  environment = fission_environment.php.name
+  source_dir  = "${path.module}/code"
+}
+
+resource "fission_function" "fn" {
+  name         = "tf-php-hello-fn"
+  environment  = fission_environment.php.name
+  package_name = fission_package.pkg.name
+  entrypoint   = "main.php::handler"
+}
+
+resource "fission_http_trigger" "route" {
+  name     = "tf-php-hello-route"
+  function = fission_function.fn.name
+  url      = "/php-hello"
+  methods  = ["GET"]
+}
@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+def handler
+  "Hello from Ruby in Fission"
+end
@@ -0,0 +1,39 @@
+terraform {
+  required_providers {
+    fission = {
+      source  = "nail/fission"
+      version = "~> 0.1.0"
+    }
+  }
+}
+
+provider "fission" {
+  kubeconfig_path = "/home/naeel/.kube/config"
+  namespace       = "default"
+}
+
+resource "fission_environment" "ruby" {
+  name    = "tf-ruby-hello-env"
+  image   = "ghcr.io/fission/ruby-env"
+  version = 3
+}
+
+resource "fission_package" "pkg" {
+  name        = "tf-ruby-hello-pkg"
+  environment = fission_environment.ruby.name
+  source_dir  = "${path.module}/code"
+}
+
+resource "fission_function" "fn" {
+  name         = "tf-ruby-hello-fn"
+  environment  = fission_environment.ruby.name
+  package_name = fission_package.pkg.name
+  entrypoint   = "handler"
+}
+
+resource "fission_http_trigger" "route" {
+  name     = "tf-ruby-hello-route"
+  function = fission_function.fn.name
+  url      = "/ruby-hello"
+  methods  = ["GET"]
+}
@@ -290,9 +290,16 @@ func unstructuredToFunctionModel(functionObject *unstructured.Unstructured, base
 }

 func validateEntrypointAgainstPackageSource(entrypoint string, pkg *unstructured.Unstructured) error {
+	if entrypoint == "" {
+		return fmt.Errorf("entrypoint не может быть пустым")
+	}
+
+	// Для Python/Go/JS: валидируем формат module.function и наличие функции в исходнике.
+	// Для PHP (module::function), Ruby (function), Perl (function) — допускаем любой непустой формат.
 	parts := strings.Split(entrypoint, ".")
 	if len(parts) != 2 || parts[0] == "" || parts[1] == "" {
-		return fmt.Errorf("entrypoint %q должен иметь формат module.function", entrypoint)
+		// Не стандартный module.function — допускаем (PHP, Ruby, Perl и др.)
+		return nil
 	}

 	if parts[0] != "main" {
@@ -70,7 +70,12 @@ func TestValidateEntrypointAgainstPackageSourcePythonMissing(t *testing.T) {

 func TestValidateEntrypointAgainstPackageSourceBadFormat(t *testing.T) {
 	pkg := &unstructured.Unstructured{}
-	if err := validateEntrypointAgainstPackageSource("main", pkg); err == nil {
-		t.Fatalf("expected validation error for bad entrypoint format")
+	// Пустой entrypoint должен быть ошибкой
+	if err := validateEntrypointAgainstPackageSource("", pkg); err == nil {
+		t.Fatalf("expected validation error for empty entrypoint")
+	}
+	// Одиночное слово допустимо (Ruby, Perl)
+	if err := validateEntrypointAgainstPackageSource("handler", pkg); err != nil {
+		t.Fatalf("unexpected error for single-word entrypoint: %v", err)
 	}
 }
@@ -71,7 +71,7 @@ func (r *PackageResource) Schema(_ context.Context, _ resource.SchemaRequest, re
 			},
 			"source_dir": schema.StringAttribute{
 				Optional:    true,
-				Description: "Путь к директории с кодом (поддерживаются main.py, main.js, main.go).",
+				Description: "Путь к директории с кодом (поддерживаются main.py, main.js, main.go, main.php, main.rb, main.pl).",
 			},
 			"code_path": schema.StringAttribute{
 				Optional:    true,
@@ -355,7 +355,7 @@ func loadPackageLiteral(sourceDir, codePath string) ([]byte, error) {

 // resolveMainSourceFile выбирает основной файл исходника из source_dir.
 func resolveMainSourceFile(sourceDir string) (string, error) {
-	candidates := []string{"main.py", "main.js", "main.go"}
+	candidates := []string{"main.py", "main.js", "main.go", "main.php", "main.rb", "main.pl"}
 	for _, candidate := range candidates {
 		candidatePath := filepath.Join(sourceDir, candidate)
 		fileInfo, err := os.Stat(candidatePath)
@@ -364,7 +364,7 @@ func resolveMainSourceFile(sourceDir string) (string, error) {
 		}
 	}

-	return "", fmt.Errorf("source_dir %q must contain one of: main.py, main.js, main.go", sourceDir)
+	return "", fmt.Errorf("source_dir %q must contain one of: main.py, main.js, main.go, main.php, main.rb, main.pl", sourceDir)
 }

 // packageToUnstructured преобразует Terraform model в Kubernetes CRD payload.