Membandingkan versi runtime Azure Functions

Azure Functions saat ini mendukung dua versi host runtime. Tabel berikut merinci versi runtime yang saat ini didukung, tingkat dukungannya, dan kapan menggunakannya:

Versi Tingkat dukungan Deskripsi
4.x GA Versi runtime yang direkomendasikan untuk fungsi dalam semua bahasa.Lihat Versi bahasa yang didukung.
1.x GA* Hanya didukung untuk aplikasi C# yang harus menggunakan .NET Framework. Versi ini dalam mode pemeliharaan, dengan perangkat tambahan yang disediakan hanya dalam versi yang lebih baru. Dukungan berakhir untuk versi 1.x pada 14 September 2026.Migrasikan aplikasi Anda ke versi 4.x. Untuk informasi selengkapnya, lihat versi bahasa yang didukung.

* Dukungan berakhir 14 September 2026. Untuk informasi selengkapnya, lihat pengumuman dukungan versi 1.x.

Azure Functions saat ini hanya mendukung versi 4.x dari host runtime.

Penting

Runtime Azure Functions versi 2.x dan 3.x tidak lagi didukung. Untuk informasi selengkapnya, lihat Versi yang dihentikan.

Penting

Aplikasi fungsi yang masih menggunakan runtime v3 yang sudah mencapai akhir masa pakai di Linux dalam rencana Konsumsi akan berhenti beroperasi setelah 30 September 2026. Untuk menghindari gangguan layanan, migrasikan aplikasi Anda ke runtime v4.

Opsi untuk menghosting aplikasi fungsi di Linux dalam paket Konsumsi akan dihentikan pada 30 September 2028. Paket Konsumsi Linux tidak mendapatkan fitur atau versi bahasa baru. Aplikasi yang berjalan di Windows dalam paket Konsumsi saat ini tidak terpengaruh. Migrasikan aplikasi Anda ke paket Konsumsi Flex sebelum tanggal penghentian.

Migrate aplikasi dari Azure Functions versi 3.x ke versi 4.x.

Tingkat dukungan

Ada dua tingkat dukungan:

  • Ketersediaan umum (GA): Didukung sepenuhnya dan disetujui untuk penggunaan produksi.
  • Pratinjau - Belum didukung, tetapi diharapkan mencapai status GA di masa mendatang.

Bahasa

Semua fungsi dalam aplikasi fungsi harus berbagi bahasa pemrogram yang sama. Pilih bahasa fungsi di aplikasi fungsi saat Anda membuat aplikasi. Bahasa aplikasi fungsi Anda dipertahankan dalam pengaturan FUNCTIONS_WORKER_RUNTIME , dan tidak dapat diubah saat ada fungsi yang ada.

Pastikan untuk memilih bahasa pengembangan pilihan Anda di bagian atas artikel.

Tabel berikut ini memperlihatkan versi .NET yang didukung oleh Azure Functions.

Versi .NET yang didukung tergantung pada versi runtime Functions dan model eksekusi yang Anda pilih.

Kode aplikasi fungsi Anda dijalankan dalam proses pekerja .NET yang terpisah. Gunakan dengan versi .NET dan .NET Framework yang didukung. Untuk informasi selengkapnya, lihat Guide untuk menjalankan Azure Functions C# dalam model pekerja terisolasi.

Versi yang didukung Tingkat dukungan Tanggal akhir dukungan yang diharapkan
.NET 10 GA 14 November 2028
.NET 9 GA 10 November 20261
.NET 8 GA 10 November 2026
.NET Framework 4.8.1 GA Lihat Kebijakan Dukungan .NET Framework

1 .NET 9 sebelumnya memiliki tanggal akhir dukungan yang diharapkan pada 12 Mei 2026. Selama jendela layanan .NET 9, tim .NET memperpanjang dukungan untuk versi STS hingga 24 bulan, dimulai dengan .NET 9. Untuk informasi selengkapnya, lihat posting blog.

Nota

.NET 9 adalah versi .NET terakhir yang didukung untuk aplikasi paket Konsumsi Linux. Versi .NET yang lebih baru tidak ditambahkan ke Konsumsi Linux. Untuk informasi selengkapnya, lihat Memigrasikan aplikasi paket Konsumsi ke paket Konsumsi Flex.

.NET 6 mencapai akhir dukungan resmi pada November 12, 2024.

.NET 7 mencapai akhir dukungan resmi pada May 14, 2024.

Untuk informasi selengkapnya, lihat Guide untuk menjalankan Azure Functions C# dalam model pekerja terisolasi.

Tabel berikut ini memperlihatkan versi bahasa yang didukung untuk aplikasi fungsi Java:

Versi yang didukung Tingkat dukungan Didukung hingga [tanggal/waktu]
Java 25 GA Mei 2029
Java 21 GA September 2028
Java 17 GA September 2027
Java 11 GA September 2027
Java 8 GA September 2027

Nota

Java 21 adalah versi Java terakhir yang didukung untuk aplikasi paket Konsumsi Linux. Versi terbaru Java tidak ditambahkan pada lingkungan Linux Consumption. Untuk informasi selengkapnya, lihat Memigrasikan aplikasi paket Konsumsi ke paket Konsumsi Flex.

Untuk informasi selengkapnya tentang mengembangkan dan menjalankan aplikasi fungsi Java, lihat panduan pengembang Azure Functions Java.

Tabel berikut ini memperlihatkan versi bahasa yang didukung untuk aplikasi fungsi Node.js:

Versi yang didukung Tingkat dukungan Tanggal akhir dukungan yang diharapkan
Node.js 24 Preview 30 April 2028
Node.js 22 GA 30 April 2027
Node.js 20 GA 30 April 2026

TypeScript didukung dengan cara ditranspilasi ke JavaScript. Untuk informasi selengkapnya, lihat panduan pengembang Azure Functions Node.js.

Nota

Node.js 22 adalah versi Node.js terakhir yang didukung untuk aplikasi paket Konsumsi Linux. Versi Node.js yang lebih baru tidak ditambahkan ke Konsumsi Linux. Untuk informasi selengkapnya, lihat Memigrasikan aplikasi paket Konsumsi ke paket Konsumsi Flex.

Tabel berikut ini memperlihatkan versi bahasa yang didukung untuk aplikasi fungsi PowerShell:

Versi yang didukung Tingkat dukungan Tanggal akhir dukungan yang diharapkan
PowerShell 7.4 GA 10 November 2026

Nota

PowerShell 7.4 adalah versi PowerShell terakhir yang didukung untuk aplikasi paket Konsumsi Linux. Versi PowerShell yang lebih baru tidak ditambahkan ke Konsumsi Linux. Untuk informasi selengkapnya, lihat Memigrasikan aplikasi paket Konsumsi ke paket Konsumsi Flex.

Untuk informasi selengkapnya, lihat panduan pengembang Azure Functions PowerShell.

Tabel berikut ini memperlihatkan versi bahasa yang didukung untuk aplikasi fungsi Python:

Versi yang didukung Tingkat dukungan Tanggal akhir dukungan yang diharapkan
Python 3.142 Preview Tertunda1
Python 3.13 GA Oktober 2029
Python 3.12 GA Oktober 2028
Python 3.11 GA Oktober 2027
Python 3.10 GA Oktober 2026

1 Tanggal akhir dukungan untuk Python 3.14 ditentukan ketika ketersediaan umum (GA) dinyatakan. 2 Dukungan build dari jarak jauh untuk Python 3.14 belum tersedia saat berjalan di paket Flex Consumption.

Nota

Python 3.12 adalah versi Python terakhir yang didukung untuk aplikasi paket Konsumsi Linux. Versi Python yang lebih baru belum ditambahkan ke lingkungan konsumsi Linux. Untuk informasi selengkapnya, lihat Memigrasikan aplikasi paket Konsumsi ke paket Konsumsi Flex.

Untuk informasi selengkapnya, lihat panduan pengembang Azure Functions Python.

Untuk informasi tentang perubahan yang direncanakan pada dukungan bahasa, lihat pembaruan peta strategi Azure.

Untuk informasi tentang versi bahasa dari versi runtime Functions yang didukung sebelumnya, lihat Versi runtime yang dihentikan.

Jalankan pada versi tertentu

Pengaturan aplikasi FUNCTIONS_EXTENSION_VERSION menentukan versi runtime Functions yang digunakan oleh aplikasi yang dipublikasikan di Azure. Dalam beberapa kasus dan untuk bahasa tertentu, pengaturan lain mungkin berlaku.

Secara default, aplikasi fungsi yang dibuat di portal Azure, oleh Azure CLI, atau dari alat Visual Studio diatur ke versi 4.x. Anda dapat memodifikasi versi ini jika diperlukan. Anda hanya dapat menurunkan versi runtime ke 1.x setelah membuat aplikasi fungsi Anda, tetapi sebelum menambahkan fungsi apa pun. Anda dapat memperbarui ke versi utama yang lebih baru bahkan dengan aplikasi yang memiliki fungsi yang ada.

Memigrasikan aplikasi fungsi yang ada

Saat aplikasi Anda memiliki fungsi yang ada, Anda harus mengambil tindakan pencegahan sebelum pindah ke versi runtime utama yang lebih baru. Artikel-artikel berikut ini merinci perubahan signifikan antara versi-versi utama, termasuk perubahan signifikan khusus untuk bahasa. Mereka juga memberi Anda instruksi langkah demi langkah untuk keberhasilan migrasi aplikasi fungsi yang ada.

Mengubah versi aplikasi di Azure

Nilai versi runtime utama berikut digunakan:

Nilai Target waktu berjalan
~4 4.x
~1 1.x

Penting

Jangan mengubah pengaturan aplikasi ini secara segan-segan, karena perubahan pengaturan aplikasi lain dan perubahan pada kode fungsi Anda mungkin diperlukan. Untuk aplikasi fungsi yang ada, ikuti instruksi migrasi.

Menyematkan ke versi minor tertentu

