Integracja z GitHub – zdarzenia repo i alerty CI/CD

GitHub to wiodąca na świecie platforma kontroli wersji i współpracy, z której korzystają miliony programistów. Ten przewodnik pokazuje, jak zintegrować webhooki GitHub z Echobell, aby otrzymywać natychmiastowe powiadomienia o zdarzeniach w repozytorium — od pull requestów i commitów po wydania i przebiegi workflow.

Wymagania wstępne

1. Konto Echobell z aktywnym kanałem
2. Uprawnienia administratora w repozytorium GitHub, które chcesz monitorować
3. Adres URL webhooka Echobell (znajdziesz go w widoku szczegółów kanału)

Konfiguracja webhooków GitHub

1. Utwórz kanał Echobell

1. Otwórz aplikację Echobell
2. Utwórz nowy kanał (np. „Powiadomienia GitHub”)
3. Skonfiguruj szablony powiadomień:

Szablon tytułu:

[{{repository.name}}] {{action}} by {{sender.login}}

Szablon treści:

🔔 Event: {{action}}
👤 Actor: {{sender.login}}
📦 Repository: {{repository.full_name}}

2. Pobierz adres URL webhooka

1. W ustawieniach kanału znajdź sekcję Wyzwalacze
2. Skopiuj podany adres URL webhooka
3. Zachowaj ten adres w bezpiecznym miejscu — użyjesz go w konfiguracji GitHub

3. Skonfiguruj webhook w GitHub

1. Przejdź do swojego repozytorium GitHub
2. Wybierz Settings → Webhooks
3. Kliknij Add webhook
4. Skonfiguruj webhook:
   • Payload URL: Twój adres URL webhooka Echobell
   • Content type: application/json
   • Secret: (opcjonalnie) dodaj tajny token dla dodatkowego bezpieczeństwa
   • Włącz weryfikację SSL
5. Wybierz zdarzenia, które mają wyzwalać webhook:
   • Zaznacz „Let me select individual events”
   • Najczęstsze wybory to:
     • Pull requests
     • Push events
     • Issues
     • Discussions
     • Releases
6. Kliknij Add webhook, aby zapisać

Testowanie integracji

1. Po skonfigurowaniu webhooka GitHub wyśle zdarzenie ping
2. Sprawdź powiadomienia w Echobell, aby potwierdzić odbiór
3. Utwórz testowe zgłoszenie lub pull request, aby zweryfikować integrację

Dobre praktyki

1. Bezpieczeństwo:
   • Zachowaj adres URL webhooka w tajemnicy
   • Używaj sekretu webhooka do weryfikacji żądań
   • Włącz weryfikację SSL
2. Wybór zdarzeń:
   • Subskrybuj tylko te zdarzenia, których naprawdę potrzebujesz
   • Przy wyborze zdarzeń weź pod uwagę rozmiar i aktywność repozytorium
3. Obsługa błędów:
   • Śledź status dostarczania webhooków w GitHub
   • Sprawdzaj historię powiadomień Echobell, aby potwierdzić dostarczenie

Rozwiązywanie problemów

Jeśli nie otrzymujesz powiadomień:

1. Sprawdź, czy adres URL webhooka jest poprawny
2. Przejrzyj historię dostarczania webhooków w GitHub pod kątem błędów
3. Upewnij się, że Twój kanał Echobell jest aktywny
4. Sprawdź, czy kanał ma aktywnych subskrybentów
5. Sprawdź, czy wybrane zdarzenia faktycznie występują

Prywatność i bezpieczeństwo

• Adresy URL webhooków należy traktować jak sekrety
• Wysyłaj tylko niezbędne dane zdarzeń
• Cała treść powiadomień jest przechowywana lokalnie na urządzeniach subskrybentów
• Nasze serwery jedynie przetwarzają żądanie webhooka i kierują powiadomienia

Potrzebujesz pomocy? Odwiedź nasze Centrum wsparcia lub napisz na echobell@weelone.com.