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

86 lines
4.0 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 → 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 (состояние до окна)
```