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