Files
buryan-infra/ops/sso/OAUTH2-COMPOSE.md
T

75 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 32 oauth2-proxy переведены под compose (10.11.2026)
## Проблема
Вход в сервисы защищён `oauth2-proxy`, но **43 контейнера** созданы командой
`docker run` — конфигурация нигде не сохранена. Пересоздали контейнер
(обновление образа, перезагрузка) — настройки потеряны. С Vaultwarden это
уже случилось: мы восстанавливали прокси вручную.
В репозитории было только **10 compose-файлов** из 43.
## Что сделано
### Генератор `ops/scripts/oauth2-compose.py`
Читает живое состояние (`docker inspect`) и выгружает все oauth2-proxy в
compose. Использует готовый `docker-to-compose.py` для сборки YAML.
Правила:
* где `deploy/ctNNN/docker-compose.yml` ещё нет — пишем туда;
* где есть — отдельный `oauth2-proxy.compose.yml` (как уже было у ct118/ct119);
* секреты в Git **не попадают**: в compose `${VAR}`, значения — в
`/root/.env-out/ctNNN.env` (права 600).
### Сгенерировано 11 файлов, 32 службы
```
CT102 1 CT107 1 CT115 1 CT119 1
CT106 1 CT108 2 CT117 1 CT155 1
CT109 1 CT110 21 CT118 1
```
Проверка YAML: 32 службы, 0 битых, **0 файлов с открытыми секретами**.
### Контейнеры переведены под compose
Процедура на каждый CT: доставить compose + env → удалить ручной контейнер →
`docker compose up -d` → проверить порт.
```
итог: служб 32 | отвечают 32 | проблем 0
вне compose всего: 0
```
Простой на службу — около 4 секунд.
## Ловушка при проверке
Первый замер показал «4 из 21 портов отвечают» на CT110. Оказалось,
у части прокси `network_mode: host` (порт в `HTTP_ADDRESS`), у части —
проброс (`9284:4180`). Проверять надо **по портам из compose**, а не по
`HTTP_ADDRESS`. После правильной проверки — 32 из 32.
## Защита от повторения
`check_sso_providers.py` (задание Hermes `sso-providers`, ежедневно 07:05)
теперь проверяет ещё и это:
```
✓ все oauth2-proxy под compose
```
Появится новый контейнер через `docker run` — станет событием в шине.
## Что осталось
1. **Значения секретов** лежат в `/root/.env-out/ctNNN.env` (600) и
продублированы на CT в `/opt/buryan-hub/oauth2.env`. При ротации менять
в обоих местах.
2. **Не автоматизирован откат**: если compose-файл окажется неверным,
вернуть ручной контейнер можно из резервных копий `.bak-*`.
3. Проверить вход в сервисы, которые давно не открывались (grocy, monica,
stirling, memos) — они были среди сломанных SSO-провайдеров.