Przejdź do głównej zawartości

Enterprise Plugin

Enterprise Plugin to komponent serwerowy Q247, który analizuje dane o pracy zespołu i wylicza z nich metryki. Obsługuje wszystkie integracje dostarczające dane: repozytoria kodu, systemy ticketowe, dokumentację i telemetrię narzędzi AI. Konfiguruje się go z panelu Zarządzanie Organizacją, ale instalacja i wymagania systemowe dotyczą tego komponentu, nie samego interfejsu.

Treść analizowanych danych nie opuszcza infrastruktury, w której działa wtyczka. Repozytoria są klonowane lokalnie, a do Q247 trafia wynik analizy. Pełny podział opisuje Bezpieczeństwo Enterprise Plugin.

Zakres analizy​

Repozytoria kodu​

Repozytoria kodu są podstawowym źródłem danych. Wtyczka pobiera z repozytorium historię commitów oraz pull requesty i merge requesty, i z nich wylicza Kalorie, Przyrosty i Linie.

Sześć systemów łączy się przez API, a każdy z nich ma własny typ konektora: GitLab (od wersji 14), GitHub (w tym GitHub Enterprise), Azure DevOps, Bitbucket (Cloud oraz Data Center i Server), Gitea i Gerrit.

Siódmy typ, Generic GIT, obejmuje dowolne repozytorium zgodne z Git, dodawane ręcznie przez adres URL. Wymaga poprawnie skonstruowanego adresu, wraz z danymi logowania, jeśli repozytorium tego wymaga. Dostęp sieciowy do takiego repozytorium musi być publiczny albo otwarty dla adresu IP, z którego działa dane wdrożenie wtyczki.

Pola formularzy i uprawnienia tokenów dla każdego typu opisują Konektory.

Tickety i dokumentacja​

Jira i Confluence działają w wariancie chmurowym i Data Center. Wtyczka odbiera z nich zdarzenia webhookami, więc dane pojawiają się bez czekania na cykl skanowania. Z Jiry przetwarzane są tickety, komentarze i zmiany pól, a przy włączonej integracji z Tempo także worklogi.

Telemetria narzędzi AI​

Wtyczka zbiera dane o użyciu narzędzi AI i przekazuje je do Q247 w postaci zagregowanej. Ma wbudowany kolektor OpenTelemetry, więc organizacja nie musi utrzymywać własnej platformy monitoringu; alternatywnie wtyczka pobiera te dane z Dynatrace. Konfigurację opisują Logi narzędzi AI.

Tryby analizy repozytoriów​

  • Analiza całej historii repozytorium, od pierwszego commita.
  • Analiza wskazanego zakresu dat, gdy pełna historia nie jest potrzebna.
  • Skanowanie przyrostowe w interwale godzinowym albo dziennym, ustawianym na źródle. Każdy przebieg cofa się o dwa tygodnie od ostatniego skanu, żeby złapać commity dostarczone z opóźnieniem.

Kolejność czynności od instalacji do pierwszych danych na dashboardzie opisuje Uruchomienie analizy kodu.

Wymagania systemowe​

  • Red Hat Enterprise Linux 9 lub nowszy, Oracle Linux 9 lub nowszy, CentOS Stream 9 albo Ubuntu 20 lub nowszy.
  • Zainstalowany klient Git.
  • 50 GB wolnego miejsca na dysku (więcej przy równoległym skanowaniu wielu dużych repozytoriów).
  • 16 GB RAM.
  • 4 rdzenie @ 2,5 GHz.

Dwa modele wdrożenia​

Wtyczka może działać w chmurze Q247 (Cloud Plugin) albo w infrastrukturze Klienta (Private Plugin). Funkcjonalnie nie ma między nimi różnicy, zmienia się tylko to, gdzie działa proces i kto go utrzymuje.

Cloud PluginPrivate Plugin
Gdzie działainfrastruktura Q247serwer Klienta
Kto instaluje i utrzymujeQ247Klient
Co trzeba otworzyć w siecidostęp z adresu Q247 do API systemu SCMruch wychodzący z serwera Klienta
Kiedy wybraćdomyślnie, gdy nie ma przeciwwskazańgdy kod nie może opuścić sieci Klienta

Pełną procedurę obu wariantów, wraz z tym, co przygotować w środowisku, opisuje Instalacja.

Zakres tej części dokumentacji​

Instalacja prowadzi przez wybór modelu wdrożenia, utworzenie wdrożenia w panelu, pobranie plików i uruchomienie procesu, plus listę rzeczy do przygotowania po stronie infrastruktury Klienta.

Zobacz też​