Integracje / Jenkins

Komunikacja, projekty i biuro

Integracja AI: Jenkins

Podłączamy REST API Jenkinsa i pobieramy logi buildów, wyniki testów z testReport oraz listę commitów z changeSet. Asystent tłumaczy nieudany build na zrozumiały komunikat dla managera i wskazuje niestabilne testy z historii ostatnich kilkudziesięciu uruchomień.

Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

Narzędzie „Buildy i testy z Jenkinsa” w portalu redAi, ekran z danymi z programu Jenkins
Narzędzie „Buildy i testy z Jenkinsa” w Waszym portalu. Dane przykładowe.

W skrócie

Jak asystent AI łączy się z systemem Jenkins?

Łączymy się z Jenkinsem przez REST API, bez wtyczek i bez zmian w istniejących pipeline'ach. Dane buildu pobieramy spod adresu /job/{nazwa}/{numer}/api/json, log konsoli z /consoleText, wyniki testów z /testReport/api/json, etapy Blue Ocean z osobnego endpointu.

Na start potrzebujemy
Konto serwisowe w Jenkinsie z uprawnieniem Read i wygenerowany token API.
Czego asystent nie robi
Nie uruchamia buildów ani nie zmienia konfiguracji Jenkinsa, pipeline'ów ani harmonogramów.
Gdzie są dane
Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.

Dane z Jenkins w czacie i we własnym module

Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Buildy i testy z Jenkinsa. Moduł Buildy z Jenkinsa zbiera historię wszystkich pipeline'ów z REST API i wyświetla wyniki buildów, testów JUnit i listę commitów w jednej tabeli. Programiści i managerowie widzą od razu, który build się wysypał i dlaczego, bez logowania do Jenkinsa. Po kliknięciu rekordu asystent AI tłumaczy błąd na zrozumiały komunikat i wskazuje niestabilne testy z historii.

  • Pobiera logi consoleText i tłumaczy błąd kompilacji na zrozumiały komunikat
  • Wyświetla wyniki testów JUnit z podziałem na passed, failed i skipped
  • Pokazuje listę commitów z changeSet, które wywołały każdy build
  • Wykrywa niestabilne testy (flaky) z historii ostatnich kilkudziesięciu uruchomień
  • Monitoruje czas trwania buildów i oznacza te przekraczające próg pipeline'u
Rozmowa z asystentem AI w portalu redAi o danych z programu Jenkins: Niestabilne testy (flaky) z ostatnich 40 buildów

Pytanie w czacie

Zamiast ręcznego przeglądania setek logów, asystent w kilka sekund wskazuje, które testy można bezpiecznie pominąć przy decyzji o release. Wyniki możecie od razu wyeksportować do arkusza dla QA.

Które testy w Jenkinsie padają losowo, bez żadnych zmian w kodzie? Za tydzień mamy release i chcę wiedzieć, co można bezpiecznie zignorować w raportach.
Karta panel-klienta #89 w narzędziu Buildy i testy z Jenkinsa w portalu redAi

Karta w narzędziu

Karta jednego buildu zbiera log, wyniki testów i listę commitów, a asystent od razu wskazuje prawdopodobną przyczynę błędu bez ręcznego przekopywania logów. Przekładacie to od razu na zadanie dla zespołu.

Jeden ekran zastępuje klikanie po Jenkinsie: wszystkie pipeline'y, wyniki testów i lista commitów w tabeli, którą możecie filtrować i pobrać. Asystent od razu sygnalizuje, co się wysypało i czy to blokuje release.

Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.

Co podłączamy

Zaczynamy od odczytu danych. Zapis i akcje w systemie Jenkins włączamy dopiero wtedy, gdy sami tego chcecie.

Logi konsoli (consoleText)

CzytamyPełny tekst wyjścia konsoli po każdym buildzie, od pobrania zależności po ostatni błąd kompilacji.

AsystentWyciąga kilkanaście linii istotnych dla awarii i zamienia techniczny stack trace na zdanie po polsku zrozumiałe dla osoby spoza zespołu IT.

Wyniki testów (testReport)

CzytamyPola failCount, passCount, skipCount oraz treść błędu każdego przypadku testowego JUnit lub TestNG.

AsystentOcenia, które nieprzechodzące testy dotyczą funkcji krytycznych, i odróżnia błąd w kodzie od problemu z infrastrukturą testową.

Lista commitów (changeSet)