Untuk mengatasi masalah yang mungkin terjadi pada aplikasi fungsi saat berjalan pada versi utama terbaru, Anda harus untuk sementara mengunci aplikasi ke versi minor tertentu. Menyematkan memberi Anda waktu untuk memastikan aplikasi berjalan dengan baik pada versi terbaru yang utama. Cara menyematkan ke versi minor berbeda antara Windows dan Linux. Untuk mempelajari selengkapnya, lihat Cara menargetkan versi runtime Azure Functions.

Versi minor yang lebih lama dihapus secara berkala dari Functions. Untuk berita terbaru tentang rilis Azure Functions, termasuk penghapusan versi minor lama tertentu, pantau pengumuman Azure App Service.

Versi ekstensi minimum

Secara teknis tidak ada korelasi antara versi ekstensi pengikatan dan versi runtime Functions. Namun, dimulai dengan versi 4.x, runtime Functions memberlakukan versi minimum untuk semua ekstensi pemicu dan pengikatan.

Jika Anda menerima peringatan tentang paket yang tidak memenuhi versi minimum yang diperlukan, Anda harus memperbarui paket NuGet tersebut ke versi minimum seperti biasa. Temukan persyaratan versi minimum untuk ekstensi yang digunakan dalam Functions v4.x di file konfigurasi tertaut.

Untuk skrip C#, perbarui referensi bundel ekstensi di host.json:

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

Secara teknis tidak ada korelasi antara versi bundel ekstensi dan versi runtime Functions. Namun, dimulai dengan versi 4.x, Functions runtime memberlakukan versi minimum untuk bundel ekstensi.

Jika Anda menerima peringatan tentang versi bundel ekstensi Anda yang tidak memenuhi versi minimum yang diperlukan, perbarui referensi bundel ekstensi yang ada di host.json sebagai berikut:

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

Untuk mempelajari selengkapnya bundel ekstensi, lihat Bundel ekstensi.

Versi yang dihentikan

Versi runtime Functions ini mencapai akhir dukungan yang diperpanjang pada 13 Desember 2022.

Versi Tingkat dukungan saat ini Tingkat dukungan sebelumnya
3.x Tidak didukung lagi GA
2.x Tidak didukung lagi GA

Migrasikan aplikasi Anda ke versi 4.x sesegera mungkin untuk mendapatkan dukungan penuh. Untuk mendapatkan serangkaian instruksi migrasi lengkap yang spesifik untuk setiap bahasa, lihat Migrasikan aplikasi ke Azure Functions versi 4.x.

Aplikasi yang menggunakan versi 2.x dan 3.x masih dapat dibuat dan disebarkan dari alur CI/CD DevOps Anda, dan aplikasi yang ada terus berjalan tanpa melanggar perubahan, kecuali untuk aplikasi v3 di Konsumsi Linux, yang akan berhenti berjalan setelah 30 September 2026. Aplikasi Anda tidak memenuhi syarat untuk fitur baru, patch keamanan, dan pengoptimalan performa. Anda hanya bisa mendapatkan dukungan layanan terkait setelah meningkatkan aplikasi ke versi 4.x.

Versi aplikasi yang dikembangkan secara lokal

Buat pembaruan berikut untuk aplikasi fungsi untuk mengubah versi yang ditargetkan secara lokal.

Visual Studio versi runtime

Di Visual Studio, Anda memilih versi runtime saat membuat proyek. Alat Azure Functions untuk Visual Studio menyediakan dukungan untuk dua versi runtime utama. Versi yang tepat digunakan untuk debugging dan penerbitan berdasarkan pengaturan proyek. Pengaturan versi ditentukan dalam file .csproj di properti berikut:

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

Jika Anda menggunakan model pekerja yang terisolasi, Anda dapat memilih, , net9.0net8.0, atau net48 sebagai kerangka kerja target. Anda juga dapat memilih untuk menggunakan dukungan pratinjau untuk net10.0. Jika Anda menggunakan model in-process , Anda dapat memilih atau , dan Anda harus menyertakan ekstensi dengan nilai paling sedikit . .NET 10 tidak didukung oleh model dalam proses; jika Anda menggunakan model dalam proses dan ingin menggunakan .NET 10, migrate aplikasi Anda ke model pekerja yang terisolasi.

.NET 6 sebelumnya didukung pada model pekerja yang terisolasi dan model dalam proses, tetapi mencapai akhir dukungan resmi pada November 12, 2024.

.NET 7 sebelumnya didukung pada model pekerja terisolasi tetapi mencapai akhir dukungan resmi pada 14 Mei 2024.

Visual Studio Code dan Azure Functions Core Tools

Azure Functions Core Tools digunakan untuk pengembangan baris perintah dan juga oleh ekstensi Azure Functions untuk Visual Studio Code. Untuk informasi selengkapnya, lihat Install Azure Functions Core Tools.

Untuk pengembangan Visual Studio Code, Anda mungkin juga perlu memperbarui pengaturan pengguna untuk azureFunctions.projectRuntime agar sesuai dengan versi alat yang diinstal. Pengaturan ini juga memperbarui pola dasar dan bahasa pemrogram yang digunakan selama pembuatan aplikasi fungsi.