Use ubuntu-latest and build images without running Homegate
This commit is contained in:
25
REGISTRY.md
25
REGISTRY.md
@@ -16,16 +16,16 @@ Gitea здесь ещё не подключена, образ не опубли
|
||||
`.gitea/workflows/`. Включите **Enable Repository Actions** в настройках репозитория.
|
||||
В Gitea должен быть включён Package Registry.
|
||||
|
||||
Workflow использует выделенный **Linux runner** с меткой `homegate:host`:
|
||||
Оба job используют **Linux runner** с меткой `ubuntu-latest`. Среда job должна содержать:
|
||||
|
||||
- Python 3.11+ с `venv` и pip, Git, OpenSSH client, Bash, Node.js 20+;
|
||||
- Docker Engine, Buildx и Docker Compose **2.30.0+**;
|
||||
- права на использование Docker и установку QEMU/binfmt через `setup-qemu-action`;
|
||||
- доступ к Gitea/registry, GitHub для загрузки actions, Docker Hub и PyPI при сборке.
|
||||
|
||||
Метка в workflow — `runs-on: homegate`; если у вашего runner другое имя метки, замените
|
||||
его в обоих jobs. Для runner с контейнерными jobs нужна специально подготовленная среда,
|
||||
включающая эти инструменты и доступ к Docker daemon. Шаблон рассчитан на `homegate:host`.
|
||||
Метка в workflow — `runs-on: ubuntu-latest`; зарегистрируйте runner с этой меткой.
|
||||
Для runner с контейнерными jobs среда job должна включать перечисленные инструменты
|
||||
и доступ к Docker daemon.
|
||||
Используйте отдельную VM для сборок: job исполняет код репозитория и имеет доступ к Docker.
|
||||
Внешние PR запускайте только после проверки авторства и содержимого либо на изолированном
|
||||
одноразовом runner. Registry secrets используются только в job публикации Git-тега.
|
||||
@@ -75,18 +75,20 @@ Workflow `.gitea/workflows/release.yaml` выполняет:
|
||||
|
||||
1. На push в ветку, тег или PR — Python/HTTP-тесты, проверку JavaScript и shell,
|
||||
проверку обоих Compose-файлов.
|
||||
2. Сборку образа для архитектуры runner и пробный запуск изолированного стека без
|
||||
портов хоста и доступа к NPM/Pi-hole. Проверяются вход по паролю, сохранение
|
||||
настроек, права volumes, отсутствие чужих secrets в UI и сохранность CA после повторной инициализации.
|
||||
2. Сборку образа для архитектуры runner без запуска контейнеров Homegate.
|
||||
Локальный тег проверочного образа удаляется после сборки.
|
||||
3. Только для push тега `v*`, после успешных проверок — проверку `VERSION`, сборку
|
||||
`linux/amd64` + `linux/arm64` и публикацию в Gitea Container Registry.
|
||||
|
||||
Образ получает два тега: `0.4.0` и `sha-<полный SHA коммита>`. Тег `latest` не создаётся.
|
||||
`org.opencontainers.image.source` связывает метаданные образа с URL исходников.
|
||||
Права на просмотр/скачивание пакета проверьте в Gitea Packages отдельно от доступа к коду.
|
||||
Workflow не меняет видимость пакетов и не развёртывает Homegate на домашнем сервере.
|
||||
Workflow не запускает контейнеры Homegate и не развёртывает приложение.
|
||||
Собранный образ скачивается и запускается отдельно на production-сервере по инструкции ниже.
|
||||
Видимость пакетов workflow не меняет.
|
||||
|
||||
Для runtime-тестов локально, если Docker запущен:
|
||||
Необязательный runtime-тест можно запустить вручную локально, если Docker запущен.
|
||||
Gitea Actions этот скрипт не выполняет:
|
||||
|
||||
```sh
|
||||
docker build --build-arg VERSION="$(cat VERSION)" -t homegate:test .
|
||||
@@ -237,8 +239,9 @@ docker compose start homegate ui ssh-export
|
||||
Локально проходят 55 тестов, включая первый запуск, сохранение пользовательских изменений
|
||||
и CA, отказ от повреждённого конфига и проверку адреса/версии публикуемого образа.
|
||||
Оба Compose-файла проверяются установленным Docker Compose. Синтаксис shell, JavaScript
|
||||
и YAML workflow проверен. Docker daemon при подготовке выключен, поэтому сборка образа,
|
||||
контейнерный smoke-test и исполнение самого workflow должны впервые пройти на вашем runner.
|
||||
и YAML workflow проверен. Docker daemon при подготовке выключен, поэтому сборка образа
|
||||
и исполнение самого workflow локально не проверены. Контейнерный smoke-test остаётся
|
||||
ручной проверкой и исключён из Gitea Actions.
|
||||
|
||||
Официальные контракты: [Gitea Container Registry](https://docs.gitea.com/usage/packages/container/),
|
||||
[Gitea Actions](https://docs.gitea.com/usage/actions/quickstart/),
|
||||
|
||||
Reference in New Issue
Block a user