CzytamyCommity połączone z danym buildem: autor, wiadomość, zmienione pliki, identyfikator w repozytorium.

AsystentZamienia techniczne opisy commitów na notatkę wydania po polsku z sekcjami: co nowego, co poprawiono, co usunięto.

Historia buildów

CzytamyPola result (SUCCESS, FAILURE, UNSTABLE, ABORTED), duration i timestamp z kilkudziesięciu ostatnich uruchomień.

AsystentRozróżnia awarię kompilacji od niestabilnych testów i ocenia trend: czy buildy są coraz częściej niestabilne na danym środowisku.

Etapy pipeline Blue Ocean

CzytamyStatus i log każdego etapu zdefiniowanego w Jenkinsfile: build, test, deploy-staging, deploy-production i inne.

AsystentWskazuje, na którym etapie pipeline stanął, i ocenia, czy problem leży w kodzie, testach, czy wdrożeniu na konkretne środowisko.

Etapy wdrożenia

CzytamyNazwa jobu wdrożeniowego (deploy-staging, deploy-uat, deploy-production), log etapu, czas uruchomienia i wynik.

AsystentPodaje, która wersja aplikacji jest na którym środowisku i kiedy trafiła na produkcję, bez ręcznego szukania w historii Jenkinsa.

Wzorzec wyników testów

CzytamyHistoria wyników poszczególnych przypadków testowych z kilkudziesięciu kolejnych buildów przy tej samej wersji kodu.

AsystentWykrywa testy z nieregularnymi wynikami i zestawia listę z liczbą niestabilnych uruchomień w ostatnich 30 dniach oraz ostatnią datą awarii.

O co pytają w praktyce

Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.

  • „Czemu wczorajszy build się wysypał i czy to blokuje release w piątek?”
  • „Które testy padają losowo bez zmian w kodzie w ostatnim miesiącu?”
  • „Co weszło do ostatniego wdrożenia na produkcję, napisz to dla klienta?”
  • „Kiedy ostatnio build skończył się sukcesem i jak długo trwał?”

Co się zmienia

Manager dostaje po każdym buildzie krótki komunikat po polsku z przyczyną awarii i oceną ryzyka dla biznesu, bez czekania na raport z działu IT.

Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.

O programie

Jenkins to serwer do automatyzacji kompilacji, testowania i wdrażania aplikacji. Korzystają z niego firmy, które rozwijają własne oprogramowanie lub zamawiają jego budowę u zewnętrznego partnera. Każde uruchomienie pipeline'u tworzy obiekt buildu z wynikiem, czasem trwania, datą startu, pełnym logiem konsoli i listą commitów z repozytorium kodu.

Na co dzień deweloperzy uruchamiają buildy z terminala lub przeglądarki, przeglądają wyniki testów JUnit i TestNG, sprawdzają status etapów pipeline'u przez interfejs Blue Ocean. Dane buildów trzymane są na serwerze Jenkinsa z konfigurowalnymi regułami retencji, które określają, jak daleko wstecz sięga historia i które pliki wynikowe są zachowywane.

Gdzie to działa najlepiej

Menedżer produktu

Build kończy się błędem. Menedżer dostawał dotąd emaila od działu IT z jednym zdaniem: 'build failed, investigating'. Nie wiedział, czy zaplanowany release jest zagrożony ani czy błąd dotyczy klientów sklepu, czy tylko modułu raportów.

Z asystentem: Asystent wysyła komunikat po polsku dwie minuty po zakończeniu buildu: wskazuje moduł z błędem, podaje poprzedni udany build z datą i ocenia, czy sklep działa normalnie. Bez telefonu do działu IT.

Kierownik techniczny

Kilka testów od tygodni raz przechodzi, raz pada bez żadnej zmiany w kodzie. Nikt nie ma czasu przeglądać historii buildów ręcznie, więc problem zostaje nierozwiązany, a deweloperzy tracą czas na diagnozowanie tych samych przypadków.

Z asystentem: Asystent dostarcza co tydzień listę testów z wzorcem nieregularnych wyników: liczba niestabilnych uruchomień w ostatnich 30 dniach, ostatnia awaria i moduł. Kierownik wie, gdzie skierować uwagę zespołu.

Kierownik projektu

Po każdym wdrożeniu na produkcję ktoś musi opisać klientowi, co się zmieniło w nowej wersji. Commity w changeSet to techniczne skróty po angielsku, nieczytelne dla handlowca, a deweloperzy nie mają czasu pisać opisu po każdym deploymencie.

