diff --git a/README.md b/README.md index c7ed424d9..b0eb35449 100755 --- a/README.md +++ b/README.md @@ -21,6 +21,18 @@ Please note that these dates are advanced estimates and might be subject to chan We will be publishing upcoming features and roadmap items on [Azure Updates for Service Fabric](https://azure.microsoft.com/en-us/updates/?product=service-fabric). +## Service Fabric community Q & A schedule +The Service Fabric community Q&A will be held on the following dates: + +| Schedule | +|--------- | +| 30 Mar 2023 | +| 25 May 2023 | +| 27 July 2023| +| 28 Sept 2023| +| 25 Jan 2024 | +| 28 Mar 2024 | + ## Repo status We are in the process to move our development to GitHub. Until then, the Service Fabric team will continue regular feature development internally. We'll be providing frequent updates here and on our [team blog](https://blogs.msdn.microsoft.com/azureservicefabric/) as we make progress. diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 000000000..e138ec5d6 --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,41 @@ + + +## Security + +Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/). + +If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below. + +## Reporting Security Issues + +**Please do not report security vulnerabilities through public GitHub issues.** + +Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report). + +If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com). If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey). + +You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc). + +Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue: + + * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.) + * Full paths of source file(s) related to the manifestation of the issue + * The location of the affected source code (tag/branch/commit or direct URL) + * Any special configuration required to reproduce the issue + * Step-by-step instructions to reproduce the issue + * Proof-of-concept or exploit code (if possible) + * Impact of the issue, including how an attacker might exploit the issue + +This information will help us triage your report more quickly. + +If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs. + +## Preferred Languages + +We prefer all communications to be in English. + +## Policy + +Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/opensource/security/cvd). + + diff --git a/release_notes/Service_Fabric_ReleaseNotes_82CU9.md b/release_notes/Service_Fabric_ReleaseNotes_82CU9.md new file mode 100644 index 000000000..896832068 --- /dev/null +++ b/release_notes/Service_Fabric_ReleaseNotes_82CU9.md @@ -0,0 +1,64 @@ +# Microsoft Azure Service Fabric 8.2 Cumulative Update 9.0 Release Notes + +This release will only be available through manual upgrades. Clusters set to automatic upgrades will not receive this release. For how to configure upgrades, please see [classic](https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-upgrade) or [managed](https://docs.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-configuration) documentation. + +## Contents + +* [Service Fabric Packages and Versions](#service-fabric-packages-and-versions) +* [Service Fabric Feature and Bug Fixes](#service-fabric-feature-and-bug-fixes) +* [Retirement and Deprecation Path Callouts](#retirement-and-deprecation-path-callouts) +* [Repositories and Download Links](#repositories-and-download-links) + +## Service Fabric Packages and Versions +This release is for Windows only. + +The following packages and versions are part of this release: + +| Service | Platform | Version | +|---------|----------|---------| +|Service Fabric Runtime| Windows | 8.2.1748.9590 | +|Service Fabric for Windows Server|Service Fabric Standalone Installer Package | 8.2.1748.9590 | +|.NET SDK |Windows .NET SDK
Microsoft.ServiceFabric
Reliable Services and Reliable Actors
ASP.NET Core Service Fabric integration| 5.2.1748
8.2.1748
5.2.1748
5.2.1748 | +|Java SDK |Java for Linux SDK | 1.0.6 | +|Service Fabric PowerShell and CLI | AzureRM PowerShell Module
SFCTL | 0.3.15
11.0.1 | + + +## Service Fabric Feature and Bug Fixes +This release includes quality improvements only and does not contain bug fixes to specific issue. + + +## Retirement and Deprecation Path Callouts +* As aligned with [Microsoft .NET and .NET Core - Microsoft Lifecycle | Microsoft Learn](https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-and-net-core), SF Runtime has dropped support for Net Core 3.1 as of December 2022. For supported versions see [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#current-versions-1) and migrate applications as needed. +* Ubuntu 18.04 LTS will reach its 5-year end-of-life window on April 30, 2023. Service Fabric runtime will drop support for 18.04 LTS after the published date, and we recommend moving your clusters and applications to supported versions listed here: [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#supported-linux-versions-and-support-end-date) +* Service Fabric runtime will soon stop supporting BinaryFormatter based remoting exception serialization by default and move to using Data Contract Serialization (DCS) based remoting exception serialization by default. Current applications using it will continue to work as-is, but Service Fabric strongly recommends moving to using Data Contract Serialization (DCS) based remoting exception instead. +* Service Fabric runtime will be archiving and removing Service Fabric runtime version 6.4 packages and older, as well as SDK version 3.3 packages and older from the package Download Center in Apr 2023. Archiving/Removing will affect application scaling and re-imaging of virtual machines in a Service Fabric Cluster running on unsupported versions. After older versions are removed/archived, this may cause failure while rolling back when the current in-progress upgrade has errors. +* Migrate Azure Active Directory Authentication Library (ADAL) library to Microsoft Authentication Library (MSAL) library, since ADAL will be out of support after December 2022. This will impact customers using AAD for authentication in Service Fabric for below features:For more information see: [MSAL Migration] (https://learn.microsoft.com/en-us/azure/active-directory/develop/msal-migration) + + +## Repositories and Download Links + +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: +* [Getting Started with Linux](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-linux) +* [Getting Started with Mac](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-mac) +* [Getting Started with Windows](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started) + +| Area | Package | Version | Repository | Direct Download Link | +|-|-|-|-|-| +|Service Fabric Runtime | Windows Developer Set-up| 8.2.1748.9590 | N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabric.8.2.1748.9590.exe | +|Service Fabric for Windows Server |Service Fabric Standalone Installer Package | 8.2.1748.9590 |N/A | https://download.microsoft.com/download/8/3/6/836E3E99-A300-4714-8278-96BC3E8B5528/8.2.1748.9590/Microsoft.Azure.ServiceFabric.WindowsServer.8.2.1748.9590.zip | +||Service Fabric Standalone Runtime | 8.2.1748.9590 |N/A | https://download.microsoft.com/download/B/0/B/B0BCCAC5-65AA-4BE3-AB13-D5FF5890F4B5/8.2.1748.9590/MicrosoftAzureServiceFabric.8.2.1748.9590.cab| +|.NET SDK |Windows .NET SDK | 5.2.1748 |N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabricSDK.5.2.1748.msi | +||Microsoft.ServiceFabric | 8.2.1748 |N/A |https://www.nuget.org | +||Reliable Services and Reliable Actors
\-Microsoft.ServiceFabric.Services
\-Microsoft.ServiceFabric.Services.Remoting
\-Microsoft.ServiceFabric.Services.Wcf
\-Microsoft.ServiceFabric.Actors
\-Microsoft.ServiceFabric.Actors.Wcf | 5.2.1748 |https://github.com/Azure/service-fabric-services-and-actors-dotnet |https://www.nuget.org | +||ASP.NET Core Service Fabric integration
\-Microsoft.ServiceFabric.Services.AspNetCore.*| 5.2.1748 |https://github.com/Azure/service-fabric-aspnetcore |https://www.nuget.org | +||Data, Diagnostics and Fabric transport
\-Microsoft.ServiceFabric.Data
\-Microsoft.ServiceFabric.Data.Interfaces
\-Microsoft.ServiceFabric.Diagnostics.Internal
\-Microsoft.ServiceFabric.FabricTransport/Internal | 8.2.1748 |N/A| https://www.nuget.org | +||Microsoft.ServiceFabric.Data.Extensions | 8.2.1748 | 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/Azure/generator-azuresfjava |N/A | +||Azure Service Fabric C# generator | 1.0.9 |https://github.com/Azure/generator-azuresfcsharp |N/A | +||Azure Service Fabric guest executables generator | 1.0.1 |https://github.com/Azure/generator-azuresfguest |N/A| +||Azure Service Fabric Container generators | 1.0.1 |https://github.com/Azure/generator-azuresfcontainer |N/A | +|CLI |Service Fabric CLI | 11.0.1 |https://github.com/Azure/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 |N/A | diff --git a/release_notes/Service_Fabric_ReleaseNotes_90CU10.md b/release_notes/Service_Fabric_ReleaseNotes_90CU10.md new file mode 100644 index 000000000..3385cb458 --- /dev/null +++ b/release_notes/Service_Fabric_ReleaseNotes_90CU10.md @@ -0,0 +1,65 @@ +# Microsoft Azure Service Fabric 9.0 Cumulative Update 10.0 Release Notes + +This release will only be available through manual upgrades. Clusters set to automatic upgrades will not receive this release. For how to configure upgrades, please see [classic](https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-upgrade) or [managed](https://docs.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-configuration) documentation. + +## Contents +* [Service Fabric Packages and Versions](#service-fabric-packages-and-versions) +* [Service Fabric Feature and Bug Fixes](#service-fabric-feature-and-bug-fixes) +* [Retirement and Deprecation Path Callouts](#retirement-and-deprecation-path-callouts) +* [Repositories and Download Links](#repositories-and-download-links) + +## Service Fabric Packages and Versions +The following packages and versions are part of this release: + +| Service | Platform | Version | +|---------|----------|---------| +|Service Fabric Runtime| Ubuntu 18
Ubuntu 20
Windows | 9.0.1489.1
9.0.1489.1
9.0.1553.9590 | +|Service Fabric for Windows Server|Service Fabric Standalone Installer Package | 9.0.1553.9590 | +|.NET SDK |Windows .NET SDK
Microsoft.ServiceFabric
Reliable Services and Reliable Actors
ASP.NET Core Service Fabric integration| 6.0.1553
9.0.1553
6.0.1553
6.0.1553 | +|Java SDK |Java for Linux SDK | 1.0.6 | +|Service Fabric PowerShell and CLI | AzureRM PowerShell Module
SFCTL | 0.3.15
11.0.1 | + +## Service Fabric Feature and Bug Fixes +| Versions | IssueType | Description | Resolution | +|-|-|-|-| +| **Windows - 9.0.1553.9590
Ubuntu 18 - 9.0.1489.1
Ubuntu 20 - 9.0.1489.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: "DatabaseFilesCorrupted" is a terminal error for the replica, requiring it to be dropped. This error occurs when the Extensible Storage Engine(ESE) Write change APIs return the DatabaseFilesCorrupted error, resulting in the replica being marked for compaction and flagged as a fault replica.
**Solution**: When a replica experiences database corruption via KVS Write APIs (e.g., Insert, Update, Delete), it is flagged with the repair task "MarkCompactTransientFault". Upon reopening, the JET_Compact API identifies the "DatabaseFilesCorrupted" state, initiating the repair policy that ultimately results in the replica being dropped. This solution ensures proper handling and repair of replicas affected by database corruption, maintaining system integrity. +| **Windows - 9.0.1553.9590
Ubuntu 18 - 9.0.1489.1
Ubuntu 20 - 9.0.1489.1** | **Bug** | Failover Manager | **Brief Description**: During a scaling-down scenario in Service Fabric, if an application upgrade is in progress, there is a possibility of Service Fabric miscalculating the MinimumInstancePercentage for stateless services. This can result in the application upgrade getting stuck.
**Solution**: The issue has been resolved, ensuring that Service Fabric accurately calculates the MinimumInstancePercentage during scaling down. This fix enables the application upgrade to progress smoothly without any disruptions.
**Workaround**: To mitigate the issue, set the MinInstancePercentage to 0 and utilize the MinInstanceCount instead. +| **Windows - 9.0.1553.9590
Ubuntu 18 - 9.0.1489.1
Ubuntu 20 - 9.0.1489.1** | **Bug** | Service Fabric Explorer (SFX) | **Brief Description**: The repair job timeline history has been updated to fix the incorrect ordering of claimed and approved actions. This correction ensures an accurate representation of the repair job actions in the history section, providing clarity for users reviewing the timeline. + + +## Retirement and Deprecation Path Callouts +* As aligned with [Microsoft .NET and .NET Core - Microsoft Lifecycle | Microsoft Learn](https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-and-net-core), SF Runtime has dropped support for Net Core 3.1 as of December 2022. For supported versions see [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#current-versions-1) and migrate applications as needed. +* Ubuntu 18.04 LTS will reach its 5-year end-of-life window on June, 2023. Service Fabric runtime will drop support for 18.04 LTS after the published date, and we recommend moving your clusters and applications to supported versions listed here: [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#supported-linux-versions-and-support-end-date) +* Service Fabric runtime will soon stop supporting BinaryFormatter based remoting exception serialization by default and move to using Data Contract Serialization (DCS) based remoting exception serialization by default. Current applications using it will continue to work as-is, but Service Fabric strongly recommends moving to using Data Contract Serialization (DCS) based remoting exception instead. +* As called out in the previous releases, Service Fabric runtime will remove Service Fabric runtime version 6.4 packages and older, SDK version 3.3 packages and older from the package Download Center in July 2023. +* Service Fabric runtime will soon be archiving and removing Service Fabric runtime versions less than 7.2 and older, as well as the corresponding SDK version 4.2 packages and older from the package Download Center. Archiving/Removing will affect application scaling and re-imaging of virtual machines in a Service Fabric Cluster running on unsupported versions. After older versions are removed/archived, this may cause failure while rolling back when the current in-progress upgrade has errors.
+To prevent disruption of workloads, create a new cluster using the following steps: Install the supported version of Service Fabric SDK based on the Runtime version installed on the cluster. + + +## Repositories and Download Links +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: +* [Getting Started with Linux](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-linux) +* [Getting Started with Mac](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-mac) +* [Getting Started with Windows](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started) + +| Area | Package | Version | Repository | Direct Download Link | +|-|-|-|-|-| +|Service Fabric Runtime |Ubuntu Developer Set-up | 9.0.1489.1 |N/A | Cluster Runtime: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabric
Service Fabric SDK for local cluster setup: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabricsdkcommon/
Container image: https://hub.docker.com/r/microsoft/service-fabric-onebox/ +|| Windows Developer Set-up| 9.0.1553.9590 | N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabric.9.0.1553.9590.exe | +|Service Fabric for Windows Server |Service Fabric Standalone Installer Package | 9.0.1553.9590 |N/A | https://download.microsoft.com/download/8/3/6/836E3E99-A300-4714-8278-96BC3E8B5528/9.0.1553.9590/Microsoft.Azure.ServiceFabric.WindowsServer.9.0.1553.9590.zip | +||Service Fabric Standalone Runtime | 9.0.1553.9590 |N/A | https://download.microsoft.com/download/B/0/B/B0BCCAC5-65AA-4BE3-AB13-D5FF5890F4B5/9.0.1553.9590/MicrosoftAzureServiceFabric.9.0.1553.9590.cab | +|.NET SDK |Windows .NET SDK | 6.0.1553 |N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabricSDK.6.0.1553.msi | +||Microsoft.ServiceFabric | 9.0.1553 |N/A |https://www.nuget.org | +||Reliable Services and Reliable Actors
\-Microsoft.ServiceFabric.Services
\-Microsoft.ServiceFabric.Services.Remoting
\-Microsoft.ServiceFabric.Services.Wcf
\-Microsoft.ServiceFabric.Actors
\-Microsoft.ServiceFabric.Actors.Wcf | 6.0.1553 |https://github.com/Azure/service-fabric-services-and-actors-dotnet |https://www.nuget.org | +||ASP.NET Core Service Fabric integration
\-Microsoft.ServiceFabric.Services.AspNetCore.*| 6.0.1553 |https://github.com/Azure/service-fabric-aspnetcore |https://www.nuget.org | +||Data, Diagnostics and Fabric transport
\-Microsoft.ServiceFabric.Data
\-Microsoft.ServiceFabric.Data.Interfaces
\-Microsoft.ServiceFabric.Diagnostics.Internal
\-Microsoft.ServiceFabric.FabricTransport/Internal | 6.0.1553 |N/A| https://www.nuget.org | +||Microsoft.ServiceFabric.Data.Extensions | 9.0.1553 | 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/Azure/generator-azuresfjava |N/A | +||Azure Service Fabric C# generator | 1.0.9 |https://github.com/Azure/generator-azuresfcsharp |N/A | +||Azure Service Fabric guest executables generator | 1.0.1 |https://github.com/Azure/generator-azuresfguest |N/A| +||Azure Service Fabric Container generators | 1.0.1 |https://github.com/Azure/generator-azuresfcontainer |N/A | +|CLI |Service Fabric CLI | 11.0.1 |https://github.com/Azure/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 |N/A | diff --git a/release_notes/Service_Fabric_ReleaseNotes_90CU7.md b/release_notes/Service_Fabric_ReleaseNotes_90CU7.md new file mode 100644 index 000000000..c9be8bdf9 --- /dev/null +++ b/release_notes/Service_Fabric_ReleaseNotes_90CU7.md @@ -0,0 +1,58 @@ +# Microsoft Azure Service Fabric 9.0 Cumulative Update 7.0 Release Notes + +This release will only be available through manual upgrades. Clusters set to automatic upgrades will not receive this release. For how to configure upgrades, please see [classic](https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-upgrade) or [managed](https://docs.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-configuration) documentation. + +## Contents +* [Service Fabric Packages and Versions](#service-fabric-packages-and-versions) +* [Service Fabric Feature and Bug Fixes](#service-fabric-feature-and-bug-fixes) +* [Retirement and Deprecation Path Callouts](#retirement-and-deprecation-path-callouts) +* [Repositories and Download Links](#repositories-and-download-links) + +## Service Fabric Packages and Versions +The following packages and versions are part of this release: + +| Service | Platform | Version | +|---------|----------|---------| +|Service Fabric Runtime| Ubuntu 18
Ubuntu 20
Windows | 9.0.1260.1
9.0.1260.1
9.0.1309.9590 | +|Service Fabric for Windows Server|Service Fabric Standalone Installer Package | 9.0.1309.9590 | +|.NET SDK |Windows .NET SDK
Microsoft.ServiceFabric
Reliable Services and Reliable Actors
ASP.NET Core Service Fabric integration| 6.0.1309
9.0.1309
6.0.1309
6.0.1309 | +|Java SDK |Java for Linux SDK | 1.0.6 | +|Service Fabric PowerShell and CLI | AzureRM PowerShell Module
SFCTL | 0.3.15
11.0.1 | + +## Service Fabric Feature and Bug Fixes +This release includes quality improvements only and does not contain bug fixes to specific issue. + +## Retirement and Deprecation Path Callouts +* As aligned with [Microsoft .NET and .NET Core - Microsoft Lifecycle | Microsoft Learn](https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-and-net-core), SF Runtime has dropped support for Net Core 3.1 as of December 2022. For supported versions see [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#current-versions-1) and migrate applications as needed. +* Ubuntu 18.04 LTS will reach its 5-year end-of-life window on April 30, 2023. Service Fabric runtime will drop support for 18.04 LTS after the published date, and we recommend moving your clusters and applications to supported versions listed here: [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#supported-linux-versions-and-support-end-date) +* Service Fabric runtime will soon stop supporting BinaryFormatter based remoting exception serialization by default and move to using Data Contract Serialization (DCS) based remoting exception serialization by default. Current applications using it will continue to work as-is, but Service Fabric strongly recommends moving to using Data Contract Serialization (DCS) based remoting exception instead. +* Service Fabric runtime will soon be archiving and removing Service Fabric runtime version 6.4 packages and older, as well as SDK version 3.3 packages and older from the package Download Center. Archiving/Removing will affect application scaling and re-imaging of virtual machines in a Service Fabric Cluster running on unsupported versions. After older versions are removed/archived, this may cause failure while rolling back when the current in-progress upgrade has errors. +* Migrate Azure Active Directory Authentication Library (ADAL) library to Microsoft Authentication Library (MSAL) library, since ADAL will be out of support after December 2022. This will impact customers using AAD for authentication in Service Fabric for below features:For more information see: [MSAL Migration] (https://learn.microsoft.com/en-us/azure/active-directory/develop/msal-migration) + +## Repositories and Download Links +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: +* [Getting Started with Linux](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-linux) +* [Getting Started with Mac](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-mac) +* [Getting Started with Windows](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started) + +| Area | Package | Version | Repository | Direct Download Link | +|-|-|-|-|-| +|Service Fabric Runtime |Ubuntu Developer Set-up | 9.0.1260.1 |N/A | Cluster Runtime: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabric
Service Fabric SDK for local cluster setup: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabricsdkcommon/
Container image: https://hub.docker.com/r/microsoft/service-fabric-onebox/ +|| Windows Developer Set-up| 9.0.1309.9590 | N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabric.9.0.1309.9590.exe | +|Service Fabric for Windows Server |Service Fabric Standalone Installer Package | 9.0.1309.9590 |N/A | https://download.microsoft.com/download/8/3/6/836E3E99-A300-4714-8278-96BC3E8B5528/9.0.1309.9590/Microsoft.Azure.ServiceFabric.WindowsServer.9.0.1309.9590.zip | +||Service Fabric Standalone Runtime | 9.0.1309.9590 |N/A | https://download.microsoft.com/download/B/0/B/B0BCCAC5-65AA-4BE3-AB13-D5FF5890F4B5/9.0.1309.9590/MicrosoftAzureServiceFabric.9.0.1309.9590.cab | +|.NET SDK |Windows .NET SDK | 6.0.1309 |N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabricSDK.6.0.1309.msi | +||Microsoft.ServiceFabric | 9.0.1309 |N/A |https://www.nuget.org | +||Reliable Services and Reliable Actors
\-Microsoft.ServiceFabric.Services
\-Microsoft.ServiceFabric.Services.Remoting
\-Microsoft.ServiceFabric.Services.Wcf
\-Microsoft.ServiceFabric.Actors
\-Microsoft.ServiceFabric.Actors.Wcf | 6.0.1309 |https://github.com/Azure/service-fabric-services-and-actors-dotnet |https://www.nuget.org | +||ASP.NET Core Service Fabric integration
\-Microsoft.ServiceFabric.Services.AspNetCore.*| 6.0.1309 |https://github.com/Azure/service-fabric-aspnetcore |https://www.nuget.org | +||Data, Diagnostics and Fabric transport
\-Microsoft.ServiceFabric.Data
\-Microsoft.ServiceFabric.Data.Interfaces
\-Microsoft.ServiceFabric.Diagnostics.Internal
\-Microsoft.ServiceFabric.FabricTransport/Internal | 6.0.1309 |N/A| https://www.nuget.org | +||Microsoft.ServiceFabric.Data.Extensions | 9.0.1309 | 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/Azure/generator-azuresfjava |N/A | +||Azure Service Fabric C# generator | 1.0.9 |https://github.com/Azure/generator-azuresfcsharp |N/A | +||Azure Service Fabric guest executables generator | 1.0.1 |https://github.com/Azure/generator-azuresfguest |N/A| +||Azure Service Fabric Container generators | 1.0.1 |https://github.com/Azure/generator-azuresfcontainer |N/A | +|CLI |Service Fabric CLI | 11.0.1 |https://github.com/Azure/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 |N/A | diff --git a/release_notes/Service_Fabric_ReleaseNotes_90CU8.md b/release_notes/Service_Fabric_ReleaseNotes_90CU8.md new file mode 100644 index 000000000..f3a92930f --- /dev/null +++ b/release_notes/Service_Fabric_ReleaseNotes_90CU8.md @@ -0,0 +1,66 @@ +# Microsoft Azure Service Fabric 9.0 Cumulative Update 8.0 Release Notes + +This release will only be available through manual upgrades. Clusters set to automatic upgrades will not receive this release. For how to configure upgrades, please see [classic](https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-upgrade) or [managed](https://docs.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-configuration) documentation. + +## Contents +* [Service Fabric Packages and Versions](#service-fabric-packages-and-versions) +* [Service Fabric Feature and Bug Fixes](#service-fabric-feature-and-bug-fixes) +* [Retirement and Deprecation Path Callouts](#retirement-and-deprecation-path-callouts) +* [Repositories and Download Links](#repositories-and-download-links) + +## Service Fabric Packages and Versions +The following packages and versions are part of this release: + +| Service | Platform | Version | +|---------|----------|---------| +|Service Fabric Runtime| Ubuntu 18
Ubuntu 20
Windows | 9.0.1317.1
9.0.1317.1
9.0.1380.9590 | +|Service Fabric for Windows Server|Service Fabric Standalone Installer Package | 9.0.1380.9590 | +|.NET SDK |Windows .NET SDK
Microsoft.ServiceFabric
Reliable Services and Reliable Actors
ASP.NET Core Service Fabric integration| 6.0.1309
9.0.1380
6.0.1380
6.0.1380 | +|Java SDK |Java for Linux SDK | 1.0.6 | +|Service Fabric PowerShell and CLI | AzureRM PowerShell Module
SFCTL | 0.3.15
11.0.1 | + +## Service Fabric Feature and Bug Fixes +| Versions | IssueType | Description | Resolution | +|-|-|-|-| +| **Windows - 9.0.1380.9590
Ubuntu 18 - 9.0.1317.1
Ubuntu 20 - 9.0.1317.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: The KVS databases now have an automatic compaction feature based on the percentage of free page size. This feature utilizes the "FreePageSizeThresholdInPercent" setting, which has a default value of 30%. The system still supports legacy settings such as "CompactionThresholdInMB", "FreePageSizeThresholdInMB", and "CompactionProbabilityInPercent", if they are still in use.
**Solution**: Customers should start using the new "FreePageSizeThresholdInPercent" property for customizing when offline auto-compaction occurs as the legacy settings will be removed in the next major Service Fabric runtime update.
**Workaround**: Auto-compaction based on "FreePageSizeThresholdInPercent" can be disabled by setting the value to 100 +| **Windows - 9.0.1380.9590
Ubuntu 18 - 9.0.1317.1
Ubuntu 20 - 9.0.1317.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: To ensure that the free page size is accurately calculated and used for auto-compaction purposes, all KVS databases will undergo regular defragmentation.
**Solution**: Customers can adjust the frequency of defragmentation using "MaxDefragFrequencyInMinutes". +| **Windows - 9.0.1380.9590
Ubuntu 18 - 9.0.1317.1
Ubuntu 20 - 9.0.1317.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: The "IntrinsicValueThresholdInBytes" setting controls the size of long values stored in a record. If a value exceeds this size, it is stored as an Long Value ID (LVID) within the record. Presently, the default value is 0 which sets the size to 1024 bytes. However, in the future, the value will be changed to 5120 bytes to enable storage of long values up to approximately 5KB within a record. This change is expected to minimize LVID creation and mitigate the risk of LVID exhaustion.
**Solution**: The default value of the IntrinsicValueThresholdInBytes is set to 5120 bytes. +| **Windows - 9.0.1380.9590
Ubuntu 18 - 9.0.1317.1
Ubuntu 20 - 9.0.1317.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: Legacy Compaction Settings (CompactionThresholdInMB, FreePageSizeThresholdInMB, and CompactionProbabilityInPercent) will be removed in the next major Service Fabric runtime version and functionality will be replaced with "FreePageSizeThresholdInPercent". These settings are deprecated and documented in the public API documentation to use the new "FreePageSizeThresholdInPercent" setting.
**Solution**: Customers should start using the new "FreePageSizeThresholdInPercent" property for customizing when offline auto-compaction occurs.
**Documentation Reference**: +| **Windows - 9.0.1380.9590
Ubuntu 18 - 9.0.1317.1
Ubuntu 20 - 9.0.1317.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: Legacy Defragmentation setting "DefragThresholdInMB" will be removed in the next major Service Fabric runtime version (June 2023) as regular defragmentation will occur by default. This setting is deprecated and documented in the public API documentation to use the new setting "MaxDefragFrequencyInMinutes".
**Solution**: Customers should start using "MaxDefragFrequencyInMinutes" to adjust frequency of defragmentation going forward.
**Documentation Reference**: [MaxDefragFrequency Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.maxdefragfrequencyinminutes?view=azure-dotnet#system-fabric-localesestoresettings-maxdefragfrequencyinminutes) +| **Windows - 9.0.1380.9590
Ubuntu 18 - 9.0.1317.1
Ubuntu 20 - 9.0.1317.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: "IntrinsicValueThresholdInBytes" and "DatabasePageSizeInKB" will be removed in the next major Service Fabric runtime version (June 2023). The optimal value for these settings will be decided internally and will not be allowed to be override.
**Solution**: Customers will not be able to override "IntrinsicValueThresholdInBytes" and "DatabasePageSizeInKB" these settings
**Documentation Reference**: + + +## Retirement and Deprecation Path Callouts +* As aligned with [Microsoft .NET and .NET Core - Microsoft Lifecycle | Microsoft Learn](https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-and-net-core), SF Runtime has dropped support for Net Core 3.1 as of December 2022. For supported versions see [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#current-versions-1) and migrate applications as needed. +* Ubuntu 18.04 LTS will reach its 5-year end-of-life window on June, 2023. Service Fabric runtime will drop support for 18.04 LTS after the published date, and we recommend moving your clusters and applications to supported versions listed here: [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#supported-linux-versions-and-support-end-date) +* Service Fabric runtime will soon stop supporting BinaryFormatter based remoting exception serialization by default and move to using Data Contract Serialization (DCS) based remoting exception serialization by default. Current applications using it will continue to work as-is, but Service Fabric strongly recommends moving to using Data Contract Serialization (DCS) based remoting exception instead. +* Service Fabric runtime will soon be archiving and removing Service Fabric runtime version 6.4 packages and older, as well as SDK version 3.3 packages and older from the package Download Center. Archiving/Removing will affect application scaling and re-imaging of virtual machines in a Service Fabric Cluster running on unsupported versions. After older versions are removed/archived, this may cause failure while rolling back when the current in-progress upgrade has errors. +* Migrate Azure Active Directory Authentication Library (ADAL) library to Microsoft Authentication Library (MSAL) library, since ADAL will be out of support after December 2022. This will impact customers using AAD for authentication in Service Fabric for below features:For more information see: [MSAL Migration] (https://learn.microsoft.com/en-us/azure/active-directory/develop/msal-migration) + +## Repositories and Download Links +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: +* [Getting Started with Linux](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-linux) +* [Getting Started with Mac](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-mac) +* [Getting Started with Windows](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started) + +| Area | Package | Version | Repository | Direct Download Link | +|-|-|-|-|-| +|Service Fabric Runtime |Ubuntu Developer Set-up | 9.0.1317.1 |N/A | Cluster Runtime: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabric
Service Fabric SDK for local cluster setup: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabricsdkcommon/
Container image: https://hub.docker.com/r/microsoft/service-fabric-onebox/ +|| Windows Developer Set-up| 9.0.1380.9590 | N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabric.9.0.1380.9590.exe | +|Service Fabric for Windows Server |Service Fabric Standalone Installer Package | 9.0.1380.9590 |N/A | https://download.microsoft.com/download/8/3/6/836E3E99-A300-4714-8278-96BC3E8B5528/9.0.1380.9590/Microsoft.Azure.ServiceFabric.WindowsServer.9.0.1380.9590.zip | +||Service Fabric Standalone Runtime | 9.0.1380.9590 |N/A | https://download.microsoft.com/download/B/0/B/B0BCCAC5-65AA-4BE3-AB13-D5FF5890F4B5/9.0.1380.9590/MicrosoftAzureServiceFabric.9.0.1380.9590.cab | +|.NET SDK |Windows .NET SDK | 6.0.1380 |N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabricSDK.6.0.1380.msi | +||Microsoft.ServiceFabric | 9.0.1380 |N/A |https://www.nuget.org | +||Reliable Services and Reliable Actors
\-Microsoft.ServiceFabric.Services
\-Microsoft.ServiceFabric.Services.Remoting
\-Microsoft.ServiceFabric.Services.Wcf
\-Microsoft.ServiceFabric.Actors
\-Microsoft.ServiceFabric.Actors.Wcf | 6.0.1380 |https://github.com/Azure/service-fabric-services-and-actors-dotnet |https://www.nuget.org | +||ASP.NET Core Service Fabric integration
\-Microsoft.ServiceFabric.Services.AspNetCore.*| 6.0.1380 |https://github.com/Azure/service-fabric-aspnetcore |https://www.nuget.org | +||Data, Diagnostics and Fabric transport
\-Microsoft.ServiceFabric.Data
\-Microsoft.ServiceFabric.Data.Interfaces
\-Microsoft.ServiceFabric.Diagnostics.Internal
\-Microsoft.ServiceFabric.FabricTransport/Internal | 6.0.1380 |N/A| https://www.nuget.org | +||Microsoft.ServiceFabric.Data.Extensions | 9.0.1309 | 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/Azure/generator-azuresfjava |N/A | +||Azure Service Fabric C# generator | 1.0.9 |https://github.com/Azure/generator-azuresfcsharp |N/A | +||Azure Service Fabric guest executables generator | 1.0.1 |https://github.com/Azure/generator-azuresfguest |N/A| +||Azure Service Fabric Container generators | 1.0.1 |https://github.com/Azure/generator-azuresfcontainer |N/A | +|CLI |Service Fabric CLI | 11.0.1 |https://github.com/Azure/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 |N/A | diff --git a/release_notes/Service_Fabric_ReleaseNotes_90CU9.md b/release_notes/Service_Fabric_ReleaseNotes_90CU9.md new file mode 100644 index 000000000..2f86b6bec --- /dev/null +++ b/release_notes/Service_Fabric_ReleaseNotes_90CU9.md @@ -0,0 +1,60 @@ +# Microsoft Azure Service Fabric 9.0 Cumulative Update 9.0 Release Notes + +This release will only be available through manual upgrades. Clusters set to automatic upgrades will not receive this release. For how to configure upgrades, please see [classic](https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-upgrade) or [managed](https://docs.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-configuration) documentation. + +## Contents +* [Service Fabric Packages and Versions](#service-fabric-packages-and-versions) +* [Service Fabric Feature and Bug Fixes](#service-fabric-feature-and-bug-fixes) +* [Retirement and Deprecation Path Callouts](#retirement-and-deprecation-path-callouts) +* [Repositories and Download Links](#repositories-and-download-links) + +## Service Fabric Packages and Versions +The following packages and versions are part of this release: + +| Service | Platform | Version | +|---------|----------|---------| +|Service Fabric Runtime| Ubuntu 18
Ubuntu 20
Windows | 9.0.1463.1
9.0.1463.1
9.0.1526.9590 | +|Service Fabric for Windows Server|Service Fabric Standalone Installer Package | 9.0.1526.9590 | +|.NET SDK |Windows .NET SDK
Microsoft.ServiceFabric
Reliable Services and Reliable Actors
ASP.NET Core Service Fabric integration| 6.0.1526
9.0.1526
6.0.1526
6.0.1526 | +|Java SDK |Java for Linux SDK | 1.0.6 | +|Service Fabric PowerShell and CLI | AzureRM PowerShell Module
SFCTL | 0.3.15
11.0.1 | + +## Service Fabric Feature and Bug Fixes +| Versions | IssueType | Description | Resolution | +|-|-|-|-| +| **Windows - 9.0.1526.9590
Ubuntu 18 - 9.0.1463.1
Ubuntu 20 - 9.0.1463.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: KVS backed partitions, including Actors and System Services, experience quorum loss due to StoreLVIDLimitHit error code (0x80071d4d), indicating the depletion of values for a monotonically increasing ID field. This results in unavailability of the partition until a manual offline maintenance task is executed to resolve the issue.
**Solution**: To address the error, KVS replicas now restart automatically and initiate the maintenance task (Extensible Storage Engine database compaction) during the next open. While there may be temporary availability loss in partitions depending on the task duration, no manual intervention is required to mitigate the issue. +| **Windows - 9.0.1526.9590
Ubuntu 18 - 9.0.1463.1
Ubuntu 20 - 9.0.1463.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: Auto-compaction now emits health events at the start and completion, visible in the Service Fabric Explorer, enhancing its monitoring capabilities. These events complement trace data, providing effective visibility into active auto-compaction progress. + +## Retirement and Deprecation Path Callouts +* As aligned with [Microsoft .NET and .NET Core - Microsoft Lifecycle | Microsoft Learn](https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-and-net-core), SF Runtime has dropped support for Net Core 3.1 as of December 2022. For supported versions see [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#current-versions-1) and migrate applications as needed. +* Ubuntu 18.04 LTS will reach its 5-year end-of-life window on June, 2023. Service Fabric runtime will drop support for 18.04 LTS after the published date, and we recommend moving your clusters and applications to supported versions listed here: [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#supported-linux-versions-and-support-end-date) +* Service Fabric runtime will soon stop supporting BinaryFormatter based remoting exception serialization by default and move to using Data Contract Serialization (DCS) based remoting exception serialization by default. Current applications using it will continue to work as-is, but Service Fabric strongly recommends moving to using Data Contract Serialization (DCS) based remoting exception instead. +* Service Fabric runtime will soon be archiving and removing Service Fabric runtime version 6.4 packages and older, as well as SDK version 3.3 packages and older from the package Download Center. Archiving/Removing will affect application scaling and re-imaging of virtual machines in a Service Fabric Cluster running on unsupported versions. After older versions are removed/archived, this may cause failure while rolling back when the current in-progress upgrade has errors. + +## Repositories and Download Links +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: +* [Getting Started with Linux](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-linux) +* [Getting Started with Mac](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-mac) +* [Getting Started with Windows](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started) + +| Area | Package | Version | Repository | Direct Download Link | +|-|-|-|-|-| +|Service Fabric Runtime |Ubuntu Developer Set-up | 9.0.1463.1 |N/A | Cluster Runtime: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabric
Service Fabric SDK for local cluster setup: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabricsdkcommon/
Container image: https://hub.docker.com/r/microsoft/service-fabric-onebox/ +|| Windows Developer Set-up| 9.0.1526.9590 | N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabric.9.0.1526.9590.exe | +|Service Fabric for Windows Server |Service Fabric Standalone Installer Package | 9.0.1526.9590 |N/A | https://download.microsoft.com/download/8/3/6/836E3E99-A300-4714-8278-96BC3E8B5528/9.0.1526.9590/Microsoft.Azure.ServiceFabric.WindowsServer.9.0.1526.9590.zip | +||Service Fabric Standalone Runtime | 9.0.1526.9590 |N/A | https://download.microsoft.com/download/B/0/B/B0BCCAC5-65AA-4BE3-AB13-D5FF5890F4B5/9.0.1526.9590/MicrosoftAzureServiceFabric.9.0.1526.9590.cab | +|.NET SDK |Windows .NET SDK | 6.0.1526 |N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabricSDK.6.0.1526.msi | +||Microsoft.ServiceFabric | 9.0.1526 |N/A |https://www.nuget.org | +||Reliable Services and Reliable Actors
\-Microsoft.ServiceFabric.Services
\-Microsoft.ServiceFabric.Services.Remoting
\-Microsoft.ServiceFabric.Services.Wcf
\-Microsoft.ServiceFabric.Actors
\-Microsoft.ServiceFabric.Actors.Wcf | 6.0.1526 |https://github.com/Azure/service-fabric-services-and-actors-dotnet |https://www.nuget.org | +||ASP.NET Core Service Fabric integration
\-Microsoft.ServiceFabric.Services.AspNetCore.*| 6.0.1526 |https://github.com/Azure/service-fabric-aspnetcore |https://www.nuget.org | +||Data, Diagnostics and Fabric transport
\-Microsoft.ServiceFabric.Data
\-Microsoft.ServiceFabric.Data.Interfaces
\-Microsoft.ServiceFabric.Diagnostics.Internal
\-Microsoft.ServiceFabric.FabricTransport/Internal | 6.0.1526 |N/A| https://www.nuget.org | +||Microsoft.ServiceFabric.Data.Extensions | 9.0.1526 | 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/Azure/generator-azuresfjava |N/A | +||Azure Service Fabric C# generator | 1.0.9 |https://github.com/Azure/generator-azuresfcsharp |N/A | +||Azure Service Fabric guest executables generator | 1.0.1 |https://github.com/Azure/generator-azuresfguest |N/A| +||Azure Service Fabric Container generators | 1.0.1 |https://github.com/Azure/generator-azuresfcontainer |N/A | +|CLI |Service Fabric CLI | 11.0.1 |https://github.com/Azure/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 |N/A | diff --git a/release_notes/Service_Fabric_ReleaseNotes_91CU2.md b/release_notes/Service_Fabric_ReleaseNotes_91CU2.md new file mode 100644 index 000000000..7e59e422f --- /dev/null +++ b/release_notes/Service_Fabric_ReleaseNotes_91CU2.md @@ -0,0 +1,62 @@ +# Microsoft Azure Service Fabric 9.1 Cumulative Update 2.0 Release Notes + +* [Service Fabric Packages and Versions](#service-fabric-packages-and-versions) +* [Key Announcements](#key-announcements) +* [Service Fabric Feature and Bug Fixes](#service-fabric-feature-and-bug-fixes) +* [Retirement and Deprecation Path Callouts](#retirement-and-deprecation-path-callouts) +* [Repositories and Download Links](#repositories-and-download-links) + +## Service Fabric Packages and Versions +The following packages and versions are part of this release: + +| Service | Platform | Version | +|---------|----------|---------| +|Service Fabric Runtime| Ubuntu 18
Ubuntu 20
Windows | 9.1.1388.1
9.1.1388.1
9.1.1583.9590 | +|Service Fabric for Windows Server|Service Fabric Standalone Installer Package | 9.1.1583.9590 | +|.NET SDK |Windows .NET SDK
Microsoft.ServiceFabric
Reliable Services and Reliable Actors
ASP.NET Core Service Fabric integration| 6.1.1583
9.1.1583
6.1.1583
6.1.1583 | +|Java SDK |Java for Linux SDK | 1.0.6 | +|Service Fabric PowerShell and CLI | AzureRM PowerShell Module
SFCTL | 0.3.15
11.0.1 | + +## Key Announcements +* Service Fabric version 9.1CU2 introduces programming model support for .NET 7.0. Service Fabric applications running on .NET 6.0 can now be upgraded to .NET 7.0.
+Note: Please install the .Net 7 runtime version greater than 7.0.2 which contains fix for binary-deserialization of float/doubles in DataContractSerializer. For details see: [Binary-deserialization of float/doubles fix](https://github.com/dotnet/runtime/pull/80321) +* Azure Service Fabric introduced a policy which will validate that the minimum virtual machine count configuration meets the durability requirements for "Silver" and "Gold." This has been a [documented requirement](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-capacity#durability-characteristics-of-the-cluster) to ensure reliable and safe infrastructure updates can occur for production workloads. Per this policy, Service Fabric Resource Provider node types with virtual machine scale set "Silver" or "Gold" durability tiers should always have at least 5 virtual machines. Any configuration with less than 5 virtual machines leads to various reliability issues while performing infrastructure updates (such as AutoOSUpgrades, scale out/in, platform updates, etc.) and can lead to availability or data loss. +Update all of your existing/new deployments to have at least 5 virtual machine instances when the virtual machine scale set durability tier is "Silver" or "Gold." We have blocked operations for new cluster creation of "Silver" and "Gold" durability tier virtual machine scale sets when the target instance count is less than 5 starting February 2023. For more updates or information on this policy and upcoming virtual machine scale set validations, refer to our [documentation](https://github.com/Azure/Service-Fabric-Troubleshooting-Guides/blob/master/Deployment/SFRP-VMSS-Validations.md). + +## Service Fabric Feature and Bug Fixes +This release includes quality improvements only and does not contain bug fixes to specific issue. + +## Retirement and Deprecation Path Callouts +* As aligned with [Microsoft .NET and .NET Core - Microsoft Lifecycle | Microsoft Learn](https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-and-net-core), SF Runtime has dropped support for Net Core 3.1 as of December 2022. For supported versions see [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#current-versions-1) and migrate applications as needed. +* Ubuntu 18.04 LTS will reach its 5-year end-of-life window on April 30, 2023. Service Fabric runtime will drop support for 18.04 LTS after the published date, and we recommend moving your clusters and applications to supported versions listed here: [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#supported-linux-versions-and-support-end-date) +* Service Fabric runtime will soon stop supporting BinaryFormatter based remoting exception serialization by default and move to using Data Contract Serialization (DCS) based remoting exception serialization by default. Current applications using it will continue to work as-is, but Service Fabric strongly recommends moving to using Data Contract Serialization (DCS) based remoting exception instead. +* Service Fabric runtime will soon be archiving and removing Service Fabric runtime version 6.4 packages and older, as well as SDK version 3.3 packages and older from the package Download Center. Archiving/Removing will affect application scaling and re-imaging of virtual machines in a Service Fabric Cluster running on unsupported versions. After older versions are removed/archived, this may cause failure while rolling back when the current in-progress upgrade has errors. +* Migrate Azure Active Directory Authentication Library (ADAL) library to Microsoft Authentication Library (MSAL) library, since ADAL will be out of support after December 2022. This will impact customers using AAD for authentication in Service Fabric for below features:For more information see: [MSAL Migration] (https://learn.microsoft.com/en-us/azure/active-directory/develop/msal-migration) + +## Repositories and Download Links +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: +* [Getting Started with Linux](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-linux) +* [Getting Started with Mac](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-mac) +* [Getting Started with Windows](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started) + +| Area | Package | Version | Repository | Direct Download Link | +|-|-|-|-|-| +|Service Fabric Runtime |Ubuntu Developer Set-up | 9.1.1388.1 |N/A | Cluster Runtime: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabric
Service Fabric SDK for local cluster setup: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabricsdkcommon/
Container image: https://hub.docker.com/r/microsoft/service-fabric-onebox/ +|| Windows Developer Set-up| 9.1.1583.9590 | N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabric.9.1.1583.9590.exe | +|Service Fabric for Windows Server |Service Fabric Standalone Installer Package | 9.1.1583.9590 |N/A | https://download.microsoft.com/download/8/3/6/836E3E99-A300-4714-8278-96BC3E8B5528/9.1.1583.9590/Microsoft.Azure.ServiceFabric.WindowsServer.9.1.1583.9590.zip | +||Service Fabric Standalone Runtime | 9.1.1583.9590 |N/A | https://download.microsoft.com/download/B/0/B/B0BCCAC5-65AA-4BE3-AB13-D5FF5890F4B5/9.1.1583.9590/MicrosoftAzureServiceFabric.9.1.1583.9590.cab | +|.NET SDK |Windows .NET SDK | 6.1.1583 |N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabricSDK.6.1.1583.msi | +||Microsoft.ServiceFabric | 9.1.1583 |N/A |https://www.nuget.org | +||Reliable Services and Reliable Actors
\-Microsoft.ServiceFabric.Services
\-Microsoft.ServiceFabric.Services.Remoting
\-Microsoft.ServiceFabric.Services.Wcf
\-Microsoft.ServiceFabric.Actors
\-Microsoft.ServiceFabric.Actors.Wcf | 6.1.1583 |https://github.com/Azure/service-fabric-services-and-actors-dotnet |https://www.nuget.org | +||ASP.NET Core Service Fabric integration
\-Microsoft.ServiceFabric.Services.AspNetCore.*| 6.1.1583 |https://github.com/Azure/service-fabric-aspnetcore |https://www.nuget.org | +||Data, Diagnostics and Fabric transport
\-Microsoft.ServiceFabric.Data
\-Microsoft.ServiceFabric.Data.Interfaces
\-Microsoft.ServiceFabric.Diagnostics.Internal
\-Microsoft.ServiceFabric.FabricTransport/Internal | 9.1.1583 |N/A| https://www.nuget.org | +||Microsoft.ServiceFabric.Data.Extensions | 9.1.1583 | 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/Azure/generator-azuresfjava |N/A | +||Azure Service Fabric C# generator | 1.0.9 |https://github.com/Azure/generator-azuresfcsharp |N/A | +||Azure Service Fabric guest executables generator | 1.0.1 |https://github.com/Azure/generator-azuresfguest |N/A| +||Azure Service Fabric Container generators | 1.0.1 |https://github.com/Azure/generator-azuresfcontainer |N/A | +|CLI |Service Fabric CLI | 11.0.1 |https://github.com/Azure/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 |N/A | diff --git a/release_notes/Service_Fabric_ReleaseNotes_91CU3.md b/release_notes/Service_Fabric_ReleaseNotes_91CU3.md new file mode 100644 index 000000000..3f9765b2f --- /dev/null +++ b/release_notes/Service_Fabric_ReleaseNotes_91CU3.md @@ -0,0 +1,64 @@ +# Microsoft Azure Service Fabric 9.1 Cumulative Update 3.0 Release Notes + +* [Service Fabric Packages and Versions](#service-fabric-packages-and-versions) +* [Service Fabric Feature and Bug Fixes](#service-fabric-feature-and-bug-fixes) +* [Retirement and Deprecation Path Callouts](#retirement-and-deprecation-path-callouts) +* [Repositories and Download Links](#repositories-and-download-links) + +## Service Fabric Packages and Versions +The following packages and versions are part of this release: + +| Service | Platform | Version | +|---------|----------|---------| +|Service Fabric Runtime| Ubuntu 18
Ubuntu 20
Windows | 9.1.1457.1
9.1.1457.1
9.1.1653.9590 | +|Service Fabric for Windows Server|Service Fabric Standalone Installer Package | 9.1.1653.9590 | +|.NET SDK |Windows .NET SDK
Microsoft.ServiceFabric
Reliable Services and Reliable Actors
ASP.NET Core Service Fabric integration| 6.1.1653
9.1.1653
6.1.1653
6.1.1653 | +|Java SDK |Java for Linux SDK | 1.0.6 | +|Service Fabric PowerShell and CLI | AzureRM PowerShell Module
SFCTL | 0.3.15
11.0.1 | + + +## Service Fabric Feature and Bug Fixes +| Versions | IssueType | Description | Resolution | +|-|-|-|-| +| **Windows - 9.1.1653.9590
Ubuntu 18 - 9.1.1457.1
Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: The KVS databases now have an automatic compaction feature based on the percentage of free page size. This feature utilizes the "FreePageSizeThresholdInPercent" setting, which has a default value of 30%. The system still supports legacy settings such as "CompactionThresholdInMB", "FreePageSizeThresholdInMB", and "CompactionProbabilityInPercent", if they are still in use.
**Solution**: Customers should start using the new "FreePageSizeThresholdInPercent" property for customizing when offline auto-compaction occurs as the legacy settings will be removed in the next major Service Fabric runtime update.
**Workaround**: Auto-compaction based on "FreePageSizeThresholdInPercent" can be disabled by setting the value to 100 +| **Windows - 9.1.1653.9590
Ubuntu 18 - 9.1.1457.1
Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: To ensure that the free page size is accurately calculated and used for auto-compaction purposes, all KVS databases will undergo regular defragmentation.
**Solution**: Customers can adjust the frequency of defragmentation using "MaxDefragFrequencyInMinutes". +| **Windows - 9.1.1653.9590
Ubuntu 18 - 9.1.1457.1
Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: The "IntrinsicValueThresholdInBytes" setting controls the size of long values stored in a record. If a value exceeds this size, it is stored as an Long Value ID (LVID) within the record. Presently, the default value is 0 which sets the size to 1024 bytes. However, in the future, the value will be changed to 5120 bytes to enable storage of long values up to approximately 5KB within a record. This change is expected to minimize LVID creation and mitigate the risk of LVID exhaustion.
**Solution**: The default value of the IntrinsicValueThresholdInBytes is set to 5120 bytes. +| **Windows - 9.1.1653.9590
Ubuntu 18 - 9.1.1457.1
Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: Legacy Compaction Settings (CompactionThresholdInMB, FreePageSizeThresholdInMB, and CompactionProbabilityInPercent) will be removed in the next major Service Fabric runtime version and functionality will be replaced with "FreePageSizeThresholdInPercent". These settings are deprecated and documented in the public API documentation to use the new "FreePageSizeThresholdInPercent" setting.
**Solution**: Customers should start using the new "FreePageSizeThresholdInPercent" property for customizing when offline auto-compaction occurs.
**Documentation Reference**: +| **Windows - 9.1.1653.9590
Ubuntu 18 - 9.1.1457.1
Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: Legacy Defragmentation setting "DefragThresholdInMB" will be removed in the next major Service Fabric runtime version (June 2023) as regular defragmentation will occur by default. This setting is deprecated and documented in the public API documentation to use the new setting "MaxDefragFrequencyInMinutes".
**Solution**: Customers should start using "MaxDefragFrequencyInMinutes" to adjust frequency of defragmentation going forward.
**Documentation Reference**: [MaxDefragFrequency Property](https://learn.microsoft.com/en-us/dotnet/api/system.fabric.localesestoresettings.maxdefragfrequencyinminutes?view=azure-dotnet#system-fabric-localesestoresettings-maxdefragfrequencyinminutes) +| **Windows - 9.1.1653.9590
Ubuntu 18 - 9.1.1457.1
Ubuntu 20 - 9.1.1457.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: "IntrinsicValueThresholdInBytes" and "DatabasePageSizeInKB" will be removed in the next major Service Fabric runtime version (June 2023). The optimal value for these settings will be decided internally and will not be allowed to be override.
**Solution**: Customers will not be able to override "IntrinsicValueThresholdInBytes" and "DatabasePageSizeInKB" these settings
**Documentation Reference**: +| **Windows - 9.1.1653.9590
Ubuntu 18 - 9.1.1457.1
Ubuntu 20 - 9.1.1457.1** | **Bug** | OpenSSL | **Brief Description**: OpenSSL is a dependency for Service Fabric, but versions prior to 3.0.7 have known security vulnerabilities. To address this, we have updated the GRPC dependency to reference a more recent version, 3.1.0.
For more information see [OpenSSL Vulnerabilities](https://www.openssl.org/news/vulnerabilities-3.1.html) + +## Retirement and Deprecation Path Callouts +* As aligned with [Microsoft .NET and .NET Core - Microsoft Lifecycle | Microsoft Learn](https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-and-net-core), SF Runtime has dropped support for Net Core 3.1 as of December 2022. For supported versions see [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#current-versions-1) and migrate applications as needed. +* Ubuntu 18.04 LTS will reach its 5-year end-of-life window in June, 2023. Service Fabric runtime will drop support for 18.04 LTS after the published date, and we recommend moving your clusters and applications to supported versions listed here: [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#supported-linux-versions-and-support-end-date) +* Service Fabric runtime will soon stop supporting BinaryFormatter based remoting exception serialization by default and move to using Data Contract Serialization (DCS) based remoting exception serialization by default. Current applications using it will continue to work as-is, but Service Fabric strongly recommends moving to using Data Contract Serialization (DCS) based remoting exception instead. +* Service Fabric runtime will soon be archiving and removing Service Fabric runtime version 6.4 packages and older, as well as SDK version 3.3 packages and older from the package Download Center. Archiving/Removing will affect application scaling and re-imaging of virtual machines in a Service Fabric Cluster running on unsupported versions. After older versions are removed/archived, this may cause failure while rolling back when the current in-progress upgrade has errors. +* Migrate Azure Active Directory Authentication Library (ADAL) library to Microsoft Authentication Library (MSAL) library, since ADAL will be out of support after December 2022. This will impact customers using AAD for authentication in Service Fabric for below features:For more information see: [MSAL Migration] (https://learn.microsoft.com/en-us/azure/active-directory/develop/msal-migration) + +## Repositories and Download Links +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: +* [Getting Started with Linux](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-linux) +* [Getting Started with Mac](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-mac) +* [Getting Started with Windows](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started) + +| Area | Package | Version | Repository | Direct Download Link | +|-|-|-|-|-| +|Service Fabric Runtime |Ubuntu Developer Set-up | 9.1.1457.1 |N/A | Cluster Runtime: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabric
Service Fabric SDK for local cluster setup: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabricsdkcommon/
Container image: https://hub.docker.com/r/microsoft/service-fabric-onebox/ +|| Windows Developer Set-up| 9.1.1653.9590 | N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabric.9.1.1653.9590.exe | +|Service Fabric for Windows Server |Service Fabric Standalone Installer Package | 9.1.1653.9590 |N/A | https://download.microsoft.com/download/8/3/6/836E3E99-A300-4714-8278-96BC3E8B5528/9.1.1653.9590/Microsoft.Azure.ServiceFabric.WindowsServer.9.1.1653.9590.zip| +||Service Fabric Standalone Runtime | 9.1.1653.9590 |N/A | https://download.microsoft.com/download/B/0/B/B0BCCAC5-65AA-4BE3-AB13-D5FF5890F4B5/9.1.1653.9590/MicrosoftAzureServiceFabric.9.1.1653.9590.cab | +|.NET SDK |Windows .NET SDK | 6.1.1653 |N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabricSDK.6.1.1653.msi | +||Microsoft.ServiceFabric | 9.1.1653 |N/A |https://www.nuget.org | +||Reliable Services and Reliable Actors
\-Microsoft.ServiceFabric.Services
\-Microsoft.ServiceFabric.Services.Remoting
\-Microsoft.ServiceFabric.Services.Wcf
\-Microsoft.ServiceFabric.Actors
\-Microsoft.ServiceFabric.Actors.Wcf | 6.1.1653 |https://github.com/Azure/service-fabric-services-and-actors-dotnet |https://www.nuget.org | +||ASP.NET Core Service Fabric integration
\-Microsoft.ServiceFabric.Services.AspNetCore.*| 6.1.1653 |https://github.com/Azure/service-fabric-aspnetcore |https://www.nuget.org | +||Data, Diagnostics and Fabric transport
\-Microsoft.ServiceFabric.Data
\-Microsoft.ServiceFabric.Data.Interfaces
\-Microsoft.ServiceFabric.Diagnostics.Internal
\-Microsoft.ServiceFabric.FabricTransport/Internal | 9.1.1653 |N/A| https://www.nuget.org | +||Microsoft.ServiceFabric.Data.Extensions | 9.1.1653 | 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/Azure/generator-azuresfjava |N/A | +||Azure Service Fabric C# generator | 1.0.9 |https://github.com/Azure/generator-azuresfcsharp |N/A | +||Azure Service Fabric guest executables generator | 1.0.1 |https://github.com/Azure/generator-azuresfguest |N/A| +||Azure Service Fabric Container generators | 1.0.1 |https://github.com/Azure/generator-azuresfcontainer |N/A | +|CLI |Service Fabric CLI | 11.0.1 |https://github.com/Azure/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 |N/A | diff --git a/release_notes/Service_Fabric_ReleaseNotes_91CU4.md b/release_notes/Service_Fabric_ReleaseNotes_91CU4.md new file mode 100644 index 000000000..707a9f1eb --- /dev/null +++ b/release_notes/Service_Fabric_ReleaseNotes_91CU4.md @@ -0,0 +1,61 @@ +# Microsoft Azure Service Fabric 9.1 Cumulative Update 4.0 Release Notes + +* [Service Fabric Packages and Versions](#service-fabric-packages-and-versions) +* [Service Fabric Feature and Bug Fixes](#service-fabric-feature-and-bug-fixes) +* [Retirement and Deprecation Path Callouts](#retirement-and-deprecation-path-callouts) +* [Repositories and Download Links](#repositories-and-download-links) + +## Service Fabric Packages and Versions +The following packages and versions are part of this release: + +| Service | Platform | Version | +|---------|----------|---------| +|Service Fabric Runtime| Ubuntu 18
Ubuntu 20
Windows | 9.1.1592.1
9.1.1592.1
9.1.1799.9590 | +|Service Fabric for Windows Server|Service Fabric Standalone Installer Package | 9.1.1799.9590 | +|.NET SDK |Windows .NET SDK
Microsoft.ServiceFabric
Reliable Services and Reliable Actors
ASP.NET Core Service Fabric integration| 6.1.1799
9.1.1799
6.1.1799
6.1.1799 | +|Java SDK |Java for Linux SDK | 1.0.6 | +|Service Fabric PowerShell and CLI | AzureRM PowerShell Module
SFCTL | 0.3.15
11.0.1 | + + +## Service Fabric Feature and Bug Fixes +| Versions | IssueType | Description | Resolution | +|-|-|-|-| +| **Windows - 9.1.1799.9590
Ubuntu 18 - 9.1.1592.1
Ubuntu 20 - 9.1.1592.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: Auto-compaction now emits health events at the start and completion, visible in the Service Fabric Explorer, enhancing its monitoring capabilities. These events complement trace data, providing effective visibility into active auto-compaction progress. +| **Windows - 9.1.1799.9590
Ubuntu 18 - 9.1.1592.1
Ubuntu 20 - 9.1.1592.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: KVS backed partitions, including Actors and System Services, experience quorum loss due to StoreLVIDLimitHit error code (0x80071d4d), indicating the depletion of values for a monotonically increasing ID field. This results in unavailability of the partition until a manual offline maintenance task is executed to resolve the issue.
**Solution**: To address the error, KVS replicas now restart automatically and initiate the maintenance task (Extensible Storage Engine database compaction) during the next open. While there may be temporary availability loss in partitions depending on the task duration, no manual intervention is required to mitigate the issue. +| **Windows - 9.1.1799.9590
Ubuntu 18 - 9.1.1592.1
Ubuntu 20 - 9.1.1592.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: The "IntrinsicValueThresholdInBytes" setting controls the size of long values stored in a record. If a value exceeds this size, it is stored as an Long Value ID (LVID) within the record. Presently, the default value is 0 which sets the size to 1024 bytes. However, in the future, the value will be changed to 5120 bytes to enable storage of long values up to approximately 5KB within a record. This change is expected to minimize LVID creation and mitigate the risk of LVID exhaustion.
**Solution**: The default value of the IntrinsicValueThresholdInBytes is set to 5120 bytes. +| **Windows - 9.1.1799.9590
Ubuntu 18 - 9.1.1592.1
Ubuntu 20 - 9.1.1592.1** | **Feature** | Application Model | **Brief Description**: Service Fabric has a restriction that allows only one application type with the same name to be provisioned or unprovisioned at any given time. However, if an application type contains illegal path characters in its name or version, it becomes stuck in an unprovisioning loop. This situation not only affects the problematic application type but also causes other application types with the same name to fail during provisioning.
**Solution**: Improvements were made in Service Fabric to address the issue with invalid characters. +| **Windows - 9.1.1799.9590
Ubuntu 18 - 9.1.1592.1
Ubuntu 20 - 9.1.1592.1** | **Feature** | Failover Manager | **Brief Description**: When MinInstancePercentage is set to 100 and the stateless service has N instances, Service Fabric creates additional instances before taking any instances down for upgrade to ensure a total of N instances remain active throughout the upgrade process. However, during the upgrade, if FailoverManager.RelaxCheckForSafeReplicaCloseCount is set to True, only N-1 instances are guaranteed to be available. On the other hand, if FailoverManager.RelaxCheckForSafeReplicaCloseCount is set to False, the upgrade gets stuck in the preSafetyCheck phase, resulting in timeouts and rollbacks due to the unavailability of N instances
**Solution**: Set parameters RelaxCheckForSafeReplicaCloseCount as False and IsStrongMinInstanceCountCheckEnabled as True under FailoverManager section in ClusterManifest to move the upgrade forward. + +## Retirement and Deprecation Path Callouts +* As aligned with [Microsoft .NET and .NET Core - Microsoft Lifecycle | Microsoft Learn](https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-and-net-core), SF Runtime has dropped support for Net Core 3.1 as of December 2022. For supported versions see [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#current-versions-1) and migrate applications as needed. +* Ubuntu 18.04 LTS will reach its 5-year end-of-life window in June, 2023. Service Fabric runtime will drop support for 18.04 LTS after the published date, and we recommend moving your clusters and applications to supported versions listed here: [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#supported-linux-versions-and-support-end-date) +* Service Fabric runtime will soon stop supporting BinaryFormatter based remoting exception serialization by default and move to using Data Contract Serialization (DCS) based remoting exception serialization by default. Current applications using it will continue to work as-is, but Service Fabric strongly recommends moving to using Data Contract Serialization (DCS) based remoting exception instead. +* Service Fabric runtime will soon be archiving and removing Service Fabric runtime version 6.4 packages and older, as well as SDK version 3.3 packages and older from the package Download Center. Archiving/Removing will affect application scaling and re-imaging of virtual machines in a Service Fabric Cluster running on unsupported versions. After older versions are removed/archived, this may cause failure while rolling back when the current in-progress upgrade has errors. + +## Repositories and Download Links +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: +* [Getting Started with Linux](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-linux) +* [Getting Started with Mac](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-mac) +* [Getting Started with Windows](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started) + +| Area | Package | Version | Repository | Direct Download Link | +|-|-|-|-|-| +|Service Fabric Runtime |Ubuntu Developer Set-up | 9.1.1592.1 |N/A | Cluster Runtime: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabric
Service Fabric SDK for local cluster setup: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabricsdkcommon/
Container image: https://hub.docker.com/r/microsoft/service-fabric-onebox/ +|| Windows Developer Set-up| 9.1.1799.9590 | N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabric.9.1.1799.9590.exe | +|Service Fabric for Windows Server |Service Fabric Standalone Installer Package | 9.1.1799.9590 |N/A | https://download.microsoft.com/download/8/3/6/836E3E99-A300-4714-8278-96BC3E8B5528/9.1.1799.9590/Microsoft.Azure.ServiceFabric.WindowsServer.9.1.1799.9590.zip| +||Service Fabric Standalone Runtime | 9.1.1799.9590 |N/A | https://download.microsoft.com/download/B/0/B/B0BCCAC5-65AA-4BE3-AB13-D5FF5890F4B5/9.1.1799.9590/MicrosoftAzureServiceFabric.9.1.1799.9590.cab | +|.NET SDK |Windows .NET SDK | 6.1.1799 |N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabricSDK.6.1.1799.msi | +||Microsoft.ServiceFabric | 9.1.1799 |N/A |https://www.nuget.org | +||Reliable Services and Reliable Actors
\-Microsoft.ServiceFabric.Services
\-Microsoft.ServiceFabric.Services.Remoting
\-Microsoft.ServiceFabric.Services.Wcf
\-Microsoft.ServiceFabric.Actors
\-Microsoft.ServiceFabric.Actors.Wcf | 6.1.1799 |https://github.com/Azure/service-fabric-services-and-actors-dotnet |https://www.nuget.org | +||ASP.NET Core Service Fabric integration
\-Microsoft.ServiceFabric.Services.AspNetCore.*| 6.1.1799 |https://github.com/Azure/service-fabric-aspnetcore |https://www.nuget.org | +||Data, Diagnostics and Fabric transport
\-Microsoft.ServiceFabric.Data
\-Microsoft.ServiceFabric.Data.Interfaces
\-Microsoft.ServiceFabric.Diagnostics.Internal
\-Microsoft.ServiceFabric.FabricTransport/Internal | 9.1.1799 |N/A| https://www.nuget.org | +||Microsoft.ServiceFabric.Data.Extensions | 9.1.1799 | 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/Azure/generator-azuresfjava |N/A | +||Azure Service Fabric C# generator | 1.0.9 |https://github.com/Azure/generator-azuresfcsharp |N/A | +||Azure Service Fabric guest executables generator | 1.0.1 |https://github.com/Azure/generator-azuresfguest |N/A| +||Azure Service Fabric Container generators | 1.0.1 |https://github.com/Azure/generator-azuresfcontainer |N/A | +|CLI |Service Fabric CLI | 11.0.1 |https://github.com/Azure/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 |N/A | diff --git a/release_notes/Service_Fabric_ReleaseNotes_91CU5.md b/release_notes/Service_Fabric_ReleaseNotes_91CU5.md new file mode 100644 index 000000000..f684c2778 --- /dev/null +++ b/release_notes/Service_Fabric_ReleaseNotes_91CU5.md @@ -0,0 +1,62 @@ +# Microsoft Azure Service Fabric 9.1 Cumulative Update 5.0 Release Notes + +* [Service Fabric Packages and Versions](#service-fabric-packages-and-versions) +* [Service Fabric Feature and Bug Fixes](#service-fabric-feature-and-bug-fixes) +* [Retirement and Deprecation Path Callouts](#retirement-and-deprecation-path-callouts) +* [Repositories and Download Links](#repositories-and-download-links) + +## Service Fabric Packages and Versions +The following packages and versions are part of this release: + +| Service | Platform | Version | +|---------|----------|---------| +|Service Fabric Runtime| Ubuntu 18
Ubuntu 20
Windows | 9.1.1625.1
9.1.1625.1
9.1.1833.9590 | +|Service Fabric for Windows Server|Service Fabric Standalone Installer Package | 9.1.1833.9590 | +|.NET SDK |Windows .NET SDK
Microsoft.ServiceFabric
Reliable Services and Reliable Actors
ASP.NET Core Service Fabric integration| 6.1.1833
9.1.1833
6.1.1833
6.1.1833 | +|Java SDK |Java for Linux SDK | 1.0.6 | +|Service Fabric PowerShell and CLI | AzureRM PowerShell Module
SFCTL | 0.3.15
11.0.1 | + + +## Service Fabric Feature and Bug Fixes +| Versions | IssueType | Description | Resolution | +|-|-|-|-| +| **Windows - 9.1.1833.9590
Ubuntu 18 - 9.1.1625.1
Ubuntu 20 - 9.1.1625.1** | **Feature** | Key Value Store (KVS) | **Brief Description**: "DatabaseFilesCorrupted" is a terminal error for the replica, requiring it to be dropped. This error occurs when the Extensible Storage Engine(ESE) Write change APIs return the DatabaseFilesCorrupted error, resulting in the replica being marked for compaction and flagged as a fault replica.
**Solution**: When a replica experiences database corruption via KVS Write APIs (e.g., Insert, Update, Delete), it is flagged with the repair task "MarkCompactTransientFault". Upon reopening, the JET_Compact API identifies the "DatabaseFilesCorrupted" state, initiating the repair policy that ultimately results in the replica being dropped. This solution ensures proper handling and repair of replicas affected by database corruption, maintaining system integrity. +| **Windows - 9.1.1833.9590
Ubuntu 18 - 9.1.1625.1
Ubuntu 20 - 9.1.1625.1** | **Bug** | Failover Manager | **Brief Description**: During a scaling-down scenario in Service Fabric, if an application upgrade is in progress, there is a possibility of Service Fabric miscalculating the MinimumInstancePercentage for stateless services. This can result in the application upgrade getting stuck.
**Solution**: The issue has been resolved, ensuring that Service Fabric accurately calculates the MinimumInstancePercentage during scaling down. This fix enables the application upgrade to progress smoothly without any disruptions.
**Workaround**: To mitigate the issue, set the MinInstancePercentage to 0 and utilize the MinInstanceCount instead. +| **Windows - 9.1.1833.9590
Ubuntu 18 - 9.1.1625.1
Ubuntu 20 - 9.1.1625.1** | **Bug** | Service Fabric Explorer (SFX) | **Brief Description**: The repair job timeline history has been updated to fix the incorrect ordering of claimed and approved actions. This correction ensures an accurate representation of the repair job actions in the history section, providing clarity for users reviewing the timeline. + + +## Retirement and Deprecation Path Callouts +* As aligned with [Microsoft .NET and .NET Core - Microsoft Lifecycle | Microsoft Learn](https://learn.microsoft.com/en-us/lifecycle/products/microsoft-net-and-net-core), SF Runtime has dropped support for Net Core 3.1 as of December 2022. For supported versions see [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#current-versions-1) and migrate applications as needed. +* Ubuntu 18.04 LTS will reach its 5-year end-of-life window in June, 2023. Service Fabric runtime will drop support for 18.04 LTS after the published date, and we recommend moving your clusters and applications to supported versions listed here: [Service Fabric supported Linux versions](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions#supported-linux-versions-and-support-end-date) +* Service Fabric runtime will soon stop supporting BinaryFormatter based remoting exception serialization by default and move to using Data Contract Serialization (DCS) based remoting exception serialization by default. Current applications using it will continue to work as-is, but Service Fabric strongly recommends moving to using Data Contract Serialization (DCS) based remoting exception instead. +* As called out in the previous releases, Service Fabric runtime will remove Service Fabric runtime version 6.4 packages and older, SDK version 3.3 packages and older from the package Download Center in July 2023. +* Service Fabric runtime will soon be archiving and removing Service Fabric runtime versions less than 7.2 and older, as well as the corresponding SDK version 4.2 packages and older from the package Download Center. Archiving/Removing will affect application scaling and re-imaging of virtual machines in a Service Fabric Cluster running on unsupported versions. After older versions are removed/archived, this may cause failure while rolling back when the current in-progress upgrade has errors.
+To prevent disruption of workloads, create a new cluster using the following steps: Install the supported version of Service Fabric SDK based on the Runtime version installed on the cluster. + +## Repositories and Download Links +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: +* [Getting Started with Linux](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-linux) +* [Getting Started with Mac](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started-mac) +* [Getting Started with Windows](https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started) + +| Area | Package | Version | Repository | Direct Download Link | +|-|-|-|-|-| +|Service Fabric Runtime |Ubuntu Developer Set-up | 9.1.1625.1 |N/A | Cluster Runtime: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabric
Service Fabric SDK for local cluster setup: https://apt-mo.trafficmanager.net/repos/servicefabric/pool/main/s/servicefabricsdkcommon/
Container image: https://hub.docker.com/r/microsoft/service-fabric-onebox/ +|| Windows Developer Set-up| 9.1.1833.9590 | N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabric.9.1.1833.9590.exe | +|Service Fabric for Windows Server |Service Fabric Standalone Installer Package | 9.1.1833.9590 |N/A |https://download.microsoft.com/download/8/3/6/836E3E99-A300-4714-8278-96BC3E8B5528/9.1.1833.9590/Microsoft.Azure.ServiceFabric.WindowsServer.9.1.1833.9590.zip| +||Service Fabric Standalone Runtime | 9.1.1833.9590 |N/A | https://download.microsoft.com/download/B/0/B/B0BCCAC5-65AA-4BE3-AB13-D5FF5890F4B5/9.1.1833.9590/MicrosoftAzureServiceFabric.9.1.1833.9590.cab | +|.NET SDK |Windows .NET SDK | 6.1.1833 |N/A | https://download.microsoft.com/download/b/8/a/b8a2fb98-0ec1-41e5-be98-9d8b5abf7856/MicrosoftServiceFabricSDK.6.1.1833.msi | +||Microsoft.ServiceFabric | 9.1.1833 |N/A |https://www.nuget.org | +||Reliable Services and Reliable Actors
\-Microsoft.ServiceFabric.Services
\-Microsoft.ServiceFabric.Services.Remoting
\-Microsoft.ServiceFabric.Services.Wcf
\-Microsoft.ServiceFabric.Actors
\-Microsoft.ServiceFabric.Actors.Wcf | 6.1.1833 |https://github.com/Azure/service-fabric-services-and-actors-dotnet |https://www.nuget.org | +||ASP.NET Core Service Fabric integration
\-Microsoft.ServiceFabric.Services.AspNetCore.*| 6.1.1833 |https://github.com/Azure/service-fabric-aspnetcore |https://www.nuget.org | +||Data, Diagnostics and Fabric transport
\-Microsoft.ServiceFabric.Data
\-Microsoft.ServiceFabric.Data.Interfaces
\-Microsoft.ServiceFabric.Diagnostics.Internal
\-Microsoft.ServiceFabric.FabricTransport/Internal | 9.1.1833 |N/A| https://www.nuget.org | +||Microsoft.ServiceFabric.Data.Extensions | 9.1.1833 | 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/Azure/generator-azuresfjava |N/A | +||Azure Service Fabric C# generator | 1.0.9 |https://github.com/Azure/generator-azuresfcsharp |N/A | +||Azure Service Fabric guest executables generator | 1.0.1 |https://github.com/Azure/generator-azuresfguest |N/A| +||Azure Service Fabric Container generators | 1.0.1 |https://github.com/Azure/generator-azuresfcontainer |N/A | +|CLI |Service Fabric CLI | 11.0.1 |https://github.com/Azure/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 |N/A | diff --git a/src/prod/src/managed/powershell/servicefabric/ServiceFabric.psd1 b/src/prod/src/managed/powershell/servicefabric/ServiceFabric.psd1 index f3c6ebc25..efb86ef8b 100644 Binary files a/src/prod/src/managed/powershell/servicefabric/ServiceFabric.psd1 and b/src/prod/src/managed/powershell/servicefabric/ServiceFabric.psd1 differ