Use ubuntu-latest and build images without running Homegate
This commit is contained in:
@@ -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"
|
||||||
|
|||||||
25
REGISTRY.md
25
REGISTRY.md
@@ -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/),
|
||||||
|
|||||||
Reference in New Issue
Block a user