Azure Developer CLI 1.34: azure.yaml Katmanları ve

⏱️ 6 dk okuma📅 4 Ekim 2026

Azure Developer CLI (azd) cephesinde Eylül 2026 art arda dört sürümle kapandı: 1.33.0, 1.34.0, 1.34.1 ve 1.34.2. Dört sürümün ortaklaştığı yerler şunlar: uzantı ekosistemini daha güvenli yönetmek, karmaşık projelerin azure.yaml dosyasını katmanlara ayırabilmek, paralel çalışan işlemlere sınır koyabilmek ve harici kimlik doğrulama senaryolarını yerel soketler üzerinden çalıştırabilmek. Sürüm notlarında duyurulan değişiklikler başlık başlık aşağıda.

Öne çıkan değişiklikler

Microsoft’un yayın notunda beş madde öne çıkarılmış:

Bağımlılık farkındalıklı uzantı kaldırma: Gerekli bağımlılıkları koruyan, artık kullanılmayan paketleri ise temizlemeye yardımcı olan bir akış.
Üst düzey altyapı ve servis katmanları: Karmaşık azure.yaml projelerini daha düzenli organize etme imkanı.
Faz bazlı eşzamanlılık limitleri: package, provision, publish ve deploy işlemlerinin paralellik derecesini kontrol etme.
Sürümlenmiş uzantı sözleşmeleri: Mevcut uzantılarla uyumu bozmadan stable ve preview API yüzeyleri sunulması.
Harici kimlik doğrulama bağlantıları: Unix domain socket ve Windows named pipe üzerinden bağlanabilme.

Yayın notunda bu sürümlerin güvenlik iyileştirmeleri içerdiği ve kullanıcıların güncellemesinin önerildiği de belirtiliyor.

Uzantı yönetimi olgunlaşıyor

azd extension uninstall artık sizin kurduğunuz uzantılarla otomatik gelen bağımlılıkları birbirinden ayırt ediyor. Seçtiğiniz uzantıya başka bir uzantı bağımlıysa kaldırma engelleniyor, artık ihtiyaç duyulmayan bağımlılıkların silinmesi ise teklif ediliyor. Davranışı iki bayrakla değiştirebiliyorsunuz:

--force: Bağımlı uzantı olmasına rağmen kaldırmayı zorlar.
--no-dependencies: Kullanılmayan bağımlılıkları yerinde bırakır.

Aynı değişiklik setiyle azd extension show çıktısı da zenginleşti; uyumluluk, sahiplik, bağımlılıklar ve kurulu bağımlı uzantılar gösteriliyor. JSON çıktısında anahtarlar camelCase biçiminde üretiliyor, boş alanlar atlanıyor.

Uzantı yazarları tarafında gRPC sözleşmeleri artık stable ve preview olarak sürümlenmiş durumda; yazar hangi API yüzeyini hedefleyeceğini seçiyor, mevcut uzantılarla uyum da korunuyor. Preview sözleşmesine eklenen Account.GetCurrentPrincipal çağrısı sayesinde uzantılar, oturum açmış kimliğin object ID ve principal type bilgisini erişim belirtecini (access token) çözmeye gerek kalmadan okuyabiliyor.

Proje yapılandırması ve dağıtım

İş akışını en çok etkileyecek iki madde proje tarafında duruyor:

Üst düzey altyapı ve servis katmanları: azure.yaml içinde tanımlanabilen bu katmanlar, provisioning ve deployment işlerini çok bileşenli projelerde daha derli toplu organize etmeyi hedefliyor.
Faz bazlı eşzamanlılık: package, provision, publish ve deploy fazları için ayrı ayrı eşzamanlılık limiti tanımlayabiliyorsunuz. Yani ne kadar işin paralel koşacağını artık siz belirliyorsunuz.

Proje eşlemeleri (project mappings) kaydedilip geri yüklendiğinde ortam şablonlarının korunması da sağlandı.

Kimlik doğrulama ve şablon güvenliği

