<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="AppInstanceDefinitionType">
<xs:sequence>
<xs:element 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>
</xs:sequence>
<xs:attribute name="Name" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Name of the application to be created.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
Имя.
Имя приложения, которое необходимо создать.
Атрибут
Значение
name
Имя.
type
xs:string
используйте
обязательно
Сведения об элементе Content
Параметры
Список параметров приложения, определенных в манифесте приложения, и соответствующие значения.
Атрибут
Значение
name
Параметры
complexType: ApplicationHealthPolicyType
Описывает политику для оценки событий работоспособности, регистрируемых на связанных с различными приложениями сущностях. Если политика не указана, объект рассматривается как неработоспособный, если отчет о работоспособности является предупреждением или ошибкой.
Атрибут
Значение
content
2 элемента, 2 атрибута
архитектура
globally
name
ApplicationHealthPolicyType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ApplicationHealthPolicyType">
<xs:annotation>
<xs:documentation>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.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element 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>
<xs:element name="ServiceTypeHealthPolicy" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Describes the policy for evaluating health events reported on services, partitions and replicas of a particular service type.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:complexContent>
<xs:extension base="ServiceTypeHealthPolicyType">
<xs:attribute name="ServiceTypeName" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The name of the service type that the policy will be applied to.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="ConsiderWarningAsError" type="xs:string" use="optional" default="false">
<xs:annotation>
<xs:documentation>Specifies whether to treat warning health reports as errors during health evaluation. Default: false.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MaxPercentUnhealthyDeployedApplications" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>Specifies the maximum tolerated percentage of deployed applications that can be unhealthy before the application is considered in error. This is calculated by dividing the number of unhealthy deployed applications over the number of nodes that the applications are currently deployed on in the cluster. The computation rounds up to tolerate one failure on small numbers of nodes. Default percentage: 0.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
ConsiderWarningAsError
Указывает, следует ли при оценке работоспособности обрабатывать предупреждения как ошибки. По умолчанию: false.
Атрибут
Значение
name
ConsiderWarningAsError
type
xs:string
используйте
необязательно
default
false
MaxPercentUnhealthyDeployedApplications
Указывает максимально допустимый процент неработоспособных приложений, превышение которого вызывает состояние Error при оценке приложения. Это выраженное частное от деления количества неработоспособных развернутых приложений на количество узлов в кластере, на которых сейчас развернуты приложения. Расчет округляется: на небольшом количестве узлов допускается один сбой. Значение в процентах по умолчанию: 0.
Атрибут
Значение
name
MaxPercentUnhealthyDeployedApplications
type
xs:string
используйте
необязательно
default
0
Сведения об элементе Content
DefaultServiceTypeHealthPolicy
Задает политику работоспособности для типов служб по умолчанию, которая заменяет политику работоспособности по умолчанию для всех типов служб в приложении.
Декларативно описывает тип приложения и его версию. Один или несколько манифестов составных служб указываются для составления типа приложения. Параметры конфигурации составных служб могут быть переопределены с помощью параметризованных настроек приложения. Службы по умолчанию, шаблоны служб, субъекты, политики, диагностическая настройка и сертификаты также могут быть объявлены на уровне приложения.
Атрибут
Значение
content
9 элементов, 0 атрибутов
архитектура
globally
name
ApplicationManifestType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ApplicationManifestType">
<xs:annotation>
<xs:documentation>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:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Description" type="xs:string" minOccurs="0">
<xs:annotation>
<xs:documentation>Text describing this application.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element 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>
<xs:element name="ServiceManifestImport" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Imports a service manifest created by the service developer. A service manifest must be imported for each constituent service in the application. Configuration overrides and policies can be declared for the service manifest.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="ServiceManifestRef" type="ServiceManifestRefType"/>
<xs:element 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>
<xs:element name="ResourceOverrides" type="ResourceOverridesType" minOccurs="0"/>
<xs:element name="EnvironmentOverrides" type="EnvironmentOverridesType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="Policies" type="ServiceManifestImportPoliciesType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="ServiceTemplates" type="ServiceTemplatesType" minOccurs="0">
<xs:annotation>
<xs:documentation>Declares the set of permitted service types that can be created dynamically inside the application instance. Default configuration values, such as replication factor, are specified and used as a template for creating service instances.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="DefaultServices" type="DefaultServicesType" minOccurs="0">
</xs:element>
<xs:element name="Principals" type="SecurityPrincipalsType" minOccurs="0"/>
<xs:element name="Policies" type="ApplicationPoliciesType" minOccurs="0"/>
<xs:element name="Diagnostics" type="DiagnosticsType" minOccurs="0"/>
<xs:element 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>
</xs:sequence>
<xs:attributeGroup ref="ApplicationManifestAttrGroup"/>
</xs:complexType>
Сведения об элементе Content
Description
Текст, описывающий это приложение.
Атрибут
Значение
name
Описание
type
xs:string
minOccurs
0
Параметры
Объявляет параметры, используемые в этом манифесте приложения. Значения этих параметров могут быть предоставлены при создании экземпляра приложения и могут использоваться для переопределения параметров конфигурации приложения или службы.
Атрибут
Значение
name
Параметры
minOccurs
0
ServiceManifestImport
Импортирует манифест службы, созданный разработчиком службы. Манифест службы должен быть импортирован для каждой составной службы в приложении. Для манифеста службы могут быть объявлены политики и переопределения параметров.
Атрибут
Значение
name
ServiceManifestImport
maxOccurs
unbounded
ServiceTemplates
Объявляет набор разрешенных типов служб, которые могут динамически создаваться внутри экземпляра приложения. Значения конфигурации по умолчанию, например коэффициент репликации, указываются и используются в качестве шаблона для создания экземпляров служб.
Описывает политики (сбор журналов, запуск от имени по умолчанию, работоспособность и доступ к безопасности) для применения на уровне приложения.
Атрибут
Значение
content
4 элемента, 0 атрибутов
архитектура
globally
name
ApplicationPoliciesType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ApplicationPoliciesType">
<xs:annotation>
<xs:documentation>Describes the policies (log collection, default run-as, health, and security access) to be applied at the application level.</xs:documentation>
</xs:annotation>
<xs:all>
<xs:element name="LogCollectionPolicies" minOccurs="0">
<xs:annotation>
<xs:documentation>Specifies whether log collection is enabled. Works only in an Azure cluster environment</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence maxOccurs="unbounded">
<xs:element name="LogCollectionPolicy">
<xs:complexType>
<xs:attribute name="Path" type="xs:string" use="optional"/>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element 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>
<xs:element name="HealthPolicy" type="ApplicationHealthPolicyType" minOccurs="0"/>
<xs:element name="SecurityAccessPolicies" minOccurs="0">
<xs:annotation>
<xs:documentation>List of security policies applied to resources at the application level.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence maxOccurs="unbounded">
<xs:element name="SecurityAccessPolicy" type="SecurityAccessPolicyType"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:all>
</xs:complexType>
Сведения об элементе Content
LogCollectionPolicies
Указывает, включен ли сбор данных журналов. Работает только в среде кластера Azure.
Атрибут
Значение
name
LogCollectionPolicies
minOccurs
0
DefaultRunAsPolicy
Указывает учетную запись пользователя по умолчанию для всех пакетов кода службы, для которых не определен RunAsPolicy в разделе ServiceManifestImport.
Список политик безопасности, применяемых к ресурсам на уровне приложения.
Атрибут
Значение
name
SecurityAccessPolicies
minOccurs
0
complexType: AzureBlobETWType
Описывает целевое хранилище BLOB-объектов Azure для событий трассировки событий Windows. Работает только в среде Azure.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
AzureBlobETWType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="AzureBlobETWType">
<xs:annotation>
<xs:documentation>Describes an Azure blob store destination for ETW events. Works only in Azure environment.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="AzureBlobType">
<xs:attributeGroup ref="LevelFilter"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType: AzureBlobType
Описывает целевое хранилище BLOB-объектов Azure для данных диагностики. Работает только в среде кластера Azure.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
AzureBlobType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="AzureBlobType">
<xs:annotation>
<xs:documentation>Describes an Azure blob store destination for diagnostics data. Works only in Azure cluster environment.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="AzureStoreBaseType">
<xs:attributeGroup ref="ContainerName"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="CertificatesType">
<xs:all>
<xs:element 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>
<xs:element 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>
<xs:element name="ClientCertificate" type="FabricCertificateType" minOccurs="0">
<xs:annotation>
<xs:documentation>The default admin role client certificate used to secure client server communication.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="UserRoleClientCertificate" type="FabricCertificateType" minOccurs="0">
<xs:annotation>
<xs:documentation>The default user role client certificate used to secure client server communication.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:all>
</xs:complexType>
Сведения об элементе Content
ClusterCertificate
Сертификат, используемый для защиты передачи данных внутри кластера.
Описывает пакеты кода, которые поддерживают тип определенной службы. При создании экземпляра службы в соответствии с одним из этих типов службы все пакеты кода, объявленные в этом манифесте, активируются путем запуска соответствующих точек входа. Запущенные вследствие этого процессы должны зарегистрировать поддерживаемые типы служб во время выполнения. При наличии нескольких пакетов кода они все активируются при поиске системой любого из задекларированных типов служб.
Атрибут
Значение
content
3 элемента, 2 атрибута
архитектура
globally
name
CodePackageType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="CodePackageType">
<xs:annotation>
<xs:documentation>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:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="SetupEntryPoint" minOccurs="0">
<xs:annotation>
<xs:documentation>A privileged entry point that by default runs with the same credentials as Service Fabric (typically the NETWORKSERVICE account) before any other entry point. 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.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="ExeHost" type="ExeHostEntryPointType"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="EntryPoint" type="EntryPointDescriptionType" minOccurs="1"/>
<xs:element name="EnvironmentVariables" type="EnvironmentVariablesType" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
<xs:attributeGroup ref="VersionedName"/>
<xs:attribute name="IsShared" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>Indicates if the contents of this code package are shared by other code packages. If true, on an upgrade of this code package, all code packages will be restarted. This attribute is currently not supported and it's value will be ignored.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="IsActivator" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>This attribute is for internal use only.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
IsShared
Указывает, является ли содержимое этого пакета кода общим для других пакетов кода. Если значение равно True, то при обновлении этого пакета будут перезапущены все пакеты кода. Этот атрибут сейчас не поддерживается, и его значение будет пропущено.
Атрибут
Значение
name
IsShared
type
xs:boolean
default
false
IsActivator
Этот атрибут предназначен только для внутреннего использования.
Атрибут
Значение
name
IsActivator
type
xs:boolean
default
false
Сведения об элементе Content
SetupEntryPoint
Это привилегированная точка входа, которая по умолчанию запускается с теми же учетными данными, что и Service Fabric (обычно это учетная запись NETWORKSERVICE), перед тем как будут запущены любые другие точки входа. Исполняемый файл, указанный в точке входа EntryPoint, обычно является узлом службы, запускаемым на длительный срок. Наличие отдельной точки входа настройки позволяет избежать необходимости в выполнении узла службы с расширенными правами в течение длительного срока.
Описывает переопределения конфигурации для определенного пакета конфигурации в импортированном манифесте службы.
Атрибут
Значение
content
1 элемент, 1 атрибут
архитектура
globally
name
ConfigOverrideType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ConfigOverrideType">
<xs:annotation>
<xs:documentation>Describes the configuration overrides for a particular config package in the imported service manifest.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Settings" type="SettingsOverridesType" minOccurs="0"/>
</xs:sequence>
<xs:attribute name="Name" use="required">
<xs:annotation>
<xs:documentation>The name of the configuration package in the service manifest which contains the setting(s) to be overridden.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
Имя.
Имя пакета конфигурации в манифесте служб, который содержит параметры для переопределения.
Объявляет папку с именем, указанным в атрибуте Name, которая содержит файл Settings.xml. Этот файл содержит разделы заданных пользователем параметров пар "ключ-значение", которые могут считываться процессом во время выполнения. Во время обновления при изменении одного только атрибута version для ConfigPackage перезапуск процесса не выполняется. Вместо этого при помощи обратного вызова в процесс передается уведомление о том, что параметры конфигурации изменились, поэтому они были перезагружены в динамическом режиме.
Атрибут
Значение
content
0 элементов, 4 атрибута
архитектура
globally
name
ConfigPackageDescriptionType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ConfigPackageDescriptionType">
<xs:annotation>
<xs:documentation>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. 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:documentation>
</xs:annotation>
<xs:attribute name="Name" use="required">
<xs:annotation>
<xs:documentation>Name of the versioned item.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="SectionName" use="required">
<xs:annotation>
<xs:documentation>Section Name of the ConfigPackage Settings.xml.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="MountPoint" type="xs:string" use="optional" default=""/>
<xs:attribute name="EnvironmentVariableName" type="xs:string" use="optional" default=""/>
</xs:complexType>
Сведения об атрибутах
Имя.
Имя элемента с управлением версиями.
Атрибут
Значение
name
Имя.
используйте
обязательно
SectionName
Имя раздела в файле Settings.xml для ConfigPackage.
Объявляет в разделе PackageRoot папку с именем, указанным в атрибуте Name, которая содержит файл Settings.xml. Этот файл содержит разделы заданных пользователем параметров пар "ключ-значение", которые могут считываться процессом во время выполнения. Во время обновления при изменении одного только атрибута version для ConfigPackage перезапуск процесса не выполняется. Вместо этого при помощи обратного вызова в процесс передается уведомление о том, что параметры конфигурации изменились, поэтому они были перезагружены в динамическом режиме.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
ConfigPackageType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ConfigPackageType">
<xs:annotation>
<xs:documentation>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. 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:documentation>
</xs:annotation>
<xs:attributeGroup ref="VersionedName"/>
</xs:complexType>
complexType: ContainerCertificateType
Указывает сведения о сертификате X509, который должен быть предоставлен в среде контейнера. Этот сертификат должен быть установлен в хранилище LocalMachine на всех узлах в кластере.
При запуске приложения в среде выполнения считываются сертификаты, создается файл PFX и пароль (в Windows) или файл PEM (в Linux).
Файл PFX и пароль, доступны в контейнере с помощью переменных среды Certificates_ServicePackageName_CodePackageName_CertName_PFX и Certificates_ServicePackageName_CodePackageName_CertName_Password. Файл PEM доступен в контейнере с помощью переменных среды Certificates_ServicePackageName_CodePackageName_CertName_PEM и Certificates_ServicePackageName_CodePackageName_CertName_PrivateKey.
Атрибут
Значение
content
0 элементов, 8 атрибутов
архитектура
globally
name
ContainerCertificateType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ContainerCertificateType">
<xs:annotation>
<xs:documentation>Specifies information about an X509 certificate which is to be exposed to the container environment. The certificate must be installed in the LocalMachine store of all the cluster nodes.
When the application starts, the runtime reads the certificate and generates a PFX file and password (on Windows) or a PEM file (on Linux).
The PFX file and password are accessible in the container using the Certificates_ServicePackageName_CodePackageName_CertName_PFX and
Certificates_ServicePackageName_CodePackageName_CertName_Password environment variables. The PEM file is accessible in the container using the
Certificates_ServicePackageName_CodePackageName_CertName_PEM and Certificates_ServicePackageName_CodePackageName_CertName_PrivateKey environment variables.</xs:documentation>
</xs:annotation>
<xs:attribute name="X509StoreName" type="xs:string" default="My">
<xs:annotation>
<xs:documentation>The store name for the X509 certificate.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="X509FindValue" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>The thumbprint of the X509 certificate.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="DataPackageRef" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>The name of data package that has the certificate files.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="DataPackageVersion" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>The version of data package that has the certificate files.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="RelativePath" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>The relative path to the certificate file inside data package.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Password" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>Password/Private key for the certificate.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="IsPasswordEncrypted" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>If true, the value of password is encrypted.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Name" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Identifier for the specific certificate information. This name is used to set the environment variable in the container.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
X509StoreName
Имя хранилища сертификата X509.
Атрибут
Значение
name
X509StoreName
type
xs:string
default
My
X509FindValue
Отпечаток сертификата X509.
Атрибут
Значение
name
X509FindValue
type
xs:string
используйте
необязательно
DataPackageRef
Имя пакета данных с файлами сертификата.
Атрибут
Значение
name
DataPackageRef
type
xs:string
используйте
необязательно
DataPackageVersion
Версия пакета данных с файлами сертификата.
Атрибут
Значение
name
DataPackageVersion
type
xs:string
используйте
необязательно
RelativePath
Относительный путь к файлу сертификата в пакете данных.
Атрибут
Значение
name
RelativePath
type
xs:string
используйте
необязательно
Пароль
Пароль или закрытый ключ сертификата.
Атрибут
Значение
name
Пароль
type
xs:string
используйте
необязательно
IsPasswordEncrypted
Если значение равно True, пароль шифруется.
Атрибут
Значение
name
IsPasswordEncrypted
type
xs:boolean
default
false
Имя.
Идентификатор сведений о конкретном сертификате. Это имя позволяет задать переменную среду в контейнере.
Атрибут
Значение
name
Имя.
type
xs:string
используйте
обязательно
ContainerHealthConfigType complexType
Указывает параметры интеграции HEALTHCHECK Docker для контейнера.
Атрибут
Значение
content
0 элементов, 2 атрибута
архитектура
globally
name
ContainerHealthConfigType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ContainerHealthConfigType">
<xs:annotation>
<xs:documentation>Specifies docker HEALTHCHECK integration options for the container.</xs:documentation>
</xs:annotation>
<xs:attribute name="IncludeDockerHealthStatusInSystemHealthReport" type="xs:boolean" use="optional" default="true">
<xs:annotation>
<xs:documentation>If the container has HEALTHCHECK enabled and docker reports health_status event for this container,
Service Fabric will include this as part of system reported health. When health_status is unhealthy
Service Fabric will report a health warning. By default it is set to true.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="RestartContainerOnUnhealthyDockerHealthStatus" type="xs:boolean" use="optional" default="false">
<xs:annotation>
<xs:documentation>If the container has HEALTHCHECK enabled and docker reports health_status event for this container,
Service Fabric will restart the container when health_status reported by docker is unhealthy.
By default it is set to false.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
IncludeDockerHealthStatusInSystemHealthReport
Если у контейнера включен параметр HEALTHCHECK и Docker сообщает о событии health_status для этого контейнера, Service Fabric включит его в сообщение о работоспособности системы. Если событие health_status связано с неработоспособностью, Service Fabric отправит соответствующее предупреждение. По умолчанию установлено значение true.
Атрибут
Значение
name
IncludeDockerHealthStatusInSystemHealthReport
type
xs:boolean
используйте
необязательно
default
true
RestartContainerOnUnhealthyDockerHealthStatus
Если у контейнера включен параметр HEALTHCHECK и Docker сообщает о событии health_status для этого контейнера, Service Fabric перезапустит контейнер после сообщения Docker о неработоспособности.
По умолчанию установлено значение false.
Атрибут
Значение
name
RestartContainerOnUnhealthyDockerHealthStatus
type
xs:boolean
используйте
необязательно
default
false
complexType: ContainerHostEntryPointType
Атрибут
Значение
content
4 элемента, 0 атрибутов
архитектура
globally
name
ContainerHostEntryPointType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ContainerHostEntryPointType">
<xs:sequence>
<!--container image name-->
<xs:element name="ImageName" type="xs:string">
<xs:annotation>
<xs:documentation>The repo and image on https://hub.docker.com or Azure Container Registry.</xs:documentation>
</xs:annotation>
</xs:element>
<!--comma delimited list of commands for container-->
<xs:element 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>
<xs:element name="EntryPoint" type="xs:string" minOccurs="0" maxOccurs="1"/>
<xs:element name="FromSource" type="xs:string" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>
Передает разделенный запятыми список команд контейнеру.
Атрибут
Значение
name
Команды
type
xs:string
minOccurs
0
maxOccurs
1
EntryPoint
Атрибут
Значение
name
EntryPoint
type
xs:string
minOccurs
0
maxOccurs
1
FromSource
Атрибут
Значение
name
FromSource
type
xs:string
minOccurs
0
maxOccurs
1
complexType: ContainerHostPoliciesType
Атрибут
Значение
content
10 элементов, 8 атрибутов
архитектура
globally
name
ContainerHostPoliciesType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ContainerHostPoliciesType">
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="RepositoryCredentials" type="RepositoryCredentialsType" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Credentials for container image repository to pull images from.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element 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>
<xs:element name="PortBinding" type="PortBindingType" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Specifies which endpoint resource to bind to the exposed container port.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element 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>
<xs:element name="LogConfig" type="ContainerLoggingDriverType" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Specifies the logging driver for a container.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="NetworkConfig" type="ContainerNetworkConfigType" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Specifies the network configuration for a container.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Volume" type="ContainerVolumeType" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Specifies the volume to be bound to container.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="SecurityOption" type="SecurityOptionsType" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Specifies securityoptions for the container.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element 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>
<xs:element name="Label" type="ContainerLabelType" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Specifies the labels for the container.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:choice>
<xs:attribute name="CodePackageRef" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="UseDefaultRepositoryCredentials" type="xs:string" use="optional" default="false">
<xs:annotation>
<xs:documentation>Use the default repository credentials specified in clusterManifest.xml
instead of the credentials specified in the "RepositoryCredentials" tag inside ApplicationManifest.xml.
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UseTokenAuthenticationCredentials" type="xs:string" use="optional" default="false">
<xs:annotation>
<xs:documentation>Use MSI token authentication (or a custom specified endpoint) to obtain a token used for authentication.
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Isolation" use="optional" type="xs:string">
<xs:annotation>
<xs:documentation>Isolation mode for container. Valid values are default, process or Hyper-V (only supported for Windows containers).</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Hostname" use="optional" type="xs:string">
<xs:annotation>
<xs:documentation>Specify Hostname for container.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ContainersRetentionCount" use="optional" type="xs:string" default="0">
<xs:annotation>
<xs:documentation>Number of containers to leave behind when container repeatedly dies. By default this is set to 0 so no containers will be left behind.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="AutoRemove" use="optional" type="xs:string">
<xs:annotation>
<xs:documentation>Flag indicating whether removal of containers will occur automatically (true) or not (false) if the container is killed. If false SF manually remove the containers.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="RunInteractive" use="optional" type="xs:string">
<xs:annotation>
<xs:documentation>Run container with interactive flag enabled. Valid values are true/false. false by default.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
CodePackageRef
Атрибут
Значение
name
CodePackageRef
используйте
обязательно
UseDefaultRepositoryCredentials
Используйте учетные данные репозитория по умолчанию, указанные в файле clusterManifest.xml, вместо учетных данных, указанных в теге RepositoryCredentials в файле ApplicationManifest.xml.
Атрибут
Значение
name
UseDefaultRepositoryCredentials
type
xs:string
используйте
необязательно
default
false
UseTokenAuthenticationCredentials
Используйте аутентификацию на основе токена MSI (или указанную пользователем конечную точку) для получения токена, необходимого для выполнения аутентификации.
Атрибут
Значение
name
UseTokenAuthenticationCredentials
type
xs:string
используйте
необязательно
default
false
Изоляция
Режим изоляции контейнера. Допустимые значения — default, process или hyperv (поддерживается только для контейнеров Windows).
Атрибут
Значение
name
Изоляция
используйте
необязательно
type
xs:string
Hostname (Имя узла)
Указывает имя узла контейнера.
Атрибут
Значение
name
Hostname (Имя узла)
используйте
необязательно
type
xs:string
ContainersRetentionCount
Число контейнеров, которое необходимо оставить, если контейнер многократно выходит из строя. Значение по умолчанию: 0 (контейнеры не остаются).
Атрибут
Значение
name
ContainersRetentionCount
используйте
необязательно
type
xs:string
default
0
AutoRemove
Флажок, указывающий, как будет выполняться удаление контейнеров после завершения их работы: автоматически (true) или нет (false). Если выбрано значение false, удалите контейнеры вручную.
Атрибут
Значение
name
AutoRemove
используйте
необязательно
type
xs:string
RunInteractive
Запускает контейнер со включенным интерактивным флагом. Допустимые значения: True и False. Значение по умолчанию: False.
Атрибут
Значение
name
RunInteractive
используйте
необязательно
type
xs:string
Сведения об элементе Content
RepositoryCredentials
Учетные данные репозитория образов контейнеров для получения образов.
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ContainerNetworkPolicyEndpointBindingType">
<xs:attribute name="EndpointRef">
<xs:annotation>
<xs:documentation>The name of the endpoint, which must be declared in the Resources section of the service manifest.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
EndpointRef
Имя конечной точки, которое должно быть объявлено в разделе ресурсов манифеста службы.
Атрибут
Значение
name
EndpointRef
ContainerNetworkPolicyType complexType
Описывает связь между пакетом службы и сетью контейнера, а также при необходимости связь между конечными точками пакета службы и сети контейнера.
Атрибут
Значение
content
1 элемент, 1 атрибут
архитектура
globally
name
ContainerNetworkPolicyType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ContainerNetworkPolicyType">
<xs:annotation>
<xs:documentation>Describes association between a service package and a container network and optionally association between endpoints of the service package and the container network.</xs:documentation>
</xs:annotation>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element 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>
</xs:choice>
<xs:attribute name="NetworkRef" use="required">
<xs:annotation>
<xs:documentation>The name of the container network (case-insensitive). It has to be name of a container network already created or reserved names including "Open" or "NAT".</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
NetworkRef
Имя сети контейнера (без учета регистра). Это должно быть имя уже созданной или зарезервированной сети контейнера, включающее Open или NAT.
Атрибут
Значение
name
NetworkRef
используйте
обязательно
Сведения об элементе Content
EndpointBinding
Указывает конечную точку, которую необходимо предоставить в сети контейнера.
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ContainerVolumeType">
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="DriverOption" type="DriverOptionType" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Driver options to be passed to driver.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:choice>
<xs:attribute name="Source" use="required">
<xs:annotation>
<xs:documentation>The source folder which can be a folder in the VM that hosts the containers or a persistent remote store.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Destination" use="required">
<xs:annotation>
<xs:documentation>The location that the Source is mapped to within the running container. Thus, your destination can't be a location that already exists within your container.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Driver" use="optional">
<xs:annotation>
<xs:documentation>The driver name for the Azure Files volume plugin is "sfazurefile".</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="IsReadOnly" type="xs:boolean" default="false"/>
</xs:complexType>
Сведения об атрибутах
Исходный код
Исходной папкой может быть папка в виртуальной машине, в которой размещаются контейнеры, или постоянное удаленное хранилище.
Атрибут
Значение
name
Оригинал
используйте
обязательно
Назначение
Расположение, с которым сопоставляется источник в работающем контейнере. Таким образом, конечной папкой не может быть существующее в контейнере расположение.
Атрибут
Значение
name
Назначение
используйте
обязательно
Драйвер
Имя драйвера для подключаемого модуля тома службы файлов Azure – sfazurefile.
Объявляет в разделе PackageRoot папку с именем, указанным в атрибуте Name, которая содержит статические файлы данных, обрабатываемые процессом во время выполнения. Service Fabric будет перезапускать все EXE-файлы и DLLHOST-файлы, указанные в пакетах поддержки и размещения, когда обновляется любой из пакетов данных, перечисленных в манифесте службы.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
DataPackageType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="DataPackageType">
<xs:annotation>
<xs:documentation>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 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.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="VersionedName"/>
</xs:complexType>
complexType: DebugParametersType
Указывает сведения об отладчике, подключаемом во время активации пакета кода.
Переопределенная точка входа для контейнеров, необходимая для запуска отладчика.
Атрибут
Значение
name
ContainerEntryPoint
type
xs:string
minOccurs
0
maxOccurs
unbounded
ContainerMountedVolume
Тома для подключения внутри контейнера.
Атрибут
Значение
name
ContainerMountedVolume
type
xs:string
minOccurs
0
maxOccurs
unbounded
ContainerEnvironmentBlock
EnvironmentBlock для контейнеров.
Атрибут
Значение
name
ContainerEnvironmentBlock
type
xs:string
minOccurs
0
maxOccurs
unbounded
ContainerLabel
Метки для контейнеров в форме "ключ=значение".
Атрибут
Значение
name
ContainerLabel
type
xs:string
minOccurs
0
maxOccurs
unbounded
complexType: DefaultServicesType
Декларирует экземпляры служб, которые создаются автоматически при создании экземпляра приложения в соответствии с его типом.
Атрибут
Значение
content
2 элемента, 0 атрибутов
архитектура
globally
name
DefaultServicesType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="DefaultServicesType">
<xs:annotation>
<xs:documentation>Declares service instances that are automatically created whenever an application is instantiated against this application type.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element 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>
<xs:element 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="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>
</xs:choice>
</xs:sequence>
</xs:complexType>
Сведения об элементе Content
Service
Объявляет службу, которая автоматически будет создана при создании экземпляра приложения.
Атрибут
Значение
name
Service
ServiceGroup
Коллекция служб, которые автоматически расположены вместе, поэтому они также перемещаются вместе во время отработки отказа или управления ресурсами.
Атрибут
Значение
name
ServiceGroup
complexType: DiagnosticsType
Описывает параметры диагностики приложений.
Атрибут
Значение
content
3 элемента, 0 атрибутов
архитектура
globally
name
DiagnosticsType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="DiagnosticsType">
<xs:annotation>
<xs:documentation>Describes the diagnostic settings for applications.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element 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>
<xs:element 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>
<xs:element 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>
</xs:sequence>
</xs:complexType>
Сведения об элементе Content
CrashDumpSource
Задает сбор аварийных дампов. Аварийные дампы собираются для исполняемых файлов, в которых размещаются пакеты кода всех служб, принадлежащих приложению.
Атрибут
Значение
name
CrashDumpSource
minOccurs
0
ETWSource
Задает сбор трассировки событий Windows. Данные трассировки событий Windows собираются для поставщиков, зарегистрированных во всех службах, относящихся к приложению.
Атрибут
Значение
name
ETWSource
minOccurs
0
FolderSource
Задает сбор содержимого определенной папки на локальном узле.
Атрибут
Значение
name
FolderSource
minOccurs
0
maxOccurs
unbounded
complexType: DllHostEntryPointType
Не поддерживается, не следует использовать. Поддержка размещения DLL (точка входа сборки) предоставляется через процесс FWP.exe. Service Fabric запускает рабочий процесс Fabric (FWP.exe) и загружает сборку в рамках процесса активации.
Атрибут
Значение
content
2 элемента, 1 атрибут
архитектура
globally
name
DllHostEntryPointType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="DllHostEntryPointType">
<xs:annotation>
<xs:documentation>Unsupported, do not use. DLL hosting support (assembly entry point) is provided through the FWP.exe process. Service Fabric starts the Fabric Worker Process (FWP.exe) and loads the assembly as part of the activation process.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="UnmanagedDll" type="UnmanagedDllType"/>
<xs:element name="ManagedAssembly" type="ManagedAssemblyType"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="IsolationPolicy" use="optional" default="DedicatedProcess">
<xs:annotation>
<xs:documentation>Unsupported, do not use. Defines the isolation policy for the Unmanaged DLLs and Managed Assemblies loaded in the DllHost. </xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="SharedDomain"/>
<xs:enumeration value="DedicatedDomain"/>
<xs:enumeration value="DedicatedProcess"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
IsolationPolicy
Не поддерживается, не следует использовать. Определяет политику изоляции неуправляемых библиотек DLL и управляемых сборок, загружаемых в DllHost.
Параметры драйвера, которые необходимо передать. Подключаемый модуль тома службы файлов Azure поддерживает следующие параметры драйвера: shareName (файловый ресурс службы файлов Azure, предоставляющий том для контейнера), storageAccountName (учетная запись хранения Azure, содержащая файловый ресурс службы файлов Azure), storageAccountKey (ключ доступа для учетной записи хранения Azure, которая содержит файловый ресурс службы файлов Azure).
Три эти параметра драйвера являются обязательными.
Атрибут
Значение
content
0 элементов, 4 атрибута
архитектура
globally
name
DriverOptionType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="DriverOptionType">
<xs:annotation>
<xs:documentation>Driver options to be passed to driver. The Azure Files volume plugin supports the following driver options:
shareName (the Azure Files file share that provides the volume for the container), storageAccountName (the Azure storage account
that contains the Azure Files file share), storageAccountKey (Access key for the Azure storage account that contains the Azure Files file share).
These three driver options are required.</xs:documentation>
</xs:annotation>
<xs:attribute name="Name" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The name of the driver option. </xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Value" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The value of the driver option. </xs:documentation>
</xs:annotation>
</xs:attribute>
<!-- TODO [dragosav] this needs to be deprecated; unclear if we can outright remove it, or give advance notice and remove it in an upcoming release. -->
<xs:attribute name="IsEncrypted" type="xs:string" use="optional" default="false"/>
<xs:attribute name="Type" type="xs:string" use="optional" default="PlainText">
<xs:annotation>
<xs:documentation>
This value defines the protection of the value of the attribute. It may be SecretsStoreRef/Encrypted/PlainText.
If set to SecretsStoreRef, the value references a secret stored encrypted in the cluster's SecureStore, which is de-referenced and decrypted upon activation.
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>
Сведения об атрибутах
Имя.
Имя параметра драйвера.
Атрибут
Значение
name
Имя.
type
xs:string
используйте
обязательно
Значение
Значение параметра драйвера.
Атрибут
Значение
name
Значение
type
xs:string
используйте
обязательно
IsEncrypted
Атрибут
Значение
name
IsEncrypted
type
xs:string
используйте
необязательно
default
false
Тип
Это значение определяет защиту значения атрибута. Может быть одним из следующих: SecretsStoreRef, Encrypted, PlainText.
Если использует SecretsStoreRef, значение ссылается на секрет, хранимый в зашифрованном виде в SecureStore кластера (при активации ссылка отменяется и секрет дешифруется).
Если задано значение Encrypted, за создание сертификата и использование командлета Invoke-ServiceFabricEncryptSecret для шифрования конфиденциальной информации отвечает разработчик приложения.
Атрибут
Значение
name
Тип
type
xs:string
используйте
необязательно
default
PlainText
complexType: EndpointBindingPolicyType
Атрибут
Значение
content
0 элементов, 2 атрибута
архитектура
globally
name
EndpointBindingPolicyType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="EndpointBindingPolicyType">
<xs:attribute name="EndpointRef">
<xs:annotation>
<xs:documentation>The name of the endpoint, which must be declared in the Resources section of the service manifest. When using HTTPS, do not use
the same port and certificate for different service instances (independent of the application) deployed to the same node. Upgrading two different services
using the same port in different application instances will result in an upgrade failure.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="CertificateRef" use="required">
<xs:annotation>
<xs:documentation>The name of the endpoint certificate, declared in the Certificates section, to return to the client. </xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
EndpointRef
Имя конечной точки, которое должно быть объявлено в разделе ресурсов манифеста службы. При использовании HTTPS не используйте тот же порт и сертификат для разных экземпляров службы (независимо от приложения), развернутых на одном узле. Обновление двух разных служб, использующих один порт в разных экземплярах приложения, приведет к сбою обновлений.
Атрибут
Значение
name
EndpointRef
CertificateRef
Имя сертификата конечной точки, объявленное в разделе сертификатов, которое возвращается клиенту.
Атрибут
Значение
name
CertificateRef
используйте
обязательно
complexType: EndpointCertificateType
Указывает сведения о сертификате X509, который используется для защиты конечной точки.
Атрибут
Значение
content
0 элементов, 3 атрибута
архитектура
globally
name
EndpointCertificateType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="EndpointCertificateType">
<xs:annotation>
<xs:documentation>Specifies information about an X509 certificate used to secure an endpoint.</xs:documentation>
</xs:annotation>
<xs:attribute name="X509StoreName" type="xs:string" default="My">
<xs:annotation>
<xs:documentation>The store name for the X509 certificate.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="X509FindValue" use="required">
<xs:annotation>
<xs:documentation>The thumbprint of the X509 certificate.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Name" type="xs:string" use="optional"/>
</xs:complexType>
Сведения об атрибутах
X509StoreName
Имя хранилища сертификата X509.
Атрибут
Значение
name
X509StoreName
type
xs:string
default
My
X509FindValue
Отпечаток сертификата X509.
Атрибут
Значение
name
X509FindValue
используйте
обязательно
Имя.
Атрибут
Значение
name
Имя.
type
xs:string
используйте
необязательно
complexType: EndpointOverrideType
Атрибут
Значение
content
0 элементов, 6 атрибутов
архитектура
globally
name
EndpointOverrideType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="EndpointOverrideType">
<xs:attribute name="Name" use="required">
<xs:annotation>
<xs:documentation>The name of the endpoint to override. A string.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Port" type="xs:string">
<xs:annotation>
<xs:documentation>The port number for the endpoint. Overrides the value in the service manifest.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Protocol" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>The protocol for the endpoint. Overrides the value in the service manifest. HTTPS endpoints must also have an EndpointCertificate and an EndpointBindingPolicy declared in the application manifest. The protocol cannot be changed later in an application upgrade. </xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Type" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>The type of the endpoint. Overrides the value in the service manifest. Input endpoints are used to expose the port to the outside, internal endpoints are used for intra-application communication.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UriScheme" use="optional">
<xs:annotation>
<xs:documentation>The URI scheme. Overrides the value in the service manifest. For example, "http", "https", or "ftp".</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="PathSuffix" use="optional">
<xs:annotation>
<xs:documentation>The path suffix. For example, "/myapp1". Overrides the value in the service manifest.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
Имя.
Имя конечной точки для переопределения. Строка .
Атрибут
Значение
name
Имя.
используйте
обязательно
Порт
Номер порта для конечной точки. Переопределяет значение в манифесте служб.
Атрибут
Значение
name
Порт
type
xs:string
Протокол
Протокол конечной точки. Переопределяет значение в манифесте служб. Конечные точки HTTPS также должны иметь EndpointCertificate и EndpointBindingPolicy, объявленные в манифесте приложения. Позже протокол невозможно будет изменить при обновлении приложения.
Атрибут
Значение
name
Протокол
type
xs:string
используйте
необязательно
Тип
Тип конечной точки. Переопределяет значение в манифесте служб. Входная конечная точка используется, когда необходимо предоставить порт вовне. Внутренние конечные точки используются для передачи данных внутри приложения.
Атрибут
Значение
name
Тип
type
xs:string
используйте
необязательно
UriScheme
Схема URI. Переопределяет значение в манифесте служб. Например, HTTP, HTTPS или FTP.
Атрибут
Значение
name
UriScheme
используйте
необязательно
PathSuffix
Суффикс пути. Например, /myapp1. Переопределяет значение в манифесте служб.
Атрибут
Значение
name
PathSuffix
используйте
необязательно
complexType: EndpointType
Определяет конечную точку службы. Можно запрашивать определенные порты. Если порт не указан явно, он назначается из диапазона зарезервированных портов приложения. Репликам службы, которые выполняются на различных узлах кластера, можно назначить разные номера портов, а реплики аналогичных служб, выполняющиеся на одном и том же узле, будут совместно использовать один порт. Такие порты могут использоваться репликами служб для различных целей, таких как репликация или прослушивание клиентских запросов.
Атрибут
Значение
content
0 элементов, 8 атрибутов
архитектура
globally
name
EndpointType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="EndpointType">
<xs:annotation>
<xs:documentation>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:documentation>
</xs:annotation>
<xs:attribute name="Name" use="required">
<xs:annotation>
<xs:documentation>The name of the endpoint.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Protocol" use="optional" default="tcp">
<xs:annotation>
<xs:documentation>The protocol for the endpoint: http, https, tcp, or udp. HTTPS endpoints must also have an EndpointCertificate and an EndpointBindingPolicy declared in the application manifest. The protocol cannot be changed later in an application upgrade. </xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="http"/>
<xs:enumeration value="https"/>
<xs:enumeration value="tcp"/>
<xs:enumeration value="udp"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Type" use="optional" default="Internal">
<xs:annotation>
<xs:documentation>The type of the endpoint. Input endpoints are used to expose the port to the outside, internal endpoints are used for intra-application communication.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Input"/>
<xs:enumeration value="Internal"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="CodePackageRef" use="optional">
<xs:annotation>
<xs:documentation>The name of code Package that will use this endpoint.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="CertificateRef">
<xs:annotation>
<xs:documentation>Do not use, this attribute is not supported.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Port">
<xs:annotation>
<xs:documentation>The port will be replaced with a port determined by Microsoft Azure Service Fabric after registering with Http.sys or BFE.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="65535"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="UriScheme">
<xs:annotation>
<xs:documentation>The URI scheme. For example, "http", "https", or "ftp".</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="PathSuffix">
<xs:annotation>
<xs:documentation>The path suffix. For example, "/myapp1".</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
Имя.
Имя конечной точки.
Атрибут
Значение
name
Имя.
используйте
обязательно
Протокол
Протокол для конечной точки: http, https, tcp или udp. Конечные точки HTTPS также должны иметь EndpointCertificate и EndpointBindingPolicy, объявленные в манифесте приложения. Позже протокол невозможно будет изменить при обновлении приложения.
Атрибут
Значение
name
Протокол
используйте
необязательно
default
tcp
Тип
Тип конечной точки. Входная конечная точка используется, когда необходимо предоставить порт вовне. Внутренние конечные точки используются для передачи данных внутри приложения.
Атрибут
Значение
name
Тип
используйте
необязательно
default
Внутренняя
CodePackageRef
Имя пакета кода, который будет использовать эта конечная точка.
Атрибут
Значение
name
CodePackageRef
используйте
необязательно
CertificateRef
Не используйте. Этот атрибут не поддерживается.
Атрибут
Значение
name
CertificateRef
Порт
Порт будет заменен портом, определенным службой Microsoft Azure Service Fabric после регистрации в Http.sys или BFE.
Атрибут
Значение
name
Порт
UriScheme
Схема URI. Например, HTTP, HTTPS или FTP.
Атрибут
Значение
name
UriScheme
PathSuffix
Суффикс пути. Например, /myapp1.
Атрибут
Значение
name
PathSuffix
complexType: EntryPointDescriptionType
Исполняемый файл, указанный в точке входа EntryPoint, обычно является узлом службы, запускаемым на длительный срок. Наличие отдельной точки входа настройки позволяет избежать необходимости в выполнении узла службы с расширенными правами в течение длительного срока. Исполняемый файл, указанный в точке входа EntryPoint, запускается после успешного выхода из точки SetupEntryPoint. Возникающий вследствие этого процесс отслеживается и перезапускается (снова начиная с точки входа SetupEntryPoint), даже если произошло непредвиденное завершение его работы или сбой.
Атрибут
Значение
content
3 элемента, 0 атрибутов
архитектура
globally
name
EntryPointDescriptionType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="EntryPointDescriptionType">
<xs:annotation>
<xs:documentation>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. The executable specified by EntryPoint is run after SetupEntryPoint exits successfully. The resulting process is monitored and restarted (beginning again with SetupEntryPoint) if it ever terminates or crashes.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:choice>
<xs:element name="ExeHost">
<xs:complexType>
<xs:complexContent>
<xs:extension base="ExeHostEntryPointType">
<xs:sequence>
<xs:element name="RunFrequency" minOccurs="0">
<xs:complexType>
<xs:attribute name="IntervalInSeconds" use="required">
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="2147483647"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:element name="DllHost" type="DllHostEntryPointType"/>
<xs:element name="ContainerHost" type="ContainerHostEntryPointType"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="EnvironmentVariableType">
<xs:attribute name="Name" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Name of environment variable.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Value">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="0"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Type" use="optional" default="PlainText">
<xs:annotation>
<xs:documentation>
The type for the Environment Variable. It can be PlainText/Encrypted/SecretsStoreRef.
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:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="PlainText"/>
<xs:enumeration value="Encrypted"/>
<xs:enumeration value="SecretsStoreRef"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
Имя.
Имя переменной среды.
Атрибут
Значение
name
Имя.
type
xs:string
используйте
обязательно
Значение
Атрибут
Значение
name
Значение
Тип
Тип переменной среды. Может иметь одно из следующих значений: PlainText, Encrypted, SecretsStoreRef.
Если задано значение SecretsStoreRef, значение ссылки будет получено из SecretStore.
Если задано значение Encrypted, за создание сертификата и использование командлета Invoke-ServiceFabricEncryptSecret для шифрования конфиденциальной информации отвечает разработчик приложения.
Атрибут
Значение
name
Тип
используйте
необязательно
default
PlainText
complexType: EnvironmentVariablesType
Передает переменные среды в контейнер или EXE-файл.
Атрибут
Значение
content
1 элемент, 0 атрибутов
архитектура
globally
name
EnvironmentVariablesType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="EnvironmentVariablesType">
<xs:annotation>
<xs:documentation>Pass environment variables to your container or exe. </xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="EnvironmentVariable" type="EnvironmentVariableType" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Environment variable.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ExeHostEntryPointType">
<xs:sequence>
<xs:element 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>
<xs:element name="Arguments" type="xs:string" minOccurs="0"/>
<xs:element name="WorkingFolder" default="Work" minOccurs="0">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Work"/>
<xs:enumeration value="CodePackage"/>
<xs:enumeration value="CodeBase"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element 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>
</xs:sequence>
<xs:attribute name="IsExternalExecutable" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>True if the executable is external to the application package. Program existence check in the application package is skipped.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
IsExternalExecutable
Значение True, если исполняемый файл находится за пределами пакета приложения. Проверка существования программы в пакете приложения пропускается.
Атрибут
Значение
name
IsExternalExecutable
type
xs:boolean
default
false
Сведения об элементе Content
Программа
Имя исполняемого файла. Например, MySetup.bat или MyServiceHost.exe.
Атрибут
Значение
name
Программа
type
xs:string
Аргументы
Атрибут
Значение
name
Аргументы
type
xs:string
minOccurs
0
WorkingFolder
Атрибут
Значение
name
WorkingFolder
default
Работа
minOccurs
0
ConsoleRedirection
Предупреждение. Не используйте перенаправление консоли в рабочем приложении. Его рекомендуется использовать только при локальной разработке и отладке. Этот элемент перенаправляет выходные данные консоли из сценария запуска в выходной файл в папке приложения с именем "log" на том узле кластера, где развертывается и выполняется приложение.
Атрибут
Значение
name
ConsoleRedirection
minOccurs
0
complexType: ExtensionsType
Описывает расширения, которые могут применяться к другим элементам.
Атрибут
Значение
content
1 элемент, 0 атрибутов
архитектура
globally
name
ExtensionsType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ExtensionsType">
<xs:annotation>
<xs:documentation>Describes extensions that can be applied to other elements.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Extension" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:any namespace="##other" processContents="lax"/>
</xs:sequence>
<xs:attribute name="Name" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="GeneratedId" type="xs:string" use="optional"/>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
Сведения об элементе Content
Расширение
Атрибут
Значение
name
Расширение
minOccurs
0
maxOccurs
unbounded
complexType: FabricCertificateType
Указывает сведения о сертификате.
Атрибут
Значение
content
0 элементов, 5 атрибутов
архитектура
globally
name
FabricCertificateType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="FabricCertificateType">
<xs:annotation>
<xs:documentation>This specifies the certificate information.</xs:documentation>
</xs:annotation>
<xs:attribute name="X509StoreName" type="xs:string" default="My">
<xs:annotation>
<xs:documentation>The store name for the X509 certificate.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="X509FindType" default="FindByThumbprint">
<xs:annotation>
<xs:documentation>This is Used only when credential is X509. This specifies how to find the certificate whether by the name or the thumbprint </xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="FindByThumbprint"/>
<xs:enumeration value="FindBySubjectName"/>
<xs:enumeration value="FindByExtension"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="X509FindValue" use="required">
<xs:annotation>
<xs:documentation>This is Used only when credential is X509. This is the actual name or thumbprint of the certificate.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="X509FindValueSecondary" use="optional" default="">
<xs:annotation>
<xs:documentation>This is used only when credential is X509. This is the actual name or thumbprint of the certificate.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Name" type="xs:string" use="optional"/>
</xs:complexType>
Сведения об атрибутах
X509StoreName
Имя хранилища сертификата X509.
Атрибут
Значение
name
X509StoreName
type
xs:string
default
My
X509FindType
Используется только в случае, если учетные данные являются объектами X509. Указывает способ поиска сертификата: по имени или по отпечатку
Атрибут
Значение
name
X509FindType
default
FindByThumbprint
X509FindValue
Используется только в случае, если учетные данные являются объектами X509. Это фактическое имя или отпечаток сертификата.
Атрибут
Значение
name
X509FindValue
используйте
обязательно
X509FindValueSecondary
Используется только в случае, если учетные данные являются объектами X509. Это фактическое имя или отпечаток сертификата.
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="FabricKtlLoggerSettingsType">
<xs:all>
<xs:element name="SharedLogFilePath" minOccurs="0">
<xs:annotation>
<xs:documentation>Defines path to shared log.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="Value" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="SharedLogFileId" minOccurs="0">
<xs:annotation>
<xs:documentation>Specific GUID to use as the shared log ID.</xs:documentation>
</xs:annotation>
<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:element name="SharedLogFileSizeInMB" minOccurs="0">
<xs:annotation>
<xs:documentation>Defines how large is the shared log.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="Value" use="required">
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:minInclusive value="512"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:all>
</xs:complexType>
Сведения об элементе Content
SharedLogFilePath
Определяет путь к общему журналу.
Атрибут
Значение
name
SharedLogFilePath
minOccurs
0
SharedLogFileId
Определенный идентификатор GUID для использования в качестве идентификатора общего журнала.
Атрибут
Значение
name
SharedLogFileId
minOccurs
0
SharedLogFileSizeInMB
Определяет размер общего журнала.
Атрибут
Значение
name
SharedLogFileSizeInMB
minOccurs
0
complexType: FabricNodeType
Описывает узел Microsoft Azure Service Fabric.
Атрибут
Значение
content
0 элементов, 6 атрибутов
архитектура
globally
name
FabricNodeType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="FabricNodeType">
<xs:annotation>
<xs:documentation>Describes a Microsoft Azure Service Fabric Node.</xs:documentation>
</xs:annotation>
<xs:attribute name="NodeName" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The name of the node instance.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="IPAddressOrFQDN" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The IP address or the FQDN of the machine on which to place this node.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="IsSeedNode" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>A flag indicating whether or not this node is a seed node.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="NodeTypeRef" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Name of the nodetype defined in the NodeTypes section. </xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="FaultDomain" type="xs:anyURI" use="optional">
<xs:annotation>
<xs:documentation>The fault domain of this node.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UpgradeDomain" type="xs:anyURI" use="optional">
<xs:annotation>
<xs:documentation>The upgrade domain of this node.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
NodeName
Имя экземпляра узла.
Атрибут
Значение
name
NodeName
type
xs:string
используйте
обязательно
IPAddressOrFQDN
IP-адрес или полное доменное имя (FQDN) компьютера, на котором следует разместить этот узел.
Атрибут
Значение
name
IPAddressOrFQDN
type
xs:string
используйте
обязательно
IsSeedNode
Флаг, указывающий, является ли этот узел начальным.
Атрибут
Значение
name
IsSeedNode
type
xs:boolean
default
false
NodeTypeRef
Имя типа узла, определенного в разделе NodeTypes.
Атрибут
Значение
name
NodeTypeRef
type
xs:string
используйте
обязательно
FaultDomain
Домен сбоя этого узла.
Атрибут
Значение
name
FaultDomain
type
xs:anyURI
используйте
необязательно
UpgradeDomain
Домен обновления узла.
Атрибут
Значение
name
UpgradeDomain
type
xs:anyURI
используйте
необязательно
complexType: FileStoreETWType
Описывает целевое хранилище файлов для событий трассировки событий Windows. Работает только в локальной среде.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
FileStoreETWType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="FileStoreETWType">
<xs:annotation>
<xs:documentation>Describes a file store destination for ETW events. Works only in on-premises environment.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="FileStoreType">
<xs:attributeGroup ref="LevelFilter"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType: FileStoreType
Описывает целевое хранилище файлов для данных диагностики. Работает только в среде изолированного кластера.
Атрибут
Значение
content
1 элемент, 2 атрибута
архитектура
globally
name
FileStoreType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="FileStoreType">
<xs:annotation>
<xs:documentation>Describes a file store destination for diagnostics data. Works only in a standalone cluster environment.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element ref="Parameters" minOccurs="0"/>
</xs:sequence>
<xs:attributeGroup ref="IsEnabled"/>
<xs:attributeGroup ref="Path"/>
<xs:attributeGroup ref="UploadIntervalInMinutes"/>
<xs:attributeGroup ref="DataDeletionAgeInDays"/>
<xs:attribute name="AccountType" type="xs:string">
<xs:annotation>
<xs:documentation>Specifies the type of account.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="AccountCredentialsGroup"/>
<xs:attribute name="PasswordEncrypted" type="xs:string">
<xs:annotation>
<xs:documentation>Specifies if password is encrypted or plain text.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
Тип учетной записи
Указывает тип учетной записи.
Атрибут
Значение
name
Тип учетной записи
type
xs:string
PasswordEncrypted
Указывает, является ли пароль зашифрованным или обычным текстом.
Атрибут
Значение
name
PasswordEncrypted
type
xs:string
Сведения об элементе Content
нет
Атрибут
Значение
ref
Параметры
minOccurs
0
ImageOverridesType complexType
Контейнеры Windows Server могут быть несовместимы в разных версиях ОС. Можно указать несколько образов операционной системы для контейнера и пометить их с помощью тега версии сборки операционной системы. Получить версию сборки операционной системы можно, выполнив в командной строке Windows команду winver. Если используется базовая ОС сборки 16299 (версия Windows Server 1709), Service Fabric выбирает образ контейнера с отметкой Os="16299". Предполагается, что образ контейнера без отметки будет работать во всех версиях операционной системы и он имеет приоритет над образом, указанным в манифесте службы.
Атрибут
Значение
content
1 элемент, 0 атрибутов
архитектура
globally
name
ImageOverridesType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ImageOverridesType">
<xs:annotation>
<xs:documentation>Windows Server containers may not be compatible across different versions of the OS. You can specify multiple OS images per container and tag
them with the build versions of the OS. Get the build version of the OS by running "winver" at a Windows command prompt. If the underlying OS
is build version 16299 (Windows Server version 1709), Service Fabric picks the container image tagged with Os="16299". An untagged 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:sequence>
<xs:element 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:sequence>
</xs:complexType>
Сведения об элементе Content
Изображения
Образ контейнера, соответствующий номеру версии сборки ОС, которая будет запущена. Если атрибут Os не указан, предполагается, что образ контейнера работает во всех версиях операционной системы и он имеет приоритет над образом, указанным в манифесте службы.
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ImageType">
<xs:attribute name="Name" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Name of container image.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Os" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>Build version of the OS. For example, the build version of Windows Server version 1709 is 16299.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
Имя.
Имя образа контейнера.
Атрибут
Значение
name
Имя.
type
xs:string
используйте
обязательно
Os
Версия сборки операционной системы. Например, версия сборки версии Windows Server 1709 – 16299.
Атрибут
Значение
name
Os
type
xs:string
используйте
необязательно
complexType: InfrastructureInformationType
Содержит сведения об инфраструктуре для этого кластера Microsoft Azure Service Fabric.
Атрибут
Значение
content
1 элемент, 0 атрибутов
архитектура
globally
name
InfrastructureInformationType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="InfrastructureInformationType">
<xs:annotation>
<xs:documentation>Contains the infrastructure information for this Microsoft Azure Service Fabric cluster.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="NodeList">
<xs:complexType>
<xs:sequence>
<xs:element name="Node" type="InfrastructureNodeType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
Сведения об элементе Content
NodeList
Атрибут
Значение
name
NodeList
complexType: InfrastructureNodeType
Описывает необходимые сведения об инфраструктуре.
Атрибут
Значение
content
2 элемента, 7 атрибутов
архитектура
globally
name
InfrastructureNodeType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="InfrastructureNodeType">
<xs:annotation>
<xs:documentation>Describes an Infrastructure information needed.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Endpoints" type="FabricEndpointsType" minOccurs="0">
<xs:annotation>
<xs:documentation>Describe the endpoints associated with this node type</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Certificates" type="CertificatesType" minOccurs="0">
<xs:annotation>
<xs:documentation>Describe the certificates associated with this node type</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:attribute name="NodeName" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The name of the node instance.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="IPAddressOrFQDN" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The IP address or the FQDN of the machine on which to place this node.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="RoleOrTierName" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Name of the role which links to node type ref which is defined in the NodeTypes section.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="NodeTypeRef" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Name of the node type which is defined in the NodeTypes section.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="IsSeedNode" type="xs:boolean" use="optional" default="false">
<xs:annotation>
<xs:documentation>Indicates whether the node is a seed node.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="FaultDomain" type="xs:anyURI" use="optional">
<xs:annotation>
<xs:documentation> The fault domain of this node. </xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UpgradeDomain" type="xs:anyURI" use="optional">
<xs:annotation>
<xs:documentation>The upgrade domain of this node. </xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
NodeName
Имя экземпляра узла.
Атрибут
Значение
name
NodeName
type
xs:string
используйте
обязательно
IPAddressOrFQDN
IP-адрес или полное доменное имя (FQDN) компьютера, на котором следует разместить этот узел.
Атрибут
Значение
name
IPAddressOrFQDN
type
xs:string
используйте
обязательно
RoleOrTierName
Имя роли, связанное со ссылкой на тип узла, определенный в разделе NodeTypes.
Атрибут
Значение
name
RoleOrTierName
type
xs:string
используйте
обязательно
NodeTypeRef
Имя типа узла, определенного в разделе NodeTypes.
Атрибут
Значение
name
NodeTypeRef
type
xs:string
используйте
обязательно
IsSeedNode
Указывает, является ли узел начальным.
Атрибут
Значение
name
IsSeedNode
type
xs:boolean
используйте
необязательно
default
false
FaultDomain
Домен сбоя этого узла.
Атрибут
Значение
name
FaultDomain
type
xs:anyURI
используйте
необязательно
UpgradeDomain
Домен обновления узла.
Атрибут
Значение
name
UpgradeDomain
type
xs:anyURI
используйте
необязательно
Сведения об элементе Content
Конечные точки
Описывает конечные точки, связанные с этим типом узла.
Ресурс, по которому должна быть сбалансирована эта служба, например память или ЦП. Содержит сведения о том, какой объем ресурса потребляет по умолчанию каждая реплика или экземпляр этой службы.
Атрибут
Значение
content
0 элементов, 5 атрибутов
архитектура
globally
name
LoadMetricType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="LoadMetricType">
<xs:annotation>
<xs:documentation>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.</xs:documentation>
</xs:annotation>
<xs:attribute name="Name" use="required">
<xs:annotation>
<xs:documentation>A unique identifier for the metric within the cluster from the Cluster Resource Manager's perspective.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="DefaultLoad" type="xs:long" use="optional" default="0">
<xs:annotation>
<xs:documentation>The default amount of load that this stateless service creates for this metric.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="PrimaryDefaultLoad" type="xs:long" use="optional" default="0">
<xs:annotation>
<xs:documentation>The default amount of load that this service will exert for this metric when it's a primary replica.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="SecondaryDefaultLoad" type="xs:long" use="optional" default="0">
<xs:annotation>
<xs:documentation>The default amount of load that this service will exert for this metric when it's a secondary replica.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Weight">
<xs:annotation>
<xs:documentation>Determines the metric weight relative to the other metrics that are configured for this service. During runtime, if two metrics end up in conflict, the Cluster Resource Manager prefers the metric with the higher weight. Zero disables load balancing for this metric.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Zero"/>
<xs:enumeration value="Low"/>
<xs:enumeration value="Medium"/>
<xs:enumeration value="High"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
Имя.
Уникальный идентификатор метрики в кластере с точки зрения диспетчера кластерных ресурсов.
Атрибут
Значение
name
Имя.
используйте
обязательно
DefaultLoad
Объем нагрузки по умолчанию, который служба без отслеживания состояния создает для этой метрики.
Атрибут
Значение
name
DefaultLoad
type
xs:long
используйте
необязательно
default
0
PrimaryDefaultLoad
Объем нагрузки по умолчанию, которую служба будет производить для этой метрики (если это первичная метрика).
Атрибут
Значение
name
PrimaryDefaultLoad
type
xs:long
используйте
необязательно
default
0
SecondaryDefaultLoad
Объем нагрузки по умолчанию, которую служба будет производить для этой метрики (если это вторичная метрика).
Атрибут
Значение
name
SecondaryDefaultLoad
type
xs:long
используйте
необязательно
default
0
Вес
Указывает вес метрики по сравнению с другими метриками, настроенными для этой службы. Если выполнение двух метрик завершается конфликтом, диспетчер кластерных ресурсов выбирает метрику с более высоким весом. Значение ноль отключает балансировку нагрузки для этой метрики.
Атрибут
Значение
name
Вес
complexType: LocalStoreETWType
Описывает целевое хранилище на узле для событий трассировки событий Windows.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
LocalStoreETWType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="LocalStoreETWType">
<xs:annotation>
<xs:documentation>Describes a store destination within the node for ETW events.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="LocalStoreType">
<xs:attributeGroup ref="LevelFilter"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType: LocalStoreType
Описывает целевое хранилище на узле для данных диагностики.
Атрибут
Значение
content
1 элемент, 0 атрибутов
архитектура
globally
name
LocalStoreType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="LocalStoreType">
<xs:annotation>
<xs:documentation>Describes a store destination within the node for diagnostic data.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element ref="Parameters" minOccurs="0"/>
</xs:sequence>
<xs:attributeGroup ref="IsEnabled"/>
<xs:attributeGroup ref="RelativeFolderPath"/>
<xs:attributeGroup ref="DataDeletionAgeInDays"/>
</xs:complexType>
Сведения об элементе Content
нет
Атрибут
Значение
ref
Параметры
minOccurs
0
complexType: LogicalDirectoryType
Описывает тип LogicalDirectoryType.
Атрибут
Значение
content
0 элементов, 3 атрибута
архитектура
globally
name
LogicalDirectoryType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="LogicalDirectoryType">
<xs:annotation>
<xs:documentation>Describes a LogicalDirectoryType.</xs:documentation>
</xs:annotation>
<xs:attribute name="LogicalDirectoryName" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The name of the LogicalDirectory.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MappedTo" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>The path of the LogicalDirectory.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Context" use="optional" default="application">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="application"/>
<xs:enumeration value="node"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
LogicalDirectoryName
Имя LogicalDirectory.
Атрибут
Значение
name
LogicalDirectoryName
type
xs:string
используйте
обязательно
MappedTo
Путь LogicalDirectory.
Атрибут
Значение
name
MappedTo
type
xs:string
используйте
обязательно
Контекст
Атрибут
Значение
name
Контекст
используйте
необязательно
default
приложений
complexType: ManagedAssemblyType
Не поддерживается, не следует использовать. Имя размещаемой управляемой сборки (например, Queue.dll).
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
ManagedAssemblyType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ManagedAssemblyType">
<xs:annotation>
<xs:documentation>Unsupported, do not use. The name of managed assembly (for example, Queue.dll), to host.</xs:documentation>
</xs:annotation>
<xs:simpleContent>
<xs:extension base="xs:string"/>
</xs:simpleContent>
</xs:complexType>
NetworkPoliciesType complexType
Описывает политики сети, включая политики сети контейнера для пакета службы.
Атрибут
Значение
content
1 элемент, 0 атрибутов
архитектура
globally
name
NetworkPoliciesType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="NetworkPoliciesType">
<xs:annotation>
<xs:documentation>Describes network policies including container network policies for the service package.</xs:documentation>
</xs:annotation>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element 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>
</xs:choice>
</xs:complexType>
Сведения об элементе Content
ContainerNetworkPolicy
Описывает политики сети контейнера для пакета службы.
Указывает, что пакет кода, конфигурации или данных должен совместно использоваться в экземплярах служб одного типа.
Атрибут
Значение
content
0 элементов, 2 атрибута
архитектура
globally
name
PackageSharingPolicyType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="PackageSharingPolicyType">
<xs:annotation>
<xs:documentation>Indicates if a code, config or data package should be shared across service instances of the same service type.</xs:documentation>
</xs:annotation>
<xs:attribute name="PackageRef">
<xs:annotation>
<xs:documentation>The name of the code, config, or data package to be shared. Must match the name of the package defined in the service manifest.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Scope" default="None">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="None"/>
<xs:enumeration value="All"/>
<xs:enumeration value="Code"/>
<xs:enumeration value="Config"/>
<xs:enumeration value="Data"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
PackageRef
Имя пакета кода, конфигурации и данных для общего использования. Должно соответствовать имени пакета, определенном в манифесте службы.
Атрибут
Значение
name
PackageRef
Область
Атрибут
Значение
name
Область
default
нет
complexType: ParameterType
Атрибут
Значение
content
0 элементов, 1 атрибут
архитектура
globally
name
ParameterType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ParameterType">
<xs:attributeGroup ref="NameValuePair"/>
<xs:attribute name="IsEncrypted" type="xs:string">
<xs:annotation>
<xs:documentation>If true, the value of this parameter is encrypted</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
IsEncrypted
Если значение равно True, то значение этого параметра шифруется
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="RepositoryCredentialsType">
<xs:attributeGroup ref="AccountCredentialsGroup"/>
<xs:attribute name="PasswordEncrypted" type="xs:boolean" use="optional">
<xs:annotation>
<xs:documentation>Specifies if password is encrypted or plain text. This attribute is deprecated. Please use the 'Type' attribute to indicate encrypted password.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="Email">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Type" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>
This value defines the type of password you have specified in the 'Password' 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>
Сведения об атрибутах
PasswordEncrypted
Указывает, является ли пароль зашифрованным или обычным текстом. Этот атрибут нерекомендуемый. Чтобы указать зашифрованный пароль, используйте атрибут Type.
Атрибут
Значение
name
PasswordEncrypted
type
xs:boolean
используйте
необязательно
Сообщение электронной почты
Атрибут
Значение
name
Сообщение электронной почты
Тип
Это значение определяет тип пароля, указанного в атрибуте Password. Может иметь такие значения: SecretsStoreRef, Encrypted, PlainText.
Если задано значение SecretsStoreRef, значение ссылки будет получено из SecretStore.
Если задано значение Encrypted, за создание сертификата и использование командлета Invoke-ServiceFabricEncryptSecret для шифрования конфиденциальной информации отвечает разработчик приложения.
Атрибут
Значение
name
Тип
type
xs:string
используйте
необязательно
complexType: ResourceGovernancePolicyType
Ограничивает ресурсы, которые могут использоваться на узле и объявляет ограничения для ресурсов для пакета кода службы.
Атрибут
Значение
content
0 элементов, 12 атрибутов
архитектура
globally
name
ResourceGovernancePolicyType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ResourceGovernancePolicyType">
<xs:annotation>
<xs:documentation>Restricts the resources that can be used on the host and declares resource limits for a service code package.</xs:documentation>
</xs:annotation>
<xs:attribute name="CodePackageRef" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="MemoryInMB" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>Memory limits in MB. Must be a positive integer. Code packages (containers or processes) are not able to allocate more memory than this limit, and attempting to do so results in an out-of-memory exception.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MemorySwapInMB" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>The total amount of swap memory that can be used, in MB. Must be a positive integer.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MemoryReservationInMB" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>The soft limit (in MB) for memory governance that is enforced only when memory contention is detected on the node. Must be a positive integer.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="CpuShares" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>Relative CPU weight. Must be a positive integer.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="CpuPercent" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>Usable percentage of available CPUs (Windows only). Must be a positive integer. If CPU limits are specified for the service package, this parameter is effectively ignored.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MaximumIOps" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>Maximum IO rate (read and write) in terms of IOPS that can be used. Must be a positive integer.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MaximumIOBandwidth" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>The maximum IO (bytes per second) that can be used (read and write). Must be a positive integer.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="BlockIOWeight" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>Block IO weight, relative to other code packages. Must be a positive integer between 10 and 1000.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="DiskQuotaInMB" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>Disk quota for containers. Must be a positive integer.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="KernelMemoryInMB" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>Kernel memory limits in bytes. Must be a positive integer. Note this is Linux specific and docker on windows will error out if this is set.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ShmSizeInMB" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>Size of /dev/shm in bytes. If omitted, the system uses 64MB. Must be a positive integer. Note this is Linux specific, however, docker will NOT error out if specified. It is simply ignored.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
CodePackageRef
Атрибут
Значение
name
CodePackageRef
используйте
обязательно
MemoryInMB
Ограничения памяти (в МБ). Принимаются только положительные целые числа. Пакеты кода (контейнеры или процессы) не могут выделить больше памяти, чем задано ограничением, а при попытке сделать это возникнет проблема нехватки памяти.
Атрибут
Значение
name
MemoryInMB
type
xs:string
используйте
необязательно
default
0
MemorySwapInMB
Общий объем используемой памяти подкачки, в МБ. Принимаются только положительные целые числа.
Атрибут
Значение
name
MemorySwapInMB
type
xs:string
используйте
необязательно
default
0
MemoryReservationInMB;
Мягкое ограничение (в МБ) для управления памятью, которое применяется, только когда на узле обнаруживается состязание за память. Принимаются только положительные целые числа.
Атрибут
Значение
name
MemoryReservationInMB;
type
xs:string
используйте
необязательно
default
0
CpuShares
Относительный вес ЦП. Принимаются только положительные целые числа.
Атрибут
Значение
name
CpuShares
type
xs:string
используйте
необязательно
default
0
CpuPercent
Процент доступных используемых ЦП (только для Windows). Принимаются только положительные целые числа. Если ограничения ресурсов ЦП указаны для пакета службы, этот параметр игнорируется.
Атрибут
Значение
name
CpuPercent
type
xs:string
используйте
необязательно
default
0
MaximumIOps
Максимальная скорость ввода-вывода (чтение и запись) с точки зрения операций ввода-вывода, которые могут использоваться. Принимаются только положительные целые числа.
Атрибут
Значение
name
MaximumIOps
type
xs:string
используйте
необязательно
default
0
MaximumIOBandwidth
Максимальная скорость ввода-вывода (в байтах в секунду), которую можно использовать (чтение и запись). Принимаются только положительные целые числа.
Атрибут
Значение
name
MaximumIOBandwidth
type
xs:string
используйте
необязательно
default
0
BlockIOWeight
Вес блока ввода-вывода, относительно других пакетов кода. Принимается только целочисленное значение в диапазоне от 10 до 1000.
Атрибут
Значение
name
BlockIOWeight
type
xs:string
используйте
необязательно
default
0
DiskQuotaInMB
Дисковая квота для контейнеров. Принимаются только положительные целые числа.
Атрибут
Значение
name
DiskQuotaInMB
type
xs:string
используйте
необязательно
default
0
KernelMemoryInMB
Ограничения памяти ядра в байтах. Принимаются только положительные целые числа. Обратите внимание, что это применимо только для Linux. При использовании данного атрибута в Docker на платформе Windows возникнет ошибка.
Атрибут
Значение
name
KernelMemoryInMB
type
xs:string
используйте
необязательно
default
0
ShmSizeInMB
Размер /dev/shm в байтах. Если размер не указан, система использует 64 МБ. Принимаются только положительные целые числа. Обратите внимание, что это применимо только для Linux. Однако при использовании данного атрибута в Docker ошибка не возникнет. Атрибут просто будет проигнорирован.
Атрибут
Значение
name
ShmSizeInMB
type
xs:string
используйте
необязательно
default
0
complexType: ResourceOverridesType
Указывает переопределения ресурсов для конечных точек, объявленных в ресурсах манифеста служб.
Атрибут
Значение
content
1 элемент, 0 атрибутов
архитектура
globally
name
ResourceOverridesType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ResourceOverridesType">
<xs:annotation>
<xs:documentation>Specifies resource overrides for endpoints declared in service manifest resources.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Endpoints" minOccurs="0">
<xs:annotation>
<xs:documentation>The service endpoint(s) to override.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element 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>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
Сведения об элементе Content
Конечные точки
Конечные точки службы для переопределения.
Атрибут
Значение
name
Конечные точки
minOccurs
0
complexType: ResourcesType
Описывает ресурсы, используемые этой службой, которые могут быть объявлены без изменения скомпилированного кода и изменены при развертывании службы. Доступ к этим ресурсам осуществляется с помощью разделов Principals и Policies манифеста приложения.
Атрибут
Значение
content
1 элемент, 0 атрибутов
архитектура
globally
name
ResourcesType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ResourcesType">
<xs:annotation>
<xs:documentation>Describes the resources used by this service, which can be declared without modifying compiled code and changed when the service is deployed. Access to these resources is controlled through the Principals and Policies sections of the application manifest.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Endpoints" minOccurs="0">
<xs:annotation>
<xs:documentation>Defines endpoints for the service.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Endpoint" type="EndpointType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
Сведения об элементе Content
Конечные точки
Определяет конечные точки службы.
Атрибут
Значение
name
Конечные точки
minOccurs
0
complexType: RunAsPolicyType
Указывает учетную запись локального пользователя или локальной системы, в которой будет выполняться пакет служебного кода. Учетные записи домена поддерживаются в развертываниях Windows Server, где доступен идентификатор Microsoft Entra. По умолчанию приложения выполняются под учетной записью, используемой процессом Fabric.exe. Приложения также могут выполняться с другими учетными записями, которые должны быть объявлены в разделе Principals. Если к службе применяется политика запуска от имени, а манифест службы объявляет в качестве ресурсов конечные точки, использующие протокол HTTP, вам нужно указать SecurityAccessPolicy. Это гарантирует, что к выделенным для этих конечных точек портам будут правильно применены списки управления доступом для той учетной записи, от имени которой выполняется служба. Для конечной точки HTTPS необходимо также определить EndpointBindingPolicy, чтобы указать имя сертификата, который будет возвращен клиенту.
Атрибут
Значение
content
0 элементов, 3 атрибута
архитектура
globally
name
RunAsPolicyType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="RunAsPolicyType">
<xs:annotation>
<xs:documentation>Specifies the local user or local system account that a service code package will run as. Domain accounts are supported on Windows Server deployments where Azure Active Directory is available. By default, applications run under the account that the Fabric.exe process runs under. Applications can also run as other accounts, which must be declared in the Principals section. 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. For an HTTPS endpoint, you also have to define a EndpointBindingPolicy to indicate the name of the certificate to return to the client.</xs:documentation>
</xs:annotation>
<xs:attribute name="CodePackageRef" use="required">
<xs:annotation>
<xs:documentation>The name of the code package. Must match the name of the CodePackage specified in the service manifest.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="UserRef" use="required">
<xs:annotation>
<xs:documentation>The user account that the service code package 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:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="EntryPointType" use="optional" default="Main">
<xs:annotation>
<xs:documentation>Setup is the SetupEntryPoint declared in the service manifest, the privileged entry point that runs before any other entry point. Main is the EntryPoint declared in the service manifest, typically the long-running service host. All is all entry points.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Setup"/>
<xs:enumeration value="Main"/>
<xs:enumeration value="All"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
CodePackageRef
Имя пакета кода. Должно соответствовать имени CodePackage, указанном в манифесте службы.
Атрибут
Значение
name
CodePackageRef
используйте
обязательно
UserRef
Учетная запись пользователя, от имени которого будет выполняться пакет служебного кода. Учетная запись пользователя должна быть объявлена в разделе Principals. Для запуска точки входа установки обычно лучше использовать учетную запись локальной системы, а не учетную запись администратора.
Атрибут
Значение
name
UserRef
используйте
обязательно
EntryPointType
Значение Setup относится к точке входа SetupEntryPoint, объявленной в манифесте службы (привилегированная точка входа, которая запускается перед любой другой точкой входа). Значение Main относится к точке входа EntryPoint, объявленной в манифесте службы. Обычно это является узлом, запускаемым на длительный срок. Все это точки входа.
Атрибут
Значение
name
EntryPointType
используйте
необязательно
default
Главная
complexType: ScalingPolicyType
Описание политики масштабирования, которая состоит из триггера и механизма масштабирования.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
ScalingPolicyType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ScalingPolicyType">
<xs:annotation>
<xs:documentation>A scaling policy description consisting of a trigger and a mechanism for scaling. </xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:group ref="ScalingPolicyTriggerGroup"/>
<xs:group ref="ScalingPolicyMechanismGroup"/>
</xs:sequence>
</xs:complexType>
complexType: SecurityAccessPolicyType
Предоставляет разрешение на доступ к субъекту в ресурсе (например, к конечной точке), определенному в манифесте службы. Как правило, это полезно для контроля и ограничения доступа служб к различным ресурсам, чтобы свести к минимуму угрозы безопасности. Это особенно важно в тех случаях, когда приложение создается на основе коллекции служб из marketplace, которые создали разные разработчики.
Атрибут
Значение
content
0 элементов, 4 атрибута
архитектура
globally
name
SecurityAccessPolicyType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="SecurityAccessPolicyType">
<xs:annotation>
<xs:documentation>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:documentation>
</xs:annotation>
<xs:attribute name="ResourceRef" use="required">
<xs:annotation>
<xs:documentation>The resource being granted access to, declared and configured in the service manifest.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="PrincipalRef" use="required">
<xs:annotation>
<xs:documentation>The user or group being assigned access rights to a resource, must be declared in the Principals section.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="GrantRights" default="Read">
<xs:annotation>
<xs:documentation>The rights to grant: Read, Change, or Full. The default is Read.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Read"/>
<xs:enumeration value="Change"/>
<xs:enumeration value="Full"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="ResourceType" use="optional" default="Endpoint">
<xs:annotation>
<xs:documentation>The type of resource, defined in the Resources section of the service manifest. Either Endpoint or Certificate.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Endpoint"/>
<xs:enumeration value="Certificate"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
ResourceRef
Ресурс, к которому предоставляется доступ, объявлен и настроен в манифесте службы.
Атрибут
Значение
name
ResourceRef
используйте
обязательно
PrincipalRef
Пользователь или группа, которым назначены права доступа к ресурсу, должны быть объявлены в разделе Principals.
Атрибут
Значение
name
PrincipalRef
используйте
обязательно
GrantRights
Предоставляемые права: Read (чтение), Change (изменение) или Full (полные). Значение по умолчанию — на чтение.
Атрибут
Значение
name
GrantRights
default
Читать
ResourceType
Тип ресурса, определенный в разделе ресурсов в манифесте служб. Конечная точка или сертификат.
Описывает субъекты безопасности (пользователи, группы), необходимые для запуска служб и защищенных ресурсов в приложении. На субъекты можно ссылаться в разделах политики.
Атрибут
Значение
content
2 элемента, 0 атрибутов
архитектура
globally
name
SecurityPrincipalsType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="SecurityPrincipalsType">
<xs:annotation>
<xs:documentation>Describes the security principals (users, groups) required for this application to run services and secure resources. Principals are referenced in the policies sections.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element 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>
<xs:element name="Users" minOccurs="0">
<xs:annotation>
<xs:documentation>Declares a set of users as security principals, which can be referenced in policies.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="User" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Declares a user 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:attribute name="PasswordSecret" type="xs:string" use="required"/>
<xs:attribute name="PasswordSecretEncrypted" type="xs:boolean" use="optional" default="false"/>
<xs:attribute name="X509StoreLocation" use="optional" default="LocalMachine">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="LocalMachine"/>
<xs:enumeration value="CurrentUser"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="X509StoreName" default="My">
<xs:simpleType>
<xs:restriction base="xs:string"/>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="X509Thumbprint" type="xs:string"/>
</xs:complexType>
</xs:element>
<xs:element 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>
</xs:sequence>
<xs:attribute name="Name" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>Name of the user account.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="AccountType" use="optional" default="LocalUser">
<xs:annotation>
<xs:documentation>Specifies the type of account: LocalUser, DomainUser, NetworkService, LocalService, ManagedServiceAccount, or LocalSystem. The default is LocalUser. Local user accounts are created on the machines where the application is deployed. By default, these accounts do not have the same names as those specified here. Instead, they are dynamically generated and have random passwords. Supported local system account types are LocalUser, NetworkService, LocalService and LocalSystem. Domain accounts are supported on Windows Server deployments where Azure Active Directory is available.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="LocalUser"/>
<xs:enumeration value="DomainUser"/>
<xs:enumeration value="NetworkService"/>
<xs:enumeration value="LocalService"/>
<xs:enumeration value="ManagedServiceAccount"/>
<xs:enumeration value="LocalSystem"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="LoadUserProfile" type="xs:boolean" use="optional" default="false"/>
<xs:attribute name="PerformInteractiveLogon" type="xs:boolean" use="optional" default="false"/>
<xs:attributeGroup ref="AccountCredentialsGroup"/>
<xs:attribute name="PasswordEncrypted" type="xs:boolean" use="optional">
<xs:annotation>
<xs:documentation>True if the password is encrypted; false if in plain text.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
Сведения об элементе Content
Группы
Объявляет набор групп в качестве субъектов безопасности, на которые можно ссылаться в политиках. Элемент Groups может быть полезен, если для разных точек входа службы есть несколько пользователей и у них должны быть определены общие права, доступные на уровне группы.
Атрибут
Значение
name
Группы
minOccurs
0
Пользователи
Объявляет набор пользователей в качестве субъектов безопасности, на которых можно ссылаться в политиках.
Описывает параметры диагностики для компонентов этого манифеста службы.
Атрибут
Значение
content
1 элемент, 0 атрибутов
архитектура
globally
name
ServiceDiagnosticsType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceDiagnosticsType">
<xs:annotation>
<xs:documentation>Describes the diagnostic settings for the components of this service manifest.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element 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>
</xs:sequence>
</xs:complexType>
Сведения об элементе Content
Трассировка событий Windows
Описывает параметры трассировки событий Windows для компонентов этого манифеста службы.
Атрибут
Значение
name
Трассировка событий Windows
minOccurs
0
ServiceFabricRuntimeAccessPolicyType complexType
Атрибут
Значение
content
0 элементов, 2 атрибута
архитектура
globally
name
ServiceFabricRuntimeAccessPolicyType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceFabricRuntimeAccessPolicyType">
<xs:attribute name="RemoveServiceFabricRuntimeAccess" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>Indicates if Fabric Runtime specific information should be exposed to the Code packages in the Service package.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UseServiceFabricReplicatedStore" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>Indicates if Service Fabric replicated blockstore should be used to provide volume for containers in service package.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
RemoveServiceFabricRuntimeAccess
Указывает, должны ли сведения, связанные со средой выполнения Service Fabric, предоставляться пакетам кода в пакете службы.
Атрибут
Значение
name
RemoveServiceFabricRuntimeAccess
type
xs:boolean
default
false
UseServiceFabricReplicatedStore
Указывает, следует ли использовать реплицируемое хранилище блоков Service Fabric для предоставления тома для контейнеров в пакете службы.
Атрибут
Значение
name
UseServiceFabricReplicatedStore
type
xs:boolean
default
false
complexType: ServiceGroupMemberType
Атрибут
Значение
content
1 элемент, 2 атрибута
архитектура
globally
name
ServiceGroupMemberType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceGroupMemberType">
<xs:sequence>
<xs:element name="LoadMetrics" minOccurs="0">
<xs:annotation>
<xs:documentation>Load metrics reported by this service.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="LoadMetric" type="LoadMetricType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="ServiceTypeName" use="required">
<xs:annotation>
<xs:documentation>Type of the service group member.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Name" use="required">
<xs:annotation>
<xs:documentation>Name of the service group member relative to the name of the service group.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
ServiceTypeName
Тип члена группы служб.
Атрибут
Значение
name
ServiceTypeName
используйте
обязательно
Имя.
Имя члена группы служб, заданное относительно имени группы служб.
Атрибут
Значение
name
Имя.
используйте
обязательно
Сведения об элементе Content
LoadMetrics
Загружает метрики, сообщаемые этой службой.
Атрибут
Значение
name
LoadMetrics
minOccurs
0
complexType: ServiceGroupTypeType
Базовый тип, описывающий ServiceGroupType с отслеживанием или без отслеживания состояния.
Атрибут
Значение
content
4 элемента, 2 атрибута
архитектура
globally
name
ServiceGroupTypeType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceGroupTypeType">
<xs:annotation>
<xs:documentation>Base type that describes a stateful or a stateless ServiceGroupType.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="LoadMetrics" minOccurs="0">
<xs:annotation>
<xs:documentation>Load metrics reported by this service.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="LoadMetric" type="LoadMetricType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="PlacementConstraints" type="xs:string" minOccurs="0">
<xs:annotation>
<xs:documentation>Constraints for the placement of services that are part of this package.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="ServiceGroupMembers" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Member types of this service group type.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element ref="ServiceGroupTypeMember" minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element ref="Extensions" minOccurs="0"/>
</xs:sequence>
<xs:attribute name="ServiceGroupTypeName" use="required">
<xs:annotation>
<xs:documentation>User-defined type identifier for a service group, For example, "ActorQueueSGType". This value is used in the ApplicationManifest.xml file to identify the service group.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="UseImplicitFactory" type="xs:boolean" use="optional">
<xs:annotation>
<xs:documentation>Specifies whether the service group instance is created by the implicit factory. If false (default), one of the code packages must register the service group factory</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
ServiceGroupTypeName
Определяемый пользователем идентификатор типа для группы служб. Например, ActorQueueSGType. Это значение используется в файле ApplicationManifest.xml для идентификации группы служб.
Атрибут
Значение
name
ServiceGroupTypeName
используйте
обязательно
UseImplicitFactory
Указывает, создается ли экземпляр группы служб с помощью неявной фабрики. Если это значение False (по умолчанию), один из пакетов кода должен зарегистрировать фабрику групп служб
Атрибут
Значение
name
UseImplicitFactory
type
xs:boolean
используйте
необязательно
Сведения об элементе Content
LoadMetrics
Загружает метрики, сообщаемые этой службой.
Атрибут
Значение
name
LoadMetrics
minOccurs
0
PlacementConstraints
Ограничения на размещение служб, которые являются частью этого пакета.
Атрибут
Значение
name
PlacementConstraints
type
xs:string
minOccurs
0
ServiceGroupMembers
Типы элементов группы служб этого типа.
Атрибут
Значение
name
ServiceGroupMembers
minOccurs
0
maxOccurs
1
нет
Атрибут
Значение
ref
Расширения
minOccurs
0
complexType: ServiceManifestImportPoliciesType
Описывает политики (привязка конечной точки, совместный доступ к пакетам, запуск от имени и безопасный доступ) для применения импортированного манифеста службы.
Атрибут
Значение
content
11 элементов, 0 атрибутов
архитектура
globally
name
ServiceManifestImportPoliciesType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceManifestImportPoliciesType">
<xs:annotation>
<xs:documentation>Describes policies (end-point binding, package sharing, run-as, and security access) to be applied on the imported service manifest.</xs:documentation>
</xs:annotation>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="RunAsPolicy" type="RunAsPolicyType" minOccurs="0"/>
<xs:element name="SecurityAccessPolicy" type="SecurityAccessPolicyType" minOccurs="0"/>
<xs:element name="PackageSharingPolicy" type="PackageSharingPolicyType" minOccurs="0"/>
<xs:element 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>
<xs:element 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>
<xs:element name="ServicePackageResourceGovernancePolicy" type="ServicePackageResourceGovernancePolicyType" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Defines the resource governance policy that is applied at the level of the entire service package.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="ResourceGovernancePolicy" type="ResourceGovernancePolicyType" minOccurs="0">
<xs:annotation>
<xs:documentation>Specifies resource limits for a codepackage.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="ServicePackageContainerPolicy" type="ServicePackageContainerPolicyType" minOccurs="0" maxOccurs="1"/>
<xs:element name="ContainerHostPolicies" type="ContainerHostPoliciesType" minOccurs="0">
<xs:annotation>
<xs:documentation>Specifies policies for activating container hosts.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="ConfigPackagePolicies" type="ConfigPackagePoliciesType" minOccurs="0">
<xs:annotation>
<xs:documentation>Config Packages to be mounted inside the container.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="NetworkPolicies" type="NetworkPoliciesType" minOccurs="0" maxOccurs="1">
<xs:annotation>
<xs:documentation>Specifies network policies including container network policies.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:choice>
</xs:complexType>
Импортирует манифест службы по ссылке. В настоящее время файл манифеста службы (ServiceManifest.xml) должен присутствовать в пакете сборки.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
ServiceManifestRefType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceManifestRefType">
<xs:annotation>
<xs:documentation>Imports the service manifest by reference. Currently the service manifest file (ServiceManifest.xml) must be present in the build package.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="ServiceManifestIdentifier"/>
</xs:complexType>
complexType: ServiceManifestType
Декларативно описывает тип службы и его версию. В нем указан независимо обновляемый код, конфигурация и пакеты данных, из которых состоит пакет службы, для поддержки одного или нескольких типов служб. Указаны также ресурсы, параметры диагностики и метаданные службы, такие как тип службы, свойства работоспособности, а также метрики балансировки нагрузки.
Атрибут
Значение
content
7 элементов, 1 атрибут
архитектура
globally
name
ServiceManifestType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceManifestType">
<xs:annotation>
<xs:documentation>Declaratively describes the service type and version. It lists the independently upgradeable code, configuration, and data packages that together compose a service package to support one or more service types. Resources, diagnostics settings, and service metadata, such as service type, health properties, and load-balancing metrics, are also specified.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Description" type="xs:string" minOccurs="0">
<xs:annotation>
<xs:documentation>Text describing this service.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="ServiceTypes" type="ServiceAndServiceGroupTypesType">
<xs:annotation>
<xs:documentation>Defines what service types are supported by a CodePackage in this manifest. 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. Service types are declared at the manifest level and not the code package level.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="CodePackage" type="CodePackageType" maxOccurs="unbounded"/>
<xs:element name="ConfigPackage" type="ConfigPackageType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="DataPackage" type="DataPackageType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="Resources" type="ResourcesType" minOccurs="0"/>
<xs:element name="Diagnostics" type="ServiceDiagnosticsType" minOccurs="0"/>
</xs:sequence>
<xs:attribute name="ManifestId" use="optional" default="" type="xs:string">
<xs:annotation>
<xs:documentation>The identifier of this service manifest, an unstructured string.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="VersionedName"/>
<xs:anyAttribute processContents="skip"/> <!-- Allow unknown attributes to be used. -->
</xs:complexType>
Сведения об атрибутах
ManifestId
Идентификатор этого манифеста службы (неструктурированная строка).
Атрибут
Значение
name
ManifestId
используйте
необязательно
default
type
xs:string
Сведения об элементе Content
Description
Текст, описывающий эту службу.
Атрибут
Значение
name
Описание
type
xs:string
minOccurs
0
ServiceTypes
Указывает, какие типы служб поддерживаются пакетами CodePackage в этом манифесте. При создании экземпляра службы в соответствии с одним из этих типов службы все пакеты кода, объявленные в этом манифесте, активируются путем запуска соответствующих точек входа. Типы служб декларируются на уровне манифеста, а не на уровне пакета кода.
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServicePackageResourceGovernancePolicyType">
<xs:attribute name="CpuCores" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>CPU limit in number of logical cores. Must be a positive integer.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MemoryInMB" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>Memory limits in MB. Must be a positive integer.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
CpuCores
Предел ЦП в количестве логических ядер. Принимаются только положительные целые числа.
Атрибут
Значение
name
CpuCores
type
xs:string
используйте
необязательно
default
0
MemoryInMB
Ограничения памяти (в МБ). Принимаются только положительные целые числа.
Атрибут
Значение
name
MemoryInMB
type
xs:string
используйте
необязательно
default
0
complexType: ServicePackageType
ServicePackage представляет единицу с управлением версиями для развертывания и активации. Версия ServicePackage определяется на основе версии манифеста и версии переопределений.
Базовый тип, который определяет службу Microsoft Azure Service Fabric.
Атрибут
Значение
content
5 элементов, 2 атрибута
архитектура
globally
name
ServiceType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceType">
<xs:annotation>
<xs:documentation>Base type that defines a Microsoft Azure Service Fabric service.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:group ref="PartitionDescriptionGroup"/>
<xs:element name="LoadMetrics" minOccurs="0">
<xs:annotation>
<xs:documentation>Load metrics reported by this service, used for resource balancing services.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="LoadMetric" type="LoadMetricType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element 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>
<xs:element 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>
<xs:element name="ServicePlacementPolicies" minOccurs="0">
<xs:annotation>
<xs:documentation>Declares placement policies for a service. Useful when the cluster spans geographic distances or and/or geopolitical regions.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="ServicePlacementPolicy" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Defines a service placement policy, which specifies that the service should or should not run in certain cluster fault domains. Useful when the cluster spans geographic distances or and/or geopolitical regions.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="DomainName">
<xs:annotation>
<xs:documentation>The fault domain where the service should or should not be placed, depending on the Type value.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Type" use="required">
<xs:annotation>
<xs:documentation>InvalidDomain allows you to specify that a particular Fault Domain is invalid for this workload. RequiredDomain requires that all of the replicas be present in the specified domain. Multiple required domains can be specified. PreferredPrimaryDomain specifies the preferred Fault Domain for primary replicas. Useful in geographically spanned clusters where you are using other locations for redundancy, but would prefer that the primary replicas be placed in a certain location in order to provider lower latency for operations which go to the primary. RequiredDomainDistribution specifies that replicas are required to be distributed among the available fault domains. NonPartiallyPlace controls if the service replicas will be partially place if not all of them can be placed.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="InvalidDomain"/>
<xs:enumeration value="RequiredDomain"/>
<xs:enumeration value="PreferredPrimaryDomain"/>
<xs:enumeration value="RequiredDomainDistribution"/>
<xs:enumeration value="NonPartiallyPlace"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="ServiceScalingPolicies" minOccurs="0">
<xs:annotation>
<xs:documentation>Declares scaling policies for a service. Useful for dynamically scaling the service based on needs. </xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="ScalingPolicy" type="ScalingPolicyType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="TagsRequiredToPlace" minOccurs="0">
<xs:annotation>
<xs:documentation>Declares tags required for placement of a service. </xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="TagRequiredToPlace" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="TagsRequiredToRun" minOccurs="0">
<xs:annotation>
<xs:documentation>Declares tags required for placement and running of a service. <xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="TagRequiredToRun" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="ServiceTypeName" use="required">
<xs:annotation>
<xs:documentation>Name of the service type, declared in the service manifest, that will be instantiated.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="DefaultMoveCost">
<xs:annotation>
<xs:documentation>Specifies default move cost for this service.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Zero"/>
<xs:enumeration value="Low"/>
<xs:enumeration value="Medium"/>
<xs:enumeration value="High"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
ServiceTypeName
Имя типа службы, объявленное в манифесте службы, экземпляр которого будет создан.
Атрибут
Значение
name
ServiceTypeName
используйте
обязательно
DefaultMoveCost
Указывает стоимость перемещения по умолчанию для этой службы.
Атрибут
Значение
name
DefaultMoveCost
Сведения об элементе Content
LoadMetrics
Загружает сообщаемые этой службой метрики, используемые для служб балансировки ресурсов.
Атрибут
Значение
name
LoadMetrics
minOccurs
0
PlacementConstraints
Используется, чтобы контролировать, на каких узлах кластера может выполняться служба. Пара "ключ — значение", которая описывает имя свойства узла и требования службы для значения. Из отдельных инструкций можно сформировать необходимое ограничение, сгруппировав их с помощью простой булевой логики. Например, "(FirmwareVersion>12 && InDMZ == True)".
Атрибут
Значение
name
PlacementConstraints
type
xs:string
minOccurs
0
ServiceCorrelations
Определяет отношения сходства между службами.
Атрибут
Значение
name
ServiceCorrelations
minOccurs
0
ServicePlacementPolicies
Объявляет политики размещения службы. Это полезно, если кластер охватывает значительные географические расстояния или геополитические регионы.
Атрибут
Значение
name
ServicePlacementPolicies
minOccurs
0
ServiceScalingPolicies
Объявляет политики масштабирования службы. Это удобно для динамического масштабирования службы на основе потребностей.
Атрибут
Значение
name
ServiceScalingPolicies
minOccurs
0
TagsRequiredToPlace
Объявляет теги, необходимые для размещения службы. Это удобно для динамического влияния на размещение службы.
Атрибут
Значение
name
TagsRequiredToPlace
minOccurs
0
TagRequiredToRun
Объявляет теги, необходимые для размещения и работы службы. Это удобно для динамического влияния на размещение и работу службы.
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceTypeHealthPolicyType">
<xs:attribute name="MaxPercentUnhealthyServices" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>Specifies the maximum tolerated percentage of unhealthy services before the application is considered unhealthy. Default percentage: 0.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MaxPercentUnhealthyPartitionsPerService" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>Specifies the maximum tolerated percentage of unhealthy partitions before a service is considered unhealthy. Default percentage: 0.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MaxPercentUnhealthyReplicasPerPartition" type="xs:string" use="optional" default="0">
<xs:annotation>
<xs:documentation>Specifies the maximum tolerated percentage of unhealthy replicas before a partition is considered unhealthy. Default percentage: 0.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
MaxPercentUnhealthyServices
Указывает максимально допустимый процент неработоспособных служб, превышение которого приведет к оценке приложения как неработоспособного. Значение в процентах по умолчанию: 0.
Атрибут
Значение
name
MaxPercentUnhealthyServices
type
xs:string
используйте
необязательно
default
0
MaxPercentUnhealthyPartitionsPerService
Указывает максимально допустимый процент неработоспособных разделов, превышение которого приведет к оценке службы как неработоспособной. Значение в процентах по умолчанию: 0.
Атрибут
Значение
name
MaxPercentUnhealthyPartitionsPerService
type
xs:string
используйте
необязательно
default
0
MaxPercentUnhealthyReplicasPerPartition
Указывает максимально допустимый процент неработоспособных реплик, превышение которого приведет к оценке раздела как неработоспособного. Значение в процентах по умолчанию: 0.
Атрибут
Значение
name
MaxPercentUnhealthyReplicasPerPartition
type
xs:string
используйте
необязательно
default
0
complexType: ServiceTypeType
Базовый тип, описывающий ServiceType с отслеживанием или без отслеживания состояния.
Атрибут
Значение
content
4 элемента, 1 атрибут
архитектура
globally
name
ServiceTypeType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceTypeType">
<xs:annotation>
<xs:documentation>Base type that describes a stateful or a stateless ServiceType.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="LoadMetrics" minOccurs="0">
<xs:annotation>
<xs:documentation>Load metrics reported by this service.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="LoadMetric" type="LoadMetricType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element 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>
<xs:element name="ServicePlacementPolicies" minOccurs="0">
<xs:annotation>
<xs:documentation>Declares placement policies for a service. Useful when the cluster spans geographic distances or and/or geopolitical regions.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="ServicePlacementPolicy" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>Defines a service placement policy, which specifies that the service should or should not run in certain cluster fault domains. Useful when the cluster spans geographic distances or and/or geopolitical regions.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:attribute name="DomainName">
<xs:annotation>
<xs:documentation>The fault domain where the service should or should not be placed, depending on the Type value.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Type" use="required">
<xs:annotation>
<xs:documentation>InvalidDomain allows you to specify that a particular Fault Domain is invalid for this workload. RequiredDomain requires that all of the replicas be present in the specified domain. Multiple required domains can be specified. PreferredPrimaryDomain specifies the preferred Fault Domain for primary replicas. Useful in geographically spanned clusters where you are using other locations for redundancy, but would prefer that the primary replicas be placed in a certain location in order to provider lower latency for operations which go to the primary. RequiredDomainDistribution specifies that replicas are required to be distributed among the available fault domains. NonPartiallyPlace controls if the service replicas will be partially place if not all of them can be placed. </xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="InvalidDomain"/>
<xs:enumeration value="RequiredDomain"/>
<xs:enumeration value="PreferredPrimaryDomain"/>
<xs:enumeration value="RequiredDomainDistribution"/>
<xs:enumeration value="NonPartiallyPlace"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element ref="Extensions" minOccurs="0"/>
</xs:sequence>
<xs:attribute name="ServiceTypeName" use="required">
<xs:annotation>
<xs:documentation>User-defined type identifier for a service. For example, "QueueType" or "CalculatorType". This value is used in the ApplicationManifest.xml file to identify the service.</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
ServiceTypeName
Определяемый пользователем идентификатор типа для службы. Например, QueueType или CalculatorType. Это значение используется в файле ApplicationManifest.xml для идентификации службы.
Атрибут
Значение
name
ServiceTypeName
используйте
обязательно
Сведения об элементе Content
LoadMetrics
Загружает метрики, сообщаемые этой службой.
Атрибут
Значение
name
LoadMetrics
minOccurs
0
PlacementConstraints
Используется, чтобы контролировать, на каких узлах кластера может выполняться служба. Пара "ключ — значение", которая описывает имя свойства узла и требования службы для значения. Из отдельных инструкций можно сформировать необходимое ограничение, сгруппировав их с помощью простой булевой логики. Например, "(FirmwareVersion>12 && InDMZ == True)".
Атрибут
Значение
name
PlacementConstraints
type
xs:string
minOccurs
0
ServicePlacementPolicies
Объявляет политики размещения службы. Это полезно, если кластер охватывает значительные географические расстояния или геополитические регионы.
Объявляет параметры конфигурации для переопределения в манифесте службы. Он состоит из одного или нескольких разделов пар "ключ — значение". Значения параметров могут быть зашифрованы с помощью командлета Invoke-ServiceFabricEncryptSecret.
Атрибут
Значение
content
1 элемент, 0 атрибутов
архитектура
globally
name
SettingsOverridesType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="SettingsOverridesType">
<xs:annotation>
<xs:documentation>Declares configuration settings in a service manifest to be overridden. It consists of one or more sections of key-value pairs. Parameter values can be encrypted using the Invoke-ServiceFabricEncryptSecret cmdlet.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element 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>
</xs:sequence>
</xs:complexType>
Сведения об элементе Content
Section
Раздел для переопределения в файле Settings.xml.
Атрибут
Значение
name
Section
maxOccurs
unbounded
complexType: SettingsType
Описывает определяемые пользователем параметры для атрибутов ServiceComponent или Application. Он состоит из одного или нескольких разделов пар "ключ — значение".
Атрибут
Значение
content
1 элемент, 0 атрибутов
архитектура
globally
name
SettingsType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="SettingsType">
<xs:annotation>
<xs:documentation>Describes user-defined settings for a ServiceComponent or an Application. It consists of one or more sections of key-value pairs.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Section" minOccurs="0" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>A user-defined named section.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element 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>
</xs:sequence>
<xs:attribute name="Name" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
Сведения об элементе Content
Section
Определяемый пользователем именованный раздел.
Атрибут
Значение
name
Section
minOccurs
0
maxOccurs
unbounded
complexType: StatefulServiceGroupType
Определяет группу служб с отслеживанием состояния.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
StatefulServiceGroupType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatefulServiceGroupType">
<xs:annotation>
<xs:documentation>Defines a stateful service group.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="StatefulServiceType">
<xs:sequence>
<xs:element name="Members" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Member services of this service group</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Member" type="ServiceGroupMemberType" minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType: StatefulServiceGroupTypeType
Описывает тип группы служб с отслеживанием состояния.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
StatefulServiceGroupTypeType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatefulServiceGroupTypeType">
<xs:annotation>
<xs:documentation>Describes a stateful service group type.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="ServiceGroupTypeType">
<xs:attribute name="HasPersistedState" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>True if the service group has state that needs to be persisted.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType: StatefulServiceType
Определяет службу с отслеживанием состояния.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
StatefulServiceType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatefulServiceType">
<xs:annotation>
<xs:documentation>Defines a stateful service.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="ServiceType">
<xs:attribute name="TargetReplicaSetSize" type="xs:string" default="1">
<xs:annotation>
<xs:documentation>Desired replica set size for the partitions of this stateful service. Must be a positive integer. This is a target size; a replica set is still functional with less members. The quorum is a majority based quorum.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MinReplicaSetSize" type="xs:string" default="1">
<xs:annotation>
<xs:documentation>Minimum number of replicas required in the replica set to allow writes. Must be positive integer less than TargetReplicaSetSize. </xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ReplicaRestartWaitDurationSeconds" type="xs:string" use="optional" default="">
<xs:annotation>
<xs:documentation>The duration between when a replica goes down and when a new replica is created. When a persistent replica goes down, this timer starts. When it expires Service Fabric will create a new replica on any node in the cluster.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="QuorumLossWaitDurationSeconds" type="xs:string" use="optional" default="">
<xs:annotation>
<xs:documentation>The maximum duration for which a partition is allowed to be in a state of quorum loss. If the partition is still in quorum loss after this duration, the partition is recovered from quorum loss by considering the down replicas as lost. Note that this can potentially incur data loss.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="StandByReplicaKeepDurationSeconds" type="xs:string" use="optional" default="">
<xs:annotation>
<xs:documentation>How long StandBy replicas should be maintained before being removed. Sometimes a replica will be down for longer than the ReplicaRestartWaitDuration. In these cases a new replica will be built to replace it. Sometimes however the loss is not permanent and the persistent replica is eventually recovered. This now constitutes a StandBy replica.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType: StatefulServiceTypeType
Описывает тип службы с отслеживанием состояния.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
StatefulServiceTypeType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatefulServiceTypeType">
<xs:annotation>
<xs:documentation>Describes a stateful service type.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="ServiceTypeType">
<xs:attribute name="HasPersistedState" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>True if the service has state that needs to be persisted on the local disk.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UseImplicitHost" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>Specifies if the service type should be implemented implicitly as a guest executable. Guest executables are used for hosting any type of applications (such as Node.js or Java) or legacy applications that do not implement the Service Fabric service interfaces.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType: StatelessServiceGroupType
Определяет группу служб без отслеживания состояния.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
StatelessServiceGroupType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatelessServiceGroupType">
<xs:annotation>
<xs:documentation>Defines a stateless service group.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="StatelessServiceType">
<xs:sequence>
<xs:element name="Members" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Member services of this service group</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Member" type="ServiceGroupMemberType" minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType: StatelessServiceGroupTypeType
Определяет тип группы служб без отслеживания состояния.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
StatelessServiceGroupTypeType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatelessServiceGroupTypeType">
<xs:annotation>
<xs:documentation>Describes a stateless service group type.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="ServiceGroupTypeType"/>
</xs:complexContent>
</xs:complexType>
complexType: StatelessServiceType
Определяет службу без отслеживания состояния.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
StatelessServiceType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatelessServiceType">
<xs:annotation>
<xs:documentation>Defines a stateless service.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="ServiceType">
<xs:attribute name="InstanceCount" type="xs:string" default="1">
<xs:annotation>
<xs:documentation>Number of instances required for this stateless service (positive integer).</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType: StatelessServiceTypeType
Описывает тип службы без отслеживания состояния.
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
StatelessServiceTypeType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatelessServiceTypeType">
<xs:annotation>
<xs:documentation>Describes a stateless service type.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="ServiceTypeType">
<xs:attribute name="UseImplicitHost" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>Specifies if the service type should be implemented implicitly as a guest executable. Guest executables are used for hosting any type of applications (such as Node.js or Java) or legacy applications that do not implement the Service Fabric service interfaces.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:complexContent>
</xs:complexType>
Не поддерживается, не следует использовать. Имя размещаемой неуправляемой сборки (например, Queue.dll).
Атрибут
Значение
content
0 элементов, 0 атрибутов
архитектура
globally
name
UnmanagedDllType
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="UnmanagedDllType">
<xs:annotation>
<xs:documentation>Unsupported, do not use. The name of unmanaged assembly (for example, Queue.dll), to host.</xs:documentation>
</xs:annotation>
<xs:simpleContent>
<xs:extension base="xs:string"/>
</xs:simpleContent>
</xs:complexType>
complexType: WindowsFabricDeploymentInformation
Атрибут
Значение
content
0 элементов, 11 атрибутов
архитектура
globally
name
WindowsFabricDeploymentInformation
XML-источник
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="WindowsFabricDeploymentInformation">
<xs:attribute name="InstanceId" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>This is the target instance of the node.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MSILocation" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>This is the full path to the MSI location.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ClusterManifestLocation" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>This is the full path to the Cluster Manifest Location.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="InfrastructureManifestLocation" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>This location of the infrastructure manifest that is internally generated.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="TargetVersion" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>This is the Target Version of the deployment.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="NodeName" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>This is the name of the Node to which the Fabric Upgrade is to happen</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="RemoveNodeState" type="xs:boolean" use="optional" default="false">
<xs:annotation>
<xs:documentation>A flag indicating if RemoveNodeState Api should be called after removing node configuration.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UpgradeEntryPointExe" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>Name of the exe used by the installer service to upgrade </xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UpgradeEntryPointExeParameters" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>Parameters to the Setup Entry point exe</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UndoUpgradeEntryPointExe" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>Name of the exe used by the installer service to undo the upgrade</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UndoUpgradeEntryPointExeParameters" type="xs:string" use="optional">
<xs:annotation>
<xs:documentation>Parameters to the Setup Entry point exe</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
Сведения об атрибутах
InstanceId
Это целевой экземпляр узла.
Атрибут
Значение
name
InstanceId
type
xs:string
используйте
необязательно
MSILocation
Это полный путь к расположению MSI.
Атрибут
Значение
name
MSILocation
type
xs:string
используйте
необязательно
ClusterManifestLocation
Это полный путь к расположению манифеста кластера.
Атрибут
Значение
name
ClusterManifestLocation
type
xs:string
используйте
необязательно
InfrastructureManifestLocation
Это расположение манифеста инфраструктуры, который создается в системе.
Атрибут
Значение
name
InfrastructureManifestLocation
type
xs:string
используйте
необязательно
TargetVersion
Это целевая версия развертывания.
Атрибут
Значение
name
TargetVersion
type
xs:string
используйте
необязательно
NodeName
Это имя узла, к которому будет применено обновление Fabric
Атрибут
Значение
name
NodeName
type
xs:string
используйте
необязательно
RemoveNodeState
Флаг, указывающий, следует ли вызывать API RemoveNodeState после удаления конфигурации узла.
Атрибут
Значение
name
RemoveNodeState
type
xs:boolean
используйте
необязательно
default
false
UpgradeEntryPointExe
Имя EXE-файла, который используется службой установщика для обновления
Атрибут
Значение
name
UpgradeEntryPointExe
type
xs:string
используйте
необязательно
UpgradeEntryPointExeParameters
Параметры для EXE-файла точки входа установки
Атрибут
Значение
name
UpgradeEntryPointExeParameters
type
xs:string
используйте
необязательно
UndoUpgradeEntryPointExe
Имя EXE-файла, который используется службой установщика, чтобы отменить обновление