doc: HISTORY/FULL-2026-08-06.md — всё что делали, обсуждали, план на будущее

2026-08-06 21:49:54 +04:00
parent 24796f4b4f
commit c235db00de
1 changed files with 171 additions and 0 deletions
@@ -0,0 +1,171 @@
+# tf_registry — ПОЛНАЯ история (2026-08-06)
+
+## Итог: что работает сейчас
+
+| Сервис | Тип | Домен | Статус |
+|---|---|---|---|
+| `registry` | pythonk8s | `registry.pythonk8s.dev.nubes.ru` | Flask (не обновлён, висит старая версия) |
+| `go-registry` | containerk8s | `go-registry.containerk8s.dev.nubes.ru` | Go ✅ (полностью работает) |
+
+### Что проверено на Go:
+- `GET /` — HTML с версией v1.0.0 ✅
+- `GET /.well-known/terraform.json` ✅
+- `GET /v1/providers/nubes-test/nubes/versions` — 17 версий ✅
+- `GET /v1/providers/.../download/linux/amd64` — shasum + 2 GPG ключа ✅
+- Платформы: darwin, linux, windows ✅
+- GPG: `3EC4673EB798238A` (основной) + `CB3A0DF161ECC416` (legacy) ✅
+
+---
+
+## Хронология
+
+### Этап 1: Flask (pythonk8s)
+1. Создан `site/app.py` — 7 роутов, структура `site/` (требование Nubes)
+2. `requirements.txt`: flask, boto3
+3. Первый деплой — ошибка `Init:Error` (gitea приватный)
+4. Репо сделан публичным → деплой успешен
+5. API не работал: `versions: []`, `shasum: ""`
+6. **Причина:** S3-ключи под `registry.kube5s.ru`, а Flask ищет под `registry.pythonk8s.dev.nubes.ru`
+7. Добавлен `S3_PREFIX` в код Flask
+8. GPG — в исходниках 1 ключ, живой деплой отдаёт 2 → заменён на 2 ключа
+9. Добавлен darwin в платформы
+
+### Этап 2: Go-контейнер (containerk8s)
+1. Обнаружен тип сервиса `containerk8s` — generic HTTP контейнер
+2. Создана ветка `go-container`
+3. Правки Go: порт `:5000` (вместо `:8080`), `PORT` из ENV
+4. GPG: 2 ключа в `gpg_key.go` (без импорта registrykeys)
+5. Платформы: добавлен darwin
+6. Dockerfile: multi-stage (golang:1.24-alpine → alpine:3.21)
+7. Gitea Docker registry: `docker login gitea.services.ngcloud.ru -u Nail` ✅
+8. Образ: `gitea.services.ngcloud.ru/nail/tf_registry:latest`
+9. S3_PREFIX: хардкод `registry.kube5s.ru` (с TODO-комментарием)
+10. VERSION: `const VERSION = "1.0.0"`, на главной странице
+
+### Ошибки при деплое containerk8s
+1. `docker build` — `repository name must be lowercase` → `nail/tf_registry`
+2. `minio-go/v7` требует Go >= 1.25 → `GOTOOLCHAIN=auto`
+3. modify не даёт менять `jsonEnv` → пришлось хардкодить `S3_PREFIX`
+
+---
+
+## Проблема S3_PREFIX
+
+**Суть:** S3-объекты хранятся с префиксом `registry.kube5s.ru/...` (старый Go-реестр).
+Новый реестр имеет домен `go-registry.containerk8s.dev.nubes.ru` — не совпадает.
+
+**Текущее решение (временное):** хардкод `s3Prefix = "registry.kube5s.ru"` в `main.go`.
+```go
+// ── TEMPORARY HARDCODE ──────────────────────────────────────────────────
+// TODO: REMOVE after devops adds jsonEnv editing to containerk8s "modify".
+//       Then read from ENV:  s3Prefix = os.Getenv("S3_PREFIX")
+//       And set in UI jsonEnv:  "S3_PREFIX": "registry.kube5s.ru"
+// ─────────────────────────────────────────────────────────────────────────
+```
+
+**Правильные решения (на будущее):**
+
+Путь 1 — скопировать S3-объекты под новый домен:
+```
+mc cp s3/.../registry.kube5s.ru/ s3/.../go-registry.containerk8s.dev.nubes.ru/ --recursive
+```
+
+Путь 2 — убрать домен из S3-путей вообще:
+```
+Вместо: {hostname}/{ns}/{name}/{ver}/...
+Сделать: {ns}/{name}/{ver}/...
+```
+
+После любого из путей — `s3Prefix = hostname`, хардкод не нужен.
+
+---
+
+## Структура репозитория
+
+### Ветка `master`
+```
+tf_registry/
+├── site/                    # Flask (НЕ ИСПОЛЬЗУЕТСЯ, мёртвый код)
+│   └── app.py
+├── requirements.txt         # Для Flask (НЕ ИСПОЛЬЗУЕТСЯ)
+├── server/                  # Go-код (LEGACY, без правок)
+├── operator/                # Go operator (LEGACY)
+├── k8s/                     # Манифесты (LEGACY)
+├── charts/                  # Helm (LEGACY)
+├── registrykeys/            # Старый GPG (LEGACY)
+├── secrets/
+│   ├── env.txt              # S3-креды + jsonEnv (в .gitignore)
+│   └── llm.key              # Токены (Gitea, LLM)
+├── HISTORY/                 # Документация
+│   ├── README-NEW-CHAT.md
+│   ├── plan-sonnet-full.md
+│   ├── 2026-08-06-plan-review.md
+│   └── 2026-08-06-first-deploy.md
+├── Dockerfile               # Для Go-контейнера
+└── .gitignore               # secrets/, __pycache__/
+```
+
+### Ветка `go-container` (АКТУАЛЬНАЯ)
+```
+server/
+├── main.go          # Порт 5000, S3_PREFIX hardcode, VERSION, darwin
+├── gpg_key.go       # 2 GPG ключа (primary + legacy)
+├── docs.go          # Без изменений
+└── gpg/             # Без изменений
+Dockerfile           # golang:1.24-alpine → alpine:3.21
+```
+
+---
+
+## CI/CD
+
+### Сборка и пуш образа
+```bash
+docker build -t gitea.services.ngcloud.ru/nail/tf_registry:latest .
+docker push gitea.services.ngcloud.ru/nail/tf_registry:latest
+```
+
+### Деплой
+- Тип: `containerk8s` (Простой HTTP контейнер)
+- `registryPath`: `gitea.services.ngcloud.ru/nail/tf_registry:latest`
+- `resourceRealm`: `iot-naeel`
+- `jsonEnv`: в UI, креды в `secrets/env.txt`
+
+### Что можно менять в modify
+- ТОЛЬКО: CPU, Memory, количество узлов
+- jsonEnv и registryPath — НЕЛЬЗЯ (надо просить devops добавить)
+
+---
+
+## Что дальше
+
+1. **Devops** — добавить редактирование `jsonEnv` в modify для containerk8s
+2. **S3** — решить что делать с префиксом (копировать или убрать домен)
+3. **Убрать хардкод** — `s3Prefix` из ENV `S3_PREFIX`
+4. **Домен** — пересоздать с именем `registry` (вместо `go-registry`)
+5. **Удалить Flask** — `site/app.py`, `requirements.txt` из master (мёртвый код)
+6. **Удалить старые Go-файлы** — `operator/`, `k8s/`, `charts/`, `registrykeys/`
+
+---
+
+## Креды и доступы
+
+| Что | Где |
+|---|---|
+| S3 креды | `secrets/env.txt`, K8s Secret `s3-credentials` |
+| Gitea токен | `secrets/llm.key` (строка `gitea`) |
+| Docker login | `gitea.services.ngcloud.ru`, user `Nail`, токен `1999993c...` |
+| ВМ | `ssh naeel@5.172.178.213` |
+| Кубер | только через ВМ |
+| Go-реестр (старый) | `https://registry.kube5s.ru` |
+| Flask-реестр | `https://registry.pythonk8s.dev.nubes.ru` |
+| Go-реестр (новый) | `https://go-registry.containerk8s.dev.nubes.ru` |
+| Gitea репо | `https://gitea.services.ngcloud.ru/Nail/tf_registry.git` |
+
+---
+
+## Правила
+- После каждого коммита → сразу push
+- Перед деплоем → `docker build && docker push`
+- `containerk8s` берёт образ из `registryPath`, НЕ клонирует git
+- Gitea Docker registry требует lowercase-имён: `nail/tf_registry`, не `Nail/...`