Memigrasikan aplikasi fungsi dari ekstensi Azure Bus Layanan versi 4.x ke versi 5.x
Artikel ini menyoroti pertimbangan untuk meningkatkan aplikasi Azure Functions yang sudah ada yang menggunakan ekstensi Azure Bus Layanan versi 4.x untuk menggunakan ekstensi yang lebih baru versi 5.x. Migrasi dari versi 4.x ke versi 5.x ekstensi Azure Bus Layanan memiliki perubahan yang merusak untuk aplikasi Anda.
Penting
Pada 31 Maret 2025 ekstensi Azure Bus Layanan versi 4.x akan dihentikan. Ekstensi dan semua aplikasi yang menggunakan ekstensi akan terus berfungsi, tetapi Azure Bus Layanan akan berhenti memberikan pemeliharaan dan dukungan lebih lanjut untuk ekstensi ini. Sebaiknya migrasikan ke ekstensi versi terbaru 5.x.
Artikel ini memandikan Anda melalui proses migrasi aplikasi fungsi Anda untuk dijalankan pada ekstensi Azure Bus Layanan versi 5.x. Karena instruksi peningkatan proyek bergantung pada bahasa, pastikan untuk memilih bahasa pengembangan Anda dari pemilih di bagian atas artikel.
Memperbarui versi ekstensi
.NET Functions menggunakan ekstensi yang diinstal dalam proyek sebagai paket NuGet. Bergantung pada model proses Functions Anda, paket NuGet untuk diperbarui bervariasi.
| Model proses fungsi | Ekstensi Azure Bus Layanan | Versi yang Direkomendasikan |
|---|---|---|
| Model dalam proses | Microsoft.Azure.WebJobs.Extensions.ServiceBus | >= 5.13.4 |
| Model pekerja terisolasi | Microsoft.Azure.Functions.Worker.Extensions.ServiceBus | >= 5.14.1 |
Perbarui file proyek Anda .csproj untuk menggunakan versi ekstensi terbaru untuk model proses Anda. File berikut .csproj menggunakan ekstensi Azure Bus Layanan versi 5.
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net7.0</TargetFramework>
<AzureFunctionsVersion>v4</AzureFunctionsVersion>
<OutputType>Exe</OutputType>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.21.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.ServiceBus" Version="5.16.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.16.4" />
</ItemGroup>
<ItemGroup>
<None Update="host.json">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
</None>
<None Update="local.settings.json">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
<CopyToPublishDirectory>Never</CopyToPublishDirectory>
</None>
</ItemGroup>
</Project>
Memperbarui bundel ekstensi
Secara default, bundel ekstensi digunakan oleh non-.NET aplikasi fungsi untuk menginstal ekstensi pengikatan. Ekstensi Azure Bus Layanan versi 5 adalah bagian dari bundel ekstensi versi 4.
Untuk memperbarui aplikasi Anda untuk menggunakan bundel ekstensi terbaru, perbarui host.json. File berikut host.json menggunakan bundel ekstensi versi 4.
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.*, 5.0.0)"
}
}
Mengubah kode fungsi Anda
Ekstensi Azure Functions Azure Bus Layanan versi 5 dibangun di atas Azure.Messaging.ServiceBus SDK versi 3, yang menghapus dukungan untuk kelas tersebutMessage. Sebagai gantinyaServiceBusReceivedMessage, gunakan jenis untuk menerima metadata pesan dari Antrean dan Langganan Bus Layanan.