Bagikan melalui


Memperbarui versi tumpukan bahasa di Azure Functions

Di Azure Functions, dukungan untuk tumpukan bahasa terbatas pada versi tertentu. Saat versi baru tersedia, Anda mungkin ingin memperbarui aplikasi fungsi untuk memanfaatkan fitur baru. Dukungan dalam Functions juga dapat berakhir untuk versi yang lebih lama dan biasanya selaras dengan garis waktu akhir dukungan komunitas. Untuk informasi selengkapnya, lihat kebijakan dukungan runtime bahasa. Untuk versi berbagai bahasa yang didukung, lihat Bahasa menurut versi runtime.

Untuk membantu memastikan aplikasi fungsi Anda terus menerima dukungan, ikuti instruksi dalam artikel ini untuk memperbaruinya ke versi terbaru yang tersedia. Cara Anda memperbarui aplikasi fungsi bergantung pada beberapa faktor:

  • Bahasa yang Anda gunakan untuk mengembangkan aplikasi fungsi Anda. Pastikan untuk memilih bahasa pemrograman Anda di bagian atas artikel ini.
  • Sistem operasi tempat aplikasi fungsi Anda berjalan di Azure: Windows atau Linux.
  • Paket hosting.

Catatan

Artikel ini memperlihatkan kepada Anda cara memperbarui versi .NET dari aplikasi fungsi yang menggunakan model pekerja yang terisolasi. Jika aplikasi fungsi Anda berjalan pada versi .NET yang lebih lama dan menggunakan model dalam proses, pertimbangkan opsi berikut:

Prasyarat

  • Sebuah akun Azure dengan langganan aktif. Buat akun gratis.
  • Aplikasi fungsi yang dihosting di salah satu paket Functions berikut:
    • Premium
    • Dedicated
    • Konsumsi

Menyiapkan aplikasi fungsi Anda

Sebelum Anda memperbarui konfigurasi tumpukan untuk aplikasi fungsi Anda di Azure, selesaikan tugas di bagian berikut.

Memverifikasi aplikasi fungsi Anda secara lokal

Uji dan verifikasi kode aplikasi fungsi Anda secara lokal pada versi target baru.

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

  1. Pastikan bahwa versi target .NET SDK diinstal.

    Jika Anda menargetkan versi pratinjau, lihat Panduan fungsi untuk pratinjau versi .NET untuk memastikan dukungan versi. Menggunakan pratinjau .NET mungkin memerlukan lebih banyak langkah.

  2. Perbarui referensi Anda ke versi terbaru Microsoft.Azure.Functions.Worker dan Microsoft.Azure.Functions.Worker.Sdk.

  3. Perbarui kerangka kerja target proyek Anda ke versi baru. Untuk proyek C#, Anda harus memperbarui <TargetFramework> elemen dalam file .csproj . Untuk informasi selengkapnya tentang versi Anda, lihat Kerangka kerja target.

    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 di pengaturan pengguna atau file .vscode/settings.json proyek Anda. Periksa dependensi apa pun pada versi kerangka kerja yang ada di luar kode proyek Anda, sebagai bagian dari langkah build atau alur integrasi berkelanjutan dan pengiriman berkelanjutan (CI/CD).

  4. Buat pembaruan apa pun untuk kode proyek Anda yang diperlukan versi .NET baru. Periksa catatan rilis versi untuk informasi tertentu. Anda juga dapat menggunakan Asisten Peningkatan .NET untuk membantu memperbarui kode Anda sebagai respons terhadap perubahan di seluruh versi utama.

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

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.

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

  1. Di portal Microsoft Azure, temukan dan pilih aplikasi fungsi Anda. Di menu samping, pilihKonfigurasi>.

  2. Buka tab Pengaturan runtime fungsi dan periksa nilai versi Runtime . Aplikasi fungsi Anda harus berjalan pada runtime Functions versi 4.x (~4).

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

Menerbitkan pembaruan aplikasi fungsi

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

Petunjuk / Saran

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

Saat Anda memublikasikan aplikasi fungsi 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 aplikasi fungsi Anda berjalan di Windows atau di Linux di Azure.

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

Gunakan langkah-langkah berikut untuk memperbarui versi Java:

  1. Di portal Microsoft Azure, temukan dan pilih aplikasi fungsi Anda. Di menu samping, pilihKonfigurasi>. Jika Anda memiliki slot penahapan, pilih slot tersebut.

  2. Pada tab Pengaturan umum , perbarui Versi Java ke versi yang diinginkan.

  3. Pilih Simpan. Saat Anda diberi tahu tentang hidupkan ulang, pilih Lanjutkan.

Gunakan langkah-langkah berikut untuk memperbarui versi .NET:

  1. Di portal Microsoft Azure, temukan dan pilih aplikasi fungsi Anda. Di menu samping, pilihKonfigurasi>. Jika Anda memiliki slot penahapan, pilih slot tersebut.

  2. Pada tab Pengaturan umum , perbarui Versi .NET ke versi yang diinginkan.

  3. Pilih Simpan. Saat Anda diberi tahu tentang hidupkan ulang, pilih Lanjutkan.

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

  1. Di portal Microsoft Azure, temukan dan pilih aplikasi fungsi Anda. Di menu samping, pilihKonfigurasi>. Jika Anda memiliki slot penahapan, pilih slot tersebut.

  2. Pada tab Pengaturan umum , perbarui versiNode.js ke versi yang diinginkan.

  3. Pilih Simpan. Saat Anda diberi tahu tentang hidupkan ulang, pilih Lanjutkan. Perubahan ini memperbarui WEBSITE_NODE_DEFAULT_VERSION pengaturan aplikasi.

Gunakan langkah-langkah berikut untuk memperbarui versi PowerShell:

  1. Di portal Microsoft Azure, temukan dan pilih aplikasi fungsi Anda. Di menu samping, pilihKonfigurasi>. Jika Anda memiliki slot penahapan, pilih slot tersebut.

  2. Pada tab Pengaturan umum , perbarui Versi PowerShell Core ke versi yang diinginkan.

  3. Pilih Simpan. Saat Anda diberi tahu tentang hidupkan ulang, pilih Lanjutkan.

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

Aplikasi fungsi Anda dimulai ulang setelah memperbarui versi.

Bertukar slot

Jika Anda menggunakan slot penahapan untuk menyebarkan proyek kode dan memperbarui pengaturan Anda, tukar slot penahapan ke dalam produksi. Untuk informasi selengkapnya, lihat Menukar slot.