Azure İşlevleri çalışma zamanı sürümlerini karşılaştırma

Azure İşlevleri halen iki çalışma zamanı ortamı sürümünü desteklemektedir. Aşağıdaki tabloda şu anda desteklenen çalışma zamanı sürümleri, destek düzeyleri ve bunların ne zaman kullanılacağı açıklanmaktadır:

Sürüm Destek düzeyi Açıklama
4.x Georgia Tüm dillerdeki işlevler için önerilen çalışma zamanı sürümü.Desteklenen dil sürümleri'ne göz atın.
1.x GA* Yalnızca .NET Framework kullanması gereken C# uygulamaları için desteklenir. Bu sürüm bakım modundadır ve iyileştirmeler yalnızca sonraki sürümlerde sağlanır. 1.x sürümü desteği 14 Eylül 2026'da sona erer.Uygulamalarınızı 4.x sürümüne geçirin. Daha fazla bilgi için bkz. Desteklenen dil sürümleri.

* Destek 14 Eylül 2026'da sona erer. Daha fazla bilgi için bkz. sürüm 1.x destek duyurusu.

Azure İşlevleri şu anda çalışma zamanı ana bilgisayarının yalnızca 4.x sürümünü desteklemektedir.

Önemli

Azure İşlevleri çalışma zamanının 2.x ve 3.x sürümleri artık desteklenmiyor. Daha fazla bilgi için bkz . Kullanımdan kaldırılacak sürümler.

Önemli

Tüketim planında Linux'ta kullanım süresi sonu v3 çalışma zamanını çalıştırmaya devam eden işlev uygulamaları 30 Eylül 2026'dan sonra çalışmayı durduruyor. Hizmet kesintisini önlemek için uygulamanızı v4 çalışma zamanına geçirin.

Tüketim planında Linux'ta işlev uygulamaları barındırma seçeneği 30 Eylül 2028'de kullanımdan kaldırılıyor. Linux Tüketim planı yeni özellikler veya dil sürümleri almayacak. Tüketim planında Windows çalışan uygulamalar şu anda etkilenmez. Uygulamalarınızı kullanımdan kaldırma tarihinden önce Esnek Tüketim planına geçirin.

Azure İşlevleri sürüm 3.x'ten 4.x sürümüne uygulamaları dağıtabilirsiniz.

Destek düzeyleri

İki destek düzeyi vardır:

  • Genel kullanıma açık (GA) - Üretim kullanımı için tam olarak desteklenir ve onaylanmıştır.
  • Önizleme - Henüz desteklenmiyor, ancak gelecekte GA durumuna ulaşması bekleniyor.

Diller

İşlev uygulamasındaki tüm işlevlerin aynı dili paylaşması gerekir. Uygulamayı oluştururken işlev uygulamanızda işlevlerin dilini seçin. İşlev uygulamanızın dili FUNCTIONS_WORKER_RUNTIME ayarında tutulur ve mevcut işlevler olduğunda değiştirilemez.

Makalenin üst kısmında tercih ettiğiniz geliştirme dilini seçtiğinizden emin olun.

Aşağıdaki tabloda, Azure İşlevleri tarafından desteklenen .NET sürümleri gösterilmektedir.

desteklenen .NET sürümü hem İşlevler çalışma zamanı sürümünüz hem de seçtiğiniz yürütme modelinize bağlıdır.

İşlev uygulama kodunuz ayrı bir .NET çalışan işleminde çalışır. .NET ve .NET Framework desteklenen sürümlerle kullanın. Daha fazla bilgi için bkz. yalıtılmış çalışan modelinde C# Azure İşlevleri çalıştırmak için Guide.

Desteklenen sürüm Destek düzeyi Beklenen destek sonu tarihi
.NET 10 Georgia 14 Kasım 2028
.NET 9 Georgia 10 Kasım 20261
.NET 8 Georgia 10 Kasım 2026
.NET Framework 4.8.1 Georgia Bkz. .NET Framework Destek İlkesi

1 .NET 9, daha önce 12 Mayıs 2026'da beklenen bir destek sonu tarihine sahipti. .NET 9 hizmet penceresinde, .NET ekibi STS sürümleri için desteği .NET 9 ile başlayarak 24 aya uzattı. Daha fazla bilgi için blog gönderisine bakın.

