AI Scan Repo Taramasını REST API ile Toplu Yönetin

GitHub Code Scanning’deki AI Scan for repositories özelliği, REST API ile enabled/disabled olarak toplu yönetilebiliyor. Yeni repository_scan ayarı, pr_scan davranışını taklit eder ve yetki/politika kurallarıyla çalışır.

GitHub code scanning içindeki AI Scan for repositories özelliği artık REST API üzerinden açılıp kapatılabiliyor. Public preview aşamasındaki değişiklik, mevcut AI Scan etkinleştirme uç noktalarına repository_scan adında yeni bir ayar ekliyor. Depo taramasını organizasyon ya da repo ayarlarına tek tek girerek açmak yerine script’lerle veya altyapıyı kod olarak yöneten araçlarla toplu biçimde dağıtmak mümkün hale geliyor.

Yeni repository_scan ayarı ne yapıyor?

Ayarı enabled veya disabled değerine çekmek için AI Scan etkinleştirme uç noktaları kullanılıyor, mantık hem organizasyon hem de repo düzeyinde aynı:

  • GET ve PATCH /orgs/{org}/code-scanning/ai-scan
  • GET ve PATCH /repos/{owner}/{repo}/code-scanning/ai-scan

Tasarım, AI Scan for pull requests için zaten var olan pr_scan ayarının davranışını birebir taklit ediyor. PR taramasını API üzerinden yönetmek için daha önce bir otomasyon yazıldıysa aynı kalıp depo taraması için tekrar kullanılabiliyor, öğrenilecek yeni bir model yok.

Kalıtım ve engelleme kuralları

Ayarın organizasyon ile repo arasındaki ilişkisi net kurallara bağlı, bunları bilmeden yazılan otomasyon da beklenmedik hata yanıtlarıyla karşılaşabiliyor:

  • Bir organizasyon AI Scan for repositories özelliğini devre dışı bırakırsa, o organizasyona bağlı depolar bu özelliği kendi başına etkinleştiremez.
  • Organizasyon özelliği etkinleştirirse, depolar bu ayarı devralır; ancak isteyen depo tek tek kapsam dışına çıkabilir (opt out).
  • Enterprise politikası AI Scan kullanımına izin vermiyorsa, etkinleştirme istekleri 422 hatasıyla döner.

Hiyerarşi yukarıdan aşağı çalışıyor. Enterprise politikası en üstte kapı bekçisi, organizasyon ayarı ortada varsayılanı belirliyor, depo yöneticisi ise yalnızca aşağı yönde, yani kapatma yönünde hareket edebiliyor.

Tek istekte iki ayarı güncellemek

pr_scan ve repository_scan alanları aynı istek içinde birlikte güncellenebiliyor, ama davranış atomik. Değişikliklerden herhangi biri engellenirse istek 422 hatası dönduruyor ve iki ayar da değişmiyor. Kısmi uygulama yok. Otomasyon tarafında bu aslında iyi haber, yarı uygulanmış tutarsız bir durumla uğraşmak yerine isteği yeniden değerlendirip tekrar göndermek yetiyor.

Buna karşılık toplu dağıtım script’lerinde hata yanıtlarını sessizce yutmamak gerekiyor. Enterprise politikası kaynaklı bir 422 “ayar uygulandı” sanılırsa, envanterde gerçekte kapalı olan depolar açık görünür.

Açmak taramayı başlatmaz

AI Scan for repositories özelliğini etkinleştirmek kendiliğinden bir tarama başlatmıyor; ayar yalnızca yeteneği kullanılabilir hale getiriyor. Taramaları, yazma (write) erişimi olan kullanıcılar talep üzerine çalıştırmaya devam ediyor ve her tarama GitHub Code Security AI kredisi tüketiyor.

Maliyet planlamasında akılda tutulması gereken nokta da burası. Organizasyon genelinde ayarı açmak tek başına kredi tüketimi yaratmıyor, tüketim fiilen çalıştırılan taramalara bağlı. Geniş kapsamlı bir etkinleştirmeyle fiili kullanım hacmi arasındaki ilişkiyi ayrı ayrı izlemek gerekiyor.

Kimler yönetebilir, nerede çalışır?

