Project: Azure Service Fabric (Orchestration & Management / Scheduling & Orchestration)
File: Service_Fabric_ReleaseNotes_82CU21.md

This release includes the bug fixes described in this document. This release includes runtime, SDKs, and Windows Server Standalone deployments to run on-premises. The following packages and versions are part of this release: | Service | Platform | Version | | | - | | | Service Fabric Runtime | Ubuntu 18 <br> Windows | 8.2.1397.1 <br> 8.2.1571.9590 | | Service Fabric for Windows Server | Service Fabric Standalone Installer Package | 8.2.1571.9590 | | .NET SDK | Windows .NET SDK <br> Microsoft.ServiceFabric <br> Reliable Services and Reliable Actors <br> ASP.NET Core Service Fabric integration | 5.2.1571 <br> 8.2.1571 <br> 5.2.1571 <br> 5.2.1571 | | Java SDK | Java for Linux SDK | 1.0.6 | | Service Fabric PowerShell and CLI | AzureRM PowerShell Module <br> SFCTL | 0.3.15 <br> 11.1.0 | Microsoft Azure Service Fabric 8.2 Cumulative Update 2.1 Release Notes | Versions | IssueType | Description | Resolution | | - | - | - | - | | Windows - 8.2.1571.9590<br>Ubuntu 18 - 8.2.1397.1 | Bug | Certificate updates leave cluster in an unhealthy state | Brief Description: Updating the certificate can trigger a cluster upgrade that becomes stuck and leaves the cluster in an unhealthy state.<br>If the cluster is currently on Service Fabric '8.2 Cumulative Update 2.0' (Windows - 8.2.1486.9590 / Ubuntu 18 - 8.2.1285.1), refrain from making any certificate changes until the cluster is first upgraded to this '8.2 Cumulative Update 2.1' (Windows - 8.2.1571.9590 / Ubuntu 18 - 8.2.1397.1).<br> Fix: The regression identified in '8.2 Cumulative Update 2.0' has been fixed with this release update. Please upgrade cluster to this '8.2 Cumulative Update 2.1' release before making any certificate changes. | Guest Executable and Container Applications*: Guest executable and container applications created or upgraded in Service Fabric clusters with runtime versions 7.1+ are incompatible with prior Service Fabric runtime versions (e.g. Service Fabric 7.0).<br/> Following scenarios are impacted:<br/> An application with guest executables or containers is created or upgraded in an Service Fabric 7.1+ cluster.<br/> The cluster is then downgraded to a previous Service Fabric runtime version (e.g. Service Fabric 7.0).<br/> The application fails to activate.<br/> A cluster upgrade from pre-Service Fabric 7.1 version to Service Fabric 7.1+ version is in progress.<br/> In parallel with the Service Fabric runtime upgrade, an application with guest executables or containers is created or upgraded.<br/> The Service Fabric runtime upgrade starts rolling back (due to any reason) to the pre-Service Fabric 7.1 version.<br/> The application fails to activate.<br/> To avoid issues when upgrading from a pre-Service Fabric 7.1 runtime version to an Service Fabric 7.1+ runtime version, do not create or upgrade applications with guest executables or containers while the Service Fabric runtime upgrade is in progress.<br/> The simplest mitigation, when possible, is to delete and recreate the application in Service Fabric 7.0.<br/> The other option is to upgrade the application in Service Fabric 7.0 (for example, with a version only change).<br/> If the application is stuck in rollback, the rollback has to be first completed before the application can be upgraded again. .NET Core 2.x Support*: .NET Core runtime LTS 2.1 runtime is out of support as of Aug 21, 2021, and .NET Core runtime 2.2 is out of support from Dec 2019. Service Fabric releases after those dates will drop support for Service Fabric apps running with .NET Core 2.1 & .NET Core 2.2 runtimes respectively. Current apps running on .NET Core

