Files
buryan-infra/docs/AUTHENTIK-WINDOW-2026-10-17.md
root a04259fcc6 Authentik: окно проведено, три препятствия найдены, служба восстановлена
Владелец: «окно для Authentik делаем, это важно». Проведено.
ИТОГ: служба работает, обновление не выполнено — найдены три
конкретные препятствия, два сняты.

1. ПРАВА НА ТАБЛИЦЫ (снято). Миграции падали:
   «must be owner of table authentik_brands_brand». Таблицы базы
   authentik_db принадлежат роли authentik, а приложение ходит как
   authentik_user. Старая версия структуру не меняла, поэтому проблема
   была невидима годами. Выдано членство роли — обратимо.

2. ПОРЯДОК ВЕРСИЙ (учтено). «Major version skips are not allowed:
   from 2025.12.6 to 2026.8.4». Прыгать через мажор нельзя, порядок
   обязателен: 2025.4 -> 2025.12.6 -> 2026.8.4.

3. МИГРАЦИЯ ЗАВИСАЕТ (не снято). После исправления прав 2025.12.6
   встала на «waiting to acquire database lock» на 20+ минут. Проверено
   и исключено: подготовленных транзакций нет, блокировок нет, зависших
   сессий нет, права выданы. Остаётся память: CT 114 имеет 2048 МБ, а у
   Authentik 2025.12 требования выше. Следующий шаг — поднять до 4 ГБ.

МОИ ОШИБКИ ПРИ ОТКАТЕ (записаны в документ):
  * откат версии приложения без отката базы оставил схему новее
    приложения -> вход отдавал 502 (session_key vs session_id);
  * восстановление из дампа не сработало молча: psql шёл от postgres, а
    файл был доступен только root; я не проверил результат;
  * завершая «зависшие» сессии, снял ту, которая была самим
    восстановлением.

ВОССТАНОВЛЕНО: база пересоздана и залита из дампа, снятого до окна.
Проверено: 165 таблиц, 10 пользователей, 23 приложения, 556 миграций,
колонка session_key на месте, страница входа 200, все домены отвечают,
наблюдение 60 проверок без провалов.

Дампы сохранены: рабочий и «сломанный». Версия приложения закреплена по
digest, чтобы случайный pull не подсунет нерабочую.
2026-10-17 18:44:21 +03:00

6.3 KiB
Raw Permalink Blame History

Окно обновления Authentik 17.10.2026: что выяснено

Владелец: «окно для Authentik делаем, это важно». Окно проведено. Итог: служба работает, обновление НЕ выполнено — найдены три препятствия, два из которых устранены.

Что нашли (по порядку)

1. Права на таблицы — устранено

django.db.utils.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_version=2025.12.6 to_version=2026.8.4

Authentik запрещает перескакивать мажорную версию. Порядок обязателен: 2025.4 → 2025.12.6 → 2026.8.4. Попытка поставить сразу 2026.8.4 обречена.

3. Миграция зависает — НЕ устранено

После исправления прав 2025.12.6 встала на:

[info] waiting to acquire database lock

и висела 20+ минут. Проверено и исключено:

Проверка Результат
подготовленные транзакции нет
блокировки в базе нет (кроме служебных)
зависшие сессии нет
права на таблицы выданы
память контейнера 2048 МБ

Вероятная причина: worker применяет миграции и не доводит их — возможно, не хватает памяти (у Authentik 2025.12 требования выше, чем у 2025.4) или миграция упирается в объём данных.

Что пошло не так при откате (мои ошибки)

  1. Первый откат оставил базу в промежуточном состоянии. Миграции 2025.12 успели применить часть изменений, а приложение вернулось на 2025.4 → вход стал отдавать 502: column authentik_core_authenticatedsession.session_key does not exist. Урок: откат версии приложения БЕЗ отката базы не работает.

  2. Восстановление из дампа не сработало молча. psql запускался от пользователя postgres, а файл дампа был доступен только root → Permission denied. Я не проверил результат восстановления и запустил приложение — оно упало на схеме. Урок: после восстановления проверять СХЕМУ, а не только «команда прошла».

  3. Прервал собственное восстановление. Завершая «зависшие» сессии, я снял ту, которая и была восстановлением (terminating connection due to administrator command), и получил полувосстановленную базу. Урок: не убивать сессии по шаблону, не проверив, чья это сессия.

Как восстановлено

База пересоздана с нуля и залита из дампа, снятого до окна:

DROP DATABASE authentik_db; CREATE DATABASE authentik_db OWNER authentik;
psql -v ON_ERROR_STOP=1 -f dump.sql

Проверено после:

Показатель Значение
таблиц 165
пользователей 10
приложений 23
миграций 556
колонка session_key есть
страница входа 200
все домены отвечают
наблюдение 60 проверок, провалов нет

Дампы сохранены: /root/authentik-db-20261017_162531.sql (рабочий), /root/authentik-broken-20261017_180545.sql (сломанное состояние).

Что готово к следующей попытке

  • членство роли выдано — миграции больше не упираются в права;
  • версия приложения закреплена по digest — случайный pull не подсунет нерабочую версию;
  • дамп рабочего состояния есть, проверен;
  • порядок версий известен: 2025.12.6, затем 2026.8.4.

Что нужно сделать перед повтором

  1. Поднять память CT 114 с 2048 до 4096 МБ — вероятная причина зависания миграций.
  2. Запускать 2025.12.6 и смотреть журнал worker (он применяет миграции), а не только server.
  3. Дать миграциям до 30 минут и следить за строками Migration finished — это признак прогресса.
  4. Откат делать вместе с базой: сначала дамп, потом версия.

Вывод

Обновление упирается не в «сломанный Authentik», а в три конкретные вещи, две из которых уже сняты. Следующая попытка с большей памятью и наблюдением за worker'ом имеет хорошие шансы.