worker-module-architecture

Worker 构建执行器模块架构指南，涵盖插件执行引擎、任务分发、日志上报、制品上传、Worker 生命周期。当用户开发 Worker 功能、实现插件执行、处理任务分发或优化执行器性能时使用。

1. Zapoznaj się ze strukturą modułu Worker w katalogu src/backend/ci/core/worker/, gdzie znajdują się komponenty worker-agent (punkt wejścia), worker-common (biblioteka wspólna) i worker-api-sdk (implementacja SDK).

2. Wybierz tryb budowania odpowiedni dla Twojego przypadku użycia: DOCKER dla publicznych pul zasobów budowania, AGENT dla własnych maszyn budowania lub WORKER dla lekkich zadań bez środowiska kompilacji.

3. Zaimplementuj logikę wykonywania zadań, korzystając z klasy Runner (dla Docker/Agent) lub WorkRunner (dla maszyn trzecich stron) z pakietu worker-common, która stanowi rdzeń frameworku wykonawczego.

4. Skonfiguruj zarządzanie zmiennymi środowiskowymi i kontekstem budowania za pomocą modułu env/ oraz zaimplementuj obsługę logów poprzez logger/, który zbiera i raportuje logi do serwisu Log.

5. Dodaj obsługę artefaktów budowania, wykorzystując moduł archive/ do przesyłania produktów budowania do biblioteki artefaktów oraz moduł atom/ do pobierania i wykonywania wtyczek ze sklepu deweloperskiego.

6. Wdrażaj usługę heartbeat/ do regularnego wysyłania sygnałów życia do serwera, aby utrzymać stan budowania i zapewnić niezawodną komunikację między agentem a serwerem CI.