Integracja · W cenie
Integracja GitHub: pull requesty przy zadaniach
Numer zadania w nazwie gałęzi albo w tytule pull requesta wystarczy. Zadanie pokazuje stan przeglądu i testów, a po scaleniu może zamknąć się samo.
Programiści nie klikają niczego w assign2me. Kod zostaje na GitHubie — zapisujemy tylko nazwy, numery, tytuły i stany.
Konfiguracja krok po kroku
Trzy kroki, dwie osoby
- Administrator łączy GitHub. W „Integracjach” instaluje aplikację assign2me na koncie albo w organizacji GitHub i wybiera wszystkie repozytoria lub tylko wybrane. Zmiany listy na GitHubie widać w assign2me w ciągu minuty.
- Właściciel projektu przypina repozytoria. Wybiera repozytoria dla swojego projektu i decyduje o automatyzacjach. Jedno repozytorium można przypiąć do kilku projektów.
- Zespół używa numeru zadania. W nazwie gałęzi, tytule lub opisie pull requesta albo w wiadomości commita. Powiązanie pojawia się w zadaniu w ciągu 60 sekund.
Konwencja nazw
Gałąź z numerem zadania, gotowa do skopiowania
Każde zadanie ma klucz z prefiksu projektu i numeru, np. A2M-142. Przycisk „Kopiuj nazwę gałęzi” w zadaniu daje gotową nazwę, a drugi — całe polecenie git checkout.
Gałąź
Zadanie pokazuje „w toku: gałąź a2m-142-…” i wpis w historii. Sekcja i osoba się nie zmieniają.
Pull request
W zadaniu widać autora, stan przeglądu, recenzentów i wynik testów.
Commit
Wielkość liter nie ma znaczenia. Jeden PR może wskazywać kilka zadań.
Słowa zamykające
Który link zamknie zadanie, a który tylko informuje
Zadanie zamyka się dopiero po scaleniu ostatniego otwartego pull requesta z linkiem zamykającym, i tylko po scaleniu do domyślnej gałęzi (albo gałęzi dodanych przez właściciela, np. release/*). Zadanie otwarte ponownie ręcznie nie zamknie się drugi raz od tego samego scalenia.
- A2M-142
Link zamykający: po scaleniu zadanie może się zamknąć, jeśli właściciel projektu włączył tę automatyzację.
- refs A2M-142
Tylko informacja. Tak samo „ref” i „related to”. Scalenie nie zamknie zadania.
Automatyzacje projektu
Domyślnie wyłączone, każda osobno
- Gdy pull request się otwiera — przenieś zadanie do wybranej sekcji, np. „Do przeglądu”.
- Gdy zostaje scalony — ukończ zadanie albo przenieś je do wybranej sekcji.
- Każda zmiana z automatyzacji trafia do historii ze źródłem „GitHub”, repozytorium i numerem PR, i wysyła te same powiadomienia co zmiana ręczna.
- Filtr „Kod” na liście i tablicy: czeka na przegląd, zmiany wymagane, testy nie przeszły, scalone przy otwartym zadaniu.
Uprawnienia aplikacji GitHub
Tylko do odczytu
- Metadane: odczyt
- Zawartość repozytorium: odczyt — gałęzie i commity; kodu nie zapisujemy
- Pull requesty: odczyt
- Checks i statusy commitów: odczyt
assign2me przechowuje nazwy gałęzi, numery, tytuły i stany pull requestów. Nigdy kodu, zmian ani komentarzy z przeglądu. Dostęp ograniczysz albo odbierzesz w ustawieniach GitHuba.
Praca z klientem
Klient widzi zadanie, nie repozytorium.
Gość nie widzi sekcji „Kod” w zadaniu, a stan kodu nigdy nie trafia na kanał Slacka. Informacje z GitHuba widzi tylko zespół z dostępem do zadania.
Pytania o integrację z GitHubem
Pełna instrukcja w dokumentacji →Mamy monorepo z kilkoma projektami. Czy to działa?
Tak. Jedno repozytorium przypinasz do kilku projektów, a zadania rozpoznaje prefiks klucza (np. A2M-, WEB-). Automatyzacje zmieniają tylko zadania projektu, do którego repozytorium jest przypięte.
Projekt korzysta z wielu repozytoriów.
Przypnij je wszystkie do projektu. Jedno zadanie może mieć kilka gałęzi i pull requestów z różnych repozytoriów.
Mamy kilka organizacji na GitHubie.
Organizacja w assign2me może mieć kilka instalacji aplikacji, np. po jednej na każdą organizację GitHub. Jedna instalacja należy do jednej organizacji assign2me.
Co się stanie po odłączeniu?
Dane dostępowe są usuwane, a nowe zdarzenia odrzucane w ciągu 60 sekund. Istniejące powiązania zostają w zadaniach z ostatnim znanym stanem, oznaczone jako nieaktualne.
Czy prywatne zadania też się zamykają?
Nie. Automatyzacje nie dotyczą zadań prywatnych.
Wszystko w jednej cenie
30 dni za darmo. Potem 79 zł netto miesięcznie za zespół do 5 osób, każda kolejna osoba +15 zł. Goście-klienci bez limitu i bez opłat.