154 lines
7.7 KiB
Markdown
154 lines
7.7 KiB
Markdown
# Ответ 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 будут получать ошибки. |
|