Skip to content

Commit 2c97afe

Browse files
Merge pull request #101190 from erikadoyle/reviewedits
Service Fabric content portfolio review (batch 2)
2 parents 5b004bc + f590d0d commit 2c97afe

7 files changed

+110
-85
lines changed

articles/service-fabric/scripts/service-fabric-powershell-change-rdp-port-range.md

Lines changed: 5 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,28 +2,23 @@
22
title: Azure PowerShell Script Sample - Change the RDP port range | Microsoft Docs
33
description: Azure PowerShell Script Sample - Changes the RDP port range of a deployed cluster.
44
services: service-fabric
5-
documentationcenter:
6-
author: athinanthny
7-
manager: chackdan
8-
editor:
95
tags: azure-service-management
10-
11-
ms.assetid:
6+
author: athinanthny
7+
ms.author: atsenthi
128
ms.service: service-fabric
139
ms.workload: multiple
1410
ms.topic: sample
1511
ms.date: 03/19/2018
16-
ms.author: atsenthi
17-
ms.custom: mvc
12+
ms.custom: sfrev
1813
---
1914

2015
# Update the RDP port range values
2116

22-
This sample script changes the RDP port range values on the cluster node VMs after the cluster has been deployed. Azure PowerShell is used so that the underlying VMs do not cycle. The script gets the `Microsoft.Network/loadBalancers` resource in cluster's resource group and updates the `inboundNatPools.frontendPortRangeStart` and `inboundNatPools.frontendPortRangeEnd` values. Customize the parameters as needed.
17+
This sample script changes the RDP port range values on the cluster node VMs after the cluster has been deployed. Azure PowerShell is used so that the underlying VMs do not cycle. The script gets the `Microsoft.Network/loadBalancers` resource in the cluster's resource group and updates the `inboundNatPools.frontendPortRangeStart` and `inboundNatPools.frontendPortRangeEnd` values. Customize the parameters as needed.
2318

2419
[!INCLUDE [updated-for-az](../../../includes/updated-for-az.md)]
2520

26-
If needed, install the Azure PowerShell using the instruction found in the [Azure PowerShell guide](/powershell/azure/overview).
21+
If needed, install the Azure PowerShell using the instruction found in the [Azure PowerShell guide](/powershell/azure/overview).
2722

2823
## Sample script
2924

articles/service-fabric/service-fabric-api-management-overview.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,7 @@
11
---
22
title: Azure Service Fabric with API Management overview
33
description: This article is an introduction to using Azure API Management as a gateway to your Service Fabric applications.
4-
54
author: vturecek
6-
75
ms.topic: conceptual
86
ms.date: 06/22/2017
97
ms.author: vturecek
@@ -13,7 +11,7 @@ ms.author: vturecek
1311

