Skip to content

Commit 46c90a4

Browse files
authored
Merge pull request #204807 from tomvcassidy/metadata3
Final Round of Service Fabric Metadata Changes
2 parents f55f772 + eec23cf commit 46c90a4

File tree

155 files changed

+948
-507
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

155 files changed

+948
-507
lines changed

articles/service-fabric/service-fabric-manage-application-in-visual-studio.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,14 @@
11
---
22
title: Manage applications in Visual Studio
33
description: Use Visual Studio to create, develop, package, deploy, and debug your Azure Service Fabric applications and services.
4-
ms.topic: conceptual
5-
ms.date: 03/26/2018
4+
ms.topic: how-to
5+
ms.author: tomcassidy
6+
author: tomvcassidy
7+
ms.service: service-fabric
8+
services: service-fabric
9+
ms.date: 07/14/2022
610
---
11+
712
# Use Visual Studio to simplify writing and managing your Service Fabric applications
813
You can manage your Azure Service Fabric applications and services through Visual Studio. Once you've [set up your development environment](service-fabric-get-started.md), you can use Visual Studio to create Service Fabric applications, add services, or package, register, and deploy applications in your local development cluster.
914

@@ -19,7 +24,7 @@ By default, deploying an application combines the following steps into one simpl
1924
In Visual Studio, pressing **F5** deploys your application and attach the debugger to all application instances. You can use **Ctrl+F5** to deploy an application without debugging, or you can publish to a local or remote cluster by using the publish profile.
2025

2126
### Application Debug Mode
22-
Visual Studio provide a property called **Application Debug Mode**, which controls how you want Visual Studios to handle Application deployment as part of debugging.
27+
Visual Studio provides a property called **Application Debug Mode**, which controls how you want Visual Studios to handle Application deployment as part of debugging.
2328

2429
#### To set the Application Debug Mode property
2530
1. On the Service Fabric application project's (*.sfproj) shortcut menu, choose **Properties** (or press the **F4** key).

articles/service-fabric/service-fabric-manage-multiple-environment-app-configuration.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,13 @@
22
title: Manage apps for multiple environments
33
description: Azure Service Fabric applications can be run on clusters that range in size from one machine to thousands of machines. In some cases, you will want to configure your application differently for those varied environments. This article covers how to define different application parameters per environment.
44
ms.topic: conceptual
5-
ms.date: 02/23/2018
5+
ms.author: tomcassidy
6+
author: tomvcassidy
7+
ms.service: service-fabric
8+
services: service-fabric
9+
ms.date: 07/11/2022
610
---
11+
712
# Manage applications for multiple environments
813

914
Azure Service Fabric clusters enable you to create clusters using anywhere from one to many thousands machines. In most cases, you find yourself having to deploy your application across multiple cluster configurations: your local development cluster, a shared development cluster and your production cluster. All of these clusters are considered different environments your code has to run in. Application binaries can run without modification across this wide spectrum, but you often want to configure the application differently.

articles/service-fabric/service-fabric-managed-disk.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
title: Deploy Service Fabric node types with managed data disks
33
description: Learn how to create and deploy Service Fabric node types with attached managed data disks.
4-
author: craftyhouse
5-
6-
ms.topic: conceptual
7-
ms.date: 10/19/2021
8-
ms.author: micraft
9-
4+
ms.topic: how-to
5+
ms.author: tomcassidy
6+
author: tomvcassidy
7+
ms.service: service-fabric
8+
services: service-fabric
9+
ms.date: 07/11/2022
1010
---
1111

1212
# Deploy an Azure Service Fabric cluster node type with managed data disks

articles/service-fabric/service-fabric-manifest-example-container-app.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
---
22
title: Azure Service Fabric container application manifest examples
33
description: Learn how to configure application and service manifest settings for a multi-container Service Fabric application.
4-
author: peterpogorski
5-
64
ms.topic: conceptual
7-
ms.date: 06/08/2018
8-
ms.author: pepogors
5+
ms.author: tomcassidy
6+
author: tomvcassidy
7+
ms.service: service-fabric
8+
services: service-fabric
9+
ms.date: 07/11/2022
910
---
1011