Harici kimlik doğrulama sağlayıcıları (external authentication hosts) artık AZD_AUTH_ENDPOINT yapılandırmasıyla Unix domain socket veya Windows named pipe üzerinden bağlanabiliyor. Ağ üzerinden dinleyen bir uç nokta yerine makine içi iletişim kanalı kullanmak isteyen senaryolarda anlamlı bir seçenek.

Şablon tarafında da küçük bir koruma eklendi. azd init --template komutu, hedef şablon deposu arşivlenmişse uyarı veriyor; bakımı bırakılmış bir projeyi klonlamadan önce işlemi iptal edebiliyorsunuz.

Düzeltilen hatalar

Sürüm notlarında listelenen düzeltmeler üç grupta toplanıyor.

Uzantılar ve kimlik doğrulama

Uzantı install, update, init ve otomatik kurulum akışları artık çalışan azd sürümüyle uyumlu yayınları seçiyor.
Eşzamanlı başlatmadan kaynaklanan aralıklı uzantı başlatma zaman aşımları giderildi.
Uzantı paketleri indirilirken yönlendirmeler takip ediliyor; bir HTTPS indirmesi HTTP’ye yönlendiğinde uyarı veriliyor.
System-assigned managed identity için oturum açma bilgileri düzeltildi.

Provisioning ve dağıtım

azd up sırasında proje seviyesindeki predeploy ve postdeploy hook çıktıları gösteriliyor (katkı: @jongio).
Azure Container Registry (ACR) log akışı, uzak derleme logu değiştirdiğinde veya kestiğinde kurtarılıyor.
ACR uzak görev zamanlamayı reddettiğinde yerel container derlemesine geri dönülüyor.
ACR uzak derleme hataları için derleme logları korunarak kararlı ve yapılandırılmış tanılama bilgisi üretiliyor.
Servislerin condition değerleri, devre dışı servisler başlatılmadan veya komut öncesi kontrol edilmeden önce dikkate alınıyor.
İlgisiz Azure kaynak sağlayıcıları için Foundry kurtarma adımları yerine kaynağa özgü kota rehberliği gösteriliyor.
Desteklenen.NET SDK sürümlerinde eşzamanlı.NET servis yayınlarında ara çıktılar birbirinden izole ediliyor.

Etkileşimli ve ajan ortamları

Eskimiş coding-agent işaretlerini devralan etkileşimli terminaller etkileşimli kalmaya devam ediyor; ajan tespiti iyileştirildi.
Boş AI coding-agent işaretleri yok sayılıyor, aktif Codex ve Cursor oturumlarına öncelik veriliyor, Cursor masaüstü uygulaması ajan olarak sınıflandırılmıyor.
azure.yaml geçersiz YAML içerdiğinde beklenmedik şekilde durmak yerine net bir doğrulama hatası dönülüyor (katkı: @Siglud).
Telemetri devre dışıyken temiz kapanma sağlanıyor.

Diğer değişiklikler

Ajan tabanlı azd init akışı, premium istek yerine AI kredisi bildiriyor.
execution.environment telemetri alanı, azd bir Agency oturumunda çalıştığında agency değerini raporluyor.
Yayınlanan Homebrew cask’leri Homebrew’un bildirimsel postflight_steps yapısını kullanıyor.
Paket içindeki Bicep CLI v0.47.16’ya güncellendi.
Paket içindeki GitHub CLI v2.101.0’a güncellendi.
Ortamdan gelen (ambient) OpenTelemetry kaynak öznitelikleri artık dışa aktarılmıyor; bildirilen telemetri alanları korunuyor.

Yeni dokümantasyon

Microsoft Learn tarafında azd için yayımlanan yeni ve güncellenen içerikler şunlar:

Build Azure Developer CLI templates (16 Eylül): Şablon geliştirme akışı; mevcut bir şablondan başlamak, AI kodlama asistanı kullanmak veya dosyaları doğrudan yazmak arasındaki seçim.
Explore and edit Azure Developer CLI template files (16 Eylül): azure.yaml, kaynak kod, altyapı dosyaları ve ortam yapılandırmasının bir şablonda nasıl birlikte çalıştığı.
Extend an Azure Developer CLI template (16 Eylül): Mevcut bir şablona Bicep modülüyle Azure servisi eklemek ve çıktıları azd ortam değerleri olarak dışa aktarmak.
Start with a new Azure Developer CLI template (16 Eylül): GitHub Copilot, başka bir AI asistanı veya doğrudan dosya yazımıyla şablon oluşturup provision ve deploy etmek.
Choose a container build and deployment workflow (15 Eylül): Container barındırma hedefleri, imaj derleme konumları, registry seçenekleri ve azd publish/deploy komutlarının karşılaştırması.

