archive: план миграции shared-sqs на Nubes + HISTORY журнал

2026-08-13 20:51:16 +04:00
parent 6af635afee
commit c5db9e0384
4 changed files with 555 additions and 0 deletions
@@ -0,0 +1,153 @@
+# Ответ Claude Sonnet (v2 — после жёстких ограничений)
+
+**Дата:** 2026-08-13
+**Источник:** Claude Sonnet, промпт v2 (жёсткий список из 16 файлов, без поиска, без терраформа)
+
+---
+
+## 1. Код-ревью (блокеры деплоя)
+
+| Файл | Находка | Блокер? |
+|---|---|---|
+| `Dockerfile` | `EXPOSE 4100`, не 80 — порт нестандартный, но конфигурируемый | зависит от платформы (→ открытый вопрос №1) |
+| `persistence/redis.go` | `redis.Options` без `TLSConfig` — plain TCP на `*.svc.cluster.local:6379` | зависит от платформы (→ открытый вопрос №3) |
+| `router/router.go` | TLS терминируется снаружи (в k8s — Ingress); сам код HTTP | нет — аналогично работает за любым proxy |
+| `admin/admin.go` | `NUBES_ENDPOINT` default = тестовый `deck-api-test.ngcloud.ru` | нет — переопределяется env |
+| `goaws.go` | `SHARED_SQS_ADMIN_TOKEN` — обязательный env, fatal без него | нет — задаётся в контейнере |
+| `Makefile` | образ в Docker Hub (`naeel/shared-sqs`), не в приватном registry | зависит от платформы (→ открытый вопрос №2) |
+
+**Код менять не нужно.** Все потенциальные проблемы — на стороне платформы, не кода.
+
+---
+
+## 2. Целевая архитектура
+
+```mermaid
+graph TD
+    Client["AWS SDK / CLI\n(endpoint_url = новый домен)"]
+    Proxy["Nubes Platform Proxy\nTLS termination"]
+    App["Простой HTTP контейнер\nnaeel/shared-sqs:v0.1.22\nport 4100"]
+    Redis["Managed Redis\nredisk8s.4ff5678b-b683-4aef-91da-22d89dec8a25\n.svc.cluster.local:6379\nrealm iot-naeel"]
+    PG["Managed PostgreSQL\n(опционально, billing)"]
+    NubesAPI["NUBES_ENDPOINT\nJWT-валидация UI"]
+
+    Client -->|HTTPS :443| Proxy
+    Proxy -->|HTTP :4100\ninternal| App
+    App -->|"TCP :6379\nno TLS, internal DNS"| Redis
+    App -. "BILLING_PG_HOST задан" .->|TCP :5432| PG
+    App -->|HTTPS| NubesAPI
+```
+
+**Env vars контейнера:**
+
+```
+SHARED_SQS_ADMIN_TOKEN=<секрет>
+REDIS_ADDR=redisk8s.4ff5678b-b683-4aef-91da-22d89dec8a25.svc.cluster.local:6379
+REDIS_USER=default
+REDIS_PASSWORD=ZJOke5b2bIr6YPOKrnJG
+NUBES_ENDPOINT=https://<production-url>/api/v1     ← уточнить (вопрос №6)
+SHARED_SQS_SEED_DEMO=false
+
+# Только если нужен billing:
+BILLING_PG_HOST=...
+BILLING_PG_PORT=5432
+BILLING_PG_DATABASE=...
+BILLING_PG_USER=...
+BILLING_PG_PASSWORD=...
+BILLING_PG_SSLMODE=require
+```
+
+---
+
+## 3. План миграции (через deck-UI)
+
+### Шаг 0 — Ответы на платформу (блокирует остальное)
+
+Получить ответы на 7 открытых вопросов из раздела 4.
+*Критерий: все вопросы закрыты, особенно №1 (порт), №3 (TLS Redis), №4 (DNS).*
+
+---
+
+### Шаг 1 — Проверить Managed Redis доступность
+
+Запустить временный контейнер (любой с `redis-cli`) в realm iot-naeel, выполнить:
+```
+redis-cli -h redisk8s.4ff5678b-b683-4aef-91da-22d89dec8a25.svc.cluster.local \
+          -p 6379 -a ZJOke5b2bIr6YPOKrnJG ping
+```
+*Критерий: ответ `PONG`.*
+*Откат: не нужен — k8s работает.*
+
+---
+
+### Шаг 2 — Создать "Простой HTTP контейнер" в deck-UI
+
+В deck выбрать realm `iot-naeel`, создать контейнер:
+- Образ: `naeel/shared-sqs:v0.1.22` (или полный путь — уточнить вопрос №2)
+- Порт: 4100 (или как требует платформа — вопрос №1)
+- Ресурсы: min 64Mi/50m CPU, max 256Mi/500m CPU
+- Env vars: полный список из раздела 2 выше
+- Health check: `/health` (уже задан в Dockerfile через `wget`)
+
+*Критерий: контейнер поднялся, статус healthy, `curl /health` → 200 OK.*
+*Откат: удалить контейнер в deck-UI, трафик остаётся в k8s.*
+
+---
+
+### Шаг 3 — Smoke test (до переключения трафика)
+
+```bash
+# 1. Health
+curl -m 5 https://<new-domain>/health
+
+# 2. Создать тенанта
+curl -m 5 -X POST https://<new-domain>/admin/tenants \
+  -H "Authorization: Bearer <ADMIN_TOKEN>" \
+  -d '{"name":"smoke","maxQueues":5}'
+
+# 3. Создать очередь и прогнать сообщение
+aws sqs create-queue --queue-name test-q \
+  --endpoint-url https://<new-domain> --region us-east-1
+aws sqs send-message --queue-url ... --message-body hello
+aws sqs receive-message --queue-url ...
+```
+
+*Критерий: все 3 операции успешны; `/metrics` содержит `sqs_*` метрики.*
+*Откат: исправить env vars в deck-UI → рестарт контейнера.*
+
+---
+
+### Шаг 4 — Переключить клиентов
+
+Обновить `endpoint_url` на всех клиентах с `qu.kube5s.ru` → новый домен Nubes.
+*(Домен `qu.kube5s.ru` не использовать.)*
+
+*Критерий: метрики `sqs_messages_received_total` растут на новом инстансе; ошибок в логах нет.*
+*Откат: вернуть `endpoint_url` на k8s адрес (он ещё жив).*
+
+---
+
+### Шаг 5 — Вывод k8s (только после N дней стабильной работы)
+
+В k8s удалить (в таком порядке):
+1. Ingress `shared-sqs-ingress`
+2. Deployment `shared-sqs`
+3. Deployment `shared-sqs-redis` + PVC `shared-sqs-redis-pvc` ← **необратимо, только когда уверены в данных**
+4. Secrets `shared-sqs-admin`, `shared-sqs-redis`
+5. Namespace `shared-sqs` (если больше не нужен)
+
+*Критерий: namespace пуст, сервис работает только через Nubes.*
+
+---
+
+## 4. Открытые вопросы (ответы только от платформы Nubes)
+
+| # | Приоритет | Вопрос |
+|---|---|---|
+| 1 | **КРИТИЧНО** | Какой порт ожидает "Простой HTTP контейнер" — читает `EXPOSE 4100`, требует явного поля `port`, или нужен env `PORT`? |
+| 2 | **КРИТИЧНО** | Как задаётся образ в deck-UI — Docker Hub `naeel/shared-sqs:v0.1.22` напрямую, или нужен предварительный push в Nubes-registry? Если registry — какой адрес и как аутентифицироваться? |
+| 3 | **КРИТИЧНО** | Требует ли Managed Redis TLS на внутреннем адресе `*.svc.cluster.local:6379`? Код подключается без TLS. |
+| 4 | **КРИТИЧНО** | Видит ли контейнер `nubes_http` внутренний DNS `*.svc.cluster.local` в realm iot-naeel? |
+| 5 | **ВЫСОКИЙ** | Какой URL/домен получает контейнер после деплоя — авто-выдаётся или задаётся вручную? |
+| 6 | **ВЫСОКИЙ** | Какой production URL для `NUBES_ENDPOINT` (вместо тестового `deck-api-test.ngcloud.ru`)? |
+| 7 | **ВЫСОКИЙ** | Поддерживает ли платформа idle HTTP-соединения до 20–30 секунд (SQS long-polling, `WaitTimeSeconds` до 20с)? Если таймаут < 20с — клиенты с long-polling будут получать ошибки. |