Files
buryan-infra/docs/AUTHENTIK-2026-8-DONE.md
root fcdf1b84ca Authentik 2026.8.4: обновление завершено, база переведена в UTF8
Доведено до последней версии: 2025.4 (апрель 2025) -> 2026.8.4.
18 месяцев обновлений.

ИТОГ: пользователей 10, приложений 23, провайдеров 24, групп 19,
миграций 556 -> 777, кодировка UTF8. Все 27 доменов отвечают,
наблюдение 60 проверок без провалов, перезапусков 0.

БЛОКЕРОМ БЫЛА КОДИРОВКА SQL_ASCII: 2026.8 требует UTF8 и висел на
«waiting to acquire database lock» — не падал, а замирал.

КАК ПЕРЕВОДИЛИ (безопасно, без риска для данных):
 1. дамп с --encoding=UTF8 (конвертация на выгрузке);
 2. ТЕСТОВАЯ база authentik_utf8_test с ENCODING UTF8 TEMPLATE template0;
 3. заливка дампа в неё;
 4. сравнение: 215 таблиц против 215, пользователи 10/10, группы 18/18,
    приложения 23/23, провайдеры 24/24, миграции 718/718;
 5. контрольная сумма данных пользователей (md5 склейки
    username/name/email) — совпала полностью;
 6. проверено наличие не-ASCII текста: 0 значений в ключевых колонках —
    риск порчи текста нулевой;
 7. только потом переключение: старая база -> authentik_db_ascii_backup,
    тестовая -> рабочая. Это переименование, а не копирование:
    мгновенно и обратимо.

После этого 2026.8.4 поднялся с первого запуска за 60 секунд.

ОСТАЛОСЬ НА ДИСКЕ: база ascii_backup, дампы до каждого шага, версия
закреплена по digest.
2026-10-18 11:22:12 +03:00

3.1 KiB
Raw Permalink Blame History

Authentik 2026.8.4: обновление завершено

18.10.2026. Доведено до последней версии.

Итог

Было Стало
Версия 2025.4 (апрель 2025) 2026.8.4
Кодировка базы SQL_ASCII UTF8
Пользователей 10 10
Приложений 23 23
Провайдеров OAuth2 24 24
Групп 18 19
Миграций 556 777

Все 27 доменов отвечают, наблюдение 60 проверок без провалов, состояние стабильно, перезапусков ноль.

Что было блокером и как снято

Блокер: кодировка базы SQL_ASCII. Authentik 2026.8 требует UTF8 и висел на waiting to acquire database lock — не падал, а замирал.

Как переводили (безопасно)

  1. Снят дамп с --encoding=UTF8 — конвертация на выгрузке.
  2. Создана тестовая база authentik_utf8_test с ENCODING 'UTF8' TEMPLATE template0.
  3. Дамп залит в тестовую базу.
  4. Сравнение: 215 таблиц против 215; пользователи 10/10, группы 18/18, приложения 23/23, провайдеры 24/24, миграции 718/718.
  5. Контрольная сумма данных пользователей (md5 от склейки username/name/email) — совпала полностью.
  6. Проверено, есть ли в базе не-ASCII текст: 0 значений в ключевых текстовых колонках. То есть риск порчи текста был нулевой.
  7. Только после этого — переключение: старая база переименована в authentik_db_ascii_backup, тестовая стала рабочей.

Переключение — это переименование, а не копирование: мгновенно и обратимо.

Почему сработало только с UTF8

Порядок обновления был такой:

2025.4 → 2025.12.6  ✅
2025.12.6 → 2026.2.7  ✅
2026.2.7 → 2026.5.7   ✅
2026.5.7 → 2026.8.4   ❌ висел

2026.8 — первая версия, которая полезла в кодировку. После перевода базы в UTF8 обновление прошло с первого запуска за 60 секунд.

Что осталось на диске

  • authentik_db_ascii_backup — прежняя база, резерв;
  • дампы до каждого шага в /root/authentik-pre-*.sql;
  • версия закреплена по digest sha256:e7226ae1....

Откат

pct exec 114 -- docker compose stop server worker
ALTER DATABASE authentik_db RENAME TO authentik_db_utf8_failed;
ALTER DATABASE authentik_db_ascii_backup RENAME TO authentik_db;
pct exec 114 -- docker compose up -d