Azure Boards'u bağlayın: adım adım kılavuz
Başarısız olan her test için bir iş öğesi oluşturur, test tekrar başarısız olduğunda bu öğeye yorum ekler ve test sorunsuz geçtiğinde öğeyi tamamlandı durumuna getirir. Aynı belirteç, test sonuçlarını da yayımlar ve işlem hatlarını kuyruğa alır. Bu kılavuz, sıfırdan başlayıp 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
- Bir Azure DevOps Services kuruluşu: https://dev.azure.com/<organization> veya https://<organization>.visualstudio.com (kendi makinelerinizde çalışan Azure DevOps Server desteklenmez).
- İş öğelerinin gönderileceği projenin adı.
- İş Öğeleri → Okuma & yazma kapsamına sahip bir kişisel erişim belirteci (PAT); CI'da Çalıştır özelliğini de kullanıyorsanız Derleme → Okuma & yürütme kapsamı da gerekir.
- İş öğesi türünü belirlediği için projenizin sürecini bilmeniz gerekir: Basic sürecinde Issue, Epic ve Task bulunur (Bug yoktur); Agile, Scrum ve CMMI süreçlerinde Bug bulunur.
Kimlik bilgilerini alın
- dev.azure.com adresini açın, ardından Kullanıcı ayarları → Kişisel erişim belirteçleri → Yeni Belirteç yolunu izleyin.
- Kuruluşunuzu seçin, bir sona erme tarihi belirleyin ve Kapsamlar altında Özel tanımlı seçeneğini seçin.
- İş Öğeleri → Okuma & yazma seçeneğini işaretleyin (CI'da Çalıştır için Derleme → Okuma & yürütme kapsamını ekleyin), belirteci oluşturun ve hemen kopyalayın. Yalnızca bir kez gösterilir.
- 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 → Azure DevOps'u Bağla bölümünü açın.
- Azure DevOps'tan herhangi bir bağlantıyı (bir pano, iş öğesi veya proje sayfası) yapıştırın ve Bağlantıyı denetle düğmesine basın. Studio, kuruluşu ve projeyi kaydeder.
- İstendiğinde PAT'yi girin ve Kaydet & denetle düğmesine basın. "İş öğelerinin gönderileceği proje" alanından projeyi seçin.
- Denetim, projede Bug adlı bir iş öğesi türü olmadığını bildirirse
AZURE_BOARDS_WORK_ITEM_TYPEdeğerini listelenen türlerden birine (Basic projesinde Issue),AZURE_BOARDS_DONE_STATEdeğerini ise o süreçte bulunan bir duruma (Basic: Done) ayarlayın. AZURE_BOARDS_ENABLEDayarını etkinleştirin.
Çalıştığını doğrulayın
- Bağlantıyı denetle işlemi, "Belirteç N projeyi görebiliyor" ve "<project>, <type> türündeki iş öğelerini kabul ediyor" mesajlarını gösterir. Denetim yalnızca okuma yapar; asla iş öğesi oluşturmaz.
- Ayarlar → Entegrasyonlar → Kayıtlar bölümünü açın ve Test kaydı oluştur düğmesine basın. nexus-test etiketli ve ekran görüntüsü eklenmiş bir iş öğesi oluşturulur.
- Öğeyi Azure Boards'da açın, etiketi ve eki doğrulayın ve işiniz bittiğinde silin.
Sık karşılaşılan hatalar
| Gördüğünüz | Neden | Çözüm |
|---|---|---|
| "Azure DevOps belirteci reddetti" (HTTP 203 veya 401) | PAT yanlış, süresi dolmuş, iptal edilmiş, eksik kopyalanmış veya farklı bir kuruluşta oluşturulmuş. | AZURE_DEVOPS_ORG_URL ile aynı kuruluşta İş Öğeleri → Okuma & yazma kapsamına sahip yeni bir PAT oluşturun ve yeniden kaydedin. |
| HTTP 403 | PAT geçerli ancak gerekli bir kapsam eksik veya kullanıcınızın bu projede izni yok. | PAT kapsamlarını düzenleyin (İş Öğeleri → Okuma & yazma; CI'da Çalıştır için Derleme → Okuma & yürütme) veya proje yöneticisinden erişim isteyin. |
| HTTP 404 | Belirtilen kuruluş ya da proje adı mevcut değil veya projenin adı değiştirilmiş. | Doğru projeden bir bağlantı yapıştırın ve projeyi listeden seçin. |
| VS402323 "Bug iş öğesi türü mevcut değil" | Projenin sürecinde bu adla bir iş öğesi türü yok. Basic projesinde Issue, Epic ve Task bulunur, Bug bulunmaz. | AZURE_BOARDS_WORK_ITEM_TYPE değerini denetimin listelediği bir türe (Basic: Issue), AZURE_BOARDS_DONE_STATE değerini ise bu sürecin durumlarından birine (Basic: Done) ayarlayın, ardından yeniden Bağlantıyı denetle düğmesine basın. |
| "<project> projesinde … adlı bir iş öğesi türü yok" | VS402323 ile aynı neden; herhangi bir kayıt oluşturulmadan önce Bağlantıyı denetle tarafından saptanır. | AZURE_BOARDS_WORK_ITEM_TYPE değerini bu iletide listelenen türlerden birine ayarlayın veya başka bir proje seçin. |
| "Bu bir Azure DevOps bağlantısı değil" | Adres dev.azure.com/<organization> veya <organization>.visualstudio.com üzerinde değil ya da http:// ile başlıyor. | Adresi Azure DevOps Services adres çubuğundan kopyalayın. Azure DevOps Server desteklenmez. |
| "Azure DevOps hizmetine ulaşılamadı (…)" veya "20 sn içinde yanıt vermedi" | Bu bilgisayar Azure DevOps hizmetine ulaşamıyor: VPN veya ara sunucu engeli var ya da ağ bağlantısı yok. | Aynı bilgisayarda bir tarayıcıda dev.azure.com adresini açın, ardından denetimi yeniden deneyin. |
| Başarılı bir test, durumu tamamlandı olarak ayarlamıyor | Süreç bu tür için AZURE_BOARDS_DONE_STATE değerini reddettiğinden öğeye yalnızca yorum eklenir. | AZURE_BOARDS_DONE_STATE değerini bu türe ait bir duruma ayarlayın (Basic: Done; Agile hatası: Resolved). |
| Tüm denetimler başarılı, ancak iş öğesi görünmüyor | AZURE_BOARDS_ENABLED değeri false; ya da sonuç FLAKY veya ortamla ilgili bir sonuç; ya da çalıştırma yalıtılmış ortamda yapıldı; ya da testin zaten açık bir iş öğesi var (tekrarlanan başarısızlıkta bunun yerine yorum eklenir). | AZURE_BOARDS_ENABLED ayarını etkinleştirin ve bağlantıyı doğrulamak için Deneme kaydı oluştur seçeneğini kullanın. |
Ayar anahtarları
| Anahtar | Ne yapar | Geçerli değer | Nasıl denetlenir |
|---|---|---|---|
AZURE_BOARDS_ENABLED | Başarısızlıklar için Azure iş öğeleri 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. |
AZURE_DEVOPS_ORG_URL | Azure DevOps kuruluş adresi | https://dev.azure.com/<organization> veya https://<organization>.visualstudio.com | Bağlantıyı denetle kuruluşu gösterir; yapıştırılan bağlantı bu alanı doldurur. |
AZURE_DEVOPS_PROJECT | Azure DevOps proje adı | Proje adı, Azure DevOps içinde göründüğü şekliyle | Bağlantıyı denetle, belirtecin erişebildiği projeleri listeler. |
AZURE_DEVOPS_PAT | Azure DevOps erişim belirteci (gizli, yalnızca bu bilgisayarda saklanır) | Tek satır, tırnak işareti ve boşluk olmadan | Bağlantıyı denetle: "belirteci reddetti" ifadesi belirtecin yanlış, süresi dolmuş veya başka bir kuruluşa ait olduğu anlamına gelir. |
AZURE_BOARDS_WORK_ITEM_TYPE | Başarısızlıklar için Azure kayıt türü | Projenin sürecinde bulunan bir tür: Bug (Agile, Scrum, CMMI) veya Issue (Basic) | Bağlantıyı denetle, "<project> projesi <type> türünde iş öğelerini kabul eder" der veya projenin türlerini listeler. |
AZURE_BOARDS_DONE_STATE | Test başarılı olduğunda Azure durumu | Bu iş öğesi türüne ait bir durum: Resolved (Agile hatası), Done (Basic sorunu) | Sorunsuz bir başarı öğenin durumunu değiştirir; süreç durumu reddederse öğeye yalnızca yorum eklenir. |
AZURE_PIPELINE_ID | CI ortamında çalıştırılacak Azure işlem hattı | Azure işlem hattının sayısal kimliği (yalnızca CI ortamında çalıştır için) | nexus ci-remote --provider=azure bu işlem hattını kuyruğa alır; Derleme → Okuma & yürütme izni gerektirir. |
Daha fazlası: tüm entegrasyonlar, Ayarlar kılavuzu, sorun giderme. Diğer kılavuzlar: Jira Cloud, 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.