Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Bu rehberi kullanarak eski Functions on Azure Container Apps V1 hosting modelinden önerilen Functions on Azure Container Apps V2 hosting modeline geçin. Geçişin neden yapıldığını, hangi değişikliklerin yapıldığını ve geçişi en düşük riskle nasıl yürüteceğinizi öğrenirsiniz.
Uyarı
Fonksiyon uygulamalarınızı v1 modelinden v2 modeline taşımak için Azure İşlevleri on Azure Container Apps v1 migration assistant'ı kullanın.
İki dağıtım modeli kullanarak Azure Container Apps'te Azure İşlevleri'ne ev sahipliği yapabilirsiniz:
Azure Container Apps V1 üzerindeki fonksiyonlar: Function App (
Microsoft.Webresource provider) ve perde arkasındaki konteyner uygulaması kullanan eski proxy modeli.Azure Container Apps V2 üzerindeki işlevler:
kind=functionappile tek bir Azure Container App kaynağı (Microsoft.App) oluşturan yerel model.
Azure Container Apps V2'de Functions'a geçtiğinizde, yönetimi basitleştirir, yerel özellikleri açar ve Azure İşlevleri'ın gelecekteki yol haritasıyla uyumlu olursunuz.
Model karşılaştırması
| Area | Azure Container Apps üzerinde Azure İşlevleri V1 (eski) | Azure Container Apps üzerinde Azure Functions V2 (önerilen) |
|---|---|---|
| Kaynak modeli | Gizli bir taşıyıcı uygulamasıyla eşleştirilmiş Ara Sunucu İşlevleri uygulaması | Tek yerel kapsayıcı uygulaması (kind=functionapp) |
| Yerel özellikler (düzeltmeler, gizli bilgiler, sağlık kontrolleri, özel etki alanları, aynı kapsamdaki modüller) |
Desteklenmez | Destekleniyor |
| Ölçeklendirme denetimleri (bekleme süresi, yoklama aralığı) |
Sınırlı | Tüm kapsayıcı uygulama ölçeklendirme seçenekleri |
| Günlük Kaydı ve Sorun Giderme | Dolaylı. Canlı konsol yok | Dolaysız. Canlı günlükleri ve tanılamaları içerir |
| Dapr tümleştirmesi | Bazı yalıtılmış .NET senaryolarında sorunlu | Standart desenlerle desteklenir |
| Kimlik Doğrulaması (Kolay Doğrulama) | Mevcut değil | Mevcut |
| Sertifikalar ve özel etki alanları | Mevcut değil | Mevcut |
| Ölçümler ve uyarı | Temel | Tam yerel ölçümler ve uyarılar |
| Gelecekteki yol haritası (işlev listesi, anahtarlar, çağırma sayısı) |
Planlanmadı | Planned |
| operasyonel karmaşıklık | çift kaynak yönetimi | Tek kaynak |
| Yeni dağıtımlar için önerilir | Hayı | Yes |
Azure Container Apps V1 üzerindeki Functions sınırlamaları
Azure Container Apps V1'deki fonksiyonlar, ölçeklenebilirlik, yönetim ve özelliklerin erişilebilirliğini etkileyen birkaç sınırlamaya sahiptir. Bu kısıtlamaları anlamak, Functions on Azure Container Apps V2'ye geçişin faydalarını netleştirmeye yardımcı olur.
Özellik boşlukları
Aşağıdaki özellikler Azure Container Apps V1 uygulamalarındaki Fonksiyonlar için mevcut değildir:
- Kolay Kimlik Doğrulaması
- Sağlık araştırmaları
- Özel alan adları
- Sepet kapsayıcıları
- Yönetilen sertifikalar
- Kapsayıcı uygulama gizlilik bilgileri
- Ayrıntılı ölçek ayarları
- Çoklu revizyonlu trafik bölme
Sorun giderme kısıtlamaları
Azure Container Apps V1 uygulamalarındaki Functions ile doğrudan konteyner erişimi veya gerçek zamanlı konsol çıktısı yok. Bunun yerine, altyapı tanılaması için Log Analytics ve uygulama günlükleri için Application Insights kullanın.
Dapr entegrasyon problemleri
Dapr ve .NET yalıtılmış İşlevleri, bağımlılık ve başlatma sıralama kısıtlamaları nedeniyle derleme veya çalışma zamanı sırasında çakışabilir.
Azure Container Apps V2 üzerinde Functions’ın Avantajları
Azure Container Apps V2 üzerindeki fonksiyonlar doğrudan bir native container app kaynağı oluşturur. Bu yaklaşım, proxy dolaylılığını ortadan kaldırır ve Azure Container Apps'in tüm yeteneklerini etkinleştirir.
Önemli avantajlar:
- Kimlik boşaltma için Kolay Kimlik Doğrulama'yı etkinleştirin.
- Dayanıklılığı artırmak için sağlık denetimlerini yapılandırın.
- Özel etki alanları ayarlayın ve yönetilen sertifikaları kullanın.
- Tek bir kaynakla operasyonel ek yükü azaltın.
- Gizli verileri yerel olarak depolayın ve yan taşıyıcı kapsayıcıları bağlayın.
- Daha net ölçümler, uyarılar ve canlı günlük akışı elde edin.
- Çok bölümlü dağıtımları kullanın ve trafiği güvenli bir şekilde bölün.
- Ayrıntılı ölçeklendirme kuralları uygulama (yoklama aralığı, bekleme süresi).
Uyarı
Kod değişikliği gerekmez. Mevcut kapsayıcı görüntünüzü yeniden kullanabilirsiniz.
Eski doğrudan görüntü dağıtımı (desteklenmiyor)
Bazı dağıtımlarda standart bir kapsayıcı uygulaması kullanılır ve İşlevler görüntüsü manuel olarak çalıştırılır.
Önemli
Bu yaklaşım desteklenmez. Otomatik ölçeklendirme kuralları yoktur ve işlev listeleme, anahtarlar ve çağrı sayıları gibi Azure Container Apps V2 üzerindeki Functions platformuna gelecek özellikleri almaz.
Öneri: Azure Container Apps V2 üzerindeki Functions'a geçin.
Önkoşullar
Taşımadan önce:
- Azure aboneliği ve kaynak oluşturma izni.
- [Azure CLI](/cli/azure/install-azure-cli-windows?view=azure-cli-latest) en son sürümü yüklü.
- Gerekli uzantılar:
az extension add --name containerapp,az extension add --name functionapp(varsa). - Azure Container Apps V1 dağıtımında Functions tarafından kullanılan konteyner görüntüsüne erişim.
- Ortam değişkenlerinin, gizli dizilerin, depolama bağlamalarının ve ağ ayarlarının envanteri.
Geçiş prosedürü
1. Hazırlama
- Mevcut dağıtımınızın bir Functions on Azure Container Apps V1 uygulaması olduğunu belirleyin.
- Ortam değişkenleri, gizli diziler, bağlantı dizeleri ve özel bağlamalar dahil olmak üzere tüm yapılandırma verilerini dışarı aktarın.
- Ortam kotalarını (CPU, bellek, maksimum örnekler) gözden geçirin ve gerekirse ayarlayın.
- Kayıt defterinizde görüntü kullanılabilirliğini onaylayın.
2. Azure Container Apps üzerinde bir Functions V2 uygulaması oluşturun
Azure Container Apps ortamı oluşturma veya yeniden kullanma.
Aynı görüntüyle yeni bir Functions on Azure Container Apps V2 uygulamasını deploy edin.
az containerapp create \ --name my-func-v2 \ --resource-group <RESOURCE_GROUP_NAME> \ --environment <ENVRONMENT_NAME> \ --image myregistry.azurecr.io/<IMAGE_NAME>:<TAG_NAME> \ --kind functionapp \ --ingress external --target-port <TARGET_PORT>Gizli diziler, ortam değişkenleri, kimlik, ağ gibi yapılandırma ayrıntılarını yeniden uygulayın.
Gerekirse kimlik doğrulamasını veya özel etki alanını etkinleştirin.
Ölçeklendirme kurallarını tanımlayın (HTTP, CPU, kuyruk tetikleyicisi bağıntısını uygun şekilde).
3. Doğrulama
HTTP ile tetiklenen işlevleri (curl veya tarayıcı) çağırma.
Her tetikleyici türünü test edin (Event Hubs, Service Bus, zamanlayıcı).
Application Insights telemetrisini ve Log Analytics günlüklerini onaylayın.
Yük altında ölçeklendirme davranışını kontrol edin (otomatik ölçeklendirme kuralları çalışıyor).
Gizli anahtarların ve bağlantı dizelerinin doğru çözüldüğünü doğrulayın.
Sağlık sondası durumu ve kapsayıcı revizyon ayrıntılarını onaylayın.
4. DNS veya özel etki alanlarını güncelleştirme (isteğe bağlı)
Özel bir alan adı kullanıyorsanız, onu yeni Functions on Azure Container Apps V2 ana adıyla (CNAME veya A kaydı) eşleyin.
SSL/TLS sertifikalarını yeniden bağlama (yönetilen veya karşıya yüklenen).
Alan adı çözümlemeyi ve TLS el sıkışmasını test edin.
Uç nokta değişikliklerini dahili olarak iletme.
5. Geçiş
Üretim trafiğini kaydırma (DNS TTL veya yönlendirme kurallarını güncelleştirme).
Gecikme süresini, hataları ve çağırma sayılarını izleyin.
Gerekirse ölçeklendirme parametrelerini ayarlayın (bekleme süresi, minimum/maksimum örnekler).
İlk birkaç saat içinde anomaliler için günlükleri izleyin.
6. Temizleme
Eski Functions on Azure Container Apps V1 uygulamasını ve ilgili kaynakları devre dışı bırakın.
Dikkat
Silmeden önce, hiçbir üretim trafiğinin hâlâ Functions on Azure Container Apps V1 uç noktasını hedeflemediğini doğrulayın.
Kullanılmayan gizli bilgileri veya depolama referanslarını kaldırın.
İç belgeleri ve operasyonel runbook'ları güncelleştirin.
Doğrulama denetim listesi
| Ürün | Geçme kriterleri |
|---|---|
| Tetikleyiciler çalışır | Yapılandırılan tüm tetikleyiciler başarıyla yürütülür |
| Günlükler ve telemetri | Application Insights çağrıları gösterir; gerçek zamanlı günlük akışı |
| Scaling | Örnek sayısı kural yapılandırmasına göre ayarlanır |
| Kimlik doğrulaması (etkinse) | Korumalı uç noktalar beklenen durum kodlarını döndürür |
| Etki alanları | Özel alan adı geçerli bir sertifikayla çözümlenir |
| Sırlar | Hassas değerler hatasız yüklenir |
operasyonel geliştirmeler (isteğe bağlı)
Geçiş sonrasında güvenilirliği artırın:
- Uyarı kuralları ekleme
- Otomatik ölçeklendirmeyi ayarlama
- Yönetilen kimlik kullanımını zorunlu kılma
- Gizli bilgileri merkezileştirme