Azure İşlevleri dil yığını sürümlerini güncelleştirme

Azure İşlevleri'nde dil yığını desteği belirli sürümler ile sınırlıdır. Yeni sürümler kullanıma sunuldukçe, işlev uygulamalarınızı yeni özelliklerden yararlanacak şekilde güncelleştirmek isteyebilirsiniz. İşlevler'deki destek eski sürümler için de sona erer ve genellikle topluluk destek sonu zaman çizelgeleriyle uyumlu hale gelir. Daha fazla bilgi için dil çalışma zamanı destek ilkesine bakın. Çeşitli dillerin desteklenen sürümleri için bkz. Çalışma zamanı sürümüne göre diller.

İşlev uygulamalarınızın destek almaya devam ettiğinden emin olmak için bu makaledeki yönergeleri izleyerek bunları kullanılabilir en son sürümlere güncelleştirin. İşlev uygulamanızı güncelleştirme yönteminiz çeşitli faktörlere bağlıdır:

  • İşlev uygulamalarınızı geliştirmek için kullandığınız dil. Bu makalenin en üstünde programlama dilinizi seçtiğinizden emin olun.
  • İşlev uygulamanızın Azure'da çalıştığı işletim sistemi: Windows veya Linux.
  • Barındırma planı.

Not

Bu makalede , yalıtılmış çalışan modelini kullanan bir işlev uygulamasının .NET sürümünü güncelleştirme işlemi gösterilmektedir. Fonksiyon uygulamanız süreç modelini kullanıyorsa, 10 Kasım 2026'dan önce süreçteki modelden izole çalışan modeline geçiş yapmanız gerekir.

İşlev uygulamanızı hazırlama

Azure'da işlev uygulamanızın yığın yapılandırmasını güncelleştirmeden önce aşağıdaki bölümlerde yer alan görevleri tamamlayın.

Bağımlılıkları gözden geçirme

Dil sürümlerini güncelleştirmeden önce şu olası bağımlılıkları gözden geçirin:

  • Uzantı paketleri: Dosyanızın host.json uyumlu bir uzantı paketi sürümüne başvurduğunu doğrulayın. Çoğu senaryo için sürüm 4.x paketleri önerilir.

  • Bağlama uzantıları: Açık bağlama uzantısı başvurularını yeni dil sürümünüzle uyumlu sürümlere güncelleştirin.

  • Paket bağımlılıkları: Tüm paket bağımlılıklarını gözden geçirin ve hedef dil sürümünüzü destekleyen sürümlerle güncelleştirin.

  • Yerel araçlar: Azure İşlevleri Temel Araçları, SDK'lar ve IDE'ler gibi yerel geliştirme araçlarınızın yeni dil sürümünü desteklediğinden emin olun.

İşlev uygulamanızı yerel olarak doğrulama

İşlev uygulama kodunuzu yeni hedef sürümde yerel olarak test edin ve doğrulayın.

Projeyi yerel bilgisayarınızda güncelleştirmek için şu adımları kullanın:

  1. .NET SDK'sının hedef sürümünün yüklendiğinden emin olun.

    Önizleme sürümünü hedef alıyorsanız sürümün desteklendiğinden emin olmak için .NET sürümlerini önizlemeye yönelik işlevler kılavuzuna bakın. .NET önizlemelerini kullanmak için daha fazla adım gerekebilir.

  2. Başvurularınızı Microsoft.Azure.Functions.Worker ve Microsoft.Azure.Functions.Worker.Sdk'nın en son sürümlerine güncelleştirin.

  3. Projenizin hedef çerçevesini yeni sürüme güncelleştirin. C# projelerinde, <TargetFramework> dosyasındaki öğesini güncellemeniz gerekir. Sürümünüz hakkında daha fazla bilgi için Hedef çerçeveler bölümüne bkz.

    Projenizin hedef çerçevesini değiştirmek için araç zincirinizin bazı bölümlerinde, proje kodunun dışında değişiklikler yapılması da gerekebilir. Örneğin, Visual Studio Code'da kullanıcı ayarlarınızda veya projenizin azureFunctions.deploySubpath dosyasında uzantı ayarını güncelleştirmeniz gerekebilir. Derleme adımlarının veya sürekli tümleştirme ve sürekli dağıtım (CI/CD) ardışık düzeninin bir parçası olarak, proje kodunuzun dışında bulunan çerçeve sürümüne yönelik tüm bağımlılıkları kontrol edin.

  4. Proje kodunuzda yeni .NET sürümünün gerektirdiği tüm güncelleştirmeleri yapın. Belirli bilgiler için sürümün sürüm notlarını denetleyin. Ana sürümlerdeki değişikliklere yanıt olarak kodunuzu güncelleştirmenize yardımcı olması için .NET Yükseltme Yardımcısı'nı da kullanabilirsiniz.

Bu değişiklikleri yaptıktan sonra projenizi yeniden derleyin ve işlev uygulamanızın beklendiği gibi çalıştığını onaylamak için test edin.

En son İşlevler çalışma zamanına geçiş yapın

İşlev uygulamanızın İşlevler çalışma zamanının en son sürümünde (sürüm 4.x) çalıştığından emin olun. Azure portalında veya Azure CLI kullanarak çalışma zamanı sürümünü belirleyebilirsiniz.

İşlevler çalışma zamanı sürümünüzü belirlemek için şu adımları kullanın:

  1. Azure portalında işlev uygulamanızı bulun ve seçin. Yan menüde Ayarlar>Yapılandırması'nı seçin.

  2. İşlev çalışma zamanı ayarları sekmesine gidin ve Çalışma zamanı sürüm değerini denetleyin. İşlev uygulamanız İşlevler çalışma zamanının (~4 ) 4.x sürümünde çalıştırılmalıdır.

İşlev uygulamanızı 4.x sürümüne güncelleştirmeniz gerekiyorsa bkz. Uygulamaları Azure İşlevleri sürüm 1.x'ten sürüm 4.x'egeçirme veya Uygulamaları Azure İşlevleri sürüm 3.x'ten sürüm 4.x'e geçirme. Yalnızca FUNCTIONS_EXTENSION_VERSION ayarını değiştirmek yerine, bu makalelerdeki yönergeleri izleyin.

İşlev uygulaması güncelleştirmelerini yayımlama

İşlev uygulamanızı yeni sürümde doğru çalışacak şekilde güncelleştirdiyseniz, işlev uygulamanızın yığın yapılandırmasını güncelleştirmeden önce işlev uygulaması güncelleştirmelerini yayımlayın.

İpucu

Güncelleme işlemini kolaylaştırmak, işlev uygulamalarınızda kapalı kalma süresini en aza indirmek ve geri döndürme için olası bir sürüm sağlamak amacıyla güncellenmiş işlev uygulamanızı bir hazırlık yuvasına yayımlayın. Daha fazla bilgi için bkz: Azure İşlevleri dağıtım yuvaları.

Güncelleştirilmiş işlev uygulamanızı bir hazırlama yuvasında yayımladığınızda, bu makalenin geri kalanındaki yuvaya özgü güncelleştirme yönergelerini izlediğinizden emin olun. Daha sonra güncelleştirilmiş hazırlama yuvasını üretime değiştirirsiniz.

Slotları kullanmayı göz önünde bulundurun

İşlev uygulamanızın dil sürümünü güncelleştirmeden önce, test ve dağıtım için kullanılacak bir dağıtım yuvası oluşturun. Bu yaklaşım kapalı kalma süresini en aza indirir ve sorun oluşursa kolay bir geri alma seçeneği sağlar. Bu makaledeki örneklerde staging adlı bir hazırlama yuvası kullanılır.

Esnek Tüketim planı: Slotlar şu anda desteklenmemektedir. Önce güncelleştirilmiş kodunuzu üretim dışı bir işlev uygulamasında doğrulamanız gerekir. Çalışan bir uygulamaya dağıtım yaparken sıralı güncelleştirme stratejisini kullanabilirsiniz. Daha fazla bilgi için bkz . Esnek Tüketimde site güncelleştirme stratejileri.

Önemli

