dispatch-module-architecture

Dispatch 构建调度模块架构指南，涵盖构建机调度策略、资源分配、队列管理、Docker/K8s 调度、Agent 选择。当用户开发调度功能、配置调度策略、处理资源分配或实现新调度类型时使用。

1. Zapoznaj się ze strukturą modułu Dispatch w katalogu src/backend/ci/core/dispatch/ — zawiera on sześć głównych komponentów: warstwy API (api-dispatch, api-dispatch-docker, api-dispatch-kubernetes), warstwę logiki biznesowej (biz-dispatch, biz-dispatch-docker, biz-dispatch-kubernetes), komponenty wspólne Kubernetesa oraz moduł startowy Spring Boot. 2. Zidentyfikuj typ dyspozycji, który chcesz wdrożyć lub zmodyfikować — maszyny budujące trzecich stron (obsługiwane przez biz-dispatch), kontenery Docker (przez biz-dispatch-docker) lub pody Kubernetes (przez biz-dispatch-kubernetes). 3. Przejrzyj strukturę wybranego modułu biznesowego: warstwa kontrolerów implementuje interfejsy REST API, warstwa usług zawiera logikę harmonogramowania i zarządzania kolejkami (zwłaszcza jobquota i tpaqueue), warstwa dostępu do danych (dao) komunikuje się z bazą danych. 4. Dla nowych typów dyspozycji lub strategii harmonogramowania rozszerz odpowiedni moduł biznesowy — dodaj nowe serwisy w katalogu service, zdefiniuj wyjątki w exception, a interfejsy API w module api-dispatch. 5. Skonfiguruj zadania cykliczne w katalogu cron jeśli potrzebujesz okresowego monitorowania lub czyszczenia kolejek. 6. Przetestuj przepływ poprzez API — zadania powinny przechodzić przez stany (QUEUE → RUNNING → DONE) i być kierowane do prawidłowych zasobów na podstawie skonfigurowanych strategii dyspozycji.