GitHub Issues bağlantısı kurma: adım adım kılavuz
Başarısız olan her test için bir GitHub kaydı açar, test tekrar başarısız olduğunda kayda yorum ekler ve test sorunsuz geçtiğinde kaydı kapatır. GitHub dosya yüklemelerini kabul etmediğinden, kayda ekran görüntüsü eklemek yerine kanıt klasörünün adı yazılır. Bu kılavuz, sıfırdan başlayarak doğrulanmış bir bağlantı kurmanıza yardımcı olur ve karşılaşabileceğiniz hataları nedenleri ve çözümleriyle birlikte listeler.
Son güncelleme:
Kimlik bilgilerinizi gizli tutun. Bir sohbete asla belirteç, anahtar, parola veya webhook URL'si yapıştırmayın. Bunları yalnızca Studio → Ayarlar → Entegrasyonlar bölümüne girin; burada çalışma alanınızın .env dosyasına kaydedilir ve nokta olarak gösterilir. Aynı kural yapay zekâ asistanı için de geçerlidir: bu kılavuzda size yol gösterebilir, ancak belirtecinize asla ihtiyaç duymaz.
Gereksinimler
- Depoda kayıt açabilen bir GitHub hesabı (katkıda bulunan veya depo sahibi).
- Issues özelliği açık olan bir depo (deponun Ayarlar → Özellikler → Issues bölümü).
- Bu depoda Issues → Okuma ve yazma iznine sahip, ayrıntılı izinli bir kişisel erişim belirteci veya repo kapsamına sahip klasik bir belirteç.
Kimlik bilgilerini alın
- https://github.com/settings/personal-access-tokens/new adresini açın (ayrıntılı izinli bir belirteç için).
- Bir ad verin, son kullanma tarihini belirleyin ve Depo erişimi altında Yalnızca seçili depolar seçeneğini seçin, ardından kayıtların açılacağı depoyu seçin.
- İzinler → Depo izinleri altında Issues iznini Okuma ve yazma olarak ayarlayın. Başka bir izin gerekmez.
- Belirteci oluşturun ve hemen kopyalayın. GitHub bunu yalnızca bir kez gösterir. Studio dışında hiçbir yere yapıştırmayın (sonraki adım).
Studio'da bağlantıyı kurun
- Studio'da Ayarlar → Entegrasyonlar → GitHub Issues bağlantısı kur bölümünü açın.
- İstendiğinde belirteci girin ve Kaydet & denetle düğmesine basın. Studio, belirtecin kime ait olduğunu ve kaç depoya erişebildiğini gösterir.
- "Kayıtların açılacağı depo" alanından depoyu seçin. Listede yalnızca belirtecin erişebildiği ve Issues özelliği açık olan depolar yer alır.
GITHUB_ISSUES_ENABLEDayarını açın.
Çalıştığını doğrulayın
- Bağlantıyı denetle seçeneği, "<you> olarak oturum açıldı" ve "<owner/repo> kayıt kabul ediyor" mesajlarını gösterir. Denetim yalnızca verileri okur; asla kayıt açmaz.
- Ayarlar → Entegrasyonlar → Talepler bölümünü açın ve GitHub hedefinde Test talebi oluştur düğmesine basın. nexus-test etiketli bir kayıt açılır.
- Kaydı GitHub'da açın, etiketi doğrulayın ve işiniz bittiğinde kapatın veya silin.
Sık karşılaşılan hatalar
| Gördüğünüz | Neden | Çözüm |
|---|---|---|
| "GitHub belirteci reddetti (401)" | Belirteç yanlış, süresi dolmuş, iptal edilmiş veya eksik kopyalanmış. | Issues → Okuma ve yazma iznine sahip yeni bir belirteç oluşturun ve yeniden kaydedin. |
| HTTP 403 | Belirtecin Issues izni yok, depo belirteç için seçilmemiş veya istek sınırına ulaşılmış. | Belirteci düzenleyin: Issues iznini Okuma ve yazma olarak ayarlayın ve depoyu seçin. Sorun istek sınırıysa birkaç dakika bekleyin. |
| HTTP 404 | Depo mevcut değil, yeniden adlandırılmış veya belirteç depoyu göremiyor (özel depolar, ayrıntılı izinli belirteçte seçilmelidir). | Depoyu listeden seçin veya belirtecin depo erişimine ekleyin. |
| HTTP 422 | GitHub, kaydın bir alanını reddetti. Bu genellikle depoya katkıda bulunanlar arasında olmayan bir atanan kişi ya da GitHub'ın kabul etmediği bir başlık veya etikettir. | Ayarlar → Entegrasyonlar → Talepler bölümünde atanan kişiyi temizleyin veya bu kişiyi katkıda bulunan olarak ekleyin. |
| "<repo> deposunda Issues kapalı" | Depoda Issues özelliği devre dışı. | Depoda Ayarlar → Özellikler → Issues seçeneğini açın veya başka bir depo seçin. |
| "GitHub'a ulaşılamadı (…)" veya "zamanında yanıt vermedi" | Bu bilgisayar api.github.com adresine erişemiyor: VPN veya vekil sunucu engeli var ya da ağ bağlantısı yok. | Aynı bilgisayarda bir tarayıcıdan github.com adresini açın, ardından denetimi yeniden deneyin. |
| Tüm denetimler başarılı, ancak kayıt görünmüyor | GITHUB_ISSUES_ENABLED değeri false; veya sonuç FLAKY ya da ortam kaynaklı bir sonuç; veya çalıştırma bir deneme ortamında yapıldı; veya testin zaten açık bir kaydı var (tekrarlanan başarısızlıkta bunun yerine yorum eklenir). | GITHUB_ISSUES_ENABLED ayarını açın ve bağlantıyı doğrulamak için Test talebi oluştur seçeneğini kullanın. |
Ayar anahtarları
| Anahtar | Ne yapar | Geçerli değer | Nasıl denetlenir |
|---|---|---|---|
GITHUB_ISSUES_ENABLED | Başarısızlıklar için GitHub sorunları oluştur | true veya false | Bağlantıyı denetle başarılı olduktan sonra etkinleştirin, ardından Deneme kaydı oluştur seçeneğini çalıştırın. |
GITHUB_ISSUES_TOKEN | GitHub erişim belirteci (gizlidir, yalnızca bu bilgisayarda saklanır) | Tek satır, tırnak işareti ve boşluk olmadan | Bağlantıyı kontrol edin: "belirteç reddedildi" ifadesi, belirtecin yanlış, süresi dolmuş veya iptal edilmiş olduğu anlamına gelir. |
GITHUB_ISSUES_REPO | Sorunlar için GitHub deposu | sahip/depo, örneğin acme/web | Listeden seçin; Studio yalnızca belirtecin erişebildiği ve Issues özelliği açık olan bir depoyu kaydeder. |
Daha fazlası: tüm entegrasyonlar, Ayarlar kılavuzu, sorun giderme. Diğer kılavuzlar: Jira Cloud, Azure Boards, Slack, Microsoft Teams, Telegram.
Hâlâ çözüme ulaşamadınız mı? Studio'nun gösterdiği hata satırını aynen ekleyerek [email protected] adresine yazın. Erişim belirteci eklemeyin.