Add first-run web setup and Compose without environment or secrets
All checks were successful
Test and publish Homegate / checks (push) Successful in 29s
Test and publish Homegate / publish (push) Successful in 12m46s

This commit is contained in:
2026-10-14 03:26:50 +03:00
parent 6844ccf0b9
commit a83d897b70
20 changed files with 689 additions and 53 deletions

View File

@@ -1,5 +1,8 @@
# Один Compose-файл и Gitea Container Registry
Для запуска без environment, secrets и пароля панели используйте [compose.simple.yaml](SIMPLE.md):
все адреса и подключения задаются в UI. Ниже описан расширенный вариант с отдельными контейнерами.
Homegate 0.4 поддерживает два способа установки:
| Файл | Назначение |
@@ -72,7 +75,7 @@ Homegate 0.4 поддерживает два способа установки:
По умолчанию registry берётся из адреса Gitea, image — из `owner/repository` в нижнем регистре:
```text
git.example.home/your-user/homegate:0.4.0
git.example.home/your-user/homegate:0.4.1
```
Если registry доступен по другому имени/порту, задайте Actions **variable** `REGISTRY`,
@@ -86,11 +89,11 @@ git.example.home/your-user/homegate:0.4.0
## 2. Выпустите образ
Файл `VERSION` сейчас содержит `0.4.0`. После загрузки проверенного кода в Gitea:
Файл `VERSION` сейчас содержит `0.4.1`. После загрузки проверенного кода в Gitea:
```sh
git tag v0.4.0
git push origin v0.4.0
git tag v0.4.1
git push origin v0.4.1
```
При следующем выпуске измените `VERSION`, закоммитьте его вместе с изменениями и создайте
@@ -107,7 +110,7 @@ Workflow `.gitea/workflows/release.yaml` выполняет:
3. Только для push тега `v*`, после успешных проверок — проверку `VERSION`, сборку
`linux/amd64` + `linux/arm64` и публикацию в Gitea Container Registry.
Образ получает два тега: `0.4.0` и `sha-<полный SHA коммита>`. Тег `latest` не создаётся.
Образ получает два тега: `0.4.1` и `sha-<полный SHA коммита>`. Тег `latest` не создаётся.
`org.opencontainers.image.source` связывает метаданные образа с URL исходников.
Права на просмотр/скачивание пакета проверьте в Gitea Packages отдельно от доступа к коду.
Workflow не запускает контейнеры Homegate и не развёртывает приложение.
@@ -133,7 +136,7 @@ sh ci/smoke_image.sh homegate:test
В Bash укажите свои адреса. Здесь `.10`, `.11` и `.2` — примеры:
```bash
export HOMEGATE_IMAGE=git.example.home/your-user/homegate:0.4.0
export HOMEGATE_IMAGE=git.example.home/your-user/homegate:0.4.1
export HOMEGATE_LAN_IP=192.168.0.10
export HOMEGATE_PROXY_IP=192.168.0.11
export HOMEGATE_ALLOWED_NETWORKS='[192.168.0.0/24]'
@@ -263,7 +266,7 @@ docker compose start homegate ui ssh-export
## Что проверено
Локально проходят 55 тестов, включая первый запуск, сохранение пользовательских изменений
Локально проходят 63 теста, включая первый запуск, сохранение пользовательских изменений
и CA, отказ от повреждённого конфига и проверку адреса/версии публикуемого образа.
Оба Compose-файла проверяются установленным Docker Compose, включая совместимость
`read_only` с источниками configs/secrets. Синтаксис shell, JavaScript и YAML workflow проверен.