From ab128515ab4b2e7e6927eba37f9fbb2eb2d865b9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=80=9CNaeel=E2=80=9D?= <tazet@narod.ru>
Date: Wed, 20 May 2026 09:09:11 +0400
Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E2=80=94=20storagesvc=20S3/PV?=
 =?UTF-8?q?=20deploy=20instructions=20+=20comparison=20table?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/README.md b/README.md
index b97a778..5facfd1 100644
--- a/README.md
+++ b/README.md
@@ -102,6 +102,58 @@ Backend сервис для управления serverless-функциями 
 
 ## Деплой
 
+### Хранилище архивов функций (storagesvc)
+
+Fission хранит ZIP-архивы функций через `storagesvc`. Поддерживается два бэкенда:
+
+#### S3 (рекомендуется)
+
+```bash
+# 1. Создать файл с credentials (НЕ коммитить в git):
+cat > helm/fission-s3-secret.yaml << 'EOF'
+persistence:
+  s3:
+    accessKeyId: <ACCESS_KEY>
+    secretAccessKey: <SECRET_KEY>
+EOF
+
+# 2. Применить:
+kubectl delete deploy executor router storagesvc -n fission  # убрать field manager конфликты
+helm upgrade fission fission-charts/fission-all --version 1.22.1 \
+  -n fission \
+  -f helm/fission-values.yaml \
+  -f helm/fission-s3-secret.yaml \
+  --no-hooks --timeout 180s
+```
+
+Параметры S3 (bucket, endpoint, region) — в `helm/fission-values.yaml`.  
+Credentials — только в `helm/fission-s3-secret.yaml` (файл в `.gitignore`).
+
+#### PV (возврат/альтернатива)
+
+```bash
+kubectl delete deploy executor router storagesvc -n fission
+helm upgrade fission fission-charts/fission-all --version 1.22.1 \
+  -n fission \
+  -f helm/fission-values-pv.yaml \
+  --no-hooks --timeout 180s
+```
+
+Никаких секретов не нужно. StorageClass `vcd-disk-ext4` (VMware VCD), 2Gi.
+
+#### Сравнение
+
+| | S3 | PV |
+|---|---|---|
+| Upload скорость | ~1-3s (сеть) | ~0.3-2s (кэш) |
+| Cold start | ≈ одинаково | ≈ одинаково |
+| Hot (основная нагрузка) | идентично | идентично |
+| Масштабирование storagesvc | ✅ N реплик | ❌ ReadWriteOnce |
+| Переезд кластера | ✅ просто бакет | ❌ надо мигрировать PV |
+| Backup | ✅ встроен в S3 | ручной |
+
+---
+
 | Параметр | Значение |
 |---|---|
 | Кластер | `kube5s.ru` |