[ready-to-test] connectivity_tester: Actions → admin registry → deploy #74

Open
opened 2026-09-21 08:10:47 +02:00 by hermes · 0 comments
Contributor

Цель

Имплементировать и закрепить типовой pipeline для stack-ов, где Brencher только оркестрирует deployment:

Brencher обнаруживает новый HEAD
→ dispatch Gitea Actions в admin/<repo>
→ Actions собирает и push-ит image в admin Container Registry
→ единый ActionsTrigger запускает workflow и ждёт его завершения
→ docker login существующими credentials Brencher
→ docker stack deploy
→ health-check

На рабочем примере connectivity_tester production flow подтверждён: image публикуется и тянется из gitea.rudolf.keenetic.link/admin/connectivity_tester, актуальный task стал healthy.

Объём реализации

  • объединить ActionsTrigger и ожидание завершения workflow в один шаг;
  • перед запуском искать Actions run для того же commit: при running ждать его завершения, при success переиспользовать опубликованный image/result, при failure или отсутствии run запускать новый;
  • передавать registry owner/repository без shell-default синтаксиса, который Brencher не умеет подставлять;
  • использовать существующий credential mechanism Brencher для registry login, без создания новых credentials;
  • выполнять docker stack deploy после завершения Actions workflow;
  • добавить проверку image namespace и health/deployment result;
  • сохранить совместимость с fork-ветками и admin/<repo>.

Acceptance criteria

  • workflow запускается из admin/<repo> и публикует image в admin/<repo> registry;
  • Brencher не выполняет build/push самостоятельно;
  • перед docker stack deploy выполняется registry login существующими Brencher credentials;
  • для одного commit не запускаются параллельные Actions run: существующий running run дожидается завершения, успешный run переиспользуется, а новый запускается только после failure, cancelled или при отсутствии run;
  • после завершения Actions workflow production task переходит в 1/1 running и healthy;
  • ошибки Actions, login и deploy видны раздельно в pipeline logs;
  • нет references на неправильный namespace hermes/<image> или registry path без owner.

Оценка

1 час.

Референсы

Related sessions:

  • 20260920_111823_6bcff0f8 — production validation, admin registry image and healthy task
  • 20260917_183305_87fd7041 — Brencher Actions/registry/pull/deploy implementation
  • 20260915_043346_fc86985c — initial workflow architecture and PR #65
  • 20260912_185217_7334e713 — initial connectivity stack diagnostics

Credentials, tokens and secret values are intentionally not included.

Additional notes

  • Webhooks: Gitea → Brencher → Hermes.
  • Allow Hermes write access to the UI for approved PRs.
## Цель Имплементировать и закрепить типовой pipeline для stack-ов, где Brencher только оркестрирует deployment: ```text Brencher обнаруживает новый HEAD → dispatch Gitea Actions в admin/<repo> → Actions собирает и push-ит image в admin Container Registry → единый ActionsTrigger запускает workflow и ждёт его завершения → docker login существующими credentials Brencher → docker stack deploy → health-check ``` На рабочем примере `connectivity_tester` production flow подтверждён: image публикуется и тянется из `gitea.rudolf.keenetic.link/admin/connectivity_tester`, актуальный task стал `healthy`. ## Объём реализации - объединить ActionsTrigger и ожидание завершения workflow в один шаг; - перед запуском искать Actions run для того же commit: при `running` ждать его завершения, при `success` переиспользовать опубликованный image/result, при `failure` или отсутствии run запускать новый; - передавать registry owner/repository без shell-default синтаксиса, который Brencher не умеет подставлять; - использовать существующий credential mechanism Brencher для registry login, без создания новых credentials; - выполнять `docker stack deploy` после завершения Actions workflow; - добавить проверку image namespace и health/deployment result; - сохранить совместимость с fork-ветками и `admin/<repo>`. ## Acceptance criteria - workflow запускается из `admin/<repo>` и публикует image в `admin/<repo>` registry; - Brencher не выполняет build/push самостоятельно; - перед `docker stack deploy` выполняется registry login существующими Brencher credentials; - для одного commit не запускаются параллельные Actions run: существующий `running` run дожидается завершения, успешный run переиспользуется, а новый запускается только после `failure`, `cancelled` или при отсутствии run; - после завершения Actions workflow production task переходит в `1/1 running` и `healthy`; - ошибки Actions, login и deploy видны раздельно в pipeline logs; - нет references на неправильный namespace `hermes/<image>` или registry path без owner. ## Оценка **1 час.** ## Референсы - Resolving PR: [admin/brencher#65](https://gitea.rudolf.keenetic.link/admin/brencher/pulls/65) - Related workflow/config PR: [admin/ansible#42](https://gitea.rudolf.keenetic.link/admin/ansible/pulls/42) - Existing auto-deploy orchestration issue: [admin/brencher#24](https://gitea.rudolf.keenetic.link/admin/brencher/issues/24) - Related credentials investigation: [admin/brencher#73](https://gitea.rudolf.keenetic.link/admin/brencher/issues/73) Related sessions: - `20260920_111823_6bcff0f8` — production validation, admin registry image and healthy task - `20260917_183305_87fd7041` — Brencher Actions/registry/pull/deploy implementation - `20260915_043346_fc86985c` — initial workflow architecture and PR #65 - `20260912_185217_7334e713` — initial connectivity stack diagnostics Credentials, tokens and secret values are intentionally not included. ## Additional notes - Webhooks: Gitea → Brencher → Hermes. - Allow Hermes write access to the UI for approved PRs.
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: admin/brencher#74