Yetkiler ve kapsam kaynakta şöyle tanımlanıyor:

  • Organizasyon sahipleri ve security manager rolündekiler organizasyon düzeyindeki ayarı yönetebilir.
  • Depo yöneticileri tek tek depoları kapsam dışına çıkarabilir.
  • Enterprise sahipleri önce enterprise politikasında AI Scan kullanımına izin vermelidir; aksi halde alt seviyelerdeki etkinleştirme denemeleri hata döner.

Depo kapsamı açısından AI Scan for repositories, organizasyonlara ait public depolarda kullanılabiliyor. GitHub Code Security veya GitHub Advanced Security bulunan private ve internal depolar da kapsamda. GitHub Enterprise Server desteklenmiyor, yani kendi sunucunuzda barındırdığınız kurulumlar bu API davranışının dışında kalıyor.

Uygulamaya geçerken ne yapmalı?

Özelliği kademeli yaymak isteyen ekipler için mantıklı sıra, kaynaktaki kurallardan doğrudan çıkıyor. Önce enterprise politikasının AI Scan’e izin verdiğini doğrulamak gerekiyor, bu adım atlandığında alttaki bütün istekler 422 ile sonuçlanıyor. Sonrasında organizasyon düzeyindeki repository_scan değeri belirleniyor, kapsam dışında kalması gereken depolar repo düzeyinde kapatılıyor.

Mevcut durumu görmek için GET uç noktaları kullanılabilir, değişiklik uygulanmadan önce organizasyon ve depo seviyesindeki değerler karşılaştırılabilir. Infrastructure as code yaklaşımıyla çalışan ekipler böylece ayarın arzu edilen durumunu (desired state) tanımlayıp düzenli olarak doğrulayabiliyor. Manuel, tek tek yapılan ayar değişikliklerinin yerini tekrarlanabilir ve denetlenebilir bir süreç alıyor.

Özellik public preview aşamasında olduğu için davranışın ileride değişebileceğini varsayıp otomasyonları esnek tutmak makul bir yaklaşım. Geri bildirim ve soru paylaşmak isteyenler için GitHub Community tartışma başlığı açık durumda.

Kaynaklar ve İleri Okuma

Bu yazı yapay zeka (büyük dil modelleri) ile hazırlanmış, insan editör tarafından incelenmiştir. İçerik üretim sürecimiz.
Aşkın KILIÇ

20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.

AZ-305AZ-104AZ-500AZ-400DP-203AI-102

Bu içerik işinize yaradı mı?

Benzer içerikleri kaçırmamak için YouTube ve GitHub hesaplarımı takip edin.

Haftalık Bülten

Her pazar özenle seçilmiş teknoloji yazıları doğrudan e-postanıza gelsin.

Kurumsal DevOps ve bulut dönüşümü danışmanlığı: Danışmanlık Hizmetleri

3 Yorum

  1. Tam zamanında denk geldi bu yazı, biz de şirkette onlarca repo için code scanning ayarlarını tek tek elle yapıyorduk. repository_scan ayarını API ile toplu çekmeyi deneyeceğim, umarım org seviyesinde policy’lere takılmaz. pr_scan ile aynı mantıkta çalışması da işleri kolaylaştırır.

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

✉

Haftalık Bülten

Azure, DevOps ve Yapay Zeka dünyasındaki en güncel içerikleri her hafta doğrudan e-postanıza alın.

Spam yok. İstediğiniz zaman iptal edebilirsiniz.
📱
Uygulamayı Yükle Ana ekrana ekle, çevrimdışı oku
Kategoriler
Ara
Paylaş
WhatsApp
İçindekiler
← GitHub Copilot App’te GH...
SqlPackage ile Dağıtım Geçmişi... →
📩

Gitmeden önce!

Her pazar özenle seçilmiş teknoloji yazıları ve AI haberleri doğrudan e-postanıza gelsin. Ücretsiz, spam yok.

🔒 Bilgileriniz güvende. İstediğiniz zaman ayrılabilirsiniz.

📬 Haftalık bülten: Teknoloji + AI haberleri
Beni Takip Et Yeni Azure / AI / DevOps yazılarını GitHub ve RSS üzerinden takip edin.