runtime will continue to work, but requests for investigations or request for changes will no longer receive support. Service Fabric .NET SDK will take a dependency on .NET runtime 3.x features to support Service Fabric .NET Core apps. Ubuntu 16.04 Support*: Ubuntu 16.04 LTS reached it's 5-year end-of-life window on April 30, 2021. Due to this, Service Fabric runtime has dropped support for 16.04 LTS and we recommend moving your clusters and applications to Ubuntu 18.04 LTS. Current applications running on it will continue to work, but requests for investigations or requests for change will no longer receive support. ASP.NET Core 1.0 Support*: Service Fabric ASP.NET Core packages are built against ASP.NET Core 1.0 binaries which are out of support. Starting Service Fabric 8.2, we will be building Service Fabric ASP.NET Core packages against .NET Core 3.1, .NET Core 5.0, .NET Core 6.0, .NET Framework 4.6.1. As a result, they can be used only to build services targeting .NET Core 3.1, .NET Core 5.0, .NET Core 6.0, >=.NET Framework 4.6.1 respectively.<br>For .NET Core 3.1, .NET Core 5.0, .NET Core 6.0, Service Fabric ASP.NET Core will be taking dependency on Microsoft.AspNetCore.App shared framework, whereas for NetFx target frameworks >=.NET Framework 4.6.1, Service Fabric ASP.NET Core will be taking dependency on ASP.NET Core 2.1 packages.<br>The package Microsoft.ServiceFabric.AspNetCore.WebListener will no longer be shipped, Microsoft.ServiceFabric.AspNetCore.HttpSys package should be used instead. Windows Server 2022*: Service Fabric runtime has identified a bug during additional testing and is temporarily suspending support for Windows Server 2022. We are working to resume the support soon. The table below is an overview of the direct links to the packages associated with this release. Follow this guidance for setting up your developer environment: | Area | Package | Version | Repository | Direct Download Link | | - | - | - | - | - | | Service Fabric Runtime | Ubuntu Developer Set-up | 8.2.1397.1 | N/A | Cluster Runtime: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabric <br> Service Fabric SDK for local cluster setup: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabricsdkcommon/ <br> Container image: https://hub.docker.com/r/microsoft/service-fabric-onebox/ | | Windows Developer Set-up | 8.2.1571.9590 | N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabric.8.2.1571.9590.exe | | Service Fabric for Windows Server | Service Fabric Standalone Installer Package | 8.2.1571.9590 | N/A | https://download.microsoft.com/download/8/3/6/836E3E99-A300-4714-8278-96BC3E8B5528/8.2.1571.9590/Microsoft.Azure.ServiceFabric.WindowsServer.8.2.1571.9590.zip | | | Service Fabric Standalone Runtime | 8.2.1571.9590 | N/A | https://download.microsoft.com/download/B/0/B/B0BCCAC5-65AA-4BE3-AB13-D5FF5890F4B5/8.2.1571.9590/MicrosoftAzureServiceFabric.8.2.1571.9590.cab | | .NET SDK | Windows .NET SDK | 5.2.1571 | N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabricSDK.5.2.1571.msi | | | Microsoft.ServiceFabric | 8.2.1571 | N/A | https://www.nuget.org | | | Reliable Services and Reliable Actors<br>\-Microsoft.ServiceFabric.Services<br>\-Microsoft.ServiceFabric.Services.Remoting<br>\-Microsoft.ServiceFabric.Services.Wcf <br>\-Microsoft.ServiceFabric.Actors <br>\-Microsoft.ServiceFabric.Actors.Wcf | 5.2.1571 | https://github.com/Azure/service-fabric-services-and-actors-dotnet | https://www.nuget.org | | | ASP.NET Core Service Fabric integration<br>\-Microsoft.ServiceFabric.Services.AspNetCore.* | 5.2.1571 | https://github.com/microsoft/service-fabric-aspnetcore | https://www.nuget.org | | | Data, Diagnostics and Fabric transport<br>\-Microsoft.ServiceFabric.Data <br>\-Microsoft.ServiceFabric.Data.Interfaces <br>\-Microsoft.ServiceFabric.Diagnostics.Internal <br>\-Microsoft.ServiceFabric.FabricTransport/Internal | 8.2.1571 | N/A | https://www.nuget.org | | | Microsoft.ServiceFabric.Data.Extensions | 8.2.1571 | N/A | https://www.nuget.org | | Java SDK | Java SDK | 1.0.6 | N/A | https://mvnrepository.com/artifact/com.microsoft.servicefabric/sf-actors/1.0.6 | | Eclipse | Service Fabric plug-in for Eclipse | 2.0.7 | N/A | N/A | | Yeoman | Azure Service Fabric Java generator | 1.0.7 | https://github.com/microsoft/generator-azuresfjava | N/A | | | Azure Service Fabric C# generator | 1.0.9 | https://github.com/microsoft/generator-azuresfcsharp | N/A | | | Azure Service Fabric guest executables generator | 1.0.1 | https://github.com/microsoft/generator-azuresfguest | N/A | | | Azure Service Fabric Container generators | 1.0.1 | https://github.com/microsoft/generator-azuresfcontainer | N/A | | CLI | Service Fabric CLI | 11.1.0 | https://github.com/microsoft/service-fabric-cli | https://pypi.python.org/pypi/sfctl | | PowerShell | AzureRM.ServiceFabric | 0.3.15 | https://github.com/Azure/azure-powershell/tree/preview/src/ResourceManager/ServiceFabric | https://www.powershellgallery.com/packages/AzureRM.ServiceFabric/0.3.15 |