Yeni şablonlar: LangGraph tabanlı hosted-agent örnekleri

Microsoft Foundry ekibi tarafından yayımlanan LangGraph hosted-agent şablonlarının tamamı Python ile yazılmış. Responses protokolü üzerinden çalışanlar:

Basic Chat: Yerel saat ve hesap makinesi araçlarına sahip, sunucu tarafında konuşma durumu tutan çok turlu sohbet ajanı.
Deep Agents: İşi planlayan, odaklı araştırmayı devreden, yönetilen web aramasını kullanan, alıntıları birleştiren ve kalıcı checkpoint tutan derin araştırma ajanı.
Foundry Toolbox: Yönetilen web araması ve Microsoft Learn MCP araçları için Foundry Toolbox kullanan ReAct ajanı; OAuth onay yönetimi ve şema temizleme dahil.
Foundry Toolbox with User Identity: Kullanıcı kimliği ve yönetilen OAuth ile WorkIQ Mail, WorkIQ Calendar ve GitHub MCP entegrasyonlarını sağlayan ReAct ajanı.
Multi-Agent Workflows: Slogan yazarı, hukuk gözden geçiricisi ve biçimlendirici LLM düğümlerini sırayla zincirleyip yalnızca son biçimlendirilmiş sonucu dönen StateGraph akışı.
File Handling: Yüklenen ve paketle gelen dosyalarla çalışan, yerel dosya sistemi araçları ve Foundry Toolbox kod yorumlayıcısını kullanan ajan.
Human-in-the-Loop: İnsan incelemesi için duraklayan; onay, geri bildirimle revizyon veya ret seçeneklerini Responses onay ve fonksiyon çağrısı kanallarıyla destekleyen teklif akışı.
Observability: Otomatik GenAI OpenTelemetry izlemesiyle düğüm, model ve araç span’lerini, metrikleri ve logları Application Insights’a gönderen enstrümante ajan.
Resilient Long Running Agent: Kalıcı checkpoint, arka plan yanıtları, yeniden oynatılabilir akış, insan onayı, yönlendirme, kurtarma ve iptal destekli çökmeye dayanıklı seyahat planlama ajanı.
Custom Host: Özel bir ResponsesHostServer ile locale başlıklarını ve özel konum mesajlarını destekleyen, standart Responses davranışını koruyan konum farkındalıklı sohbet ajanı.

Invocations protokolü üzerinden çalışanlar ise Basic Chat (LangGraph checkpointer ile oturum durumu), Resilient Long Running Agent (arka plan invocation’ları, çok turlu oturum, onay, kurtarma ve iptal) ve Custom Host (InvocationsHostServer ile locale desteği) şablonları.

azd’ye yeni başlayanlar için

azd, uygulamanızı yerel geliştirme ortamından Azure’a daha hızlı taşımanıza yardımcı olan açık kaynaklı bir komut satırı aracı. İş akışınızın temel aşamalarına karşılık gelen geliştirici dostu komutlar sunuyor, terminalde de editörünüzde de sürekli entegrasyon ve teslim (CI/CD) hatlarında da çalışabiliyor. Şablonlar için Awesome azd galerisi ve AI App Templates koleksiyonu, sorun giderme için resmi dokümantasyon ve GitHub deposu başlangıç noktası olarak öneriliyor.

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ÇYazar

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.

YouTube GitHub

Azure Developer CLI 1.34: azure.yaml Katmanları ve

Öne çıkan değişiklikler

Uzantı yönetimi olgunlaşıyor

Proje yapılandırması ve dağıtım

Kimlik doğrulama ve şablon güvenliği