Use ubuntu-latest and build images without running Homegate
All checks were successful
Test and publish Homegate / checks (push) Successful in 26s
Test and publish Homegate / publish (push) Successful in 12m46s

This commit is contained in:
2026-10-14 01:47:30 +03:00
parent 357daa8915
commit 3d329cc637
2 changed files with 21 additions and 19 deletions

View File

@@ -5,13 +5,13 @@ name: Test and publish Homegate
tags: ['v*']
pull_request:
# Use a dedicated Linux runner labelled homegate:host; see REGISTRY.md.
# Use a Linux runner labelled ubuntu-latest; see REGISTRY.md.
permissions:
contents: read
jobs:
checks:
runs-on: homegate
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: https://github.com/actions/checkout@v4
@@ -38,15 +38,14 @@ jobs:
env:
PYTHONPATH: .
run: '"$TEST_PYTHON" ci/check_compose.py'
- name: Build and smoke-test runtime image
- name: Build image
env:
CI_REVISION: ${{ gitea.sha }}
run: |
set -eu
test_image="homegate-ci:$CI_REVISION-$$"
trap 'docker image rm "$test_image" >/dev/null 2>&1 || true' EXIT
docker build --build-arg VERSION="$(cat VERSION)" --tag "$test_image" .
sh ci/smoke_image.sh "$test_image"
build_image="homegate-ci:$CI_REVISION-$$"
trap 'docker image rm "$build_image" >/dev/null 2>&1 || true' EXIT
docker build --build-arg VERSION="$(cat VERSION)" --tag "$build_image" .
- name: Clean Python environment
if: always()
shell: bash
@@ -56,7 +55,7 @@ jobs:
publish:
needs: checks
if: gitea.event_name == 'push' && startsWith(gitea.ref, 'refs/tags/v')
runs-on: homegate
runs-on: ubuntu-latest
env:
DOCKER_BUILD_SUMMARY: "false"
DOCKER_BUILD_RECORD_UPLOAD: "false"

View File

@@ -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/),