Jira Cloud'u bağlayın: adım adım kılavuz
Başarısız olan her test için bir Bug kaydı açar, test tekrar başarısız olduğunda kayda yorum ekler ve test sorunsuz geçtiğinde kaydı Done durumuna taşır. Bu kılavuz, sıfırdan başlayarak doğrulanmış bir bağlantı kurmanızı sağlar 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
- Bir Jira Cloud sitesi, örneğin https://your-team.atlassian.net (yalnızca Jira Cloud; adres https olmalıdır).
- Atlassian hesabınızın e-posta adresi ve aynı hesapla oluşturulmuş bir API belirteci.
- Bug adlı kayıt türüne sahip bir projenin anahtarı, örneğin QA.
- Bu hesap için söz konusu projede gezinme, kayıt oluşturma, yorum ekleme, ek oluşturma ve kayıtların durumunu değiştirme izinleri.
Kimlik bilgilerini alın
- https://id.atlassian.com/manage-profile/security/api-tokens adresini açın ve API belirteci oluştur seçeneğini seçin.
- Bir ad verin (örneğin "Nexus StudioQA"), son kullanma tarihini seçin, oluşturun ve belirteci hemen kopyalayın. Atlassian bunu yalnızca bir kez gösterir.
- Panonuzda tutun. Studio dışında hiçbir yere yapıştırmayın (sonraki adım).
Studio'da bağlantıyı kurun
- Studio'da Ayarlar → Entegrasyonlar → Jira'yı bağla yolunu açın.
- Jira'nızdan herhangi bir bağlantıyı (ana sayfa, pano veya kayıt) yapıştırın ve Bağlantıyı kontrol et düğmesine basın. Studio, site adresini ve proje anahtarını saklar.
- İstendiğinde Atlassian e-posta adresinizi ve belirteci girip Kaydet & kontrol et düğmesine basın.
- "Hataların kaydedileceği proje" alanında projeyi seçin, ardından
JIRA_ENABLEDseçeneğini etkinleştirin.
Çalıştığını doğrulayın
- Bağlantıyı kontrol et işlemi "<adınız> olarak oturum açıldı" ve "<KEY> Bug kayıtlarını kabul ediyor" mesajlarını gösterir. Kontrol yalnızca okuma yapar; hiçbir zaman kayıt açmaz.
- Ayarlar → Entegrasyonlar → Kayıtlar yolunu açın ve Test kaydı oluştur düğmesine basın. Bu işlem, nexus-test etiketli bir kayıt açar ve bu bölümde Jira'ya istek gönderen tek tıklamadır.
- Bu kaydı Jira'da açın ve auto-generated, nexus-studioqa-automation ve nexus-test etiketlerine sahip olduğunu doğrulayın. İşiniz bittiğinde kaydı silin.
Sık karşılaşılan hatalar
| Gördüğünüz | Neden | Çözüm |
|---|---|---|
| "Bu bir bağlantı değil" veya "Jira bağlantısı https:// ile başlar" | Yapıştırılan metin tam bir web adresi değil veya http:// ile başlıyor. | Jira sitenizdeyken adres çubuğundaki adresi kopyalayın. Adres https:// ile başlamalıdır. |
| HTTP 401 | E-posta adresi veya belirteç yanlış, belirtecin süresi dolmuş ya da belirteç iptal edilmiş veya e-posta adresi belirteci oluşturan hesaba ait değil. | Kaydettiğiniz e-posta adresine sahip hesapla id.atlassian.com adresinde yeni bir belirteç oluşturun, ardından her ikisini de Ayarlar'da yeniden kaydedin. |
| HTTP 403 | Oturum açma başarılı, ancak Jira bu hesabın işlemi yapmasına izin verilmediğini bildiriyor: genellikle projede Kayıt oluşturma, Yorum ekleme veya Ek oluşturma izni eksiktir. | Proje yöneticisinden bu izinleri isteyin veya başka bir proje seçin. Nexus StudioQA bu izinleri veremez. |
| HTTP 404 | Site adresi veya proje anahtarı mevcut değil ya da bu hesap projeyi göremiyor (Jira, gizlediği projeler için 404 yanıtı verir). | Doğru siteden herhangi bir bağlantı yapıştırın ve listeden projeyi seçin. |
| "Bu adres yanıt verdi, ancak bir Jira hesabıyla değil" | Adres bir Jira Cloud sitesi değil (örneğin bir Server veya Data Center adresi ya da başka bir web sayfası). | Jira Cloud sitenizin https://<team>.atlassian.net adresini kullanın. |
| "<KEY> projesinde Bug adlı bir iş türü yok" | Projede Bug adlı bir iş türü olmadığından kayıt oluşturulamıyor. | Jira içinde Proje ayarları → İş türleri bölümünü açıp Bug ekleyin veya başka bir proje seçin. |
| "Jira bağlantısı kurulamadı (ENOTFOUND)" veya "20 s içinde yanıt vermedi" | Bu bilgisayar siteye erişemiyor: adreste yazım hatası, VPN veya ara sunucu sorunu ya da ağ bağlantısı yok. | Adresi düzeltin, ardından siteyi aynı bilgisayarda bir tarayıcıda açın. Denetimi yeniden deneyin. |
| Tüm denetimler başarılı, ancak kayıt görünmüyor | JIRA_ENABLED değeri false; ya da sonuç FLAKY veya ortamla ilgili bir sonuç; ya da çalıştırma bir yalıtılmış ortamda yapıldı; ya da bu test için zaten açık bir Bug var (tekrarlanan başarısızlıkta bunun yerine yorum eklenir); ya da son 24 saat içinde aynı başlıkla bir Bug oluşturuldu. | JIRA_ENABLED ayarını açın, entegrasyonlar sayfasındaki "Test başına bir iş" bölümünü okuyun ve bağlantıyı doğrulamak için Test kaydı oluştur seçeneğini kullanın. |
| Başarılı olan testin kaydı kapanmıyor | İş akışında JIRA_DONE_TRANSITION ile aynı adı taşıyan bir geçiş olmadığından kayda yalnızca yorum eklenir. | JIRA_DONE_TRANSITION değerini iş akışınızdaki geçiş düğmesinin tam adı olarak ayarlayın. |
Ayar anahtarları
| Anahtar | Ne yapar | Geçerli değer | Nasıl denetlenir |
|---|---|---|---|
JIRA_ENABLED | Başarısızlıklar için Jira kayıtları oluştur | true veya false | Entegrasyonu açın, ardından Test kaydı oluştur seçeneğini çalıştırın. |
JIRA_BASE_URL | Jira site adresi | https://<site>.atlassian.net | Bağlantıyı denetle seçeneği siteyi gösterir; yapıştırılan bağlantı bu alanı doldurur. |
JIRA_EMAIL | Jira oturum açma e-postası | Belirtecin sahibi olan Atlassian hesabının e-posta adresi | Bağlantıyı denetle seçeneği bu e-posta adresiyle "… olarak oturum açıldı" ifadesini gösterir. |
JIRA_API_TOKEN | Jira erişim belirteci (gizlidir, yalnızca bu bilgisayara kaydedilir) | Tek satır, tırnak işareti ve boşluk olmadan | Bağlantıyı denetle: HTTP 401, e-posta/belirteç çiftinin yanlış olduğu anlamına gelir. |
JIRA_PROJECT_KEY | Bug kayıtları için Jira projesi | Genellikle büyük harflerden oluşan proje anahtarı, örneğin QA | Proje açılır listesinde yer alır; "Bug kayıtlarını kabul ediyor" ifadesi türü doğrular. |
JIRA_DONE_TRANSITION | Test başarılı olduğunda Jira durumu | Büyük/küçük harf ayrımı yapılmadan eşleştirilen iş akışı geçişinin tam adı | Sorunsuz bir başarı, kaydın durumunu değiştirir; iş akışında böyle bir geçiş yoksa kayda yalnızca yorum eklenir. |
Daha fazlası: tüm entegrasyonlar, Ayarlar kılavuzu, sorun giderme. Diğer kılavuzlar: Azure Boards, Slack, Microsoft Teams, Telegram, GitHub Issues.
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.