Files
buryan-infra/docs/AUTHENTIK-UPGRADED.md
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

4.8 KiB

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, затем проверить наличие нужных колонок — только потом поднимать приложение.