Fix inline configs and secrets in registry Compose deployment
All checks were successful
Test and publish Homegate / checks (push) Successful in 28s
Test and publish Homegate / publish (push) Has been skipped

This commit is contained in:
2026-10-14 02:54:23 +03:00
parent dd0f4ff8a8
commit 6844ccf0b9
3 changed files with 51 additions and 9 deletions

View File

@@ -7,8 +7,21 @@ Homegate 0.4 поддерживает два способа установки:
| `compose.registry.yaml` | Готовый образ из Gitea; именованные volumes, автоматическая первичная настройка |
| `compose.yaml` | Прежний запуск из исходников с `build`, `setup.sh` и каталогами на хосте |
Gitea здесь ещё не подключена, образ не опубликован. Workflow готов к запуску в вашем
репозитории. Имена `git.example.home` и `your-user` ниже — примеры.
Для установки дождитесь успешной публикации образа в Gitea Actions.
Имена `git.example.home` и `your-user` ниже — примеры.
В варианте с одним файлом Compose записывает `configs.content` и `secrets.environment`
в файловую систему контейнера до его запуска. Поэтому у `initialize`, `homegate` и `ui`
задано `read_only: false`; у `ssh-export` остаётся `read_only: true`. Иначе создание
контейнера завершается ошибкой `cannot create config/secret ... in read-only service`.
Это ограничение проверяется в `ci/check_compose.py` без запуска контейнеров.
Ограничения UID, capabilities и `no-new-privileges` сохраняются. В варианте установки
из исходников configs/secrets берутся из файлов на хосте и не требуют этого исключения.
Если скачали ранний `compose.registry.yaml` для `0.4.0`, добавьте `read_only: false`
в каждый из сервисов `initialize`, `homegate`, `ui` после `<<: *runtime`, затем выполните
`docker compose up -d`. Исправление совместимо с образом `0.4.0`; новый образ не нужен.
Сохраняйте прежнее имя Compose-проекта и volumes с настройками и CA.
## 1. Настройте репозиторий и runner один раз
@@ -252,12 +265,16 @@ docker compose start homegate ui ssh-export
Локально проходят 55 тестов, включая первый запуск, сохранение пользовательских изменений
и CA, отказ от повреждённого конфига и проверку адреса/версии публикуемого образа.
Оба Compose-файла проверяются установленным Docker Compose. Синтаксис shell, JavaScript
и YAML workflow проверен. Docker daemon при подготовке выключен, поэтому сборка образа
и исполнение самого workflow локально не проверены. Контейнерный smoke-test остаётся
ручной проверкой и исключён из Gitea Actions.
Оба Compose-файла проверяются установленным Docker Compose, включая совместимость
`read_only` с источниками configs/secrets. Синтаксис shell, JavaScript и YAML workflow проверен.
После исправления `read_only` локально проверены сборка образа для ARM64 и контейнерный
smoke-test на Docker Compose 5.3.1: инициализация volumes, вход в панель, изоляция secrets,
SSH-export и сохранение настроек/CA при повторной инициализации. Проверка использует
временные volumes без портов хоста и без доступа к NPM/Pi-hole; их реальные API этим тестом
не проверяются. Контейнерный smoke-test остаётся ручной проверкой и исключён из Gitea Actions.
Официальные контракты: [Gitea Container Registry](https://docs.gitea.com/usage/packages/container/),
[Gitea Actions](https://docs.gitea.com/usage/actions/quickstart/),
[Compose secrets из environment](https://docs.docker.com/reference/compose-file/secrets/),
[Compose configs с content](https://docs.docker.com/reference/compose-file/configs/).
[Compose configs с content](https://docs.docker.com/reference/compose-file/configs/),
[ограничение read_only в реализации Compose](https://github.com/docker/compose/blob/v2.40.0/pkg/compose/secrets.go).

View File

@@ -7,6 +7,21 @@ import yaml
import homegate as h
def check_read_only_resources(model):
# compose config accepts this combination, but container creation rejects it.
for name, service in model['services'].items():
if not service.get('read_only'):
continue
for kind in ('configs', 'secrets'):
for resource in service.get(kind, []):
source = resource['source']
definition = model[kind][source]
assert 'file' in definition, (
f'{name}: read_only requires a file source for {kind}.{source}; '
'Compose cannot inject content/environment into a read-only container'
)
def main():
env = dict(os.environ, HOMEGATE_IMAGE='registry.example/homegate/homegate:0.4.0',
HOMEGATE_LAN_IP='192.168.0.10', HOMEGATE_PROXY_IP='192.168.0.10',
@@ -18,6 +33,7 @@ def main():
model = json.loads(subprocess.check_output(
['docker', 'compose', '--env-file', os.devnull, '-f', 'compose.registry.yaml',
'config', '--format', 'json'], env=env))
check_read_only_resources(model)
assert set(model['services']) == {'initialize', 'homegate', 'ssh-export', 'ui'}
for name, service in model['services'].items():
assert 'build' not in service, name
@@ -31,6 +47,7 @@ def main():
assert model['services']['initialize']['network_mode'] == 'none'
assert not model['services']['initialize'].get('secrets')
assert not model['services']['ssh-export'].get('secrets')
assert model['services']['ssh-export']['read_only']
assert [v['source'] for v in model['services']['ui']['secrets']] == ['ui_password']
for name in ('ui', 'ssh-export'):
assert all(v['target'] != '/data' for v in model['services'][name]['volumes'])
@@ -38,8 +55,10 @@ def main():
assert all('environment' in s and 'file' not in s for s in model['secrets'].values())
seed = h.validate_config(yaml.safe_load(model['configs']['initial-config']['content']))
assert seed['services'] == [] and seed['ssh_hosts'] == []
subprocess.run(['docker', 'compose', '--env-file', '.env.example', '-f', 'compose.yaml',
'config', '--quiet'], check=True, env=env)
source_model = json.loads(subprocess.check_output(
['docker', 'compose', '--env-file', '.env.example', '-f', 'compose.yaml',
'config', '--format', 'json'], env=env))
check_read_only_resources(source_model)
# The one-file deployment cannot accidentally fall back to all host interfaces.
del env['HOMEGATE_LAN_IP']
missing = subprocess.run(['docker', 'compose', '--env-file', os.devnull,

View File

@@ -31,6 +31,8 @@ x-environment: &environment
services:
initialize:
<<: *runtime
# Compose copies configs.content into the container before starting it.
read_only: false
entrypoint: [python, /app/bootstrap.py]
command: []
user: "0:0"
@@ -52,6 +54,8 @@ services:
homegate:
<<: *runtime
# Compose requires a writable root filesystem for secrets.environment.
read_only: false
depends_on:
initialize:
condition: service_completed_successfully
@@ -98,6 +102,8 @@ services:
ui:
<<: *runtime
# Compose requires a writable root filesystem for secrets.environment.
read_only: false
entrypoint: [python, /app/homegate_ui.py]
command: []
depends_on: