다음을 통해 공유


Durable Functions 확장 버전 업그레이드

Durable Functions에 대한 사용자 환경의 많은 문제는 종종 중요한 버그 수정 및 성능 향상을 포함하는 최신 버전의 확장으로 업그레이드하여 해결할 수 있습니다. 이 문서의 지침에 따라 최신 버전의 Durable Functions 확장을 가져올 수 있습니다.

확장에 대한 변경 내용은 리포지토리의 Azure/azure-functions-durable-extension 찾을 수 있습니다. 새 확장 기능이 릴리스될 때마다 알림을 받도록 구성하려면 릴리스 페이지로 이동하여 감시, 사용자 지정, 그 다음 릴리스 필터를 선택하세요.

릴리스 알림을 설정하는 1단계의 스크린샷

릴리스 알림을 설정하는 2단계의 스크린샷.

최신 NuGet 패키지 참조(.NET 앱만 해당)

.NET 앱은 최신 NuGet 패키지를 참조하여 최신 버전의 Durable Functions 확장을 가져올 수 있습니다.

Azure Storage 대신 Netherite 또는 MSSQL 스토리지 공급자를 사용하는 경우 다음 중 하나를 참조해야 합니다.

확장 번들 업그레이드

확장 번들은 non-.NET 함수 앱이 다양한 Azure Function 트리거 및 바인딩을 참조하고 사용할 수 있는 쉽고 편리한 방법을 제공합니다. 예를 들어 함수가 트리거될 때마다 Event Hubs에 메시지를 보내야 하는 경우 Event Hubs 확장을 사용하여 Event Hubs 바인딩에 액세스할 수 있습니다. Durable Functions 확장은 확장 번들의 각 버전에도 포함됩니다. 함수 앱을 지원되는 개발 도구 중 하나를 사용하여 만들 때 확장 번들들은 host.json에서 자동으로 구성됩니다.

대부분의 non-.NET 애플리케이션은 확장 번들을 사용하여 다양한 트리거 및 바인딩에 액세스합니다. 최신 번들 릴리스에는 중요한 버그 수정 및 성능 향상이 포함된 최신 버전의 Durable Functions 확장이 포함되어 있는 경우가 많습니다. 따라서 앱에서 최신 버전의 확장 번들을 사용하는 것이 중요합니다. host.json 파일을 확인하여 사용 중인 버전 범위에 최신 확장 번들 버전이 포함되어 있는지 확인할 수 있습니다.

지속성 함수 확장을 수동으로 업그레이드

확장 번들을 업그레이드해도 문제가 해결되지 않고 문제에 대한 잠재적인 수정 사항이 포함된 Durable Functions 확장의 최신 릴리스가 발견되면 확장 자체를 수동으로 업그레이드할 수 있습니다. 이는 고급 시나리오 또는 수동으로 확장을 관리하는 데 많은 단점이 있기 때문에 시간에 민감한 수정이 필요한 경우에만 사용됩니다. 예를 들어 사용하는 확장이 서로 호환되지 않는 경우 .NET 오류를 처리해야 할 수 있습니다. 또한 확장 번들을 통해 자동으로 가져오는 대신 최신 수정 사항 및 패치를 가져오기 위해 확장을 수동으로 업그레이드해야 합니다.

먼저 host.json 파일에서 extensionBundle 섹션을 제거합니다.

dotnet 아직 CLI가 없는 경우 설치하세요. 이 페이지에서 가져올 수 있습니다.

애플리케이션은 일반적으로 둘 이상의 확장을 사용하므로 다음을 실행하여 확장 번들에서 지원하는 모든 확장의 모든 최신 버전을 수동으로 설치하는 것이 좋습니다.

func extensions install

그러나 최신 Durable Functions 확장 릴리스 설치하려는 경우 다음 명령을 실행합니다.

func extensions install -p Microsoft.Azure.WebJobs.Extensions.DurableTask -v <version>

다음은 그 예입니다.

func extensions install -p Microsoft.Azure.WebJobs.Extensions.DurableTask -v 2.9.1