Függvényalkalmazások migrálása az Azure Service Bus 4.x-es verziójáról az 5.x-es verzióra
Ez a cikk kiemeli a meglévő Azure Functions-alkalmazások frissítésének szempontjait, amelyek az Azure Service Bus 4.x-es verzióját használják az újabb 5.x verzió használatára. Az Azure Service Bus bővítmény 4.x-es verziójáról az 5.x-es verzióra való migrálás kompatibilitástörő változásokat hoz az alkalmazásra vonatkozóan.
Fontos
2025. március 31-én megszűnik az Azure Service Bus 4.x-es verziója. A bővítmény és a bővítményt használó összes alkalmazás továbbra is működni fog, de az Azure Service Bus nem biztosít további karbantartást és támogatást a bővítményhez. Javasoljuk, hogy a bővítmény legújabb 5.x-es verziójára migráljon.
Ez a cikk végigvezeti a függvényalkalmazás migrálásának folyamatán az Azure Service Bus bővítmény 5.x-es verzióján való futtatáshoz. Mivel a projektfrissítési utasítások nyelvfüggőek, mindenképpen válassza ki a fejlesztési nyelvet a cikk tetején található választóból.
A bővítmény verziójának frissítése
A .NET Functions a projektben NuGet-csomagokként telepített bővítményeket használ. A Functions-folyamatmodelltől függően a frissíteni kívánt NuGet-csomag eltérő.
| Függvények folyamatmodellje | Azure Service Bus-bővítmény | Ajánlott verzió |
|---|---|---|
| Folyamaton belüli modell | Microsoft.Azure.WebJobs.Extensions.ServiceBus | >= 5.13.4 |
| Izolált feldolgozói modell | Microsoft.Azure.Functions.Worker.Extensions.ServiceBus | >= 5.14.1 |
Frissítse a projektfájlt .csproj a folyamatmodell legújabb bővítményverziójának használatára. Az alábbi .csproj fájl az Azure Service Bus bővítmény 5- ös verzióját használja.
<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>
A bővítménycsomag frissítése
Alapértelmezés szerint a bővítménycsomagokat non-.NET függvényalkalmazások használják kötésbővítmények telepítéséhez. Az Azure Service Bus 5-ös verziója a 4-es verziójú bővítménycsomag része.
Ha frissíteni szeretné az alkalmazást a legújabb bővítménycsomag használatára, frissítse a host.json. Az alábbi host.json fájl a bővítménycsomag 4. verzióját használja.
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.*, 5.0.0)"
}
}
A függvénykód módosítása
Az Azure Functions Azure Service Bus 5-ös verziója az Azure.Messaging.ServiceBus SDK 3-as verziójára épül, amely eltávolította az Message osztály támogatását. Ehelyett használja a típust az ServiceBusReceivedMessage üzenet metaadatainak fogadásához a Service Bus-üzenetsorokból és -előfizetésekből.