GitHub Entegrasyonu - Depo Olayları ve CI/CD Uyarıları

GitHub, milyonlarca geliştiricinin kullandığı, sürüm kontrolü ve iş birliği alanındaki dünyanın önde gelen platformudur. Bu kılavuz, pull request ve commit'lerden sürümlere ve iş akışı çalıştırmalarına kadar depo olayları için anında bildirim almak üzere GitHub webhook'larını Echobell ile nasıl entegre edeceğinizi gösterir.

Ön Koşullar

1. Etkin bir kanalı olan bir Echobell hesabı
2. İzlemek istediğiniz GitHub deposunda yönetici erişimi
3. Echobell webhook URL'niz (kanalınızın ayrıntılar görünümünde bulunur)

GitHub Webhook'larını Kurma

1. Bir Echobell Kanalı Oluşturun

1. Echobell uygulamasını açın
2. Yeni bir kanal oluşturun (örneğin "GitHub Bildirimleri")
3. Bildirim şablonlarını yapılandırın:

Başlık Şablonu:

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

Gövde Şablonu:

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

2. Webhook URL'nizi Alın

1. Kanal ayarlarınızda Tetikleyiciler bölümünü bulun
2. Sunulan webhook URL'sini kopyalayın
3. GitHub yapılandırmasında kullanılacağı için bu URL'yi güvende tutun

3. GitHub Webhook'unu Yapılandırın

1. GitHub deponuza gidin
2. Settings → Webhooks yolunu izleyin
3. Add webhook'a tıklayın
4. Webhook'u yapılandırın:
   • Payload URL: Echobell webhook URL'niz
   • Content type: application/json
   • Secret: (İsteğe bağlı) Ek güvenlik için bir gizli token ekleyin
   • SSL doğrulamasını etkinleştirin
5. Webhook'u tetikleyecek olayları seçin:
   • "Let me select individual events" seçeneğini işaretleyin
   • Yaygın tercihler şunlardır:
     • Pull request'ler
     • Push olayları
     • Issue'lar
     • Discussion'lar
     • Release'ler
6. Kaydetmek için Add webhook'a tıklayın

Entegrasyonunuzu Test Etme

1. Webhook'u kurduktan sonra GitHub bir ping olayı gönderir
2. Ulaştığını doğrulamak için Echobell bildirimlerinizi kontrol edin
3. Entegrasyonu doğrulamak için bir test issue'su veya pull request oluşturun

En İyi Uygulamalar

1. Güvenlik:
   • Webhook URL'nizi gizli tutun
   • Doğrulanmış istekler için bir webhook secret'ı kullanın
   • SSL doğrulamasını etkinleştirin
2. Olay Seçimi:
   • Yalnızca ihtiyacınız olan olaylara abone olun
   • Olayları seçerken deponun boyutunu ve etkinliğini göz önünde bulundurun
3. Hata Yönetimi:
   • GitHub'da webhook teslim durumunu izleyin
   • Başarılı teslimat için Echobell'in bildirim geçmişini kontrol edin

Sorun Giderme

Bildirim almıyorsanız:

1. Webhook URL'sinin doğru olduğunu doğrulayın
2. GitHub'ın webhook teslim geçmişinde hata olup olmadığına bakın
3. Echobell kanalınızın etkin olduğundan emin olun
4. Kanalınızda etkin aboneler olduğunu doğrulayın
5. Seçtiğiniz olayların gerçekten tetiklenip tetiklenmediğini kontrol edin

Gizlilik ve Güvenlik

• Webhook URL'leri gizli bilgi gibi ele alınmalıdır
• Yalnızca gerekli olay verilerini gönderin
• Tüm bildirim içeriği abonelerin cihazlarında yerel olarak saklanır
• Sunucularımız yalnızca webhook isteğini işler ve bildirimleri yönlendirir

Yardıma mı ihtiyacınız var? Destek Merkezimizi ziyaret edin veya echobell@weelone.com adresinden bize ulaşın.