loop-ops

Скрипты эксплуатации Loop, собранные после переезда с Yandex на Selectel (октябрь 2026): перенос баз между Postgres-кластерами, перенос инстансов между кубами, временные прокси, DNS, проверка здоровья. Одна точка входа: loopctl.

Установка

cp config.env.example config.env     # пути к kubeconfig, целевой куб
ln -s "$PWD/loopctl" /usr/local/bin/loopctl

Нужны kubectl, jq, curl, dig, python3. Секретов в репозитории нет:

Что	Откуда
пароли баз инстансов	секреты <id>-db-credentials в кубе
пароль базы визора	секрет loop-support/loop-vizor-production-secrets
токен визора	~/.vizor-token / ~/.vizor-refresh, обновляется из буфера (JSON ответа Keycloak /token из DevTools)
доступ к Selectel DNS	~/.selectel-dns.env (разбирается, не исполняется)

Всё, что меняет состояние, спрашивает подтверждение. LOOPCTL_YES=1 — не спрашивать.

Команды

loopctl db move    <куб> <id> <lm|lp3|ff|wilix> [--scale-0]   перенос базы целиком
loopctl db migrate | verify | cutover | bind                  те же шаги по одному
loopctl k8s move   <id>...                                    перенос инстанса на DST (loop-3)
loopctl k8s rebind <id>                                       только секреты + привязка в визоре
loopctl proxy make <id> <исходный куб>                        манифест временного прокси
loopctl proxy traffic <исходный куб> [секунд]                 запросы через прокси (0 = можно снимать)
loopctl dns show|ttl|cname <поддомен> [значение]
loopctl check <id>... | --db <хост> | --all

Перенос базы (db move)

1. migrate: роль и база на целевом CNPG, Job pg_dump | psql в кубе инстанса. --scale-0 гасит инстанс до конца cutover (иначе посты за время копии останутся в старой базе); если копия или сверка не прошли, реплики возвращаются и инстанс остаётся на старой базе. Статус в локальном registry db move не останавливает.
2. verify: сравнение количества users/channels/posts.
3. cutover: секрет + env в CR на новую базу, рестарт, ожидание Ready. Свои ресурсы и probes инстанса не понижает, приостановленный (replicas 0) не будит: ему только меняет DSN.
4. bind: новая база в визоре (провайдер + env через API). Без этого шага следующий sync визора вернёт инстанс на старую базу.

Параметры кластеров БД (хосты, порты, пулеры) — apply_cnpg_cluster_profile в db/lib.sh, тонкая настройка копии — db/config.env. Работает только TRANSFER_MODE=stream: режим file отключён, пока не исправлена проверка полноты дампа.

Перенос инстанса между кубами (k8s move)

Секреты и TLS на DST → привязка в визоре → env → sync → проверка (ping с БД, лицензия, env против исходного CR) → прокси на старом кубе и replicas 0 → CNAME на DST_DNS. До прокси исходный инстанс не трогается. Остановка на первой ошибке; PARALLEL=1 — до 10 инстансов, каждый в свой лог в state/batch-logs/.

Прокси снимать по факту трафика, а не по времени: loopctl proxy traffic loop-2 300 — у кого 0 запросов за интервал, можно удалять. Для редких клиентов (webhook раз в сутки) сравнить снимок счётчиков через сутки. Список прокси — state/proxy-cleanup.txt.

Проверки

bash tests/cutover-patch.sh — патч CR при cutover (ресурсы, probes, replicas).

Известные ограничения

• Движок копии: wait_job считает Job упавшим в паузе между перезапусками пода; при Job, оставленном после таймаута, у роли снимается SUPERUSER до конца restore. При ручном наблюдении не мешает, исправить отдельно.
• DSN баз указывают на IP одной ноды с externalTrafficPolicy: Local: если пулер уедет с этой ноды, база недоступна (сбой lp3 24.10.2026). Нужны FQDN для баз.
• Пул соединений lp3 (max_connections=1000, pgbouncer session) почти выбран: массовый рестарт упирается в лимит.