Functions on Azure Container Apps V1’den Functions on Azure Container Apps V2’ye geçiş yapma

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=functionapp ile 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

  1. Mevcut dağıtımınızın bir Functions on Azure Container Apps V1 uygulaması olduğunu belirleyin.
  2. 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.
  3. Ortam kotalarını (CPU, bellek, maksimum örnekler) gözden geçirin ve gerekirse ayarlayın.
  4. Kayıt defterinizde görüntü kullanılabilirliğini onaylayın.

2. Azure Container Apps üzerinde bir Functions V2 uygulaması oluşturun

  1. Azure Container Apps ortamı oluşturma veya yeniden kullanma.

  2. 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>
    
  3. Gizli diziler, ortam değişkenleri, kimlik, ağ gibi yapılandırma ayrıntılarını yeniden uygulayın.

  4. Gerekirse kimlik doğrulamasını veya özel etki alanını etkinleştirin.

  5. Ölçeklendirme kurallarını tanımlayın (HTTP, CPU, kuyruk tetikleyicisi bağıntısını uygun şekilde).

3. Doğrulama

  1. HTTP ile tetiklenen işlevleri (curl veya tarayıcı) çağırma.

  2. Her tetikleyici türünü test edin (Event Hubs, Service Bus, zamanlayıcı).

  3. Application Insights telemetrisini ve Log Analytics günlüklerini onaylayın.

  4. Yük altında ölçeklendirme davranışını kontrol edin (otomatik ölçeklendirme kuralları çalışıyor).

  5. Gizli anahtarların ve bağlantı dizelerinin doğru çözüldüğünü doğrulayın.

  6. 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ı)

  1. Özel bir alan adı kullanıyorsanız, onu yeni Functions on Azure Container Apps V2 ana adıyla (CNAME veya A kaydı) eşleyin.

  2. SSL/TLS sertifikalarını yeniden bağlama (yönetilen veya karşıya yüklenen).

  3. Alan adı çözümlemeyi ve TLS el sıkışmasını test edin.

  4. Uç nokta değişikliklerini dahili olarak iletme.

5. Geçiş

  1. Üretim trafiğini kaydırma (DNS TTL veya yönlendirme kurallarını güncelleştirme).

  2. Gecikme süresini, hataları ve çağırma sayılarını izleyin.

  3. Gerekirse ölçeklendirme parametrelerini ayarlayın (bekleme süresi, minimum/maksimum örnekler).

  4. İlk birkaç saat içinde anomaliler için günlükleri izleyin.

6. Temizleme

  1. 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.

  2. Kullanılmayan gizli bilgileri veya depolama referanslarını kaldırın.

  3. İç 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: