Memperbarui versi tumpukan bahasa di Azure Functions

Artikel
07/06/2024

Dukungan untuk tumpukan bahasa tertentu di Azure Functions terbatas pada versi tertentu. Saat versi baru tersedia, Anda mungkin ingin memperbarui aplikasi untuk memanfaatkan fiturnya. Dukungan dalam Functions juga dapat berakhir untuk versi yang lebih lama, biasanya selaras dengan garis waktu akhir dukungan komunitas. Lihat Kebijakan dukungan runtime bahasa untuk detailnya. Untuk memastikan aplikasi Anda terus menerima dukungan, Anda harus mengikuti instruksi yang diuraikan dalam artikel ini untuk memperbaruinya ke versi terbaru yang tersedia.

Cara Anda memperbarui aplikasi fungsi bergantung pada:

Bahasa yang Anda gunakan untuk menulis fungsi Anda; pastikan untuk memilih bahasa pemrograman Anda di bagian atas artikel.
Sistem operasi tempat aplikasi Anda berjalan di Azure: Windows atau Linux.
Paket hosting.

Catatan

Artikel ini memperlihatkan kepada Anda cara memperbarui versi .NET aplikasi menggunakan model pekerja yang terisolasi. Aplikasi yang berjalan pada versi .NET yang lebih lama dengan model dalam proses dapat diperbarui untuk menargetkan .NET 8, atau dapat bermigrasi dari model dalam proses ke model pekerja yang terisolasi.

Bersiap untuk memperbarui

Sebelum memperbarui konfigurasi tumpukan untuk aplikasi fungsi Anda di Azure, Anda harus menyelesaikan tugas-tugas ini:

1. Verifikasi fungsi Anda secara lokal

Pastikan Anda menguji dan memverifikasi kode fungsi Anda secara lokal pada versi target baru.

Gunakan langkah-langkah ini untuk memperbarui proyek di komputer lokal Anda:

Pastikan Anda telah menginstal versi target .NET SDK.

Jika Anda menargetkan versi pratinjau, lihat panduan Functions untuk pratinjau versi .NET untuk memastikan bahwa versi didukung. Langkah tambahan mungkin diperlukan untuk pratinjau .NET.
Perbarui referensi Anda ke versi terbaru: Microsoft.Azure.Functions.Worker dan Microsoft.Azure.Functions.Worker.Sdk.
Perbarui kerangka kerja target proyek Anda ke versi baru. Untuk proyek C#, Anda harus memperbarui <TargetFramework> elemen dalam .csproj file. Lihat Kerangka kerja target untuk spesifik yang terkait dengan versi yang dipilih.

Mengubah kerangka kerja target proyek Anda mungkin juga memerlukan perubahan pada bagian toolchain Anda, di luar kode proyek. Misalnya, di Visual Studio Code, Anda mungkin perlu memperbarui azureFunctions.deploySubpath pengaturan ekstensi melalui pengaturan pengguna atau file proyek .vscode/settings.json Anda. Periksa dependensi apa pun pada versi kerangka kerja yang mungkin ada di luar kode proyek Anda, sebagai bagian dari langkah build atau alur CI/CD.
Buat pembaruan apa pun untuk kode proyek Anda yang diperlukan oleh versi .NET baru. Periksa catatan rilis versi untuk mengetahui secara spesifik. Anda juga dapat menggunakan Asisten Peningkatan .NET untuk membantu Anda memperbarui kode sebagai respons terhadap perubahan di seluruh versi utama.

Setelah Anda membuat perubahan tersebut, bangun kembali proyek Anda dan uji untuk mengonfirmasi aplikasi Anda berjalan seperti yang diharapkan.

2. Pindah ke runtime Functions terbaru

Pastikan aplikasi fungsi Anda berjalan pada versi terbaru runtime Functions (versi 4.x). Anda dapat menentukan versi runtime baik di portal Azure atau dengan menggunakan Azure CLI.

Portal Azure
Azure CLI

Gunakan langkah-langkah ini untuk menentukan versi runtime Functions Anda:

Di portal Azure, temukan aplikasi fungsi Anda dan pilih Konfigurasi di sisi kiri di bawah Pengaturan.
Pilih tab Pengaturan runtime fungsi dan periksa nilai Versi runtime untuk melihat apakah aplikasi fungsi Anda berjalan pada versi 4.x dari runtime Functions (~4).

Gunakan perintah ini az functionapp config appsettings list untuk memeriksa versi runtime Anda:

az functionapp config appsettings list --name "<FUNCTION_APP_NAME>" --resource-group "<RESOURCE_GROUP_NAME>"

Pengaturan FUNCTIONS_EXTENSION_VERSION mengatur versi runtime. Nilai ~4 berarti bahwa aplikasi fungsi Anda sudah berjalan pada versi minor terbaru dari versi utama terbaru (4.x).

