go-agent-development

Przewodnik do tworzenia agentów budowania w Go dla platformy DevOps. Obejmuje projektowanie architektury agenta, mechanizm pulsu, wykonywanie zadań, raportowanie logów, procesy aktualizacji i interakcję z modułem Dispatch. Zawiera przykłady kodu, strukturę projektu i konwencje nazewnictwa. Użyj tego gdy rozwijasz agenta budowania, implementujesz logikę wykonywania zadań, obsługujesz komunikację agenta lub pracujesz z Go w kontekście systemów CI/CD.

1. Upewnij się, że masz zainstalowany Go w wersji 1.19 lub nowszej — jest to wymóg minimalny dla tego przewodnika. 2. Zapoznaj się ze strukturą projektu: główny katalog src/agent/ zawiera agent główny (agent/), wersję lekką (agent-slim/) i biblioteki wspólne (common/). Kluczowe pakiety to api/ dla wywołań API, config/ dla zarządzania konfiguracją, job/ dla logiki wykonywania zadań i util/ dla funkcji pomocniczych. 3. Przejrzyj konwencje nazewnictwa: pakiety używają małych liter bez podkreśleń, struktury danych PascalCase, stałe w camelCase. Zastosuj te reguły w swoim kodzie. 4. Implementuj startup agenta, korzystając z dostarczonego wzorca: zbuduj URL do punktu końcowego API, utwórz strukturę ThirdPartyAgentStartInfo z danymi hosta (nazwa, IP, system operacyjny, wersja), wyślij żądanie POST z nagłówkami autoryzacji. 5. Obsługuj logowanie za pomocą pakietu logs z metodami Debug, Info, Error i WithError — raportuj zdarzenia cyklu życia agenta i wykonywania zadań. 6. Gdy potrzebujesz logiki dotyczącej planowania lub modułu Dispatch, odwołaj się do powiązanych umiejętności dispatch-module-architecture i agent-module-architecture dla kontekstu architektonicznego.