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

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