Uyarı

.NET 9, Linux Tüketim planı uygulamaları için desteklenen son .NET sürümüdür. Linux Kullanım Planına daha yeni .NET sürümleri eklenmez. Daha fazla bilgi için bkz . Tüketim planı uygulamalarını Esnek Tüketim planına geçirme.

.NET 6, November 12, 2024 tarihinde resmi desteğin sonuna ulaştı.

.NET 7, May 14, 2024 tarihinde resmi desteğin sonuna ulaştı.

Daha fazla bilgi için bkz. yalıtılmış çalışan modelinde C# Azure İşlevleri çalıştırmak için Guide.

Aşağıdaki tabloda, Java işlev uygulamaları için desteklenen dil sürümleri gösterilmektedir:

Desteklenen sürüm Destek düzeyi Desteklenme süresi sonuna kadar
Java 25 Georgia Mayıs 2029
Java 21 Georgia Eylül 2028
Java 17 Georgia Eylül 2027
Java 11 Georgia Eylül 2027
Java 8 Georgia Eylül 2027

Uyarı

Java 21, Linux Tüketim planı uygulamaları için desteklenen son Java sürümüdür. Linux Tüketimi'ne daha yeni Java sürümleri eklenmez. Daha fazla bilgi için bkz . Tüketim planı uygulamalarını Esnek Tüketim planına geçirme.

Java işlev uygulamalarını geliştirme ve çalıştırma hakkında daha fazla bilgi için bkz. Azure İşlevleri Java geliştirici kılavuzu.

Aşağıdaki tabloda, Node.js işlev uygulamaları için desteklenen dil sürümleri gösterilmektedir:

Desteklenen sürüm Destek düzeyi Beklenen destek sonu tarihi
Node.js 24 Preview 30 Nisan 2028
Node.js 22 Georgia 30 Nisan 2027
Node.js 20 Georgia 30 Nisan 2026

TypeScript, JavaScript'e dönüştürme yoluyla desteklenir. Daha fazla bilgi için bkz. Azure İşlevleri Node.js geliştirici kılavuzu.

Uyarı

Node.js 22, Linux Tüketim planı uygulamaları için desteklenen son Node.js sürümüdür. Linux Tüketimi'ne daha yeni Node.js sürümleri eklenmez. Daha fazla bilgi için bkz . Tüketim planı uygulamalarını Esnek Tüketim planına geçirme.

Aşağıdaki tabloda PowerShell işlev uygulamaları için desteklenen dil sürümü gösterilmektedir:

Desteklenen sürüm Destek düzeyi Beklenen destek sonu tarihi
PowerShell 7.4 Georgia 10 Kasım 2026

Uyarı

PowerShell 7.4, Linux Tüketim planı uygulamaları için desteklenen son PowerShell sürümüdür. Linux Tüketimi'ne daha yeni PowerShell sürümleri eklenmez. Daha fazla bilgi için bkz . Tüketim planı uygulamalarını Esnek Tüketim planına geçirme.

Daha fazla bilgi için bkz. Azure İşlevleri PowerShell geliştirici kılavuzu.

Aşağıdaki tabloda, Python işlev uygulamaları için desteklenen dil sürümleri gösterilmektedir:

Desteklenen sürüm Destek düzeyi Beklenen destek sonu tarihi
Python 3.142 Preview Bekleyen1
Python 3.13 Georgia Ekim 2029
Python 3.12 Georgia Ekim 2028
Python 3.11 Georgia Ekim 2027
Python 3.10 Georgia Ekim 2026

1 Genel kullanılabilirlik (GA) bildirildiğinde Python 3.14 için destek sonu tarihi belirlenir. 2 Python 3.14 için uzaktan derleme desteği, esnek tüketim planında çalışırken henüz sağlanmamıştır.

Uyarı

Python 3.12, Linux Tüketim planı uygulamaları için desteklenen son Python sürümüdür. Linux Tüketimi'ne daha yeni Python sürümleri eklenmez. Daha fazla bilgi için bkz . Tüketim planı uygulamalarını Esnek Tüketim planına geçirme.

Daha fazla bilgi için bkz. Azure İşlevleri Python geliştirici kılavuzu.