1112
# Multi-container application and service manifest examples
@@ -253,7 +254,7 @@ See [Application manifest elements](#application-manifest-elements), [FrontEndSe
253254

254255
## Application manifest elements
255256
### ApplicationManifest Element
256-
Declaratively describes the application type and version. One or more service manifests of the constituent services are referenced to compose an application type. Configuration settings of the constituent services can be overridden using parameterized application settings. Default services, service templates, principals, policies, diagnostics set-up, and certificates can also declared at the application level. For more information, see [ApplicationManifest Element](service-fabric-service-model-schema-elements.md#ApplicationManifestElementApplicationManifestTypeComplexType)
257+
Declaratively describes the application type and version. One or more service manifests of the constituent services are referenced to compose an application type. Configuration settings of the constituent services can be overridden using parameterized application settings. Default services, service templates, principals, policies, diagnostics set-up, and certificates can also be declared at the application level. For more information, see [ApplicationManifest Element](service-fabric-service-model-schema-elements.md#ApplicationManifestElementApplicationManifestTypeComplexType)
257258

258259
### Parameters Element
259260
Declares the parameters that are used in this application manifest. The value of these parameters can be supplied when the application is instantiated and can be used to override application or service configuration settings. For more information, see [Parameters Element](service-fabric-service-model-schema-elements.md#ParametersElementanonymouscomplexTypeComplexTypeDefinedInApplicationManifestTypecomplexType)
@@ -298,7 +299,7 @@ Windows Server containers may not be compatible across different versions of the
298299
is assumed to work across all versions of the OS and overrides the image specified in the service manifest. For more information, see [ImageOverrides Element](service-fabric-service-model-schema-elements.md#ImageOverridesElementImageOverridesTypeComplexTypeDefinedInContainerHostPoliciesTypecomplexType)
299300

300301
### Image Element
301-
Container image corresponding to OS build version number to be launched. If the Os attribute is not specified, the container image
302+
Container image corresponding to OS build version number to be launched. If the OS attribute is not specified, the container image
302303
is assumed to work across all versions of the OS and overrides the image specified in the service manifest. For more information, see [Image Element](service-fabric-service-model-schema-elements.md#ImageElementImageTypeComplexTypeDefinedInImageOverridesTypecomplexType)
303304

304305
### EnvironmentOverrides Element

articles/service-fabric/service-fabric-manifest-example-reliable-services-app.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
---
22
title: Reliable services app manifest examples
33
description: Learn how to configure application and service manifest settings for a reliable services Service Fabric application.
4-
author: peterpogorski
5-
64
ms.topic: conceptual
7-
ms.date: 06/11/2018
8-
ms.author: pepogors
5+
ms.author: tomcassidy
6+
author: tomvcassidy
7+
ms.service: service-fabric
8+
services: service-fabric
9+
ms.date: 07/11/2022
910
---
1011

1112
# Reliable services application and service manifest examples
@@ -269,7 +270,7 @@ See [Application manifest elements](#application-manifest-elements), [VotingWeb
269270

270271
## Application manifest elements
271272
### ApplicationManifest Element
272-
Declaratively describes the application type and version. One or more service manifests of the constituent services are referenced to compose an application type. Configuration settings of the constituent services can be overridden using parameterized application settings. Default services, service templates, principals, policies, diagnostics set-up, and certificates can also declared at the application level. For more information, see [ApplicationManifest Element](service-fabric-service-model-schema-elements.md#ApplicationManifestElementApplicationManifestTypeComplexType)
273+
Declaratively describes the application type and version. One or more service manifests of the constituent services are referenced to compose an application type. Configuration settings of the constituent services can be overridden using parameterized application settings. Default services, service templates, principals, policies, diagnostics set-up, and certificates can also be declared at the application level. For more information, see [ApplicationManifest Element](service-fabric-service-model-schema-elements.md#ApplicationManifestElementApplicationManifestTypeComplexType)
273274

274275
### Parameters Element
275276
Declares the parameters that are used in this application manifest. The value of these parameters can be supplied when the application is instantiated and can be used to override application or service configuration settings. For more information, see [Parameters Element](service-fabric-service-model-schema-elements.md#ParametersElementanonymouscomplexTypeComplexTypeDefinedInApplicationManifestTypecomplexType)

articles/service-fabric/service-fabric-manifest-examples.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
---
22
title: Azure Service Fabric application manifest examples
33
description: Learn how to configure application and service manifest settings for a Service Fabric application.
4-
author: peterpogorski
5-
64
ms.topic: conceptual
7-
ms.date: 06/11/2018
8-
ms.author: pepogors
5+
ms.author: tomcassidy
6+
author: tomvcassidy
7+
ms.service: service-fabric
8+
services: service-fabric
9+
ms.date: 07/11/2022
910
---
1011

1112
# Service Fabric application and service manifest examples

articles/service-fabric/service-fabric-migrate-old-javaapp-to-use-maven.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,14 @@
11
---
22
title: Migrate from Java SDK to Maven
3-
description: Update the older Java applications which used to use the Service Fabric Java SDK, to fetch Service Fabric Java dependencies from Maven. After completing this setup, your older Java applications would be able to build .
4-
5-
ms.topic: conceptual
6-
ms.date: 08/23/2017
7-
ms.custom: devx-track-java
3+
description: Update the older Java applications which used to use the Service Fabric Java SDK, to fetch Service Fabric Java dependencies from Maven. After completing this setup, your older Java applications would be able to build.
4+
ms.topic: how-to
5+
ms.author: tomcassidy
6+
author: tomvcassidy
7+
ms.service: service-fabric
8+
services: service-fabric
9+
ms.date: 07/11/2022
810
---
11+
912
# Update your previous Java Service Fabric application to fetch Java libraries from Maven
1013
Service Fabric Java binaries have moved from the Service Fabric Java SDK to Maven hosting. You can use **mavencentral** to fetch the latest Service Fabric Java dependencies. This guide will help you update existing Java applications created for the Service Fabric Java SDK using either Yeoman template or Eclipse to be compatible with the Maven-based build.
1114

articles/service-fabric/service-fabric-networking-modes.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,14 @@
11
---
22
title: Configure networking modes for container services
33
description: Learn how to set up the different networking modes that are supported by Azure Service Fabric.
4-
author: athinanthny
5-
6-
ms.topic: conceptual
7-
ms.date: 2/23/2018
8-
ms.author: atsenthi
4+
ms.topic: how-to
5+
ms.author: tomcassidy
6+
author: tomvcassidy
7+
ms.service: service-fabric
8+
services: service-fabric
9+
ms.date: 07/11/2022
910
---
11+
1012
# Service Fabric container networking modes
1113

1214
An Azure Service Fabric cluster for container services uses **nat** networking mode by default. When more than one container service is listening on the same port and nat mode is being used, deployment errors can occur. To support multiple container services listening on the same port, Service Fabric offers **Open** networking mode (versions 5.7 and later). In Open mode, each container service has an internal, dynamically assigned IP address that supports multiple services listening on the same port.

articles/service-fabric/service-fabric-node-transition-apis.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,12 @@
11
---
22
title: Start and stop cluster nodes
33
description: Learn how to use fault injection to test a Service Fabric application by starting and stopping cluster nodes.
4-
ms.topic: conceptual
5-
ms.date: 6/12/2017
6-
ms.custom: devx-track-csharp
4+
ms.topic: how-to
5+
ms.author: tomcassidy
6+
author: tomvcassidy
7+
ms.service: service-fabric
8+
services: service-fabric
9+
ms.date: 07/11/2022
710
---
811

912
# Replacing the Start Node and Stop Node APIs with the Node Transition API
@@ -18,7 +21,7 @@ As described earlier, a *stopped* Service Fabric node is a node intentionally ta
1821

1922
In addition, some errors returned by these APIs are not as descriptive as they could be. For example, invoking the Stop Node API on an already *stopped* node will return the error *InvalidAddress*. This experience could be improved.
2023

21-
Also, the duration a node is stopped for is "infinite" until the Start Node API is invoked. We've found this can cause problems and may be error-prone. For example, we've seen problems where a user invoked the Stop Node API on a node and then forgot about it. Later, it was unclear if the node was *down* or *stopped*.
24+
Also, the duration a node remains stopped for is "infinite" until the Start Node API is invoked. We've found this can cause problems and may be error-prone. For example, we've seen problems where a user invoked the Stop Node API on a node and then forgot about it. Later, it was unclear if the node was *down* or *stopped*.
2225

2326

2427
## Introducing the Node Transition APIs
@@ -27,7 +30,7 @@ We've addressed these issues above in a new set of APIs. The new Node Transitio
2730

2831
**Usage**
2932

30-
If the Node Transition API does not throw an exception when invoked, then the system has accepted the asynchronous operation, and will execute it. A successful call does not imply the operation is finished yet. To get information about the current state of the operation, call the Node Transition Progress API (managed: [GetNodeTransitionProgressAsync()][gntp]) with the guid used when invoking Node Transition API for this operation. The Node Transition Progress API returns an NodeTransitionProgress object. This object's State property specifies the current state of the operation. If the state is "Running", then the operation is executing. If it is Completed, the operation finished without error. If it is Faulted, there was a problem executing the operation. The Result property's Exception property will indicate what the issue was. See [TestCommandProgressState Enum](/dotnet/api/system.fabric.testcommandprogressstate) for more information about the State property, and the "Sample Usage" section below for code examples.
33+
If the Node Transition API does not throw an exception when invoked, then the system has accepted the asynchronous operation, and will execute it. A successful call does not imply the operation is finished yet. To get information about the current state of the operation, call the Node Transition Progress API (managed: [GetNodeTransitionProgressAsync()][gntp]) with the guid used when invoking Node Transition API for this operation. The Node Transition Progress API returns a NodeTransitionProgress object. This object's State property specifies the current state of the operation. If the state is "Running", then the operation is executing. If it is Completed, the operation finished without error. If it is Faulted, there was a problem executing the operation. The Result property's Exception property will indicate what the issue was. See [TestCommandProgressState Enum](/dotnet/api/system.fabric.testcommandprogressstate) for more information about the State property, and the "Sample Usage" section below for code examples.
3134

3235
**Differentiating between a stopped node and a down node**
3336
If a node is *stopped* using the Node Transition API, the output of a node query (managed: [GetNodeListAsync()][nodequery], PowerShell: [Get-ServiceFabricNode][nodequeryps]) will show that this node has an *IsStopped* property value of true. Note this is different from the value of the *NodeStatus* property, which will say *Down*. If the *NodeStatus* property has a value of *Down*, but *IsStopped* is false, then the node was not stopped using the Node Transition API, and is *Down* due to some other reason. If the *IsStopped* property is true, and the *NodeStatus* property is *Down*, then it was stopped using the Node Transition API.

articles/service-fabric/service-fabric-overview-microservices.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,13 @@
22
title: Introduction to microservices on Azure
33
description: An overview of why building cloud applications with a microservices approach is important for modern application development and how Azure Service Fabric provides a platform to achieve this.
44
ms.topic: conceptual
5-
ms.date: 01/07/2020
5+
ms.author: tomcassidy
6+
author: tomvcassidy
7+
ms.service: service-fabric
8+
services: service-fabric
9+
ms.date: 07/11/2022
610
---
11+
712
# Why use a microservices approach to building applications
813

914
For software developers, factoring an application into component parts is nothing new. Typically, a tiered approach is used, with a back-end store, middle-tier business logic, and a front-end user interface (UI). What *has* changed over the last few years is that developers are building distributed applications for the cloud.

0 commit comments

Comments
 (0)