Jika Anda perlu terlebih dahulu memperbarui aplikasi fungsi Anda ke versi 4.x, lihat Memigrasikan aplikasi dari Azure Functions versi 1.x ke aplikasi versi 4.x atau Migrasi dari Azure Functions versi 3.x ke versi 4.x. Anda harus mengikuti instruksi dalam artikel tersebut daripada hanya mengubah FUNCTIONS_EXTENSION_VERSION pengaturan.

Menerbitkan pembaruan aplikasi

Jika Anda memperbarui aplikasi untuk berjalan dengan benar pada versi baru, terbitkan pembaruan aplikasi sebelum memperbarui konfigurasi tumpukan untuk aplikasi fungsi Anda.

Tip

Untuk menyederhanakan proses pembaruan, minimalkan waktu henti untuk fungsi Anda, dan berikan potensi pembatalan, Anda harus memublikasikan aplikasi yang diperbarui ke slot penahapan. Untuk informasi selengkapnya, lihat Slot penyebaran Azure Functions.

Saat menerbitkan aplikasi yang diperbarui ke slot penahapan, pastikan untuk mengikuti instruksi pembaruan khusus slot di sisa artikel ini. Anda kemudian menukar slot penahapan yang diperbarui ke dalam produksi.

Memperbarui konfigurasi tumpukan

Cara Anda memperbarui konfigurasi tumpukan bergantung pada apakah Anda berjalan di Windows atau di Linux di Azure.

Saat menggunakan slot penahapan, pastikan untuk menargetkan pembaruan Anda ke slot yang benar.

Gunakan langkah-langkah berikut untuk memperbarui versi Java:

Di portal Azure, temukan aplikasi fungsi Anda dan pilih Konfigurasi di sisi kiri. Saat menggunakan slot penahapan, pastikan untuk terlebih dahulu memilih slot tertentu.
Di tab Pengaturan umum, perbarui versi Java ke versi yang diinginkan.
Pilih Simpan dan saat diberi tahu tentang hidupkan ulang pilih Lanjutkan.

Gunakan langkah-langkah berikut untuk memperbarui versi .NET:

Di portal Azure, temukan aplikasi fungsi Anda dan pilih Konfigurasi di sisi kiri. Saat menggunakan slot penahapan, pastikan untuk terlebih dahulu memilih slot tertentu.
Di tab Pengaturan umum, perbarui versi .NET ke versi yang diinginkan.
Pilih Simpan dan saat diberi tahu tentang hidupkan ulang pilih Lanjutkan.

Gunakan langkah-langkah berikut untuk memperbarui versi Node.js:

Di portal Azure, temukan aplikasi fungsi Anda dan pilih Konfigurasi di sisi kiri. Saat menggunakan slot penahapan, pastikan untuk terlebih dahulu memilih slot tertentu.
Di tab Pengaturan umum, perbarui versi Node.js ke versi yang diinginkan.
Pilih Simpan dan saat diberi tahu tentang hidupkan ulang pilih Lanjutkan. Perubahan ini memperbarui WEBSITE_NODE_DEFAULT_VERSION pengaturan aplikasi.

Gunakan langkah-langkah berikut untuk memperbarui versi PowerShell:

Di portal Azure, temukan aplikasi fungsi Anda dan pilih Konfigurasi di sisi kiri. Saat menggunakan slot penahapan, pastikan untuk terlebih dahulu memilih slot tertentu.
Di tab Pengaturan umum, perbarui versi .NET ke versi yang diinginkan.
Pilih Simpan dan saat diberi tahu tentang hidupkan ulang pilih Lanjutkan.

Aplikasi Python tidak didukung di Windows. Pilih tab Linux sebagai gantinya.

Catatan

Anda hanya dapat menggunakan portal Azure untuk memperbarui aplikasi fungsi di Linux yang dihosting dalam paket Premium atau paket Khusus (App Service). Untuk aplikasi di Linux yang dihosting dalam paket Konsumsi, Anda harus menggunakan Azure CLI.

Gunakan langkah-langkah berikut untuk memperbarui versi Java:

Di portal Azure, temukan aplikasi fungsi Anda dan pilih Konfigurasi di sisi kiri. Saat menggunakan slot penahapan, pastikan untuk terlebih dahulu memilih slot tertentu.
Di tab Pengaturan umum, perbarui versi Java ke versi yang diinginkan.
Pilih Simpan dan saat diberi tahu tentang hidupkan ulang pilih Lanjutkan.

Gunakan langkah-langkah berikut untuk memperbarui versi .NET:

Di portal Azure, temukan aplikasi fungsi Anda dan pilih Konfigurasi di sisi kiri. Saat menggunakan slot penahapan, pastikan untuk terlebih dahulu memilih slot tertentu.
Di tab Pengaturan umum, perbarui versi .NET ke versi yang diinginkan.
Pilih Simpan dan saat diberi tahu tentang hidupkan ulang pilih Lanjutkan.

Gunakan langkah-langkah berikut untuk memperbarui versi Node.js:

