Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
W tym artykule opisano zagadnienia dotyczące uaktualniania istniejących aplikacji usługi Azure Functions korzystających z rozszerzenia usługi Azure Service Bus w wersji 4.x do korzystania z nowszego rozszerzenia w wersji 5.x. Migracja z wersji 4.x do wersji 5.x rozszerzenia Azure Service Bus wprowadza niezgodne zmiany w aplikacji.
Ważne
Rozszerzenie Azure Service Bus w wersji 4.x zostało wycofane 31 marca 2025 roku. Aplikacje mogą nadal działać z tym rozszerzeniem, ale nie otrzymuje ono już konserwacji ani wsparcia. Migruj do rozszerzenia w wersji 5.x, które korzysta z obsługiwanej biblioteki Azure.Messaging.ServiceBus. Biblioteka Microsoft.Azure.ServiceBus używana przez wersję 4.x została wycofana 30 września 2026 roku. Szczegóły dotyczące wycofania biblioteki można znaleźć w ogłoszeniu o wycofaniu biblioteki.
W tym artykule przedstawiono proces migracji aplikacji funkcji do uruchomienia w wersji 5.x rozszerzenia usługi Azure Service Bus. Ponieważ instrukcje uaktualniania projektu są zależne od języka, pamiętaj, aby wybrać język programowania z selektora w górnej części artykułu.
Note
Ta migracja nie dotyczy aplikacji z funkcją Go. Wsparcie dla Go pierwszej klasy nie było dostępne w wersji 4.x rozszerzenia Azure Service Bus. Aktualne informacje na temat wyzwalaczy Go można znaleźć w artykule Wyzwalacz Azure Service Bus.
Aktualizowanie wersji rozszerzenia
Usługa .NET Functions używa rozszerzeń zainstalowanych w projekcie jako pakietów NuGet. W zależności od modelu procesów usługi Functions pakiet NuGet do aktualizacji różni się.
| Model przetwarzania funkcji | Rozszerzenie usługi Azure Service Bus | Rekomendowana wersja |
|---|---|---|
| Model w trakcie przetwarzania | Microsoft.Azure.WebJobs.Extensions.ServiceBus | >= 5.13.4 |
| Model izolowanego procesu roboczego | Microsoft.Azure.Functions.Worker.Extensions.ServiceBus | >= 5.14.1 |
.csproj Zaktualizuj plik projektu, aby użyć najnowszej wersji rozszerzenia dla modelu przetwarzania.
.csproj Poniższy plik używa wersji 5 rozszerzenia usługi Azure Service Bus.
<Project Sdk="Azure.Functions.Sdk/1.0.0">
<PropertyGroup>
<TargetFramework>net10.0</TargetFramework>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.Azure.Functions.Worker" Version="2.52.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.ServiceBus" Version="5.16.0" />
</ItemGroup>
<ItemGroup>
<None Update="host.json">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
</None>
<None Update="local.settings.json">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
<CopyToPublishDirectory>Never</CopyToPublishDirectory>
</None>
</ItemGroup>
</Project>
Aktualizowanie pakietu rozszerzeń
Domyślnie pakiety rozszerzeń są używane przez aplikacje funkcji non-.NET do instalowania rozszerzeń powiązań. Rozszerzenie usługi Azure Service Bus w wersji 5 jest częścią pakietu rozszerzenia w wersji 4.
Aby zaktualizować aplikację tak, aby korzystała z najnowszego pakietu rozszerzeń, zaktualizuj plik host.json.
host.json Poniższy plik używa wersji 4 pakietu rozszerzenia.
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.*, 5.0.0)"
}
}
Modyfikowanie kodu funkcji
Rozszerzenie Azure Service Bus dla Azure Functions w wersji 5 bazuje na zestawie SDK Azure.Messaging.ServiceBus w wersji 3, który usunął obsługę klasy Message. Zamiast tego użyj typu ServiceBusReceivedMessage do odbierania metadanych komunikatów z kolejek i subskrypcji usługi Service Bus.