Dil desteğinde planlanan değişiklikler hakkında bilgi için bkz. Azure yol haritası güncelleştirmeleri.

Daha önce desteklenen İşlevler çalışma zamanı sürümlerinin dil sürümleri hakkında bilgi için bkz . Kullanımdan kaldırılacak çalışma zamanı sürümleri.

Belirli bir sürümde çalıştırma

FUNCTIONS_EXTENSION_VERSION uygulama ayarı, yayımlanan uygulamaların Azure'de kullandığı İşlevler çalışma zamanının sürümünü belirler. Bazı durumlarda ve belirli diller için diğer ayarlar geçerli olabilir.

Varsayılan olarak, Azure portalında, Azure CLI veya Visual Studio araçlarından oluşturulan işlev uygulamaları 4.x sürümüne ayarlanır. Gerekirse bu sürümü değiştirebilirsiniz. İşlev uygulamanızı oluşturduktan sonra ancak herhangi bir işlev eklemeden önce çalışma zamanı sürümünü yalnızca 1.x sürümüne düşürebilirsiniz. Mevcut işlevleri olan uygulamalarla bile daha sonraki bir ana sürüme güncelleştirebilirsiniz.

Mevcut işlev uygulamalarını geçirme

Uygulamanızın mevcut işlevleri olduğunda, daha sonraki bir ana çalışma zamanı sürümüne geçmeden önce önlem almanız gerekir. Aşağıdaki makaleler, dile özgü uyumluluk bozan değişiklikler de dahil olmak üzere ana sürümler arasındaki uyumluluk bozan değişiklikleri ayrıntılı olarak açıklar. Ayrıca, mevcut işlev uygulamanızın başarılı bir şekilde geçirilmesi için size adım adım yönergeler sağlar.

Azure'da uygulamaların sürümünü değiştirme

Aşağıdaki ana çalışma zamanı sürüm değerleri kullanılır:

Değer Çalışma zamanı hedefi
~4 4.x
~1 1.x

Önemli

Bu uygulama ayarını rastgele değiştirmeyin, çünkü diğer uygulama ayarlarında ve işlev kodunuzda değişiklikler yapmanız gerekebilir. Mevcut işlev uygulamaları için geçiş yönergelerini izleyin.

Belirli bir ikincil sürüme sabitle

İşlev uygulamanızın en son ana sürümde çalışırken karşılaşabileceği sorunları çözmek için uygulamanızı geçici olarak belirli bir ikincil sürüme sabitlemeniz gerekir. Sabitleme, uygulamanızın en son ana sürümde sorunsuz çalışabilmesi için size zaman tanır. Alt sürüme sabitleme şekli, Windows ve Linux arasında farklıdır. Daha fazla bilgi edinmek için bkz. Azure İşlevleri çalışma zamanı sürümlerini hedefleme.

Eski ikincil sürümler, İşlevler'den düzenli aralıklarla kaldırılır. Belirli eski ikincil sürümlerin kaldırılması dahil olmak üzere Azure İşlevleri sürümleri hakkında en son haberler için Azure App Service duyurularını izleyin.

En düşük uzantı sürümleri

Bağlama uzantısı sürümleri ile İşlevler çalışma zamanı sürümü arasında teknik olarak bir bağıntı yoktur. Ancak, sürüm 4.x'den başlayarak İşlevler çalışma zamanı tüm tetikleyici ve bağlama uzantıları için en düşük sürümü zorlar.

Gerekli en düşük sürüme uymayan bir paket hakkında uyarı alırsanız, bu NuGet paketini normalde yaptığınız gibi en düşük sürüme güncelleştirmeniz gerekir. bağlı yapılandırma dosyası 'da İşlevler v4.x'te kullanılan uzantılar için en düşük sürüm gereksinimlerini bulun.

C# komut dosyası için host.json uzantı paketi başvurusunu güncelleştirin:

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

Uzantı paketi sürümleri ile İşlevler çalışma zamanı sürümü arasında teknik olarak bir bağıntı yoktur. Ancak, 4.x sürümünden başlayarak İşlevler çalışma zamanı, uzantı paketleri için en düşük sürümü zorunlu bırakır.