Sıralı güncelleştirme stratejisi genellikle Doğu Asya, Orta Batı ABD, Orta Kuzey ABD ve Batı ABD 2'de kullanılabilir. Sonraki haftalarda diğer tüm bölgelere dağıtım devam etmektedir. Bu stratejiyi etkinleştirmeden önce sınırlamaları ve dikkate alınacak noktaları gözden geçirin.

Yığın yapılandırmasını güncelleştir

Yığın yapılandırmasını güncelleştirme yönteminiz, işlev uygulamanızın Windows'da mı yoksa Azure'da Linux'ta mı çalıştığına bağlıdır.

Hazırlık yuvası kullandığınızda, güncellemelerinizin doğru hazırlık yuvasına hedeflendiğinden emin olun.

Java sürümünü güncelleştirmek için aşağıdaki adımları kullanın:

  1. Azure portalında işlev uygulamanızı bulun ve seçin. Yan menüde Ayarlar>Yapılandırması'nı seçin. Aşama yuvanız varsa, belirli bir yuvası seçin.

  2. Genel ayarlar sekmesinde Java Sürümünü istediğiniz sürüme güncelleştirin.

  3. Kaydetseçeneğini seçin. Yeniden başlatma hakkında bildirim aldığınızda Devam'ı seçin.

.NET sürümünü güncelleştirmek için aşağıdaki adımları kullanın:

  1. Azure portalında işlev uygulamanızı bulun ve seçin. Yan menüde Ayarlar>Yapılandırması'nı seçin. Aşama yuvanız varsa, belirli bir yuvası seçin.

  2. Genel ayarlar sekmesinde .NET Sürümünü istediğiniz sürüme güncelleştirin.

  3. Kaydetseçeneğini seçin. Yeniden başlatma hakkında bildirim aldığınızda Devam'ı seçin.

Node.js sürümünü güncelleştirmek için aşağıdaki adımları kullanın:

  1. Azure portalında işlev uygulamanızı bulun ve seçin. Yan menüde Ayarlar>Yapılandırması'nı seçin. Aşama yuvanız varsa, belirli bir yuvası seçin.

  2. Genel ayarlar sekmesinde ,Node.js Sürümünü istediğiniz sürüme güncelleştirin.

  3. Kaydetseçeneğini seçin. Yeniden başlatma hakkında bildirim aldığınızda Devam'ı seçin. Bu değişiklik uygulama ayarını güncelleştirir WEBSITE_NODE_DEFAULT_VERSION .

PowerShell sürümünü güncelleştirmek için aşağıdaki adımları kullanın:

  1. Azure portalında işlev uygulamanızı bulun ve seçin. Yan menüde Ayarlar>Yapılandırması'nı seçin. Aşama yuvanız varsa, belirli bir yuvası seçin.

  2. Genel ayarlar sekmesinde PowerShell Core Sürümünü istediğiniz sürüme güncelleştirin.

  3. Kaydetseçeneğini seçin. Yeniden başlatma hakkında bildirim aldığınızda Devam'ı seçin.

Portal, Windows'da Python uygulamalarını desteklemez. Bunun yerine Linux sekmesine gidin.

Sürümü güncelleştirdikten sonra işlev uygulamanız yeniden başlatılır.

Not

Yeniden başlatma sırasında işlev uygulamanız kısa bir süre (genellikle 30-60 saniye) kullanılamaz. Bir üretim işlevi uygulamasını doğrudan güncelleştirirseniz (hazırlama yuvası kullanmadan), bakım zaman dilimi sırasında kapalı kalma süresini göz önünde bulundurarak plan yapın. Yeniden başlatma, tüm uçuş içi istekleri sonlandırır ve uygulama başarıyla yeniden başlatılana kadar yeni istekler başarısız olur.

Güncellemeyi doğrulayın

İşlev uygulamanız yeniden başlatıldıktan sonra dil sürümü güncelleştirmesinin başarılı olduğunu doğrulayın.

  1. Azure portalında işlev uygulamanızı bulun ve seçin. Yan menüde Ayarlar>Yapılandırması'nı seçin.

  2. Genel ayarlar sekmesinde, dil sürümünün seçtiğiniz yeni sürümü görüntülediğini doğrulayın.

  3. Yan menüden Genel Bakış'ı seçin ve Durum'unÇalışıyor olarak gösterildiğini onaylayın.

