Durable Functions 확장 버전 업그레이드
Durable Functions에서 발생하는 많은 문제는 종종 중요한 버그 수정 및 성능 향상이 포함된 최신 버전의 확장으로 업그레이드하여 해결할 수 있습니다. 이 문서의 지침에 따라 Durable Functions 확장의 최신 버전을 다운로드할 수 있습니다.
확장에 대한 변경 내용은 Azure/azure-functions-durable-extension 리포지토리의 릴리스 페이지에서 찾을 수 있습니다. 릴리스 페이지로 이동하여 조사식, 사용자 지정을 차례로 클릭하고 마지막으로 릴리스 필터를 선택하여 새 확장 릴리스가 있을 때마다 알림을 받도록 구성할 수도 있습니다.
최신 NuGet 패키지 참조(.NET 앱에만 해당)
.NET 앱은 최신 NuGet 패키지를 참조하여 Durable Functions 확장의 최신 버전을 가져올 수 있습니다.
Azure Storage 대신 Netherite 또는 MSSQL 스토리지 공급자를 사용하는 경우 다음 중 하나를 참조해야 합니다.
확장 번들 업그레이드
확장 번들은 비 .NET 함수 앱이 다양한 Azure Function 트리거 및 바인딩을 참조하고 사용할 수 있는 쉽고 편리한 방법을 제공합니다. 예를 들어 함수가 트리거될 때마다 Event Hubs에 메시지를 보내야 하는 경우 Event Hubs 확장을 사용하여 Event Hubs 바인딩에 액세스할 수 있습니다. Durable Functions 확장은 확장 번들의 각 버전에도 포함됩니다. 확장 번들은 지원되는 개발 도구를 사용하여 함수 앱을 만들 때 host.json에서 자동으로 구성됩니다.
대부분의 비 .NET 애플리케이션은 확장 번들을 사용하여 다양한 트리거 및 바인딩에 액세스합니다. 최신 번들 릴리스에는 중요한 버그 수정 및 성능 개선이 포함된 최신 버전의 Durable Functions 확장이 포함되어 있는 경우가 많습니다. 따라서 앱에서 최신 버전의 확장 번들을 사용하는 것이 중요합니다. host.json 파일을 확인하여 사용 중인 버전 범위에 최신 확장 번들 버전이 포함되어 있는지 알아볼 수 있습니다.
Durable Functions 확장을 수동으로 업그레이드
확장 번들을 업그레이드해도 문제가 해결되지 않고 문제에 대한 잠재적인 수정 사항이 포함된 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