Microsoft Azure Service Fabric 6.0 Release Notes

Transcription

1 Microsoft Azure Service Fabric 6.0 Release Notes This is the 6.0 major release of Azure Service Fabric. It includes the feature improvements and bug fixes described in this document. The following packages and versions are part of this release Service Fabric Runtime Linux Windows NET SDK Windows.NET SDK Microsoft.ServiceFabric Reliable Services and Reliable Actors ASP.NET Core Service Fabric integration NET SDK Preview Microsoft.ServiceFabric preview Reliable Services and Reliable Actors preview ASP.NET Core Service Fabric integration preview Java SDK Java SDK preview1 Visual Studio Visual Studio Tools for Service Fabric 1.7 Eclipse Service Fabric plug-in for Eclipse 2.04 Yeoman Azure Service Fabric Java generator Azure Service Fabric C# generator Azure Service Fabric guest executables generator Azure Service Fabric Container generators CLI Service Fabric CLI PowerShell AzureRM.ServiceFabric 0.2.6

2 Service Fabric Runtime Versions Linux Windows Features Linux General Availability of the Linux runtime is our first general availability release for guest executable and container orchestration on Service Fabric on Linux. Part of this release we will now support upgrading Linux clusters going forward. This release includes all preview features released until now: and-runtime-preview for-linux/ for-linux/ and-runtime-preview for-linux/ and-runtime-preview for-linux/ and-runtime-preview for-linux/ - The Service Fabric programming model are still in preview for Linux. More information can be found in the SDK section of this document. Applications Add definition kind in the Application and Application Type query In addition to the existing application package deployments, we added support for compose deployments (preview). To distinguish between different kind of deployments, the application information returned by get application list query exposes an additional ApplicationDefinitionKind field. Similarly, the application type information returned by the get application type list query includes ApplicationTypeDefinitionKind" field. The new fields have been added as optional input to their respective queries, so users can filter for the desired application or application type definition kind. Containers Compose deployment (preview) Multiple changes have happened for compose deployment in 6.0: The compose APIs now take in a deployment name to identify the compose deployment. Scheme fabric:/ and / are not allowed in the deployment name. The Service fabric application name is generated from the deployment name. 5.7 PowerShell

3 New-ServiceFabricComposeApplication -ApplicationName fabric:/legacyapp - Compose C:\docker-compose.yml Remove-ServiceFabricComposeApplication fabric:/legacyapp 6.0 PowerShell New-ServiceFabricComposeDeployment -DeploymentName legacyapp -Compose C:\docker-compose.yml Remove-ServiceFabricComposeDeployment legacyapp The 6.0 compose APIs will only work against the 6.0 runtime. Compose APIs in 5.7 client will continue to work against the 6.0 runtime. You can keep using the 2.7 SDK PowerShell cmdlets against a 6.0 cluster. You can now upgrade a compose deployment using the following commands: Powershell Start-ServiceFabricComposeDeploymentUpgrade -DeploymentName legacyapp -Compose C:\docker-compose.yml Get-ServiceFabricComposeDeploymentUpgrade -DeploymentName legacyapp CLI sfctl compose upgrade sfctl compose upgrade-status Management Endpoint Fabric URI We are adding a new tilde (~) as a reserved character to the Fabric name URI. These are all the characters now reserved in the URI - $+ ~ fabric:/my$+ ~App <- Not supported We are introducing a new encoding form for fabric names - including application names, service names when they are used in REST uri's. Previously, we allowed the hierarchical name to be specified directly in the uri - for example if a service name is fabric:/myapp/myservice, the uri for delete was <root>/services/myapp/myservice/$/delete?api-version=3.0 Starting with 6.0, we don t support hierarchical names directly, the forward slash (/) in the name needs to be replaced with a tiled (~) before using it in the URI. <root>/services/myapp~myservice/$/delete?api-version=6.0 Management Endpoint REST API version With 6.0 release, all Service Fabric Client REST APIs will also support current runtime version as the apiversion. This can be used as the default api-version. For instance, Get Node Info can now be called with /Nodes/{nodeName}?api-version=6.0&timeout={timeout} APIs that were supporting other api-versions like 1.0, 2.0 etc. will continue to be supported without any changes. Resource Governance Linux support for processes Resource governance limits can now be set in the Application Manifest for processes running in Linux, the same way they can be used on Windows. Resource Governance CPU You can now express the resource limits for core allocation down to of a core.

4 Resource Governance Emit health warning when incorrect node capacities are provided If capacity values are inconsistent between the user defined manifest and what was provisioned, Service Fabric will emit health warnings with appropriate messages, so users can easily understand the issues and make proper actions accordingly. Resource Governance Specifying CPU resource constraints in Compose In addition to memory, Service Fabric now supports CPU resource constraints in Compose - see Networking Modes Open network configuration has changed The configuration for setting up the open networking mode on Linux has changed. See Bug fixes Default Services Reject application upgrade if fields in Default Service are Updated Application upgrades will now reject requests if description of a default service is not in sync with the cluster. Default Services Default Service validation causing crash When creating a Service Fabric application, the error code of validating the application could cause a crash and failover. The validation is mainly for validating default service and service templates during creating a Service Fabric application. DNS Service - DnsService can't communicate with other system services on Windows secured cluster. Fix for a regression in DnsService which was introduced in build. DnsService was unable to resolve DNS queries due to lack of privileges. Health Reporting ServiceKind parameter now mandatory in REST api-version 4.0 The ServiceKind parameter that is passed when requesting information about replica health is mandatory for api-versions higher than 4.0. Health Reporting Stuck Reconfiguration A health report with a warning will be created on the primary replica when a reconfiguration is stuck. The report contains information about what went wrong and what possible actions can be taken to fix the situation. Performance Improvement Placement Operations Performance of emitting traces as part of placement operations have been improved to enable quicker and more scalable placement operations. Performance Improvement Node Configuration Operations Fixed performance issue in GetNodeConfiguration call, which could time out when nodes contained a high number of files in the data root.

5 Reliable Collections Change FabricNotReadable exception to a FabricTransientException You now see FabricNotReadable exception as a FabricTransientException instead of a FabricException. This means that if this exception is caught, the current transaction should be disposed, and all the operations should be retried with a new transaction object. Reverse Proxy Failed to process characters Fixed a bug where reverse proxy was failing to process any requests with a vertical bar ( ) character in the URI. Reverse Proxy Cookie handling disabled Reverse proxy was reading the Set-Cookie header from the application's response and sending Cookie header in subsequent requests. This is a security issue and has been fixed in this release. Cookie handling is now disabled, and client application can read/add Cookie header as appropriate. Reverse Proxy Retry behavior For service response status codes 404 (without X-ServiceFabric=ResourceNotFound, 410 and 503), reverse proxy will retry the request only for idempotent safe methods: GET, OPTIONS and HEAD. For any other HTTP method, it will not retry and forward the status code back to the client. As of now, Reverse proxy will not honor the Retry-After header for such retries. We will look at adding that support in one of the future releases.

6 Service Fabric SDK Versions NET SDK: o Windows.NET SDK o Microsoft.ServiceFabric o Reliable Services and Reliable Actors o ASP.NET Core Service Fabric integration NET SDK Preview o Microsoft.ServiceFabric preview o Reliable Services and Reliable Actors preview o ASP.NET Core Service Fabric integration preview Java SDK o Java SDK Jars preview1 Features.NET Standard 2.0 preview The Service Fabric.NET SDK is now available as.net Standard 2.0 packages, allowing you to compile your services against either.net Core 2.0 or.net Framework The preview and preview NuGet packages contain the.net Standard 2.0 version of the Service Fabric SDK. There are no other preview features in these packages. To use the.net Standard 2.0 packages, use the preview and preview versions of the Service Fabric NuGet packages. Note that these are currently in preview. To use the latest version of the full.net Framework packages, use the and Service Fabric NuGet packages. ASP.NET Core WebListener renamed to HttpSys In ASP.NET Core 2.0, the WebListener server was repackaged and renamed to HttpSys. A Service Fabric integration package for the HttpSys server is now available: Microsoft.ServiceFabric.AspNetCore.HttpSys. This package contains a renamed ICommunicationListener implementation for HttpSys: HttpSysCommunicationListener. If you are currently using WebListener and want to upgrade to ASP.NET Core 2.0, use the Microsoft.ServiceFabric.AspNetCore.HttpSys package instead of the Microsoft.ServiceFabric.AspNetCore.WebListener package. protected override IEnumerable<ServiceInstanceListener> CreateServiceInstanceListeners() { return new ServiceInstanceListener[] { new ServiceInstanceListener(serviceContext => new HttpSysCommunicationListener(serviceContext, "ServiceEndpoint", (url, listener) => new WebHostBuilder().UseHttpSys().ConfigureServices( services => services.addsingleton<statelessservicecontext>(servicecontext))

7 .UseContentRoot(Directory.GetCurrentDirectory()).UseServiceFabricIntegration(listener, ServiceFabricIntegrationOptions.None).UseStartup<Startup>().UseUrls(url).Build())) }; } Service Remoting V2 A new version of Service Remoting is now available for reliable services and actors. The new version works the same as the current service remoting, but introduces several features and improvements, including custom serialization and memory use optimizations such as buffer pooling and reduction of buffer copying. More information about RemotingV2 can be found here: State provider - Linux The.NET SDK Preview only supports the default state provider on Linux. Reliable Collections state provider is not supported in this release. Java preview1 With this release, it is possible to develop Stateful Reliable Services (using Reliable Collections) in addition to Stateless Reliable Services and Actors with the Java SDK. Bug Fixes Xml Schema in the SDK package did not have the ResourceOverrides as part of the ApplicationManifest:

8 Service Fabric IDE Integration Versions Visual Studio Tools for Service Fabric 1.8 Service Fabric plug-in for Eclipse 2.04 Yeoman - Azure Service Fabric Java generator Yeoman - Azure Service Fabric C# generator Yeoman - Azure Service Fabric guest executables generator Yeoman - Azure Service Fabric Container generators Visual Studio Tools for Service Fabric New service created in Visual Studio, will have package compression turned on by default in the Cloud.xml publish profile. The Actor service project templates now uses v2 remoting by default. All new Service projects, except for actors, now use ServicePackageActivationMode="ExclusiveProcess" by default. Service Fabric plug-in for Eclipse Support for developing Stateful services using Eclipse. Yeoman Generators Java generator now supports generating stateful services.

9 Service Fabric PowerShell and CLI Versions Service Fabric CLI PowerShell AzureRM Module (AzureRM.ServiceFabric) Azure CLI 2.0 All non-azure (non-arm) commands have been migrated to the Service Fabric CLI (sfctl). Command references: Azure CLI 2.0 (az sf): Service Fabric CLI (sfctl): Service Fabric CLI The change log for SFCTL can be found her: PowerShell AzureRM Module No new features

10 Repositories and Download Links The table below is an overview of the direct links to the packages associated with this release. Please follow this guidance for setting up your developer environment: Linux: Mac: Windows: Area Package Version Repository Direct Download Link Service Fabric Runtime Linux Developer Set-up N/A abric/pool/main/s/servicefabric/servic efabric_ deb Windows Developer Set-up N/A load/a/7/3/a73e4b b6-8c ba38dbeb/microsoftservicefabri c exe.net SDK Windows.NET SDK N/A load/a/7/3/a73e4b b6-8c ba38dbeb/microsoftservicefabri csdk msi Microsoft.ServiceFabric N/A Reliable Services and Reliable Actors Microsoft.ServiceFabric.Services Microsoft.ServiceFabric.Services.Remoting Microsoft.ServiceFabric.Services.Wcf Microsoft.ServiceFabric.Actors Microsoft.ServiceFabric.Actors.Wcf ASP.NET Core Service Fabric integration Microsoft.ServiceFabric.Services.AspNetCore.* Azure/servicefabric-services-andactors-dotnet Azure/servicefabric-aspnetcore

11 .NET SDK Preview Microsoft.ServiceFabric preview Reliable Services and Reliable Actors Microsoft.ServiceFabric.Services preview Microsoft.ServiceFabric.Services.Remoting Microsoft.ServiceFabric.Services.Wcf Microsoft.ServiceFabric.Actors Microsoft.ServiceFabric.Actors.Wcf ASP.NET Core Service Fabric integration Microsoft.ServiceFabric.Services.AspNetCore.* Azure/servicefabric-services-andactors-dotnet preview Java SDK Java SDK preview1 N/A Azure/servicefabric-aspnetcore N/A abric/pool/main/s/servicefabricsdkco mmon/servicefabric_sdkcommon_ deb Visual Studio Visual Studio 2017 Tools for Service Fabric 1.8 N/A Included in Visual Studio 2017 Update 4 Preview 4 Visual Studio 2015 Tools for Service Fabric 1.8 N/A See localized download links below Eclipse Service Fabric plug-in for Eclipse 2.04 N/A N/A Yeoman Azure Service Fabric Java generator Azure/generatorazuresfjava Azure Service Fabric C# generator Azure/generatorazuresfcsharp Azure Service Fabric guest executables generator Azure/generatorazuresfguest Azure Service Fabric Container generators Azure/generatorazuresfcontainer N/A N/A N/A N/A

12 CLI Service Fabric CLI Azure/servicefabric-cli 0 PowerShell AzureRM.ServiceFabric N/A ackages/azurerm.servicefabric/0.2.6 Visual Studio 2015 Tool for Service Fabric localized download links NOTE: The below download links are for the 1.7 release of Visual Studio 2015 Tools for Service Fabric. 1.8 will be available soon