Files
buryan-infra/docs/AUTHENTIK-UPGRADED.md
T
root f2e0c7ade7 Authentik обновлён: 2025.4 -> 2025.12.6 (18 месяцев обновлений)
Окно проведено по решению владельца. ИТОГ: обновление ВЫПОЛНЕНО.

БЫЛО: образ от 8 апреля 2025 (2025.4), 18 месяцев без обновлений —
:Docker-тег latest не существует, поэтому pull всегда падал, а скрипт
обновления молча объявлял успех.
СТАЛО: 2025.12.6, последняя версия 2025 года.

ДАННЫЕ ЦЕЛЫ: 10 пользователей, 23 приложения, 24 OAuth2-провайдера.
Все 28 доменов отвечают, наблюдение 60 проверок без провалов, состояние
стабильно через 2 и 4 минуты.

ТРИ ПРЕПЯТСТВИЯ, КОТОРЫЕ ПРИШЛОСЬ СНЯТЬ:
1. ПРАВА НА ТАБЛИЦЫ: таблицы базы принадлежат роли authentik, а
   приложение ходит как authentik_user; миграции меняют структуру и
   требовали прав владельца. Выдано членство роли.
2. ПОРЯДОК ВЕРСИЙ: Authentik запрещает прыгать через мажор
   («Major version skips are not allowed»). Обязательный порядок:
   2025.4 -> 2025.12.6 -> 2026.8.4.
3. ПАМЯТЬ: при 2048 МБ миграция стояла на «waiting to acquire database
   lock». После подъёма до 4096 МБ обновление прошло с первого запуска.

ОСТАЛОСЬ: 2026.8.4 снова зависает на блокировке даже при 4 ГБ. Откат на
2025.12.6 работает штатно. Нужно отдельное окно и разбор конкретной
миграции. Не срочно: 2025.12.6 — последняя версия 2025 года.

ЗАЩИТА: версия закреплена по digest (случайный pull не подсунет
нерабочую), дамп базы до окна сохранён, членство роли выдано.

МОИ ОШИБКИ В ОКНЕ (записаны в документ):
  * откатил версию без отката базы -> схема новее приложения -> вход 502;
  * не проверил результат восстановления (psql от postgres, файл только
    для root) — приложение упало на схеме;
  * снял свою же сессию восстановления, получив полусостояние.
Правило: откатывать версию и базу ВМЕСТЕ, после восстановления
проверять схему, перед завершением сессии смотреть, чей это запрос.
2026-10-17 19:16:29 +03:00

89 lines
4.8 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.
# Authentik обновлён: 2025.4 → 2025.12.6
**17.10.2026, окно проведено по решению владельца.**
## Результат
| | Было | Стало |
|---|---|---|
| Версия | 2025.4 (образ от 8 апреля 2025) | **2025.12.6** |
| Пользователей | 10 | **10** (все на месте) |
| Приложений | 23 | **23** |
| OAuth2-провайдеров | 24 | **24** |
| Страница входа | работает | работает |
| Память CT | 2048 МБ | **4096 МБ** |
Проверено: все 28 доменов отвечают, наблюдение 60 проверок без провалов,
состояние стабильно через 2 и 4 минуты после запуска.
## Что мешало (три препятствия)
### 1. Права на таблицы
```
ProgrammingError: must be owner of table authentik_brands_brand
```
Таблицы базы `authentik_db` принадлежат роли `authentik`, а приложение
подключается как `authentik_user`. Миграции меняют структуру — нужны
права владельца. **Исправлено:** `GRANT authentik TO authentik_user`.
### 2. Порядок версий
```
Major version skips are not allowed: from 2025.12.6 to 2026.8.4
```
Authentik запрещает перескакивать мажорную версию. Порядок обязателен:
**2025.4 → 2025.12.6 → 2026.8.4**.
### 3. Память
С 2048 МБ миграция 2025.12 стояла на `waiting to acquire database lock`
и не двигалась. После подъёма до **4096 МБ** обновление прошло с первого
запуска. Это подтвердило догадку: не хватало памяти, процесс не падал, а
«замирал».
## Что осталось: 2026.8.4
Переход на 2026.8.4 **не выполнен**: он снова зависает на
`waiting to acquire database lock`, уже при 4 ГБ памяти. Откат на
2025.12.6 работает штатно.
Вероятно, дело в конкретной миграции 2026.8, а не в ресурсах. Нужен
отдельный подход: посмотреть, какая именно миграция запускается и на чём
встаёт (журнал с уровнем DEBUG), либо идти через промежуточную версию
2026.2 или 2026.5.
**Это не срочно:** 2025.12.6 — последняя версия 2025 года, все
исправления безопасности за год получены. 2026.8.4 — следующая ступень,
её можно сделать в отдельное окно.
## Защита на будущее
* версия закреплена по digest (`sha256:d4c1750e...`) — случайный
`docker compose pull` не подсунет нерабочую версию;
* дамп базы до окна сохранён: `/root/authentik-db-20261017_162531.sql`;
* членство роли выдано — следующая попытка не упрётся в права.
## Мои ошибки в этом окне (важно для следующего раза)
1. **Откат версии без отката базы.** Миграции успели изменить схему, а
приложение вернулось на старую версию → вход отдавал 502
(`session_key` против `session_id`).
**Правило: откатывать версию и базу ВМЕСТЕ.**
2. **Не проверил результат восстановления.** `psql` шёл от пользователя
`postgres`, а файл дампа был доступен только `root` — восстановление
не выполнилось, я этого не заметил и запустил приложение.
**Правило: после восстановления проверять СХЕМУ, а не «команда
прошла».**
3. **Снял свою же сессию.** Завершая «зависшие» соединения, убил ту,
которая была восстановлением, и получил полувосстановленную базу.
**Правило: перед завершением сессии смотреть, чей это запрос.**
Из этого вышло правило восстановления: пересоздать базу и залить дамп с
`ON_ERROR_STOP=1`, затем проверить наличие нужных колонок — только потом
поднимать приложение.