Przejdź do głównej zawartości

Automatycznie wyklucz cherry-pick, revert, rebase i squash ze statystyk

Przełącznik znajduje się w zakładce Konfiguracja panelu Zarządzanie Organizacją, w sekcji „Automatycznie wyklucz cherry-pick, revert, rebase i squash ze statystyk”.

Włączony przełącznik Wyłącz/Włącz sprawia, że commity rozpoznane jako cherry-pick, revert, rebase albo squash nie wliczają się do Kalorii i Linii ani do Retencji, żeby ta sama praca (przeniesiona z innej gałęzi, cofnięta poleceniem Gita albo ręcznie, odtworzona, połączona w jeden commit) nie liczyła się do statystyk więcej niż raz.

Przełącznik automatycznego wykluczania commitów cherry-pick, revert, rebase i squash w Konfiguracji organizacji

Reguły rozpoznawania​

Każdy commit dostaje jedną z pięciu klasyfikacji: zwykły, revert, cherry-pick, duplikat po rebase albo zawartość plików powtórzona z wcześniejszego commita. Rozpoznanie działa niezależnie od przełącznika, więc klasyfikacja jest zapisana zawsze; przełącznik decyduje tylko o tym, czy rozpoznany commit wypada ze statystyk.

KlasyfikacjaNa czym opiera się rozpoznanie
Revertlinia This reverts commit <identyfikator>, którą Git dopisuje do wiadomości przy git revert. Liczy się treść wiadomości, nie jej pierwszy wiersz.
Cherry-pickadnotacja cherry picked from commit <identyfikator>, którą Git dopisuje przy git cherry-pick -x.
Duplikat po rebasedwie reguły, sprawdzane w tej kolejności. Pierwsza porównuje treść zmiany: commit wprowadza tę samą zmianę co wcześniejszy commit tego repozytorium (zgodny odcisk zmiany z git patch-id), także przy innym autorze i innej dacie. Druga zestawia commit z commitami już policzonymi: to samo repozytorium, ten sam autor, ten sam znacznik czasu autorstwa i ten sam zestaw zmienionych plików. Ta druga reguła porównuje wyłącznie ścieżki plików, bez ich treści.
Zawartość plików powtórzona z wcześniejszego commitaporównanie zawartości plików: każdy plik zmieniony w commicie ma dokładnie taką zawartość, jaką miał po którymś z wcześniejszych commitów tego repozytorium. Pasują tu dwa przypadki. Commit połączony przez squash zawiera pliki w postaci, jaką miały już po commitach scalanej gałęzi; klasyfikację dostaje commit po squashu, a commity gałęzi liczą się jak dotąd. Ręczne cofnięcie zmian albo przywrócenie pliku do dawnej wersji odtwarza zawartość, którą plik miał przed cofanymi zmianami.

Revert i cherry-pick rozpoznawane są wyłącznie po wiadomości commita. Pozostałe trzy reguły porównują commit z wcześniejszymi commitami tego samego repozytorium i to one wychwytują commity bez żadnej adnotacji: przepisane identyfikatory po rebase albo force pushu, cherry-pick bez -x, squash i ręczne cofnięcie zmian. Q247 sprawdza reguły w kolejności tabeli i przypisuje klasyfikację pierwszej pasującej, więc commit z adnotacją git revert pozostaje revertem.

Commity sprzed aktualizacji i wersja wtyczki

Reguła porównująca treść zmiany i reguła porównująca zawartość plików działają tylko dla commitów pobranych po aktualizacji wtyczki.

Private Plugin musi być w wersji q247-enterprise-plugin-linux-v2.7.9 lub nowszej. Starsza wtyczka działa dalej, tylko pobrane przez nią commity nie dostają nowych oznaczeń. Cloud Plugin instaluje i utrzymuje Q247 (Dwa modele wdrożenia).

Granice tego mechanizmu​

Tłumaczą one wyniki, które wyglądają na błąd:

  • Ręczne cofnięcie zostaje rozpoznane tylko w całości. Cofnięcie zmian bez adnotacji Gita, na przykład przez git revert --no-commit i własną wiadomość, zostaje rozpoznane jako zawartość plików powtórzona z wcześniejszego commita, gdy każdy zmieniony plik wraca do zawartości, którą już kiedyś miał. Commit, który cofa zmiany tylko w części plików albo tylko część zmian w pliku, pozostaje zwykłym commitem.
  • Cherry-pick bez przełącznika -x nie zostawia adnotacji, a rebase może zmienić znacznik czasu autorstwa. Takie kopie rozpoznaje reguła porównująca treść zmiany, także gdy kopia ma innego autora albo inną datę niż oryginał.
  • Reguła porównująca treść zmiany obejmuje też trzy linie kontekstu wokół zmiany. Kopii, w której zmienił się ten kontekst albo nazwa pliku, ta reguła nie skojarzy z oryginałem. O rozpoznaniu decydują wtedy pozostałe reguły.
  • Zmiana nazwy pliku, skopiowanie pliku i pusty commit nie są rozpoznawane jako zawartość plików powtórzona z wcześniejszego commita.
  • Reguły porównujące commity działają w obrębie jednego repozytorium. Commita przeniesionego do forka albo do kopii lustrzanej repozytorium żadna z nich nie skojarzy z oryginałem.
  • Sam revert jest wykluczany, cofnięty commit zostaje. Praca, która została wycofana, liczy się więc raz, a nie zero razy.
  • Dwa różne commity tego samego autora, z tym samym znacznikiem czasu i tym samym zestawem plików, zostaną uznane za duplikat. Zdarza się to przy commitach generowanych skryptem albo masowym formatowaniu.
  • Ręczna decyzja ma pierwszeństwo. Commit włączony ręcznie do statystyk zostaje w nich niezależnie od klasyfikacji, co opisuje sekcja niżej.
