<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="AddRemoveIncrementalNamedPartitionScalingMechanism" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Defines a mechanism for adding or removing named partitions.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="MinPartitionCount" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The minimum number of partitions.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MaxPartitionCount" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The maximum number of partitions.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ScaleIncrement" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The number of partitions by which to perform the upshift/downshift.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
MinPartitionCountMinPartitionCount
最小分区数。The minimum number of partitions.
属性Attribute
ValueValue
namename
MinPartitionCountMinPartitionCount
typetype
xs:stringxs:string
useuse
必填required
MaxPartitionCountMaxPartitionCount
最大分区数。The maximum number of partitions.
属性Attribute
ValueValue
namename
MaxPartitionCountMaxPartitionCount
typetype
xs:stringxs:string
useuse
必填required
ScaleIncrementScaleIncrement
作为执行升档/降档依据的分区数。The number of partitions by which to perform the upshift/downshift.
属性Attribute
ValueValue
namename
ScaleIncrementScaleIncrement
typetype
xs:stringxs:string
useuse
必填required
Application 元素Application element
用于创建应用程序的特定于应用程序实例的信息,例如应用程序名称和应用程序参数值。Application Instance specific information like application name and application parameter values used to create application.此文件中的参数值重写应用程序清单中定义的默认参数值。Parameter values in this file overrides the default parameter values defined in Application Manifest.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Application" type="AppInstanceDefinitionType">
<xs:annotation>
<xs:documentation>Application Instance specific information like application name and application parameter values used to create application. Parameter values in this file overrides the default parameter values defined in Application Manifest.</xs:documentation>
</xs:annotation>
</xs:element>
ApplicationEndpoints 元素ApplicationEndpoints element
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ApplicationInstance" type="ApplicationInstanceType">
<xs:annotation>
<xs:documentation>Describes an instance of a Azure Service Fabric application.</xs:documentation>
</xs:annotation>
</xs:element>
ApplicationManifest 元素ApplicationManifest element
以声明方式描述应用程序类型和版本。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.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ApplicationPackage" type="ApplicationPackageType">
<xs:annotation>
<xs:documentation>ApplicationPackage represents the versioned Application information required by the node.</xs:documentation>
</xs:annotation>
</xs:element>
ApplicationPackageRef 元素ApplicationPackageRef element
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="AveragePartitionLoadScalingTrigger" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Defines a scaling mechanism based on the average load of replicas of a partition.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="MetricName" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The name of metric which should be used for scaling operations.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="LowerLoadThreshold" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The lower limit of the load value of a metric.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UpperLoadThreshold" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The upper limit of the load value of a metric.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ScaleIntervalInSeconds" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The time interval in seconds to be considered for scaling.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
MetricNameMetricName
用于缩放操作的指标的名称。The name of metric which should be used for scaling operations.
属性Attribute
ValueValue
namename
MetricNameMetricName
typetype
xs:stringxs:string
useuse
必填required
LowerLoadThresholdLowerLoadThreshold
指标负载值的下限。The lower limit of the load value of a metric.
属性Attribute
ValueValue
namename
LowerLoadThresholdLowerLoadThreshold
typetype
xs:stringxs:string
useuse
必填required
UpperLoadThresholdUpperLoadThreshold
指标负载值的上限。The upper limit of the load value of a metric.
属性Attribute
ValueValue
namename
UpperLoadThresholdUpperLoadThreshold
typetype
xs:stringxs:string
useuse
必填required
ScaleIntervalInSecondsScaleIntervalInSeconds
缩放时应考虑的时间间隔(以秒为单位)。The time interval in seconds to be considered for scaling.
属性Attribute
ValueValue
namename
ScaleIntervalInSecondsScaleIntervalInSeconds
typetype
xs:stringxs:string
useuse
必填required
AverageServiceLoadScalingTrigger 元素AverageServiceLoadScalingTrigger element
定义基于服务分区平均负载的缩放机制。Defines a scaling mechanism based on the average load of partitions of a service.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="AverageServiceLoadScalingTrigger" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Defines a scaling mechanism based on the average load of partitions of a service.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="MetricName" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The name of metric which should be used for scaling operations.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="LowerLoadThreshold" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The lower limit of the load value of a metric.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UpperLoadThreshold" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The upper limit of the load value of a metric.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ScaleIntervalInSeconds" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The time interval in seconds to be considered for scaling.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UseOnlyPrimaryLoad" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>Use load of primary replica as average load of partition.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
MetricNameMetricName
用于缩放操作的指标的名称。The name of metric which should be used for scaling operations.
属性Attribute
ValueValue
namename
MetricNameMetricName
typetype
xs:stringxs:string
useuse
必填required
LowerLoadThresholdLowerLoadThreshold
指标负载值的下限。The lower limit of the load value of a metric.
属性Attribute
ValueValue
namename
LowerLoadThresholdLowerLoadThreshold
typetype
xs:stringxs:string
useuse
必填required
UpperLoadThresholdUpperLoadThreshold
指标负载值的上限。The upper limit of the load value of a metric.
属性Attribute
ValueValue
namename
UpperLoadThresholdUpperLoadThreshold
typetype
xs:stringxs:string
useuse
必填required
ScaleIntervalInSecondsScaleIntervalInSeconds
缩放时应考虑的时间间隔(以秒为单位)。The time interval in seconds to be considered for scaling.
属性Attribute
ValueValue
namename
ScaleIntervalInSecondsScaleIntervalInSeconds
typetype
xs:stringxs:string
useuse
必填required
UseOnlyPrimaryLoadUseOnlyPrimaryLoad
将主要副本的负载用作分区的平均负载。Use load of primary replica as average load of partition.
属性Attribute
ValueValue
namename
UseOnlyPrimaryLoadUseOnlyPrimaryLoad
typetype
xs:stringxs:string
useuse
可选optional
AzureBlob 元素(类型 AzureBlobETWType)AzureBlob element (type AzureBlobETWType)
描述 ETW 事件的 Azure blob 存储目标。Describes an Azure blob store destination for ETW events.只能在 Azure 环境中运行。Works only in Azure environment.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="CertificateRef" type="ContainerCertificateType" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Specifies information for a certificate which will be exposed to the container.</xs:documentation>
</xs:annotation>
</xs:element>
Certificates 元素(类型 CertificatesType)Certificates element (type CertificatesType)
描述与此节点类型关联的证书Describe the certificates associated with this node type
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Certificates" type="CertificatesType" minOccurs="0">
<xs:annotation>
<xs:documentation>Describe the certificates associated with this node type</xs:documentation>
</xs:annotation>
</xs:element>
Certificates 元素(在 ApplicationManifestType 中定义)Certificates element (defined in ApplicationManifestType)
声明用于保护终结点或用于加密应用程序清单或群集清单中的机密的证书。Declares certificates used to secure endpoints or encrypt secrets within the application manifest or a cluster manifest.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Certificates" minOccurs="0">
<xs:annotation>
<xs:documentation>Declares certificates used to secure endpoints or encrypt secrets within the application manifest or a cluster manifest.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence maxOccurs="unbounded">
<xs:element name="SecretsCertificate" type="FabricCertificateType" minOccurs="0">
<xs:annotation>
<xs:documentation>Declares a certificate used to encrypt sensitive information within the application manifest. The application author uses the Invoke-ServiceFabricEncryptSecret cmdlet to encrypt the sensitive information, which is copied to a Parameter in the ConfigOverrides section.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="EndpointCertificate" type="EndpointCertificateType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
Content 元素详细信息Content element details
SecretsCertificateSecretsCertificate
声明用于加密应用程序清单中的敏感信息的证书。Declares a certificate used to encrypt sensitive information within the application manifest.应用程序作者可使用 Invoke-ServiceFabricEncryptSecret cmdlet 来加密要复制到 ConfigOverrides 节中某个参数的敏感信息。The application author uses the Invoke-ServiceFabricEncryptSecret cmdlet to encrypt the sensitive information, which is copied to a Parameter in the ConfigOverrides section.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ClusterCertificate" type="FabricCertificateType" minOccurs="0">
<xs:annotation>
<xs:documentation>The certificate used to secure the intra cluster communication.</xs:documentation>
</xs:annotation>
</xs:element>
ClusterConnectionEndpoint 元素ClusterConnectionEndpoint element
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ClusterManifest" type="ClusterManifestType">
<xs:annotation>
<xs:documentation>Describes a Azure Service Fabric Cluster.</xs:documentation>
</xs:annotation>
</xs:element>
CodePackage 元素CodePackage element
描述支持定义的服务类型的代码包。Describes a code package that supports a defined service type.当一种服务针对这些服务类型之一进行实例化时,可激活此清单中声明的所有代码包,方法是运行这些代码包的入口点。When a service is instantiated against one of these service types, all code packages declared in this manifest are activated by running their entry points.生成的进程应在运行时注册所支持的服务类型。The resulting processes are expected to register the supported service types at run time.当存在多个代码包时,每当系统查找任何一种声明的服务类型时,它们都会被激活。When there are multiple code packages, they are all activated whenever the system looks for any one of the declared service types.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Commands" type="xs:string" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Pass a comma delimited list of commands to the container.</xs:documentation>
</xs:annotation>
</xs:element>
ConfigOverride 元素ConfigOverride element
描述导入的服务清单中特定配置包的配置重写。Describes the configuration overrides for a particular config package in the imported service manifest.
描述所导入服务清单的配置重写。Describes configuration overrides for the imported service manifest.使用配置重写可以做到仅当与特定的应用程序类型配合使用时才重写服务清单的配置,从而可在多个应用程序类型中重复使用相同的服务清单。Configuration overrides allow the flexibility of re-using the same service manifests across multiple application types by overriding the service manifest's configuration only when used with a particular application type.只要使用 ConfigPackage 文件夹中的 Settings.xml 定义默认配置,配置重写就能更改服务清单中的任何默认配置。Configuration overrides can change any default configuration in a service manifest as long as default configuration is defined using the Settings.xml in the ConfigPackage folder.
属性Attribute
ValueValue
typetype
匿名的 complexTypeanonymous complexType
contentcontent
1 个元素,0 个属性1 element(s), 0 attribute(s)
defineddefined
在 ServiceManifestImport 元素本地locally in ServiceManifestImport element
namename
ConfigOverridesConfigOverrides
minOccursminOccurs
00
XML 源XML source
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ConfigOverrides" minOccurs="0">
<xs:annotation>
<xs:documentation>Describes configuration overrides for the imported service manifest. Configuration overrides allow the flexibility of re-using the same service manifests across multiple application types by overriding the service manifest's configuration only when used with a particular application type. Configuration overrides can change any default configuration in a service manifest as long as default configuration is defined using the Settings.xml in the ConfigPackage folder. </xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="ConfigOverride" type="ConfigOverrideType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
ConfigPackage 元素(ConfigPackageDescriptionType 类型)ConfigPackage element (type ConfigPackageDescriptionType)
声明一个由 Name 属性命名的文件夹,该文件夹中包含 Settings.xml 文件。Declares a folder, named by the Name attribute, that contains a Settings.xml file.此文件包含进程用户定义的键值对设置,进程可在运行时读回这些设置。This file contains sections of user-defined, key-value pair settings that the process can read back at run time.升级期间,如果仅更改了 ConfigPackage 版本,则不重启正在运行的进程。During an upgrade, if only the ConfigPackage version has changed, then the running process is not restarted.相反,一个回调会告知进程配置设置已更改,以便动态重新加载。Instead, a callback notifies the process that configuration settings have changed so they can be reloaded dynamically.
ConfigPackage 元素(ConfigPackageType 类型)ConfigPackage element (type ConfigPackageType)
声明按 Name 属性命名的文件夹,该文件夹位于包含 Settings.xml 文件的 PackageRoot 中。Declares a folder, named by the Name attribute, and PackageRoot that contains a Settings.xml file.此文件包含进程用户定义的键值对设置,进程可在运行时读回这些设置。This file contains sections of user-defined, key-value pair settings that the process can read back at run time.升级期间,如果仅更改了 ConfigPackage 版本,则不重启正在运行的进程。During an upgrade, if only the ConfigPackage version has changed, then the running process is not restarted.相反,一个回调会告知进程配置设置已更改,以便动态重新加载。Instead, a callback notifies the process that configuration settings have changed so they can be reloaded dynamically.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ConfigPackagePolicies" type="ConfigPackagePoliciesType" minOccurs="0">
<xs:annotation>
<xs:documentation>Config Packages to be mounted inside the container.</xs:documentation>
</xs:annotation>
</xs:element>
ConsoleRedirection 元素ConsoleRedirection element
警告!Warning!请勿在生产应用程序中使用控制台重定向,只能将其用于本地开发和调试。Do not use console redirection in a production application, only use it for local development and debugging.请在部署和运行应用程序时所在的群集节点上,将控制台输出从启动脚本重定向到名为“log”的应用程序文件夹中的一个输出文件。Redirects console output from the startup script to an output file in the application folder called "log" on the cluster node where the application is deployed and run.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ConsoleRedirection" minOccurs="0">
<xs:annotation>
<xs:documentation>Warning! Do not use console redirection in a production application, only use it for local development and debugging. Redirects console output from the startup script to an output file in the application folder called "log" on the cluster node where the application is deployed and run.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="FileRetentionCount" default="2">
<xs:annotation>
<xs:documentation>Sets the number of console redirection output files to retain. Must be a positive integer, the default value is "2".</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:minInclusive value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="FileMaxSizeInKb" default="20480">
<xs:annotation>
<xs:documentation>Set the maximum size of a console redirection output file. Must be a positive integer greater than 128KB, the default value is "20480".</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:minInclusive value="128"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
FileRetentionCountFileRetentionCount
设置要保留的控制台重定向输出文件的数量。Sets the number of console redirection output files to retain.必须为正整数,默认值为“2”。Must be a positive integer, the default value is "2".
属性Attribute
ValueValue
namename
FileRetentionCountFileRetentionCount
默认值default
22
FileMaxSizeInKbFileMaxSizeInKb
设置控制台重定向输出文件的最大大小。Set the maximum size of a console redirection output file.必须是大于 128 KB 的正整数,默认值为“20480”。Must be a positive integer greater than 128KB, the default value is "20480".
属性Attribute
ValueValue
namename
FileMaxSizeInKbFileMaxSizeInKb
默认值default
2048020480
ContainerEntryPoint 元素ContainerEntryPoint element
已重写容器的入口点,以便能够启动调试程序。Overridden entrypoint for containers so debugger can be launched.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ContainerEntryPoint" type="xs:string" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Overridden entrypoint for containers so debugger can be launched.</xs:documentation>
</xs:annotation>
</xs:element>
ContainerEnvironmentBlock 元素ContainerEnvironmentBlock element
容器的 EnvironmentBlock。EnvironmentBlock for containers.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ContainerNetworkPolicy" type="ContainerNetworkPolicyType" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Describes container network policies for the service package.</xs:documentation>
</xs:annotation>
</xs:element>
CrashDumpSource 元素CrashDumpSource element
指定故障转储收集。Specifies crash dump collection.故障转储是针对托管属于应用程序的所有服务的代码包的可执行文件收集的。Crash dumps are collected for executables that host the code packages of all services belonging to the application.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="CrashDumpSource" minOccurs="0">
<xs:annotation>
<xs:documentation>Specifies crash dump collection. Crash dumps are collected for executables that host the code packages of all services belonging to the application.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Destinations" minOccurs="0">
<xs:annotation>
<xs:documentation>Destinations to which the crash dumps need to be transferred.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="LocalStore" type="LocalStoreType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="FileStore" type="FileStoreType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="AzureBlob" type="AzureBlobType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element ref="Parameters" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
<xs:attribute name="IsEnabled" type="xs:string">
<xs:annotation>
<xs:documentation>Whether or not crash dump collection is enabled. By default, it is not enabled.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
IsEnabledIsEnabled
指示是否启用故障转储收集。Whether or not crash dump collection is enabled.默认未启用。By default, it is not enabled.
属性Attribute
ValueValue
namename
IsEnabledIsEnabled
typetype
xs:stringxs:string
Content 元素详细信息Content element details
DestinationsDestinations
故障转储需要传输到的目标。Destinations to which the crash dumps need to be transferred.
声明一个按 Name 属性命名的文件夹,该文件夹位于将由进程在运行时使用的静态数据文件所在的 PackageRoot 中。Declares a folder, named by the Name attribute, under PackageRoot which contains static data files to be consumed by the process at runtime.升级服务清单中所列的任何数据包时,Service Fabric 会回收主机和支持包中指定的所有 EXE 和 DLLHOST。Service Fabric will recycle all EXEs and DLLHOSTs specified in the host and support packages when any of the data packages listed in the service manifest are upgraded.
针对在 ServiceManifestImport 节中未定义特定 RunAsPolicy 的所有服务代码包指定默认用户帐户。Specify a default user account for all service code packages that don't have a specific RunAsPolicy defined in the ServiceManifestImport section.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="DefaultRunAsPolicy" minOccurs="0">
<xs:annotation>
<xs:documentation>Specify a default user account for all service code packages that don't have a specific RunAsPolicy defined in the ServiceManifestImport section.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="UserRef" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The user account that the service code packages will run as. The user account must be declared in the Principals section. Often it is preferable to run the setup entry point using a local system account rather than an administrators account.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
UserRefUserRef
服务代码包运行时将采用的用户帐户身份。The user account that the service code packages will run as.必须在“Principals”部分中声明用户帐户。The user account must be declared in the Principals section.一般情况下,最好是使用本地系统帐户而不是管理员帐户来运行安装程序入口点。Often it is preferable to run the setup entry point using a local system account rather than an administrators account.
属性Attribute
ValueValue
namename
UserRefUserRef
typetype
xs:stringxs:string
useuse
必填required
DefaultServiceTypeHealthPolicy 元素DefaultServiceTypeHealthPolicy element
指定默认服务类型运行状况策略,该策略会替换应用程序中所有服务类型的默认运行状况策略。Specifies the default service type health policy, which will replace the default health policy for all service types in the application.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="DefaultServiceTypeHealthPolicy" type="ServiceTypeHealthPolicyType" minOccurs="0">
<xs:annotation>
<xs:documentation>Specifies the default service type health policy, which will replace the default health policy for all service types in the application.</xs:documentation>
</xs:annotation>
</xs:element>
DefaultServices 元素DefaultServices element
声明每当一个应用程序依据此应用程序类型进行实例化时自动创建的服务实例。Declares service instances that are automatically created whenever an application is instantiated against this application type.
不受支持,请不要使用。Unsupported, do not use.DLL 宿主支持(程序集入口点)通过 FWP.exe 进程提供。DLL hosting support (assembly entry point) is provided through the FWP.exe process.在激活过程中,Service Fabric 会启动结构工作进程 (FWP.exe) 并加载程序集。Service Fabric starts the Fabric Worker Process (FWP.exe) and loads the assembly as part of the activation process.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ETW" minOccurs="0">
<xs:annotation>
<xs:documentation>Describes the ETW settings for the components of this service manifest.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="ProviderGuids" minOccurs="0">
<xs:annotation>
<xs:documentation>Lists the ETW provider GUIDs for the components of this service manifest.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="ProviderGuid" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="Value" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="ManifestDataPackages" minOccurs="0">
<xs:annotation>
<xs:documentation>Lists the data packages containing ETW manifests for the components of this service manifest. The data package containing ETW manifests should not contain any other files. </xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="ManifestDataPackage" type="DataPackageType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
Content 元素详细信息Content element details
ProviderGuidsProviderGuids
列出此服务清单的组件的 ETW 提供程序 GUID。Lists the ETW provider GUIDs for the components of this service manifest.
属性Attribute
ValueValue
namename
ProviderGuidsProviderGuids
minOccursminOccurs
00
ManifestDataPackagesManifestDataPackages
列出包含此服务清单的组件的 ETW 清单的数据包。Lists the data packages containing ETW manifests for the components of this service manifest.包含 ETW 清单的数据包不应包含其他任何文件。The data package containing ETW manifests should not contain any other files.
属性Attribute
ValueValue
namename
ManifestDataPackagesManifestDataPackages
minOccursminOccurs
00
ETWSource 元素ETWSource element
指定 ETW 跟踪收集。Specifies ETW trace collection.ETW 跟踪是针对属于应用程序的所有服务注册的提供程序收集的。ETW traces are collected for the providers that are registered by all services belonging to the application.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ETWSource" minOccurs="0">
<xs:annotation>
<xs:documentation>Specifies ETW trace collection. ETW traces are collected for the providers that are registered by all services belonging to the application.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Destinations" minOccurs="0">
<xs:annotation>
<xs:documentation>Destinations to which the crash dumps need to be transferred.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="LocalStore" type="LocalStoreETWType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="FileStore" type="FileStoreETWType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="AzureBlob" type="AzureBlobETWType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element ref="Parameters" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
<xs:attribute name="IsEnabled" type="xs:string">
<xs:annotation>
<xs:documentation>Whether or not ETW trace collection is enabled. By default, it is not enabled.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
IsEnabledIsEnabled
指示是否启用 ETW 跟踪收集。Whether or not ETW trace collection is enabled.默认未启用。By default, it is not enabled.
属性Attribute
ValueValue
namename
IsEnabledIsEnabled
typetype
xs:stringxs:string
Content 元素详细信息Content element details
DestinationsDestinations
故障转储需要传输到的目标。Destinations to which the crash dumps need to be transferred.
属性Attribute
ValueValue
namename
DestinationsDestinations
minOccursminOccurs
00
无None
属性Attribute
ValueValue
refref
parametersParameters
minOccursminOccurs
00
maxOccursmaxOccurs
11
Endpoint 元素(类型 EndpointOverrideType)Endpoint element (type EndpointOverrideType)
要重写的已在服务清单中声明的终结点。The endpoint, declared in the service manifest, to override.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Endpoint" type="EndpointOverrideType" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>The endpoint, declared in the service manifest, to override.</xs:documentation>
</xs:annotation>
</xs:element>
Endpoint 元素(类型 EndpointType)Endpoint element (type EndpointType)
定义服务的终结点。Defines an endpoint for the service.可请求的特定端口。Specific ports can be requested.如果未显式指定端口,则从保留的应用程序端口范围分配一个端口。If a port is not explicitly specified, a port is assigned from the reserved application port range.在不同群集节点上运行的服务副本可以分配不同的端口号,而运行在同一节点上的服务副本共享同一个端口。Service replicas running on different cluster nodes can be assigned different port numbers, while replicas of the same service running on the same node share the same port.服务副本可出于各种目的(例如复制或侦听客户端请求)使用此类端口。Such ports can be used by the service replicas for various purposes such as replication or listening for client requests.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="EndpointBinding" type="ContainerNetworkPolicyEndpointBindingType" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Specifies an endpoint that should be exposed on the container network.</xs:documentation>
</xs:annotation>
</xs:element>
EndpointBindingPolicy 元素EndpointBindingPolicy element
指定应返回到 HTTPS 终结点客户端的证书。Specifies a certificate that should be returned to a client for an HTTPS endpoint.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="EndpointBindingPolicy" type="EndpointBindingPolicyType" minOccurs="0">
<xs:annotation>
<xs:documentation>Specifies a certificate that should be returned to a client for an HTTPS endpoint.</xs:documentation>
</xs:annotation>
</xs:element>
EndpointCertificate 元素EndpointCertificate element
指定用于保护终结点的 X509 证书的相关信息。Specifies information about an X509 certificate used to secure an endpoint.
EntryPoint 元素(类型 EntryPointDescriptionType)EntryPoint element (type EntryPointDescriptionType)
EntryPoint 指定的可执行文件通常是长时间运行的服务主机。The executable specified by EntryPoint is typically the long-running service host.提供单独的设置入口点可避免长时间使用高特权运行服务主机。The presence of a separate setup entry point avoids having to run the service host with high privileges for extended periods of time.由 EntryPoint 指定的可执行文件在 SetupEntryPoint 成功退出后运行。The executable specified by EntryPoint is run after SetupEntryPoint exits successfully.如果总是终止或出现故障,则将监视并重启所产生的过程(再次从 SetupEntryPoint 开始)。The resulting process is monitored and restarted (beginning again with SetupEntryPoint) if it ever terminates or crashes.
声明要重写的服务清单中的配置设置。Declares configuration settings in a service manifest to be overridden.它由键/值对的一个或多个节组成。It consists of one or more sections of key-value pairs.可以使用 Invoke-ServiceFabricEncryptSecret cmdlet 加密参数值。Parameter values can be encrypted using the Invoke-ServiceFabricEncryptSecret cmdlet.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="FolderSource" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Specifies the collection of the contents of a particular folder on the local node.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Destinations" minOccurs="0">
<xs:annotation>
<xs:documentation>Destinations to which the folder contents need to be transferred.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="LocalStore" type="LocalStoreType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="FileStore" type="FileStoreType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="AzureBlob" type="AzureBlobType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element ref="Parameters" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
<xs:attribute name="IsEnabled" type="xs:string">
<xs:annotation>
<xs:documentation>Whether or not collection of the contents of this folder is enabled. By default, it is not enabled.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="RelativeFolderPath"/>
<xs:attributeGroup ref="DataDeletionAgeInDays"/>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
IsEnabledIsEnabled
指示是否启用对此文件夹的内容的收集。Whether or not collection of the contents of this folder is enabled.默认未启用。By default, it is not enabled.
属性Attribute
ValueValue
namename
IsEnabledIsEnabled
typetype
xs:stringxs:string
Content 元素详细信息Content element details
DestinationsDestinations
文件夹内容需要传输到的目标。Destinations to which the folder contents need to be transferred.
Group 元素(在 Groups 中定义)Group element (defined in Groups)
将组声明为可在策略中引用的安全主体。Declares a group as a security principal, which can be referenced in policies.
属性Attribute
ValueValue
typetype
匿名的 complexTypeanonymous complexType
contentcontent
2 个元素,1 个属性2 element(s), 1 attribute(s)
defineddefined
在 Groups 元素本地locally in Groups element
namename
组Group
maxOccursmaxOccurs
unboundedunbounded
XML 源XML source
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Group" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Declares a group as a security principal, which can be referenced in policies.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="NTLMAuthenticationPolicy" minOccurs="0">
<xs:complexType>
<xs:attribute name="IsEnabled" type="xs:boolean" use="optional" default="true"/>
</xs:complexType>
</xs:element>
<xs:element name="Membership" minOccurs="0">
<xs:complexType>
<xs:choice maxOccurs="unbounded">
<xs:element name="DomainGroup" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="Name" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="SystemGroup" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="Name" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="DomainUser" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="Name" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="Name" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Name of the local group account. The name will be prefixed with the application ID.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
名称Name
本地组帐户的名称。Name of the local group account.该名称将以应用程序 ID 作为前缀。The name will be prefixed with the application ID.
属性Attribute
ValueValue
namename
名称Name
typetype
xs:stringxs:string
useuse
必填required
Content 元素详细信息Content element details
NTLMAuthenticationPolicyNTLMAuthenticationPolicy
属性Attribute
ValueValue
namename
NTLMAuthenticationPolicyNTLMAuthenticationPolicy
minOccursminOccurs
00
MembershipMembership
属性Attribute
ValueValue
namename
MembershipMembership
minOccursminOccurs
00
Group 元素(在 MemberOf 中定义)Group element (defined in MemberOf)
要将用户添加到的组。The group to add the user to.必须在 Groups 节中定义该组。The group must be defined in the Groups section.
属性Attribute
ValueValue
typetype
匿名的 complexTypeanonymous complexType
contentcontent
0 个元素,1 个属性0 element(s), 1 attribute(s)
defineddefined
在 MemberOf 元素本地locally in MemberOf element
namename
组Group
minOccursminOccurs
00
maxOccursmaxOccurs
unboundedunbounded
XML 源XML source
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Group" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>The group to add the user to. The group must be defined in the Groups section.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="NameRef" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The name of the group.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
NameRefNameRef
组名称。The name of the group.
属性Attribute
ValueValue
namename
NameRefNameRef
typetype
xs:stringxs:string
useuse
必填required
Groups 元素Groups element
将组集声明为可在策略中引用的安全主体。Declares a set of groups as security principals, which can be referenced in policies.如果不同的服务入口点有多个用户,而且这些用户需要拥有特定的常见组级别权限,Groups 就特别有用。Groups are useful if there are multiple users for different service entry points and they need to have certain common privileges that are available at the group level.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Groups" minOccurs="0">
<xs:annotation>
<xs:documentation>Declares a set of groups as security principals, which can be referenced in policies. Groups are useful if there are multiple users for different service entry points and they need to have certain common privileges that are available at the group level.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Group" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Declares a group as a security principal, which can be referenced in policies.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="NTLMAuthenticationPolicy" minOccurs="0">
<xs:complexType>
<xs:attribute name="IsEnabled" type="xs:boolean" use="optional" default="true"/>
</xs:complexType>
</xs:element>
<xs:element name="Membership" minOccurs="0">
<xs:complexType>
<xs:choice maxOccurs="unbounded">
<xs:element name="DomainGroup" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="Name" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="SystemGroup" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="Name" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="DomainUser" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="Name" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="Name" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Name of the local group account. The name will be prefixed with the application ID.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
Content 元素详细信息Content element details
组Group
将组声明为可在策略中引用的安全主体。Declares a group as a security principal, which can be referenced in policies.
属性Attribute
ValueValue
namename
组Group
maxOccursmaxOccurs
unboundedunbounded
HealthConfig 元素HealthConfig element
指定容器的 docker HEALTHCHECK 集成选项。Specifies docker HEALTHCHECK integration options for the container.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="HealthConfig" type="ContainerHealthConfigType" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Specifies docker HEALTHCHECK integration options for the container.</xs:documentation>
</xs:annotation>
</xs:element>
HealthPolicy 元素HealthPolicy element
描述各种应用程序评估运行状况事件报告该策略相关实体。Describes the policy for evaluating health events reported on various application-related entities.如果未指定策略,则假定实体处于警告或错误运行状况报告是否不正常状态。If no policy is specified, an entity is assumed to be unhealthy if the health report is a warning or error.
容器映像,对应于要启动的 OS 内部版本号。Container image corresponding to OS build version number to be launched.如果 Os 属性未指定,则认为容器映像适合所有版本的 OS,并且会替代在服务清单中指定的映像。If the Os attribute is not specified, the container image is assumed to work across all versions of the OS and overrides the image specified in the service manifest.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Image" type="ImageType" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Container image corresponding to OS build version number to be launched. If the Os attribute is not specified, the container image
is assumed to work across all versions of the OS and overrides the image specified in the service manifest.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ImageOverrides" type="ImageOverridesType" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Image names corresponding to OS build number to be launched.</xs:documentation>
</xs:annotation>
</xs:element>
ImageStoreServiceReplicatorEndpoint 元素ImageStoreServiceReplicatorEndpoint element
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="InfrastructureInformation" type="InfrastructureInformationType">
<xs:annotation>
<xs:documentation>Describes the infrastructure on which fabric needs to run.</xs:documentation>
</xs:annotation>
</xs:element>
InstanceCountScalingMechanism 元素InstanceCountScalingMechanism element
定义用于增加分区实例数的机制。Defines a mechanism for increasing the instance count of a partition.此属性仅适用于无状态服务。This is for stateless services only.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="InstanceCountScalingMechanism" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Defines a mechanism for increasing the instance count of a partition. This is for stateless services only.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="MinInstanceCount" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The minimum number of instances.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MaxInstanceCount" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The maximum number of instances..</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ScaleIncrement" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The number of instances by which to perform the upshift/downshift.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
MinInstanceCountMinInstanceCount
最小实例数。The minimum number of instances.
属性Attribute
ValueValue
namename
MinInstanceCountMinInstanceCount
typetype
xs:stringxs:string
useuse
必填required
MaxInstanceCountMaxInstanceCount
最大实例数。The maximum number of instances..
属性Attribute
ValueValue
namename
MaxInstanceCountMaxInstanceCount
typetype
xs:stringxs:string
useuse
必填required
ScaleIncrementScaleIncrement
作为执行升档/降档依据的实例数。The number of instances by which to perform the upshift/downshift.
属性Attribute
ValueValue
namename
ScaleIncrementScaleIncrement
typetype
xs:stringxs:string
useuse
必填required
KtlLoggerSettings 元素KtlLoggerSettings element
描述与此节点类型关联的 KtlLogger 信息Describe the KtlLogger information associated with this node type
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="KtlLoggerSettings" type="FabricKtlLoggerSettingsType" minOccurs="0">
<xs:annotation>
<xs:documentation>Describe the KtlLogger information associated with this node type</xs:documentation>
</xs:annotation>
</xs:element>
应在其上均衡此服务的资源,例如内存或 CPU 使用率。A resource that this service should be balanced on, such as memory or CPU usage.包含此服务的每个副本或实例默认消耗的资源量信息。Includes information about how much of that resource each replica or instance of this service consumes by default.
声明一个按 Name 属性命名的文件夹,该文件夹位于将由进程在运行时使用的静态数据文件所在的 PackageRoot 中。Declares a folder, named by the Name attribute, under PackageRoot which contains static data files to be consumed by the process at runtime.升级服务清单中所列的任何数据包时,Service Fabric 会回收主机和支持包中指定的所有 EXE 和 DLLHOST。Service Fabric will recycle all EXEs and DLLHOSTs specified in the host and support packages when any of the data packages listed in the service manifest are upgraded.
ManifestDataPackages 元素ManifestDataPackages element
列出包含此服务清单的组件的 ETW 清单的数据包。Lists the data packages containing ETW manifests for the components of this service manifest.包含 ETW 清单的数据包不应包含其他任何文件。The data package containing ETW manifests should not contain any other files.
属性Attribute
ValueValue
typetype
匿名的 complexTypeanonymous complexType
contentcontent
1 个元素,0 个属性1 element(s), 0 attribute(s)
defineddefined
在 ETW 元素本地locally in ETW element
namename
ManifestDataPackagesManifestDataPackages
minOccursminOccurs
00
XML 源XML source
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ManifestDataPackages" minOccurs="0">
<xs:annotation>
<xs:documentation>Lists the data packages containing ETW manifests for the components of this service manifest. The data package containing ETW manifests should not contain any other files. </xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="ManifestDataPackage" type="DataPackageType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
用户可以添加到任何现有的成员身份组中,因此它可以继承所有属性和该成员身份组的安全设置。Users can be added to any existing membership group, so it can inherit all the properties and security settings of that membership group.成员身份组可用来保护需要按不同的服务或相同的服务(在不同计算机上)访问的外部资源。The membership group can be used to secure external resources that need to be accessed by different services or the same service (on a different machine).
属性Attribute
ValueValue
typetype
匿名的 complexTypeanonymous complexType
contentcontent
2 个元素,0 个属性2 element(s), 0 attribute(s)
defineddefined
在 User 元素本地locally in User element
namename
MemberOfMemberOf
minOccursminOccurs
00
XML 源XML source
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="MemberOf" minOccurs="0">
<xs:annotation>
<xs:documentation>Users can be added to any existing membership group, so it can inherit all the properties and security settings of that membership group. The membership group can be used to secure external resources that need to be accessed by different services or the same service (on a different machine).</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:choice maxOccurs="unbounded">
<xs:element name="SystemGroup" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>The system group to add the user to. The system group must be defined in the Groups section.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="Name" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The name of the system group.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
<xs:element name="Group" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>The group to add the user to. The group must be defined in the Groups section.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="NameRef" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The name of the group.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
Content 元素详细信息Content element details
SystemGroupSystemGroup
要将用户添加到的系统组。The system group to add the user to.必须在 Groups 节中定义该系统组。The system group must be defined in the Groups section.
属性Attribute
ValueValue
namename
SystemGroupSystemGroup
minOccursminOccurs
00
maxOccursmaxOccurs
unboundedunbounded
组Group
要将用户添加到的组。The group to add the user to.必须在 Groups 节中定义该组。The group must be defined in the Groups section.
属性Attribute
ValueValue
namename
组Group
minOccursminOccurs
00
maxOccursmaxOccurs
unboundedunbounded
Members 元素(在 StatefulServiceGroupType 中定义)Members element (defined in StatefulServiceGroupType)
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="NamedPartition">
<xs:annotation>
<xs:documentation>Describes a named partitioning scheme based on names for each partition.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence maxOccurs="unbounded">
<xs:element name="Partition">
<xs:annotation>
<xs:documentation>Describes a partition by name.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="Name" use="required">
<xs:annotation>
<xs:documentation>The name of the partition</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
Content 元素详细信息Content element details
分区Partition
按名称描述分区。Describes a partition by name.
属性Attribute
ValueValue
namename
分区Partition
NamingReplicatorEndpoint 元素NamingReplicatorEndpoint element
Parameters 中定义的 Parameter 元素Parameter element defined in Parameters
要在此清单中使用的应用程序参数。An application parameter to be used in this manifest.可在应用程序实例化期间更改参数值;如果未提供值,则使用默认值。The parameter value can be changed during application instantiation, or, if no value is supplied the default value is used.
属性Attribute
ValueValue
typetype
匿名的 complexTypeanonymous complexType
contentcontent
0 个元素,2 个属性0 element(s), 2 attribute(s)
defineddefined
在 Parameters 元素本地locally in Parameters element
namename
参数Parameter
blockblock
minOccursminOccurs
00
maxOccursmaxOccurs
unboundedunbounded
XML 源XML source
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Parameter" block="" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>An application parameter to be used in this manifest. The parameter value can be changed during application instantiation, or, if no value is supplied the default value is used.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="Name" use="required">
<xs:annotation>
<xs:documentation>The name of the parameter to be used in the manifest as "[Name]".</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="DefaultValue" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Default value for the parameter, used if the parameter value is not provided during application instantiation.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
名称Name
要在清单中用作“[Name]”的参数名称。The name of the parameter to be used in the manifest as "[Name]".
属性Attribute
ValueValue
namename
名称Name
useuse
必填required
DefaultValueDefaultValue
该参数的默认值,若应用程序实例化期间未提供该参数值,将使用该值。Default value for the parameter, used if the parameter value is not provided during application instantiation.
属性Attribute
ValueValue
namename
DefaultValueDefaultValue
typetype
xs:stringxs:string
useuse
必填required
Parameter 元素(在 Parameters 中定义)Parameter element (defined in Parameters)
Section 中定义的 Parameter 元素Parameter element defined in Section
要重写的设置。The setting to override.
属性Attribute
ValueValue
typetype
匿名的 complexTypeanonymous complexType
contentcontent
0 个元素,2 个属性0 element(s), 2 attribute(s)
defineddefined
在 Section 元素本地locally in Section element
namename
参数Parameter
minOccursminOccurs
00
maxOccursmaxOccurs
unboundedunbounded
XML 源XML source
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Parameter" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>The setting to override.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attributeGroup ref="NameValuePair"/>
<xs:attribute name="IsEncrypted" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>
If true, the value of this parameter is encrypted. The application developer is responsible for creating a certificate and using the Invoke-ServiceFabricEncryptSecret cmdlet to encrypt sensitive information. The certificate information that will be used to encrypt the value is specified in the Certificates section. This attribute is deprecated. Please use Type attribute.
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Type" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>
This value defines the type of value you have specified in the 'Value' Attribute. It can be SecretsStoreRef/Encrypted/PlainText.
If set to SecretsStoreRef, we retrieve the reference value from the SecretStore.
If set to Encrypted, the application developer is responsible for creating a certificate and using the Invoke-ServiceFabricEncryptSecret cmdlet to encrypt sensitive information.
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
IsEncryptedIsEncrypted
若为 true,则此参数的值已加密。If true, the value of this parameter is encrypted.应用程序开发人员负责创建证书并使用 Invoke ServiceFabricEncryptSecret cmdlet 来加密敏感信息。The application developer is responsible for creating a certificate and using the Invoke-ServiceFabricEncryptSecret cmdlet to encrypt sensitive information.在证书部分中指定将用于加密值的证书信息。The certificate information that will be used to encrypt the value is specified in the Certificates section.此属性已弃用。This attribute is deprecated.请使用 Type 属性。Please use Type attribute.
AttributeAttribute
值Value
namename
IsEncryptedIsEncrypted
typetype
xs:booleanxs:boolean
默认值default
falsefalse
类型Type
此值定义在“Value”属性中指定的值的类型。This value defines the type of value you have specified in the 'Value' Attribute.它可以是 SecretsStoreRef/Encrypted/PlainText。It can be SecretsStoreRef/Encrypted/PlainText.如果设置为 SecretsStoreRef,则我们从 SecretStore 检索引用值。If set to SecretsStoreRef, we retrieve the reference value from the SecretStore.如果设置为 Encrypted,则应用程序开发人员负责创建证书并使用 Invoke-ServiceFabricEncryptSecret cmdlet 来加密敏感信息。If set to Encrypted, the application developer is responsible for creating a certificate and using the Invoke-ServiceFabricEncryptSecret cmdlet to encrypt sensitive information.
AttributeAttribute
值Value
namename
类型Type
typetype
xs:stringxs:string
useuse
可选optional
Parameter 元素(在 Section 中定义)Parameter element (defined in Section)
AttributeAttribute
ValueValue
typetype
匿名的 complexTypeanonymous complexType
内容content
0 个元素,5 个属性0 element(s), 5 attribute(s)
defineddefined
在 Section 元素本地locally in Section element
namename
参数Parameter
minOccursminOccurs
00
maxOccursmaxOccurs
unboundedunbounded
XML 源XML source
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Parameter" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="Name" type="xs:string" use="required"/>
<xs:attribute name="Value" type="xs:string" use="required"/>
<xs:attribute name="MustOverride" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>If true, the value of this parameter must be overridden by higher level configuration.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="IsEncrypted" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>If true, the value of this parameter is encrypted.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Type" type="xs:string" use="optional"/>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
名称Name
AttributeAttribute
值Value
namename
“属性”Name
typetype
xs:stringxs:string
useuse
必需required
ValueValue
AttributeAttribute
值Value
namename
ValueValue
typetype
xs:stringxs:string
useuse
必需required
MustOverrideMustOverride
若为 true,则此参数的值必须由更高级别的配置重写。If true, the value of this parameter must be overridden by higher level configuration.
AttributeAttribute
值Value
namename
NewMustOverride
typetype
xs:booleanxs:boolean
默认值default
falsefalse
IsEncryptedIsEncrypted
若为 true,则此参数的值已加密。If true, the value of this parameter is encrypted.
AttributeAttribute
值Value
namename
IsEncryptedIsEncrypted
typetype
xs:booleanxs:boolean
默认值default
falsefalse
类型Type
AttributeAttribute
值Value
namename
类型Type
typetype
xs:stringxs:string
useuse
可选optional
Parameters 元素(类型 ParametersType)Parameters element (type ParametersType)
指定为名称/值对的其他设置Additional settings specified as name-value pairs
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Parameters">
<xs:annotation>
<xs:documentation>List of parameters for the application as defined in application manifest and their respective values.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Parameter" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attributeGroup ref="NameValuePair"/>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
Content 元素详细信息Content element details
参数Parameter
AttributeAttribute
值Value
namename
参数Parameter
minOccursminOccurs
00
maxOccursmaxOccurs
unboundedunbounded
Parameters 元素(在 ApplicationManifestType 中定义)Parameters element (defined in ApplicationManifestType)
声明在此应用程序清单中使用的参数。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.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Parameters" minOccurs="0">
<xs:annotation>
<xs:documentation>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.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Parameter" block="" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>An application parameter to be used in this manifest. The parameter value can be changed during application instantiation, or, if no value is supplied the default value is used.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="Name" use="required">
<xs:annotation>
<xs:documentation>The name of the parameter to be used in the manifest as "[Name]".</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="DefaultValue" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Default value for the parameter, used if the parameter value is not provided during application instantiation.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
Content 元素详细信息Content element details
参数Parameter
要在此清单中使用的应用程序参数。An application parameter to be used in this manifest.可在应用程序实例化期间更改参数值;如果未提供值,则使用默认值。The parameter value can be changed during application instantiation, or, if no value is supplied the default value is used.
AttributeAttribute
值Value
namename
参数Parameter
blockblock
minOccursminOccurs
00
maxOccursmaxOccurs
unboundedunbounded
Partition 元素Partition element
按名称描述分区。Describes a partition by name.
AttributeAttribute
ValueValue
typetype
匿名的 complexTypeanonymous complexType
内容content
0 个元素,1 个属性0 element(s), 1 attribute(s)
defineddefined
在 NamedPartition 元素本地locally in NamedPartition element
namename
分区Partition
XML 源XML source
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Partition">
<xs:annotation>
<xs:documentation>Describes a partition by name.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="Name" use="required">
<xs:annotation>
<xs:documentation>The name of the partition</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
名称Name
分区名称The name of the partition
AttributeAttribute
值Value
namename
“属性”Name
useuse
必需required
PersistencePolicy 元素PersistencePolicy element
服务类型的持久性策略扩展Persistence Policy extension for the Service Type
PlacementConstraints 元素PlacementConstraints element
用于控制服务可在群集中的哪些节点上运行。Used to control which nodes in the cluster a service can run on.描述节点属性名称和值的服务的要求一个键/值对。A key/value pair which describes the node property name and the service's requirements for the value.可以使用简单的布尔逻辑将各个语句组合在一起,以创建所需的约束。Individual statements can be grouped together with simple boolean logic to create the necessary constraint.例如 "(FirmwareVersion>12 && InDMZ == True)"。For example, "(FirmwareVersion>12 && InDMZ == True)".
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="PlacementConstraints" type="xs:string" minOccurs="0">
<xs:annotation>
<xs:documentation>Used to control which nodes in the cluster a service can run on. A key/value pair which describes the node property name and the service's requirements for the value. Individual statements can be grouped together with simple boolean logic to create the necessary constraint. For example, "(FirmwareVersion>12 && InDMZ == True)".</xs:documentation>
</xs:annotation>
</xs:element>
PlacementProperties 元素PlacementProperties element
描述要用作放置约束的此 NodeType 的属性Describe the properties for this NodeType that will be used as placement constraints
AttributeAttribute
ValueValue
typetype
匿名的 complexTypeanonymous complexType
内容content
1 个元素,0 个属性1 element(s), 0 attribute(s)
defineddefined
在 NodeType 元素本地locally in NodeType element
namename
PlacementPropertiesPlacementProperties
minOccursminOccurs
00
XML 源XML source
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="PlacementProperties" minOccurs="0">
<xs:annotation>
<xs:documentation>Describe the properties for this NodeType that will be used as placement constraints</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Property" type="KeyValuePairType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
Policies 元素(类型 ApplicationPoliciesType)Policies element (type ApplicationPoliciesType)
描述要在应用程序级别应用的策略(日志集合、默认运行方式帐户、运行状况和安全访问)。Describes the policies (log collection, default run-as, health, and security access) to be applied at the application level.
Policies 元素(类型 ServiceManifestImportPoliciesType)Policies element (type ServiceManifestImportPoliciesType)
描述要在导入的服务清单中应用的策略(终结点绑定、包共享、运行方式和安全访问权限)。Describes policies (end-point binding, package sharing, run-as, and security access) to be applied on the imported service manifest.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="PortBinding" type="PortBindingType" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Specifies which endpoint resource to bind container exposed port.</xs:documentation>
</xs:annotation>
</xs:element>
Principals 元素Principals element
描述此应用程序运行服务和安全资源所需的安全主体(用户、组)。Describes the security principals (users, groups) required for this application to run services and secure resources.主体在 policies 节中引用。Principals are referenced in the policies sections.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Program" type="xs:string">
<xs:annotation>
<xs:documentation>The executable name. For example, "MySetup.bat" or "MyServiceHost.exe".</xs:documentation>
</xs:annotation></xs:element>
Properties 元素Properties element
定义持久性和逐出策略的属性。Defines Properties for the Persistence and Eviction policies.
描述此服务使用的资源,可以在不修改已编译代码的情况下声明,并可以在部署服务时更改。Describes the resources used by this service, which can be declared without modifying compiled code and changed when the service is deployed.通过应用程序清单的 Principals 和 Policies 节控制对这些资源的访问。Access to these resources is controlled through the Principals and Policies sections of the application manifest.
指定运行服务代码包时所用的本地用户或本地系统帐户。Specifies the local user or local system account that a service code package will run as.在 Azure Active Directory 是可用的 Windows Server 部署上支持域帐户。Domain accounts are supported on Windows Server deployments where Azure Active Directory is available.默认情况下,应用程序在运行 Fabric.exe 程序的帐户之下运行。By default, applications run under the account that the Fabric.exe process runs under.应用程序也可以以其他帐户运行,必须在 Principals 节中声明。Applications can also run as other accounts, which must be declared in the Principals section.如果向服务应用 RunAs 策略务,而服务清单声明具有 HTTP 协议的终结点资源,则还必须指定 SecurityAccessPolicy,以确保分配给这些终结点的端口都已针对用来运行服务的 RunAs 用户帐户正确列入访问控制列表中。If you apply a RunAs policy to a service, and the service manifest declares endpoint resources with the HTTP protocol, you must also specify a SecurityAccessPolicy to ensure that ports allocated to these endpoints are correctly access-control listed for the RunAs user account that the service runs under.对于 HTTPS 终结点,还必须定义 EndpointBindingPolicy,用于指示要返回给客户端的证书名称。For an HTTPS endpoint, you also have to define a EndpointBindingPolicy to indicate the name of the certificate to return to the client.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Section" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>A section in the Settings.xml file to override.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Parameter" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>The setting to override.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attributeGroup ref="NameValuePair"/>
<xs:attribute name="IsEncrypted" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>
If true, the value of this parameter is encrypted. The application developer is responsible for creating a certificate and using the Invoke-ServiceFabricEncryptSecret cmdlet to encrypt sensitive information. The certificate information that will be used to encrypt the value is specified in the Certificates section. This attribute is deprecated. Please use Type attribute.
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Type" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>
This value defines the type of value you have specified in the 'Value' Attribute. It can be SecretsStoreRef/Encrypted/PlainText.
If set to SecretsStoreRef, we retrieve the reference value from the SecretStore.
If set to Encrypted, the application developer is responsible for creating a certificate and using the Invoke-ServiceFabricEncryptSecret cmdlet to encrypt sensitive information.
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="Name" use="required">
<xs:annotation>
<xs:documentation>The name of the section in the Settings.xml file to override.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
名称Name
要重写的 Settings.xml 文件中的节的名称。The name of the section in the Settings.xml file to override.
AttributeAttribute
值Value
namename
“属性”Name
useuse
必需required
Content 元素详细信息Content element details
参数Parameter
要重写的设置。The setting to override.
AttributeAttribute
值Value
namename
参数Parameter
minOccursminOccurs
00
maxOccursmaxOccurs
unboundedunbounded
Section 元素(在 SettingsType 中定义)Section element (defined in SettingsType)
SecurityAccessPolicy 元素SecurityAccessPolicy element
向服务清单中定义的资源(例如终结点)上的主体授予访问权限。Grants access permissions to a principal on a resource (such as an endpoint) defined in a service manifest.通常,它非常有助于控制和限制服务对不同资源的访问,以尽量降低安全风险。Typically, it is very useful to control and restrict access of services to different resources in order to minimize security risks.从市场中由不同开发人员开发的服务集合构建应用程序时,此属性尤其重要。This is especially important when the application is built from a collection of services from a marketplace which are developed by different developers.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServerCertificate" type="FabricCertificateType" minOccurs="0">
<xs:annotation>
<xs:documentation>The certificate used to secure the intra cluster communication.</xs:documentation>
</xs:annotation>
</xs:element>
Service 元素Service element
声明在实例化应用程序时要自动创建的服务。Declares a service to be created automatically when the application is instantiated.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="Service">
<xs:annotation>
<xs:documentation>Declares a service to be created automatically when the application is instantiated.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:choice minOccurs="0">
<xs:element name="StatelessService" type="StatelessServiceType"/>
<xs:element name="StatefulService" type="StatefulServiceType"/>
</xs:choice>
<xs:attribute name="Name" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The service name, used to form the fully qualified application name URI. The fully qualified name URI of the service would be: fabric:/ApplicationName/ServiceName.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="GeneratedIdRef" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>Reference to the auto generated id used by Visual Studio tooling.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ServiceDnsName" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>The DNS name of the service.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ServicePackageActivationMode" type="xs:string" use="optional" default="SharedProcess">
<xs:annotation>
<xs:documentation>ServicePackageActivationMode to be used when creating the service. Allowed values are 'SharedProcess' and 'ExclusiveProcess'. With SharedProcess mode, replica(s) or instance(s) from different partition(s) of service will share same activation of service package on a node. With ExclusiveProcess mode, each replica or instance of service will have its own dedicated activation of service package.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
“属性”Name
服务名称,用于构成完全限定的应用程序名称 URI。The service name, used to form the fully qualified application name URI.服务的完全限定名称 URI 为:fabric:/ApplicationName/ServiceName。The fully qualified name URI of the service would be: fabric:/ApplicationName/ServiceName.
AttributeAttribute
值Value
namename
“属性”Name
typetype
xs:stringxs:string
useuse
必需required
GeneratedIdRefGeneratedIdRef
对自动生成的 ID 的引用,此 ID 由 Visual Studio 工具使用。Reference to the auto generated id used by Visual Studio tooling.
创建服务时要使用的 ServicePackageActivationMode。ServicePackageActivationMode to be used when creating the service.允许的值为“SharedProcess”和“ExclusiveProcess”。Allowed values are 'SharedProcess' and 'ExclusiveProcess'.使用 SharedProcess 模式时,来自不同服务分区的副本或实例在节点上共享相同的服务包激活。With SharedProcess mode, replica(s) or instance(s) from different partition(s) of service will share same activation of service package on a node.使用 ExclusiveProcess 模式时,每个服务副本或实例都拥有自己专用的服务包激活。With ExclusiveProcess mode, each replica or instance of service will have its own dedicated activation of service package.
定义与另一个服务之间的关联关系。Defines an affinity relationship with another service.将整体应用程序拆分为微服务时很有用。Useful when splitting a previously-monolithic application into microservices.一个服务对另一个服务存在本地依赖,这两个服务需要在同一个节点上运行才能正常工作。One service has a local dependency on another service and both services need to run on the same node in order to work.
AttributeAttribute
ValueValue
typetype
匿名的 complexTypeanonymous complexType
内容content
0 个元素,2 个属性0 element(s), 2 attribute(s)
defineddefined
在 ServiceCorrelations 元素本地locally in ServiceCorrelations element
namename
ServiceCorrelationServiceCorrelation
maxOccursmaxOccurs
unboundedunbounded
XML 源XML source
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceCorrelation" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Defines an affinity relationship with another service. Useful when splitting a previously-monolithic application into microservices. One service has a local dependency on another service and both services need to run on the same node in order to work.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="ServiceName" use="required">
<xs:annotation>
<xs:documentation>The name of the other service as a URI. Example, "fabric:/otherApplication/parentService".</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Scheme" use="required">
<xs:annotation>
<xs:documentation>In NonAlignedAffinity the replicas or instances of the different services are placed on the same nodes. AlignedAffinity is used with stateful services. Configuring one stateful service as having aligned affinity with another stateful service ensures that the primaries of those services are placed on the same nodes as each other, and that each pair of secondaries are also placed on the same nodes.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Affinity"/>
<xs:enumeration value="AlignedAffinity"/>
<xs:enumeration value="NonAlignedAffinity"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
属性详细信息Attribute details
ServiceNameServiceName
作为 URI 的其他服务的名称。The name of the other service as a URI.例如“fabric:/otherApplication/parentService”。Example, "fabric:/otherApplication/parentService".
AttributeAttribute
值Value
namename
ServiceNameServiceName
useuse
必需required
SchemeScheme
在 NonAlignedAffinity 下,不同服务的副本或实例放在同一个节点上。In NonAlignedAffinity the replicas or instances of the different services are placed on the same nodes.AlignedAffinity 适用于有状态服务。AlignedAffinity is used with stateful services.将某一有状态服务配置为与另一有状态服务具有一致相关性后,可确保这些服务的主体位于相同节点上,且每对副本也位于相同节点上。Configuring one stateful service as having aligned affinity with another stateful service ensures that the primaries of those services are placed on the same nodes as each other, and that each pair of secondaries are also placed on the same nodes.
AttributeAttribute
值Value
namename
SchemeScheme
useuse
必需required
ServiceCorrelations 元素ServiceCorrelations element
定义服务之间的关联关系。Defines affinity relationships between services.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceCorrelations" minOccurs="0">
<xs:annotation>
<xs:documentation>Defines affinity relationships between services.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="ServiceCorrelation" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Defines an affinity relationship with another service. Useful when splitting a previously-monolithic application into microservices. One service has a local dependency on another service and both services need to run on the same node in order to work.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="ServiceName" use="required">
<xs:annotation>
<xs:documentation>The name of the other service as a URI. Example, "fabric:/otherApplication/parentService".</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Scheme" use="required">
<xs:annotation>
<xs:documentation>In NonAlignedAffinity the replicas or instances of the different services are placed on the same nodes. AlignedAffinity is used with stateful services. Configuring one stateful service as having aligned affinity with another stateful service ensures that the primaries of those services are placed on the same nodes as each other, and that each pair of secondaries are also placed on the same nodes.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Affinity"/>
<xs:enumeration value="AlignedAffinity"/>
<xs:enumeration value="NonAlignedAffinity"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
Content 元素详细信息Content element details
ServiceCorrelationServiceCorrelation
定义与另一个服务之间的关联关系。Defines an affinity relationship with another service.将整体应用程序拆分为微服务时很有用。Useful when splitting a previously-monolithic application into microservices.一个服务对另一个服务存在本地依赖,这两个服务需要在同一个节点上运行才能正常工作。One service has a local dependency on another service and both services need to run on the same node in order to work.
AttributeAttribute
值Value
namename
ServiceCorrelationServiceCorrelation
maxOccursmaxOccurs
unboundedunbounded
ServiceFabricRuntimeAccessPolicy 元素ServiceFabricRuntimeAccessPolicy element
指定用于确定如何向副本公开 Service Fabric 运行时的策略。Specifies policies that determine how the service fabric runtime is exposed to the replicas.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceFabricRuntimeAccessPolicy" type="ServiceFabricRuntimeAccessPolicyType" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Specifies policies that determine how the service fabric runtime is exposed to the replicas.</xs:documentation>
</xs:annotation>
</xs:element>
ServiceGroup 元素ServiceGroup element
自动放置在一起的服务集合,因此在故障转移或资源管理过程中它们也会一起移动。A collection of services that are automatically located together, so they are also moved together during fail-over or resource management.
<xs:element xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceGroup">
<xs:annotation>
<xs:documentation>A collection of services that are automatically located together, so they are also moved together during fail-over or resource management.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:choice minOccurs="0">
<xs:element name="StatelessServiceGroup" type="StatelessServiceGroupType"/>
<xs:element name="StatefulServiceGroup" type="StatefulServiceGroupType"/>
</xs:choice>
<xs:attribute name="Name" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Name of this service relative to this application Name URI. Fully qualified Name of the service is a combination of Name Uri of the Application and this Name.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ServicePackageActivationMode" type="xs:string" use="optional" default