Entegrasyonlar
SetGet, ekibinizin halihazırda güvendiği araçlarla entegre olur. Herkesi tek bir uygulamaya zorlamak yerine SetGet, kod depolarıyla, iletişim platformlarıyla, hata takipçileriyle ve diyagram araçlarıyla senkronize olurken proje yönetiminin merkezi merkezi olarak işlev görür. Bu sayfa, mevcut her entegrasyona genel bir bakış ve iş akışınız için doğru olanları seçme konusunda rehberlik sunar.
Neden entegrasyon?
Entegrasyonlar üç yaygın sorunu çözer:
- Bağlam geçişi -- geliştiriciler, tasarımcılar ve yöneticiler günde onlarca kez araçlar arasında geçiş yapar. Entegrasyonlar, sistemler arasında bilgi kopyalama-yapıştırma ihtiyacını azaltır.
- Veri siloları -- iş öğesi durumu bir araçta, kod değişiklikleri başka bir araçta yaşadığında kimsenin tam resmi olmaz. Araçlar arasında durum senkronizasyonu herkese tek bir gerçek kaynağı sağlar.
- Manuel kayıt tutma -- bir çekme isteği her birleştirildiğinde veya üretimde bir hata bildirildiğinde iş öğesini güncellemek sıkıcı ve hataya açıktır. Entegrasyonlar bu güncellemeleri otomatikleştirir.
Mevcut entegrasyonlar
| Entegrasyon | Kategori | Temel yetenekler | Kurulum karmaşıklığı |
|---|---|---|---|
| GitHub | Kaynak kontrolü | Sorun senkronizasyonu, PR bağlantısı, yorum senkronizasyonu, etiket eşlemesi | Orta |
| GitLab | Kaynak kontrolü | Sorun senkronizasyonu, MR bağlantısı, etiket senkronizasyonu, durum eşlemesi | Orta |
| Slack | İletişim | Eğik çizgi komutları, mesaj kısayolları, iş parçacığı senkronizasyonu | Düşük |
| Sentry | Hata takibi | Sentry sorunlarını iş öğelerine bağlama, çift yönlü durum senkronizasyonu | Düşük |
| Draw.io | Diyagram | Sayfalara diyagram gömme, satır içi düzenleme, akış şemaları, mimari diyagramlar | Düşük |
| Webhooks | Özel | SetGet'te olaylar gerçekleştiğinde herhangi bir URL'ye gerçek zamanlı JSON yük gönderme | Düşük |
Entegrasyon kategorileri
Kaynak kontrol
GitHub ve GitLab entegrasyonları kod depolarınızı SetGet projelerine bağlar. Bağlandıktan sonra şunları yapabilirsiniz:
- Depoda açılan sorunlardan otomatik olarak iş öğeleri oluşturmak.
- Çekme isteklerini ve birleştirme isteklerini mevcut iş öğelerine bağlamak.
- Konuşmaların tek bir yerde kalması için yorumları çift yönlü senkronize etmek.
- Depo etiketlerini SetGet etiketleriyle eşleştirmek.
- GitHub'da bir sorunu kapatmanın ilgili SetGet iş öğesini "Tamamlandı" konumuna taşıması için durum eşlemeleri tanımlamak.
Depolarınızın bulunduğu yere göre GitHub veya GitLab'ı seçin. Her iki entegrasyon da eşdeğer işlevsellik sunar.
İletişim
Slack entegrasyonu SetGet'i ekibinizin halihazırda iletişim kurduğu yere taşır. Ekip üyeleri eğik çizgi komutuyla iş öğeleri oluşturabilir, @mention ile SetGet AI asistanına sorular sorabilir ve iş öğesi durumu veya atanan değiştiğinde otomatik güncellemeler alabilir. Slack iş parçacıkları, belirli iş öğelerine bağlı hafif konuşma geçmişlerine dönüşür.
Hata takibi
Sentry entegrasyonu, üretim hataları ile proje çalışması arasındaki uçurumu kapatır. Sentry yeni bir sorun tespit ettiğinde, bunu mevcut bir SetGet iş öğesiyle ilişkilendirebilir veya doğrudan yeni bir tane oluşturabilirsiniz. SetGet'te iş öğesini çözmek, Sentry sorununu çözülmüş olarak işaretler ve tam tersi de geçerlidir.
Diyagram
Draw.io entegrasyonu, SetGet sayfalarına tam özellikli bir diyagram düzenleyicisi gömer. Uygulamadan çıkmadan akış şemaları, sistem mimarisi diyagramları, tel kafes modelleri, ER diyagramları ve daha fazlasını oluşturun. Diyagramlar sayfa içeriğiyle birlikte depolanır; bu sayede sürümlü ve erişilebilir kalır.
Webhook'lar aracılığıyla özel entegrasyonlar
Ekibinizin kullandığı bir araç için yerleşik entegrasyon bulunmadığında webhook'lar bu boşluğu doldurur. Bir webhook URL'si yapılandırın, önem verdiğiniz olayları seçin ve SetGet bu olay her gerçekleştiğinde uç noktanıza bir JSON yükü gönderir. SetGet'i CI/CD hatlarıyla, özel panolarla, dahili araçlarla veya HTTP geri aramalarını kabul eden herhangi bir hizmetle bağlamak için webhook'ları kullanın.
Entegrasyonlara erişim
- Çalışma alanınızı açın.
- Kenar çubuğundaki Ayarlar'a gidin.
- Ayarlar menüsünden Entegrasyonlar'ı seçin.
- Her entegrasyonun Bağlan düğmesi ve yapılandırma paneli olan kendi kartı vardır.
Çalışma alanı yöneticileri entegrasyonları yükleyebilir ve yapılandırabilir. Üyeler, halihazırda bağlı olan entegrasyonları kullanabilir ancak yapılandırmalarını değiştiremez.
Entegrasyon izinleri
| Rol | Yükleyebilir | Yapılandırabilir | Kullanabilir |
|---|---|---|---|
| Sahip | Evet | Evet | Evet |
| Yönetici | Evet | Evet | Evet |
| Üye | Hayır | Hayır | Evet |
| Misafir | Hayır | Hayır | Sınırlı |
İPUCU
Bir entegrasyonla başlayın ve ek olanları etkinleştirmeden önce senkronizasyon davranışını doğrulayın. Bu, bir şey beklendiği gibi çalışmadığında sorun gidermeyi kolaylaştırır.
Veri akışı ve gizlilik
- Tüm entegrasyon verileri SetGet arka ucundan geçer. Hiçbir üçüncü taraf hizmet doğrudan ön uçla iletişim kurmaz.
- OAuth belirteçleri ve API anahtarları bekleme modunda şifrelenir ve tarayıcıya hiçbir zaman açık edilmez.
- Webhook sırları sunucu tarafında depolanır ve HMAC imza doğrulaması için kullanılır.
- Bir entegrasyonun bağlantısını istediğiniz zaman kesebilirsiniz. Bağlantının kesilmesi OAuth bağlantısını kaldırır ancak önceden senkronize edilen iş öğelerini veya yorumları silmez.
UYARI
Bir entegrasyonun bağlantısını kesmek gelecekteki senkronizasyonu durdurur ancak iş öğelerinize zaten uygulanan değişiklikleri geri almaz. Bağlantıyı kesmeden önce senkronize edilmiş verileri gözden geçirin.
Yaygın kullanım senaryoları
| Senaryo | Önerilen entegrasyon |
|---|---|
| İş öğelerine karşı PR'ları takip etme | GitHub veya GitLab |
| Slack konuşmalarından iş öğeleri oluşturma | Slack |
| Üretim hatalarını iş öğelerine bağlama | Sentry |
| Proje belgelerine mimari diyagramlar ekleme | Draw.io |
| İş öğesi olaylarını CI/CD hattına gönderme | Webhooks |
| Özel analitik panosuna olaylar gönderme | Webhooks |
| Bir döngü tamamlandığında harici aracı bilgilendirme | Webhooks |
Entegrasyon yaşam döngüsü
Her entegrasyon aynı yaşam döngüsünden geçer:
1. Bağlantı
SetGet'in harici hizmetle iletişim kurmasına izin verin. Çoğu entegrasyon OAuth kullanır; bu nedenle izin vermek için harici hizmete yönlendirilirsiniz. Yetkilendirildikten sonra SetGet belirteci güvenli bir şekilde depolar.
2. Yapılandırma
İstediğiniz belirli davranışları ayarlayın: hangi depoları bağlayacağınızı, hangi olaylara abone olacağınızı, durumların sistemler arasında nasıl eşleşeceğini ve hangi bildirimlerin etkinleştirileceğini.
3. İşletim
Entegrasyon otomatik olarak çalışır. SetGet'teki olaylar giden senkronizasyonu tetikler, harici hizmetteki olaylar ise gelen senkronizasyonu tetikler. Entegrasyon ayarları panelinde etkinliği izleyin.
4. Bakım
Entegrasyon sağlığını periyodik olarak gözden geçirin. OAuth belirteçleri süresi dolabilir ve yenilenmesi gerekebilir. İş akışınız değiştiğinde alan eşlemeleri güncellenmeye ihtiyaç duyabilir. Hatalar için entegrasyon durum sayfasını kontrol edin.
5. Bağlantı kesme (isteğe bağlı)
Bir entegrasyon artık gerekmiyorsa bağlantısını temiz bir şekilde kesin. Bu, OAuth belirtecini iptal eder ve zaten senkronize edilmiş verileri korurken tüm senkronizasyonu durdurur.
Birden fazla entegrasyon
Birden fazla entegrasyonu aynı anda bağlayabilirsiniz. Örneğin:
- Kaynak kontrol senkronizasyonu için GitHub
- Ekip iletişimi için Slack
- Hata takibi için Sentry
- CI/CD hattına olay göndermek için Webhook'lar
Her entegrasyon bağımsız olarak çalışır. Birbirlerini etkilemezler.
Limitler
| Konu | Limit |
|---|---|
| Çalışma alanı başına entegrasyon | Sınırsız |
| Çalışma alanı başına webhook | 25 |
| Saniye başına webhook olayı | 50 (ani), 10 (sürekli) |
| Proje başına bağlı depo | 10 |
| Proje başına bağlı Slack kanalı | 10 |
Sık sorulan sorular
Aynı GitHub kuruluşunu birden fazla çalışma alanına bağlayabilir miyim?
Evet. Her çalışma alanı kendi OAuth bağlantısını korur. Aynı GitHub kuruluşu birden fazla SetGet çalışma alanına bağımsız olarak bağlanabilir.
Entegrasyonlar kendi barındırılan örneklerle çalışır mı?
GitHub Cloud, GitLab Cloud ve Sentry Cloud tam olarak desteklenmektedir. Kendi yönetilen GitLab örnekleri, kurulum sırasında örnek URL'si yapılandırılarak desteklenir. Kendi barındırılan GitHub Enterprise ek yapılandırma gerektirir.
Bir entegrasyonun bağlantısını kesersem senkronize verilere ne olur?
Senkronize edilen iş öğeleri, yorumlar ve etiketler SetGet'te kalır. Artık senkronize edilmeyen normal SetGet verilerine dönüşürler. Bağlantı kestiğinizde hiçbir veri silinmez.
Hangi üyelerin bir entegrasyonu kullanabileceğini sınırlayabilir miyim?
Entegrasyonlar, bağlandıktan sonra çalışma alanı genelinde geçerlidir. Tüm üyeler bir entegrasyonun sağladığı özellikleri kullanabilir. Yalnızca yöneticiler ve sahipler entegrasyonları yükleyebilir, yapılandırabilir veya bağlantısını kesebilir.
Sorun giderme
Bir entegrasyon beklendiği gibi çalışmıyorsa:
- Bağlantı durumunu kontrol edin -- Ayarlar > Entegrasyonlar'a gidin ve entegrasyonun yeşil "Bağlandı" rozeti gösterdiğini doğrulayın.
- Yeniden yetkilendirin -- OAuth belirteçleri süresi dolabilir. Belirteci yenilemek için Yeniden bağlan'a tıklayın.
- Webhook günlüklerini kontrol edin -- webhook entegrasyonları için HTTP hata kodları açısından teslimat günlüğünü inceleyin.
- İzinleri doğrulayın -- bağlı hesabın harici hizmette yeterli izinlere sahip olduğundan emin olun (ör. GitHub için depo yazma erişimi).
- Alan eşlemelerini gözden geçirin -- yanlış durum veya etiket eşlemeleri beklenmedik davranışlara neden olabilir.
- Hız limitlerini kontrol edin -- aynı anda çok fazla olay gerçekleşirse, hız sınırlama nedeniyle bazıları gecikebilir.
- Etkinlik günlüğünü inceleyin -- entegrasyon etkinlik günlüğü, son senkronizasyon olaylarını ve karşılaşılan hataları gösterir.