Доведено до последней версии: 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.
71 lines
3.1 KiB
Markdown
71 lines
3.1 KiB
Markdown
# 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
|
||
```
|