오케스트레이션 오류, 느린 재생 또는 예기치 않은 동작이 발생하는 경우 Durable Functions 확장을 업그레이드하는 것이 권장되는 첫 번째 단계입니다. 새 릴리스에는 종종 중요한 버그 수정 및 성능 향상이 포함됩니다. 새 릴리스에 대한 알림을 받으려면 GitHub에서 릴리스 구독을 설정하세요.
앱 유형과 일치하는 업그레이드 방법을 선택합니다.
| 앱 유형 | 업그레이드 방법 |
|---|---|
| .NET(인프로세스 또는 아이솔레이티드) | 최신 NuGet 패키지 참조 |
| 비 .NET(JavaScript, Python, Java, PowerShell) | 확장 번들 업그레이드 |
| 고급/시간에 민감한 수정 필요 | 수동으로 확장 업그레이드 |
.NET 앱에 대한 최신 NuGet 패키지 참조
프로젝트에서 Durable Functions NuGet 패키지 참조를 업데이트합니다. 올바른 패키지는 호스팅 모델 및 스토리지 공급자에 따라 달라집니다.
예를 들어 격리된 작업자 앱에서 기본 Azure Storage 확장을 업그레이드하려면 다음을 수행합니다.
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.DurableTask
확장 번들 업그레이드
비 .NET 앱(JavaScript, Python, Java, PowerShell)은 extension 번들을 사용하여 Durable Functions 확장을 포함한 트리거 및 바인딩에 액세스합니다.
extensionBundle
host.json 버전 범위에 최신 번들 릴리스가 포함되어 있는지 확인합니다.
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.*, 5.0.0)"
}
}
필요한 경우 버전 범위를 업데이트한 다음, 앱을 다시 배포합니다.
Durable Functions 확장 버전을 수동으로 업그레이드
확장 번들을 업그레이드해도 문제가 해결되지 않고 최신 Durable Functions 확장 릴리스에 필요한 수정 사항이 포함된 경우 특정 확장 버전을 수동으로 설치할 수 있습니다.
Caution
확장을 수동으로 관리하면 확장 번들에서 자동 업데이트가 손실되고 확장 간에 호환성 문제가 발생할 수 있습니다. 이 방법은 시간에 민감한 수정에만 사용합니다.
extensionBundle섹션을host.json파일에서 제거합니다.아직 없는 경우 .NET CLI 설치합니다.
확장을 설치합니다. 확장 번들에서 지원하는 모든 확장을 설치하려면 다음을 실행합니다.
func extensions install특정 버전에서 Durable Functions 확장만 설치하려면 다음을 실행합니다.
func extensions install -p Microsoft.Azure.WebJobs.Extensions.DurableTask -v <version><version>를 releases 페이지의 대상 버전으로 교체합니다.