Di portal Azure, temukan aplikasi fungsi Anda dan pilih Konfigurasi di sisi kiri. Saat menggunakan slot penahapan, pastikan untuk terlebih dahulu memilih slot tertentu.
Di tab Pengaturan umum, perbarui versi Node.js ke versi yang diinginkan.
Pilih Simpan dan saat diberi tahu tentang hidupkan ulang pilih Lanjutkan. Perubahan ini memperbarui WEBSITE_NODE_DEFAULT_VERSION pengaturan aplikasi.

Gunakan langkah-langkah berikut untuk memperbarui versi PowerShell:

Di portal Azure, temukan aplikasi fungsi Anda dan pilih Konfigurasi di sisi kiri. Saat menggunakan slot penahapan, pastikan untuk terlebih dahulu memilih slot tertentu.
Di tab Pengaturan umum, perbarui versi .NET ke versi yang diinginkan.
Pilih Simpan dan saat diberi tahu tentang hidupkan ulang pilih Lanjutkan.

Aplikasi Python tidak didukung di Windows. Pilih tab Linux sebagai gantinya.

Di portal Azure, temukan aplikasi fungsi Anda dan pilih Konfigurasi di sisi kiri. Saat menggunakan slot penahapan, pastikan untuk terlebih dahulu memilih slot tertentu.
Di tab Pengaturan umum, perbarui versi Python ke versi yang diinginkan.

Catatan

Anda tidak dapat mengubah versi Python saat berjalan dalam paket Konsumsi.
Pilih Simpan dan saat diberi tahu tentang hidupkan ulang pilih Lanjutkan.

Aplikasi Python tidak didukung di Windows. Pilih tab Linux sebagai gantinya.

Pertama, gunakan az functionapp list-runtimes perintah untuk melihat nilai versi yang didukung untuk bahasa Anda. Kemudian, jalankan az functionapp config set perintah untuk memperbarui versi bahasa aplikasi fungsi Anda:

Jalankan az functionapp list-runtimes perintah untuk melihat nilai versi yang didukung untuk .NET pada model pekerja terisolasi:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'java'].{Version:version}" --output table

az functionapp config set --java-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

az functionapp list-runtimes --os "windows" --query "[?runtime == 'dotnet-isolated'].{Version:version}" --output table

Jalankan az functionapp config set perintah untuk memperbarui versi .NET aplikasi fungsi Anda:

az functionapp config set --net-framework-version "v<VERSION>.0" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

Pertama, gunakan az functionapp list-runtimes perintah untuk melihat nilai versi yang didukung untuk tumpukan bahasa Anda (Node.js). Kemudian, jalankan az functionapp config set perintah untuk memperbarui versi Node.js aplikasi fungsi Anda:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'node'].{Version:version}" --output table

az functionapp config appsettings set --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --settings "WEBSITE_NODE_DEFAULT_VERSION=~<VERSION>" --slot "staging"

az functionapp list-runtimes --os "windows" --query "[?runtime == 'powershell'].{Version:version}" --output table

az functionapp config set --powershell-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

Dalam contoh ini, ganti <APP_NAME> dan <RESOURCE_GROUP> dengan nama aplikasi fungsi dan grup sumber daya Anda. <VERSION> Ganti juga dengan versi bahasa yang didukung yang sedang Anda perbarui. Jika Anda tidak menggunakan slot penahapan, hapus --slot parameter .

Catatan

Anda tidak dapat mengubah versi Python saat berjalan dalam paket Konsumsi.

Jalankan az functionapp list-runtimes perintah untuk menampilkan pengaturan situs yang didukung linuxFxVersion untuk versi bahasa Anda:

Jalankan az functionapp list-runtimes perintah untuk menampilkan pengaturan situs yang didukung linuxFxVersion untuk versi tumpukan bahasa Anda:

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'dotnet-isolated'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'node'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'powershell'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

Jalankan az functionapp config set perintah untuk memperbarui pengaturan situs untuk versi bahasa baru aplikasi fungsi Anda:

Jalankan az functionapp config set perintah untuk memperbarui pengaturan situs untuk versi tumpukan baru aplikasi fungsi Anda:

az functionapp config set --linux-fx-version "<LANGUAGE|VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

Dalam contoh ini, ganti <APP_NAME> dan <RESOURCE_GROUP> dengan nama aplikasi fungsi dan grup sumber daya Anda. <LANGUAGE|VERSION> Ganti juga dengan linuxFxVersion untuk pembaruan Anda. Jika Anda tidak menggunakan slot penahapan, hapus --slot parameter .

Aplikasi fungsi Anda dimulai ulang setelah memperbarui versi.

Bertukar slot

Jika Anda telah melakukan penyebaran proyek kode dan memperbarui pengaturan di slot penahapan, Anda akhirnya perlu menukar slot penahapan ke dalam produksi. Untuk informasi selengkapnya, lihat Menukar slot.