Sürümü doğruladıktan sonra işlevlerinizin beklendiği gibi çalıştığını da doğrulayın.

Yuvaları değiştir

Eğer kod projenizi dağıtmak ve ayarlarınızı güncellemek için bir hazırlama yuvası kullanıyorsanız, hazırlama yuvasını üretimle değiştirin. Daha fazla bilgi için bkz. Yuva değiştirme.

Sorun giderme

Dil sürümünü güncelleştirdikten sonra sorunlarla karşılaşırsanız, yaygın sorunları çözmek için aşağıdaki kılavuzu kullanın:

İşlev uygulaması başlatılmıyor

Belirti -leri: İşlev uygulaması durumu Durduruldu veya sürekli yeniden başlatıyor olarak gösterilir.

Çözümler:

  1. Azure portalında uygulama günlüklerini denetleyin:

    • İşlev uygulamanıza gidin ve İzleme>Günlük akışı seçeneğini tıklayın.
    • Çalışma zamanı veya dil sürümü uyuşmazlıklarıyla ilgili hata iletilerini arayın.

  2. Tüm bağımlılıkların yeni dil sürümüyle uyumlu olduğunu doğrulayın:

    • .NET için NuGet paketlerinin hedef çerçeveyi desteklediğinden emin olun.
    • Python için içindeki paket sürümlerinin requirements.txt uyumlu olup olmadığını denetleyin.
    • Node.js için bağımlılıkların yeni Node sürümünü desteklediğini doğrulayın package.json.

  3. Dosyanızdaki host.json denetleyin. Eski paketler daha yeni dil sürümlerini desteklemeyebilir.

İşlevler çalışma zamanı hatalarıyla başarısız olur

Belirti -leri: Tek tek işlevler tetiklendiğinde başarısız olur ve günlüklerdeki hatalar oluşur.

Çözümler:

  1. Dil sürümünüz için uyumsuzluk yaratan değişiklikleri gözden geçirin.

  2. Bağlama uzantılarını yeni dil sürümünüzle uyumlu sürümlere güncelleştirin.

  3. Yeniden dağıtmadan önce işlevleri yeni dil sürümüyle yerel olarak test edin.

Uzantı sürümü çakışmaları

Belirtiler: "Uzantı" veya "bağlama" sürümü uyumsuzluğundan bahseden hatalar.

Çözümler:

  1. içindeki host.json sürümünü 4.x veya sonraki bir sürüme güncelleştirin.

    {
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

  2. Açık uzantı başvuruları kullanan .NET projeleri için tüm Microsoft.Azure.WebJobs.Extensions.* paketleri en son sürümlerine güncelleştirin.

Güncelleştirmeyi geri döndürme

Önceki dil sürümüne geri dönmeniz gerekiyorsa:

  1. Hazırlama yuvası kullandıysanız:

    • Hazırlama yuvasını üretime geri değiştirin.
    • Sonraki denemeler için hazırlık yuvasını eski sürüme döndürün.

  2. Üretimi doğrudan güncellediyseniz:

    • Bu makaledeki aynı güncelleştirme adımlarını izleyin, ancak önceki dil sürümünüzü belirtin.
    • Önceki kod sürümünüzü yeniden dağıt.

  3. İşlev uygulamanızı izleyerek normal çalışmaya geri döndüğünden emin olun.

İpucu

Sorunlardan kaçınmak için, dil sürümü güncelleştirmelerini üretime uygulamadan önce her zaman bir hazırlama yuvasında test edin. Değişiklik yapmadan önce işlev uygulaması yapılandırmanızın yedeğini oluşturun.

İlgili içerik

Java geliştirici kılavuzu

C# yalıtılmış çalışan işlemi kılavuzu

Node.js geliştirici kılavuzu

Python geliştirici kılavuzu

PowerShell geliştirici kılavuzu

Go geliştirici referansı

  • Last updated on