Uzantı paketi sürümünüzün gerekli en düşük sürüme uymadığı konusunda bir uyarı alırsanız, host.json mevcut uzantı paketi başvurunuzu aşağıdaki gibi güncelleştirin:

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

Uzantı paketleri hakkında daha fazla bilgi edinmek için bkz. Uzantı paketleri.

Kullanımdan kaldırılacak sürümler

Önemli

Support, Azure İşlevleri çalışma zamanının 1.x sürümü için 14 Eylül 2026 tarihinde sona erecektir. Tam destek için uygulamalarınızı 4.x sürümüne geçirmenizi kesinlikle öneririz.

İşlevler çalışma zamanının bu sürümleri 13 Aralık 2022'de genişletilmiş desteğin sonuna ulaşmıştır.

Sürüm Geçerli destek düzeyi Önceki destek düzeyi
3.x Destek kapsamı dışında Georgia
2.x Destek kapsamı dışında Georgia

Tam destek almak için uygulamalarınızı en kısa sürede sürüm 4.x'e geçirin. Belirli diller için tam bir geçiş yönergeleri seti için bkz. Uygulamaları Azure İşlevleri sürüm 4.x'e taşıma.

2.x ve 3.x sürümlerini kullanan uygulamalar CI/CD DevOps işlem hattınızdan oluşturulmaya ve dağıtılmaya devam edebilir ve Linux Tüketimindeki v3 uygulamaları dışında mevcut uygulamalar, 30 Eylül 2026'dan sonra çalışmayı durduracak olan hataya neden olmayan değişiklikler olmadan çalışmaya devam eder. Uygulamalarınız yeni özellikler, güvenlik düzeltme ekleri ve performans iyileştirmeleri için uygun değildir. yalnızca uygulamalarınızı 4.x sürümüne yükseltdikten sonra ilgili hizmet desteği alabilirsiniz.

Yerel olarak geliştirilen uygulama sürümleri

Hedeflenen sürümleri yerel olarak değiştirmek için işlev uygulamalarında aşağıdaki güncelleştirmeleri yapın.

Visual Studio çalışma zamanı sürümleri

Visual Studio'da, proje oluştururken çalışma zamanı sürümünü seçersiniz. Visual Studio için Azure İşlevleri araçları iki ana çalışma zamanı sürümünü destekler. Proje ayarlarına göre hata ayıklama ve yayımlama sırasında doğru sürüm kullanılır. Sürüm ayarları aşağıdaki özelliklerde .csproj dosyasında tanımlanır:

<TargetFramework>net8.0</TargetFramework>
<AzureFunctionsVersion>v4</AzureFunctionsVersion>

Yalıtılmış çalışan modelini kullanıyorsanız hedef çerçeve olarak , net9.0veya net8.0 seçebilirsiniznet48. için net10.0 kullanmayı da seçebilirsiniz. in-process modeli kullanıyorsanız, net8.0 veya net6.0 seçebilirsiniz ve en az Microsoft.NET.Sdk.Functions olarak ayarlanmış 4.4.0 uzantısını eklemeniz gerekir. .NET 10, işlem içi model tarafından desteklenmez; işlem içi modeldeyseniz ve .NET 10 kullanmak istiyorsanız uygulamanızı yalıtılmış çalışan modeline dağıtın.

.NET 6 daha önce yalıtılmış çalışan modelinde ve işlem içi modelde destekleniyordu, ancak November 12, 2024 üzerinde resmi desteğin sonuna ulaştı.

.NET 7 daha önce yalıtılmış çalışan modelinde destekleniyordu ancak May 14, 2024 üzerinde resmi desteğin sonuna ulaştı.

Visual Studio Code ve Azure İşlevleri Temel Araçları

Azure İşlevleri Core Tools komut satırı geliştirme için ve ayrıca Visual Studio Code için Azure İşlevleri uzantısı tarafından kullanılır. Daha fazla bilgi için bkz. Azure İşlevleri Core Tools yükleme.

Visual Studio Code geliştirme için, azureFunctions.projectRuntime kullanıcı ayarını yüklenen araçların sürümüyle eşleşecek şekilde güncelleştirmeniz de gerekebilir. Bu ayar, işlev uygulaması oluşturma sırasında kullanılan şablonları ve dilleri de güncelleştirir.