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

View File

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