1412
Cloud applications typically need a front-end gateway to provide a single point of ingress for users, devices, or other applications. In Service Fabric, a gateway can be any stateless service such as an [ASP.NET Core application](service-fabric-reliable-services-communication-aspnetcore.md), or another service designed for traffic ingress, such as [Event Hubs](https://docs.microsoft.com/azure/event-hubs/), [IoT Hub](https://docs.microsoft.com/azure/iot-hub/), or [Azure API Management](https://docs.microsoft.com/azure/api-management/).
1513

16-
This article is an introduction to using Azure API Management as a gateway to your Service Fabric applications. API Management integrates directly with Service Fabric, allowing you to publish APIs with a rich set of routing rules to your back-end Service Fabric services.
14+
This article is an introduction to using Azure API Management as a gateway to your Service Fabric applications. API Management integrates directly with Service Fabric, allowing you to publish APIs with a rich set of routing rules to your back-end Service Fabric services.
1715

1816
## Availability
1917

@@ -44,7 +42,8 @@ Azure API Management can be used with any combination of stateless services, sta
4442

4543
In the simplest case, traffic is forwarded to a stateless service instance. To achieve this, an API Management operation contains an inbound processing policy with a Service Fabric back-end that maps to a specific stateless service instance in the Service Fabric back-end. Requests sent to that service are sent to a random instance of the service.
4644

47-
#### Example
45+
**Example**
46+
4847
In the following scenario, a Service Fabric application contains a stateless service named `fabric:/app/fooservice`, that exposes an internal HTTP API. The service instance name is well known and can be hard-coded directly in the API Management inbound processing policy.
4948

5049
![Service Fabric with Azure API Management topology overview][sf-apim-static-stateless]
@@ -53,7 +52,7 @@ In the following scenario, a Service Fabric application contains a stateless ser
5352

5453
Similar to the stateless service scenario, traffic can be forwarded to a stateful service instance. In this case, an API Management operation contains an inbound processing policy with a Service Fabric back-end that maps a request to a specific partition of a specific *stateful* service instance. The partition to map each request to is computed via a lambda method using some input from the incoming HTTP request, such as a value in the URL path. The policy may be configured to send requests to the primary replica only, or to a random replica for read operations.
5554

56-
#### Example
55+
**Example**
5756

5857
In the following scenario, a Service Fabric application contains a partitioned stateful service named `fabric:/app/userservice` that exposes an internal HTTP API. The service instance name is well known and can be hard-coded directly in the API Management inbound processing policy.
5958

@@ -63,14 +62,14 @@ The service is partitioned using the Int64 partition scheme with two partitions
6362

6463
## Send traffic to multiple stateless services
6564

66-
In more advanced scenarios, you can define an API Management operation that maps requests to more than one service instance. In this case, each operation contains a policy that maps requests to a specific service instance based on values from the incoming HTTP request, such as the URL path or query string, and in the case of stateful services, a partition within the service instance.
65+
In more advanced scenarios, you can define an API Management operation that maps requests to more than one service instance. In this case, each operation contains a policy that maps requests to a specific service instance based on values from the incoming HTTP request, such as the URL path or query string, and in the case of stateful services, a partition within the service instance.
6766

6867
To achieve this, an API Management operation contains an inbound processing policy with a Service Fabric back-end that maps to a stateless service instance in the Service Fabric back-end based on values retrieved from the incoming HTTP request. Requests to a service are sent to a random instance of the service.
6968

70-
#### Example
69+
**Example**
7170

7271
In this example, a new stateless service instance is created for each user of an application with a dynamically generated name using the following formula:
73-
72+
7473
- `fabric:/app/users/<username>`
7574

7675
Each service has a unique name, but the names are not known up-front because the services are created in response to user or admin input and thus cannot be hard-coded into APIM policies or routing rules. Instead, the name of the service to which to send a request is generated in the back-end policy definition from the `name` value provided in the URL request path. For example:
@@ -86,10 +85,10 @@ Similar to the stateless service example, an API Management operation can map re
8685

8786
To achieve this, an API Management operation contains an inbound processing policy with a Service Fabric back-end that maps to a stateful service instance in the Service Fabric back-end based on values retrieved from the incoming HTTP request. In addition to mapping a request to specific service instance, the request can also be mapped to a specific partition within the service instance, and optionally to either the primary replica or a random secondary replica within the partition.
8887

89-
#### Example
88+
**Example**
9089

9190
In this example, a new stateful service instance is created for each user of the application with a dynamically generated name using the following formula:
92-
91+
9392
- `fabric:/app/users/<username>`
9493

9594
Each service has a unique name, but the names are not known up-front because the services are created in response to user or admin input and thus cannot be hard-coded into APIM policies or routing rules. Instead, the name of the service to which to send a request is generated in the back-end policy definition from the `name` value provided the URL request path. For example:
@@ -113,4 +112,4 @@ Follow the [tutorial](service-fabric-tutorial-deploy-api-management.md) to set u
113112
[sf-apim-static-stateless]: ./media/service-fabric-api-management-overview/sf-apim-static-stateless.png
114113
[sf-apim-static-stateful]: ./media/service-fabric-api-management-overview/sf-apim-static-stateful.png
115114
[sf-apim-dynamic-stateless]: ./media/service-fabric-api-management-overview/sf-apim-dynamic-stateless.png
116-
[sf-apim-dynamic-stateful]: ./media/service-fabric-api-management-overview/sf-apim-dynamic-stateful.png
115+
[sf-apim-dynamic-stateful]: ./media/service-fabric-api-management-overview/sf-apim-dynamic-stateful.png

articles/service-fabric/service-fabric-application-scenarios.md

Lines changed: 17 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
---
22
title: Application scenarios and design
33
description: Overview of categories of cloud applications in Service Fabric. Discusses application design that uses stateful and stateless services.
4-
54
ms.topic: conceptual
6-
ms.date: 4/24/2019
5+
ms.date: 01/08/2020
6+
ms.custom: sfrev
77
---
88
# Service Fabric application scenarios
9-
Azure Service Fabric offers a reliable and flexible platform where you can write and run many types of business applications and services. These applications and microservices can be stateless or stateful, and they're resource-balanced across virtual machines to maximize efficiency.
109

11-
The unique architecture of Service Fabric enables you to perform near real-time data analysis, in-memory computation, parallel transactions, and event processing in your applications. You can easily scale your applications up or down (really in or out), depending on your changing resource requirements.
10+
Azure Service Fabric offers a reliable and flexible platform where you can write and run many types of business applications and services. These applications and microservices can be stateless or stateful, and they're resource-balanced across virtual machines to maximize efficiency.
11+
12+
The unique architecture of Service Fabric enables you to perform near real-time data analysis, in-memory computation, parallel transactions, and event processing in your applications. You can easily scale your applications in or out depending on your changing resource requirements.
1213

1314
For design guidance on building applications, read [Microservices architecture on Azure Service Fabric](https://docs.microsoft.com/azure/architecture/reference-architectures/microservices/service-fabric) and [Best practices for application design using Service Fabric](service-fabric-best-practices-applications.md).
1415

@@ -30,8 +31,8 @@ Consider using the Service Fabric platform for the following types of applicatio
3031

3132
* **Computation on data**: Service Fabric enables you to build stateful applications that do intensive data computation. Service Fabric allows the colocation of processing (computation) and data in applications.
3233

33-
Normally, when your application requires access to data, network latency associated with an external data cache or storage tier limits the computation time. Stateful Service Fabric services eliminate that latency, enabling more optimized reads and writes.
34-
34+
Normally, when your application requires access to data, network latency associated with an external data cache or storage tier limits the computation time. Stateful Service Fabric services eliminate that latency, enabling more optimized reads and writes.
35+
3536
For example, consider an application that performs near real-time recommendation selections for customers, with a round-trip time requirement of less than 100 milliseconds. The latency and performance characteristics of Service Fabric services provide a responsive experience to the user, compared with the standard implementation model of having to fetch the necessary data from remote storage. The system is more responsive because the computation of recommendation selection is colocated with the data and rules.
3637

3738
Customers who have built computation services include [Solidsoft Reply](https://customers.microsoft.com/story/solidsoft-reply-platform-powers-e-verification-of-pharmaceuticals) and [Infosupport](https://customers.microsoft.com/story/service-fabric-customer-profile-info-support-and-fudura).
@@ -41,16 +42,18 @@ Consider using the Service Fabric platform for the following types of applicatio
4142
* **Scalable services**: Individual services can be partitioned, allowing for state to be scaled out across the cluster. Individual services can also be created and removed on the fly. You can scale out services from a few instances on a few nodes to thousands of instances on many nodes, and then scale them in again as needed. You can use Service Fabric to build these services and manage their complete life cycles.
4243

4344
## Application design case studies
44-
Case studies that show how Service Fabric is used to design applications are published on the [Customer stories](https://customers.microsoft.com/search?sq=%22Azure%20Service%20Fabric%22&ff=&p=0&so=story_publish_date%20desc/) and [Microservices in Azure](https://azure.microsoft.com/solutions/microservice-applications/) sites.
45+
46+
Case studies that show how Service Fabric is used to design applications are published on the [Customer stories](https://customers.microsoft.com/search?sq=%22Azure%20Service%20Fabric%22&ff=&p=2&so=story_publish_date%20desc) and [Microservices in Azure](https://azure.microsoft.com/solutions/microservice-applications/) sites.
4547

4648
## Designing applications composed of stateless and stateful microservices
47-
Building applications with Azure Cloud Services worker roles is an example of a stateless service. In contrast, stateful microservices maintain their authoritative state beyond the request and its response. This functionality provides high availability and consistency of the state through simple APIs that provide transactional guarantees backed by replication.
49+
50+
Building applications with Azure Cloud Services worker roles is an example of a stateless service. In contrast, stateful microservices maintain their authoritative state beyond the request and its response. This functionality provides high availability and consistency of the state through simple APIs that provide transactional guarantees backed by replication.
4851

4952
Stateful services in Service Fabric bring high availability to all types of applications, not just databases and other data stores. This is a natural progression. Applications have already moved from using purely relational databases for high availability to NoSQL databases. Now the applications themselves can have their "hot" state and data managed within them for additional performance gains without sacrificing reliability, consistency, or availability.
5053

5154
When you're building applications that consist of microservices, you typically have a combination of stateless web apps (like ASP.NET and Node.js) calling onto stateless and stateful business middle-tier services. The apps and services are all deployed in the same Service Fabric cluster through the Service Fabric deployment commands. Each of these services is independent with regard to scale, reliability, and resource usage. This independence improves agility and flexibility in development and life-cycle management.
5255

53-
Stateful microservices simplify application designs because they remove the need for the additional queues and caches that have traditionally been required to address the availability and latency requirements of purely stateless applications. Because stateful services have high availability and low latency, there are fewer details to manage in your application.
56+
Stateful microservices simplify application designs because they remove the need for the additional queues and caches that have traditionally been required to address the availability and latency requirements of purely stateless applications. Because stateful services have high availability and low latency, there are fewer details to manage in your application.
5457

5558
The following diagrams illustrate the differences between designing an application that's stateless and one that's stateful. By taking advantage of the [Reliable Services](service-fabric-reliable-services-introduction.md) and [Reliable Actors](service-fabric-reliable-actors-introduction.md) programming models, stateful services reduce application complexity while achieving high throughput and low latency.
5659

@@ -62,19 +65,17 @@ Here's an example application that uses stateful services:
6265

6366
## Next steps
6467

65-
* Learn more about [patterns and scenarios](service-fabric-patterns-and-scenarios.md).
66-
6768
* Get started building stateless and stateful services with the Service Fabric
6869
[Reliable Services](service-fabric-reliable-services-quick-start.md) and [Reliable Actors](service-fabric-reliable-actors-get-started.md) programming models.
6970
* Visit the Azure Architecture Center for guidance on [building microservices on Azure](https://docs.microsoft.com/azure/architecture/microservices/).
7071
* Go to [Azure Service Fabric application and cluster best practices](service-fabric-best-practices-overview.md) for application design guidance.
7172

72-
* Also see the following topics:
73-
* [Tell me about microservices](service-fabric-overview-microservices.md)
73+
* See also:
74+
* [Understanding microservices](service-fabric-overview-microservices.md)
7475
* [Define and manage service state](service-fabric-concepts-state.md)
75-
* [Availability of Service Fabric services](service-fabric-availability-services.md)
76-
* [Scale Service Fabric services](service-fabric-concepts-scalability.md)
77-
* [Partition Service Fabric services](service-fabric-concepts-partitioning.md)
76+
* [Availability of services](service-fabric-availability-services.md)
77+
* [Scale services](service-fabric-concepts-scalability.md)
78+
* [Partition services](service-fabric-concepts-partitioning.md)
7879

7980
[Image1]: media/service-fabric-application-scenarios/AppwithStatelessServices.png
8081
[Image2]: media/service-fabric-application-scenarios/AppwithStatefulServices.png

0 commit comments

Comments
 (0)