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