Files
buryan-infra/ops/audit/GITEA-COMPOSE-MIGRATION.md

6.4 KiB
Raw Permalink Blame History

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. Что сделано

  1. Плагин compose установлен во все 26 контейнеров.
  2. Составлен compose-файл по текущей конфигурации: порты 222→22 и 3000→3000, том /opt/gitea:/data, все переменные окружения, политика перезапуска.
  3. Секрет OAuth2 вынесен в отдельный файл /opt/gitea/.env с правами 600. В compose-файле — ссылка на переменную. Поэтому compose-файл хранится в репозитории, а секрет — нет.
  4. Снят снимок контейнера, старый контейнер переименован и сохранён.
  5. Контейнер пересоздан через compose из свежего образа.
  6. Проверено, что сервис работает.

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 при ошибке сервера, пройденная проверка здоровья при старом образе, запись «ГОТОВО» в журнале при отсутствии обновления. Во всех трёх случаях система сообщала об успехе, ничего не сделав.

Теперь у каждого обновления есть проверка применения: сравнивается образ работающего контейнера с тем, что скачан.