6.4 KiB
Gitea: перевод на управление через compose
Дата: 2026-10-14 Причина: контейнер Gitea невозможно было обновить штатным путём Результат: ✅ Gitea 1.25.4 → 28.1.0, данные целы, обновление теперь работает
1. С чего началось
При проверке вопроса «а обновление точно произошло?» выяснилось, что Gitea не обновлялась никогда с момента установки:
образ контейнера: sha256:4c697a48… (контейнер создан 29 июля)
образ в хранилище: sha256:0338a633… (скачан 6 октября)
Запись в журнале от 09.10.2026:
[16:05:26] Начинаем обновление сервиса: gitea (CT 140, type: docker)
[16:05:29] Обновляем образ: gitea/gitea:latest
[16:05:54] 🎉 ГОТОВО! Сервис gitea обновлён и зафиксирован.
Образа обновили, а контейнер не пересоздали. «ГОТОВО» было ложным.
2. Три причины, а не одна
2.1 Контейнер создан вручную
У Gitea нет файла compose и нет меток проекта — он поднят командой
docker run. Поэтому ветка обновления через compose его не находила, а запасная
ветка умела только скачать образ.
2.2 Плагина compose в контейнере не было вовсе
$ docker compose version
docker: unknown command: docker compose
Ни docker compose (плагин v2), ни docker-compose (v1). То есть путь
обновления через compose не мог сработать в принципе, даже при наличии файла.
Это оказалось общей проблемой: из 26 контейнеров плагин отсутствовал в 12:
116 117 118 119 120 121 122 125 127 134 139 140
То есть исправление обновления работало бы меньше чем в половине парка. Плагин установлен во все 26.
2.3 Новый контейнер не запускался из-за AppArmor
AppArmor enabled on system but the docker-default profile could not be loaded:
apparmor_parser: Unable to load a profile while confined?
Проверка показала: работающий контейнер Gitea запущен с apparmor=unconfined,
а новый получает профиль docker-default и падает при старте. Причина —
CT 140 привилегированный, и внутри него загрузка профилей запрещена.
Решение: строка security_opt: apparmor:unconfined в compose-файле. Это не
ослабление защиты — контейнер и так работал в этом режиме. Проверено пробой:
обычный запуск падает, с этой строкой проходит.
3. Что сделано
- Плагин compose установлен во все 26 контейнеров.
- Составлен compose-файл по текущей конфигурации: порты
222→22и3000→3000, том/opt/gitea:/data, все переменные окружения, политика перезапуска. - Секрет OAuth2 вынесен в отдельный файл
/opt/gitea/.envс правами 600. В compose-файле — ссылка на переменную. Поэтому compose-файл хранится в репозитории, а секрет — нет. - Снят снимок контейнера, старый контейнер переименован и сохранён.
- Контейнер пересоздан через compose из свежего образа.
- Проверено, что сервис работает.
4. Проверка
| Что | Результат |
|---|---|
| Версия до / после | 1.25.4 → 28.1.0 |
| Образ контейнера = скачанный | да |
| Репозитории | 5, все на месте |
| Пользователи | 3 |
| Обновление схемы базы | миграции 350–357, ошибок нет |
| Страница входа | 200 |
| Порты 3000 и 222 | слушают |
| Секрет OAuth2 | подставлен из .env, длина 164 |
| Штатное обновление после переноса | проходит, снимок удаляется |
Список репозиториев после переноса: root/buryan-hub, root/buryan-infra,
agent-qwen/buryan-infra, infrastructure/docs, root/runbooks.
5. Что осталось прибрать
- Контейнер
gitea-old-20261014-163407— оставлен на сутки для отката. Удалить:pct exec 140 -- docker rm gitea-old-20261014-163407 - Снимок
pre-compose-20261014-163407— оставлен до подтверждения. Удалить:pct delsnapshot 140 pre-compose-20261014-163407
Оба занимают место в пуле, поэтому убрать их нужно, а не «когда-нибудь».
6. Замечание на будущее
Проверка должна смотреть на результат, а не на факт выполнения команды.
Три раза за день одна и та же ошибка принимала разные формы: успешный код
возврата curl при ошибке сервера, пройденная проверка здоровья при старом
образе, запись «ГОТОВО» в журнале при отсутствии обновления. Во всех трёх
случаях система сообщала об успехе, ничего не сделав.
Теперь у каждого обновления есть проверка применения: сравнивается образ работающего контейнера с тем, что скачан.