Files
buryan-infra/docs/AUTHENTIK-2026-5.md
root 7ec318616d Authentik: 2025.4 -> 2026.5.7 (13 месяцев обновлений), найден блокер 2026.8
Ступенчатый подход сработал:
  2025.12.6  — прошло
  2026.2.7   — прошло
  2026.5.7   — прошло
  2026.8.4   — зависает

ИТОГО: апрель 2025 -> май 2026. Данные целы: 10 пользователей,
23 приложения, 24 OAuth2-провайдера, 718 миграций. Все 26 доменов
отвечают, наблюдение 60 проверок без провалов, состояние стабильно.

ПОЧЕМУ СТУПЕНИ ПОМОГЛИ: прямой прыжок 2025.12.6 -> 2026.8.4 виснет, а
промежуточные версии встали с первого запуска. Значит проблема не в
ресурсах и не в правах, а в конкретном переходе.

ПРИЧИНА ЗАВИСАНИЯ 2026.8 — КОДИРОВКА БАЗЫ. Authentik предупреждает:
«PostgreSQL Server encoding is not UTF8: SQL_ASCII». Проверено:
рабочая база authentik_db — SQL_ASCII, а 25 других баз сервера — UTF8.
Там же лежат базы *_pre_utf8_20261014_* — следы НЕЗАВЕРШЁННОГО перевода
в UTF8, сделанного 14 октября. 2026.8 требует UTF8 и виснет на
преобразовании.

СЛЕДУЮЩИЙ ШАГ (задача 1.20): перевести authentik_db в UTF8 отдельной
операцией — дамп с --encoding=UTF8, новая база с TEMPLATE template0,
заливка, проверка кириллицы и счётчиков, переключение приложения. И
только потом 2026.8.4. Не смешивал с обновлением версии: это уже
миграция данных, а смешивать два риска в одной операции нельзя.

НАДЁЖНОСТЬ: версия закреплена по digest; перед каждым шагом снимался
дамп; порядок откката отработан и проверен (версия + база, с проверкой
схемы); память CT 114 — 4096 МБ.
2026-10-18 02:21:15 +03:00

4.0 KiB
Raw Permalink Blame History

Authentik: 2025.4 → 2026.5.7, и почему 2026.8 упирается

18.10.2026. Продолжение окна. Ступенчатый подход сработал.

Результат

Шаг Версия Итог
1 2025.12.6 ✅ прошло
2 2026.2.7 ✅ прошло
3 2026.5.7 ✅ прошло
4 2026.8.4 ❌ зависает

Итого: 2025.4 (апрель 2025) → 2026.5.7 (май 2026) — 13 месяцев обновлений.

Данные целы: 10 пользователей, 23 приложения, 24 OAuth2-провайдера, 718 миграций. Все 26 доменов отвечают, наблюдение 60 проверок без провалов, состояние стабильно.

Почему ступени помогли

Прямой прыжок 2025.12.6 → 2026.8.4 виснет. А через 2026.2.7 и 2026.5.7 обе промежуточные версии встали с первого запуска. То есть проблема не в ресурсах и не в правах, а в конкретном переходе.

Причина зависания 2026.8: кодировка базы

В журнале Authentik:

PostgreSQL Server and Client encoding are mismatched:
  Server: SQL_ASCII, Client: UTF8
PostgreSQL Server encoding is not UTF8: SQL_ASCII

Проверка баз на сервере:

База Кодировка
authentik_db (рабочая) SQL_ASCII
authentik UTF8
authentik_db_pre_utf8_20261014_194631 SQL_ASCII
authentik_pre_utf8_20261014_194645 SQL_ASCII
остальные 25 баз UTF8

Вывод: 2026.8 требует UTF8 и виснет на попытке преобразования. А имена *_pre_utf8_20261014_* — это следы незавершённого перевода в UTF8, сделанного 14 октября. Тогда базу пересоздали, но данные перенесли не полностью или откатили, и рабочая база осталась в SQL_ASCII.

Что нужно для 2026.8 (план)

Перевод базы в UTF8 — отдельная операция с данными:

  1. снять дамп с конвертацией: pg_dump --encoding=UTF8;
  2. создать новую базу с ENCODING 'UTF8' TEMPLATE template0;
  3. залить дамп, проверить, что кириллица не побилась;
  4. проверить число пользователей, приложений, провайдеров;
  5. переключить приложение на новую базу;
  6. только потом ставить 2026.8.4.

Риск: неверное преобразование кодировки портит текстовые данные (названия групп, описания, имена). Поэтому делать это надо отдельно от обновления версии — сначала перевод и проверка, потом версия.

Почему не сделал сейчас: это уже не обновление, а миграция данных. Смешивать её с обновлением версии — двойной риск в одной операции.

Что сделано для надёжности

  • версия закреплена по digest (sha256:76bf433f...);
  • перед каждым шагом снимался дамп (последние три сохранены);
  • отработан и проверен порядок откката: версия + база, с проверкой схемы;
  • память CT 114 — 4096 МБ.

Дампы

/root/authentik-pre-2026.5.7-20261018_015421.sql
/root/authentik-pre-2026.8.4-20261018_015610.sql
/root/authentik-2025_12-20261018_015208.sql
/root/authentik-db-20261017_162531.sql   (состояние до окна)