Przełączenie przelicza dane stopniowo

Zmiana przełącznika nie przepisuje wszystkich commitów naraz. Q247 uzupełnia je partiami w tle, więc na dużej organizacji statystyki zmieniają się przez kilka kolejnych przebiegów, a nie od razu po zapisie. W tym samym rytmie zmienia się Retencja.

Ten przełącznik zapisuje się natychmiast

Nie ma tu przycisku zapisu ani pytania o potwierdzenie. Kliknięcie od razu zmienia sposób wyliczania statystyk dla całej organizacji.

Wykluczenie pojedynczego commita​

Poza automatyczną regułą można wykluczyć konkretny commit. Ta czynność odbywa się poza Konfiguracją: w oknie szczegółów commita, otwieranym z listy przyrostów na stronach Projekt, Zespół i Uczestnik. Służy do tego przycisk z ikoną oka przy commicie. Jego podpowiedź nazywa akcję: przy commicie liczonym do statystyk „Wyklucz ze statystyk”, przy wykluczonym „Uwzględnij w statystykach”, więc decyzję można w każdej chwili odwrócić.

W tym samym oknie commit rozpoznany przez którąkolwiek z reguł rozpoznawania, także revert, ma ikonę z podpowiedzią: „Ten commit wykazuje wysokie podobieństwo do innego commita i może być wynikiem operacji cherry-pick, squash, rebase lub revert.” Ikona pojawia się niezależnie od przełącznika w Konfiguracji, więc widać ją także przy commitach, które nadal liczą się do statystyk. Okno nie wskazuje commita oryginalnego.

Okno szczegółów commita z ikoną podobieństwa i jej podpowiedzią przy wierszu commita

Przy wykluczonym commicie podpowiedź przycisku ma drugą linię z powodem wykluczenia. Powód jest zawsze jeden, wybierany w tej kolejności: „Wykluczone ręcznie”, „Automatyczna klasyfikacja (cherry-pick/revert/rebase/squash)”, „Przekroczony limit kalorii”. Commit wykluczony ręcznie, który pasuje też do reguł rozpoznawania, pokazuje więc tylko „Wykluczone ręcznie”. Powód „Przekroczony limit kalorii” dotyczy commita, którego Kalorie przekraczają próg ustawienia „Ukryj przyrosty powyżej”, opisanego w Widoczności przyrostów.

Uprawnienia do tej akcji różnią się od uprawnień do pozostałych ustawień zakładki. Commit może wykluczyć ze statystyk i przywrócić:

  • menedżer zespołu, do którego należy autor commita, albo zespołu nadrzędnego w drzewie,
  • menedżer korzenia drzewa zespołów, przy każdym commicie w organizacji,
  • kierownik projektu, z którego pochodzi commit,
  • menedżer zespołu przypisanego do projektu,
  • menedżer zespołu, do którego należy kierownik projektu.

Menedżer zespołu autora commita i menedżer zespołu nadrzędnego mają tę akcję w każdym projekcie, również takim, do którego sami nie mają dostępu. Menedżer zespołu to rola zespołowa Manager, opisana w Uprawnieniach.

Role Viewer projektu, zwykłego uczestnika projektu i członka zespołu same w sobie tej akcji nie dają. Podobnie rola Admin, która nie otwiera dostępu do danych biznesowych: administrator bez jednej z ról z listy akcji nie zobaczy. Q247 sprawdza dostępność przy każdym commicie osobno: gdy okno pokazuje kilka commitów, przycisk z ikoną oka może się pojawić tylko przy części z nich. Pełny podział opisują Uprawnienia.

Wykluczenie działa na jednym commicie i obejmuje wszystkie metryki liczone z jego zawartości: Kalorie, Przyrosty i Linie oraz wszystko, co z nich powstaje.

Commit przywrócony akcją "Uwzględnij w statystykach" liczy się także w Retencji i we wskaźniku R30 w panelu Adopcji AI. Ręczna decyzja nie znosi natomiast wykluczenia wzorcami plików.

Kolumny Retencji i wskaźnik R30 w Adopcji AI pokazują zmianę po zamknięciu okna szczegółów commita, a pozostałe kolumny tabel, na przykład Kalorie, po kolejnym cyklicznym przeliczeniu danych w tle.

Zobacz też​