Kalite kapısı (quality gate)
Son güncelleme
Kalite kapısı, bir değişikliğin ilerlemeden önce geçmesi gereken geçti/kaldı kontrolüdür. Neyi kontrol ettiği, yapay zekâ kodu için önemi ve AI CodeOps'ta uygulanışı.
Kalite kapısı, bir kod değişikliğinin pull request'e dönüşmek, merge edilmek veya dağıtılmak gibi bir sonraki aşamaya geçmeden önce geçmesi gereken, otomatik bir geçti/kaldı kontrol noktasıdır. Kapı birkaç sinyali (testler, inceleme sonuçları, onaylar) tek bir karara dönüştürür.
Nedir
Bir kapının bir koşullar kümesi ve bir kararı vardır. Tipik koşullar "testler geçiyor", "açık kritik sorun yok" ve "bir inceleyici onayladı" şeklindedir. Herhangi bir koşul sağlanmazsa değişiklik durur ve kapı nedenini söyler. Kapılar genellikle bir geçiş noktasında durur: merge'den önce, yayından önce, canlı ortamdan önce.
İyi kapılar neyi bilmediklerini açıkça belirtir. Hiç çalışmamış bir inceleme temiz bir inceleme değildir ve eksik bir sonuç geçti sayılmamalıdır.
Neden önemlidir
Yapay zekâ ajanları değişiklikleri insanların okuyabileceğinden daha hızlı yazabilir. Bir kapı, kimin veya neyin yazdığından bağımsız olarak her değişiklik için çıtayı aynı tutar ve bir değişikliğin neden bekletildiğini kaydeder. Kapı olmadan, üretilen kod ile ana branch'iniz arasındaki tek şey, yoğun bir günde birinin dikkatidir.
AI CodeOps'ta
Her yapay zekâ oturumu bir diff ile sona erer. Bu diff bir pull request'e dönüşmeden önce AI CodeOps sırasıyla şunları kontrol eder:
- Çalışma alanı politikası: bir deny kararı onu durdurur, bir ask kararı onaylanmış bir inceleme gerektirir.
- Onay: bekleyen veya reddedilmiş bir onay onu durdurur.
- Kalite kapısının kendisi: testler güncel sürümde başarısız olmamış, yapay zekâ bulgu incelemesi tamamlanmış ve hiçbir high (yüksek) veya critical (kritik) bulgu hâlâ open, acknowledged veya in progress durumunda değil.
Çalıştırma sayfasındaki Quality gates paneli, gerekçeleriyle birlikte Release-ready veya Not release-ready gösterir. Aynı kapı, konsol bir oturumun açtığı bir pull request'i merge etmeden önce yeniden çalışır.
CI'ınız aynı soruyu herhangi bir pull request veya commit için sorabilir:
curl -s -X POST "https://console.aicodeops.dev/api/release/check" \
-H "Authorization: Bearer $WORKSPACE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"pullRequestURL":"https://github.com/acme/api/pull/42","blockingSeverity":"medium"}'
Reddedilen bir yanıt, kısaltılmış hâliyle:
{
"allowed": false,
"summary": "HIGH security: Coupon code is passed to the pricing query without validation",
"reasons": ["HIGH security: Coupon code is passed to the pricing query without validation"],
"testFailures": [],
"coverageShortfall": null
}
Uç nokta her iki durumda da HTTP 200 yanıtı verir; bu yüzden bir CI adımı allowed değerini okumalıdır. Değişikliğe hiçbir oturum dokunmadıysa reddedilir: kapının değerlendireceği bir şey yoktur. CI kontrolü ayrıca bir kapsam alt sınırı, bir lisans politikası, zorunlu iş akışları ve önceki bir dağıtım şartı da uygulayabilir. Alanların tam listesi API referansındadır.
İlgili terimler
- Dağıtım kapısı: aynı fikrin bir ortama yayına uygulanmış hâli.
- Döngüdeki insan (human-in-the-loop): otomatik kontrollerin yanında duran onay.
- Statik uygulama güvenlik testi (SAST): bir kapının kullanabileceği bir sinyal türü.
Sık sorulan sorular
Kalite kapısı bir CI kontrolüyle aynı şey midir?
Bir CI kontrolü tek bir sinyaldir. Kalite kapısı ise testler, inceleme bulguları ve onaylar gibi birkaç sinyal üzerine kurulan ve değişikliğin ilerleyip ilerleyemeyeceğini söyleyen karardır.
AI CodeOps'ta kapının kendisi hata verirse ne olur?
Değişiklik reddedilir. Kapı hata durumunda kapalı kalır; bu yüzden kontrol sırasında oluşan bir hata asla bir değişikliğin geçmesine izin vermez.
CI pipeline'ım AI CodeOps kapısından karar isteyebilir mi?
Evet. Bir çalışma alanı API anahtarı ve bir pull request URL'si veya commit SHA'sı ile POST /api/release/check, gerekçeleriyle birlikte allowed true veya false döndürür.