Z asystentem: Asystent zamienia listę commitów na dokument po polsku z sekcjami: co nowego, co poprawiono, co usunięto. Trafia do kierownika zaraz po deploymencie, bez czekania na opis od dewelopera.

Jak się łączymy

Łączymy się z Jenkinsem przez REST API, bez wtyczek i bez zmian w istniejących pipeline'ach. Dane buildu pobieramy spod adresu /job/{nazwa}/{numer}/api/json, log konsoli z /consoleText, wyniki testów z /testReport/api/json, etapy Blue Ocean z osobnego endpointu. Skrypt działa w trybie tylko odczytu i nie modyfikuje żadnej konfiguracji Jenkinsa.

Połączenie wymaga konta serwisowego z tokenem API generowanym w ustawieniach użytkownika (User > Configure > Add new Token). Serwer Jenkinsa nie musi być publicznie dostępny, wystarczy połączenie z sieci firmowej lub VPN. Portal z plikami, bazami i historią rozmów stoi na serwerze klienta. Do modelu AI trafia polecenie i wybrane fragmenty danych, bez trenowania cudzych modeli na danych klienta.

Czego potrzebujemy od Was

  • Konto serwisowe w Jenkinsie z uprawnieniem Read i wygenerowany token API.
  • Dostęp sieciowy do serwera Jenkinsa z sieci firmowej lub przez VPN.
  • Jenkins z aktywnym REST API (dostępne natywnie, bez dodatkowych wtyczek).
  • Osoba po stronie firmy do weryfikacji pierwszego połączenia i wyboru jobów.
  • Informacja o ustawieniach retencji: jakie buildy są dostępne i jak daleko wstecz.

Czego asystent nie robi

  • Nie uruchamia buildów ani nie zmienia konfiguracji Jenkinsa, pipeline'ów ani harmonogramów.
  • Nie pobiera binarnych plików artefaktów (JAR, ZIP), tylko metadane i logi dostępne przez API.
  • Nie widzi buildów usuniętych przez politykę retencji Discard Old Builds w Jenkinsie.
  • Wskazuje problem i ocenia ryzyko, nie podejmuje decyzji o naprawie ani revertowaniu wdrożenia.

Częste pytania

Czy raport dostajemy po każdym buildzie z osobna, czy może być zbiorczy raz dziennie?

Oba tryby są możliwe. Webhook w Jenkinsie (Post-build Actions) wywołuje asystenta zaraz po zakończeniu buildu, więc komunikat przychodzi w kilka minut. Raport zbiorczy robi skrypt uruchamiany o ustalonej godzinie, niezależnie od harmonogramu buildów. Wybór ustalamy przy konfiguracji.

Mamy kilkadziesiąt jobów w Jenkinsie. Wszystkie będą analizowane?

Zakres ustawiamy razem przed uruchomieniem: wybieracie, które joby trafiają do asystenta. Typowo zaczynamy od pipeline'ów produkcyjnych i jednego środowiska testowego. Pozostałe joby w Jenkinsie działają bez zmian, asystent ich nie obserwuje i nie pobiera ich danych.

Logi naszych buildów mogą zawierać tokeny i zmienne środowiskowe. Co z tym?

Przed uruchomieniem integracji ustalamy, które fragmenty logów trafiają do analizy. Skrypt może pobierać tylko linie po słowie ERROR albo kilkadziesiąt linii przed końcem buildu zamiast całego wyjścia konsoli. Do modelu AI trafia polecenie i przycięty fragment, bez trenowania cudzych modeli na tych danych.

Czy integracja obsługuje multibranch pipeline'y i buildy feature branchy?

Tak. Jenkins zwraca w danych buildu informację o branchu, więc skrypt może filtrować: szczegółowy raport dla main i gałęzi release/*, a dla feature branchy tylko alerty o awarii lub zbiorcze podsumowanie raz dziennie. Zakres filtrowania ustalamy przy konfiguracji.

Pełny opis integracji w bazie wiedzy →

Jak zaczynamy

  1. Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
  2. Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
  3. Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Wybierzcie termin → Wolicie napisać?
Wolicie napisać

Pokażemy to na Waszych danych z Jenkins

Jedno zdanie wystarczy: czego szukacie w Jenkins albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.

Inne programy: komunikacja, projekty i biuro

Loom Figma Teamwork ClickUp

Wszystkie programy: komunikacja, projekty i biuro →

Jenkins jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.