Tipos complejos del esquema XML del modelo de servicio
Artículo
AppInstanceDefinitionType complexType
Atributo
Value
content
1 elemento, 1 atributo
definido
globalmente
name
AppInstanceDefinitionType
Origen XML
<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>
Detalles de atributos
Nombre
Nombre de la aplicación que se va a crear.
Atributo
Value
name
Nombre
type
xs:string
use
requerido
Detalles del elemento de contenido
Parámetros
Lista de parámetros de la aplicación tal y como se define en el manifiesto de aplicación y sus valores respectivos.
Atributo
Value
name
Parámetros
ApplicationHealthPolicyType complexType
Describe la directiva para evaluar los eventos de estado notificados en diversas entidades relacionadas con la aplicación. Si no se especifica ninguna directiva, se supone que el estado de una entidad no es correcto si el informe de mantenimiento es advertencia o error.
Atributo
Value
content
2 elementos, 2 atributos
definido
globalmente
name
ApplicationHealthPolicyType
Origen 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>
Detalles de atributos
ConsiderWarningAsError
Especifica si los informes de mantenimiento de advertencia se tratan como errores durante la evaluación del mantenimiento. Valor predeterminado: false.
Atributo
Value
name
ConsiderWarningAsError
type
xs:string
use
opcional
default
false
MaxPercentUnhealthyDeployedApplications
Especifica el porcentaje máximo tolerado de aplicaciones implementadas que pueden ser incorrectas antes de que la aplicación se considere errónea. Dicho porcentaje se calcula dividiendo el número de aplicaciones implementadas incorrectas entre el número de nodos en los que las aplicaciones están implementadas actualmente en el clúster. El cálculo se redondea hacia arriba para tolerar un error en números reducidos de nodos. Porcentaje predeterminado: 0.
Atributo
Value
name
MaxPercentUnhealthyDeployedApplications
type
xs:string
use
opcional
default
0
Detalles del elemento de contenido
DefaultServiceTypeHealthPolicy
Especifica la directiva de mantenimiento predeterminada del tipo de servicio, que reemplaza a la directiva de mantenimiento predeterminada de todos los tipos de servicio de la aplicación.
Describe mediante declaración el tipo de aplicación y la versión. Para crear un tipo de aplicación, se hace referencia a uno o varios manifiestos de servicio de los servicios constituyentes. Los valores de configuración de los servicios constituyentes pueden invalidarse mediante la configuración de aplicación parametrizada. También se pueden declarar servicios predeterminados, plantillas de servicio, entidades de seguridad, directivas, configuraciones de diagnóstico y certificados en el nivel de aplicación.
Atributo
Value
content
9 elementos, 0 atributos
definido
globalmente
name
ApplicationManifestType
Origen 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>
Detalles del elemento de contenido
Descripción
Texto que describe esta aplicación.
Atributo
Value
name
Description
type
xs:string
minOccurs
0
Parámetros
Declara los parámetros que se usan en este manifiesto de aplicación. El valor de estos parámetros puede proporcionarse cuando se crea una instancia de la aplicación y se puede usar para invalidar los valores de configuración del servicio o de la aplicación.
Atributo
Value
name
Parámetros
minOccurs
0
ServiceManifestImport
Importa un manifiesto de servicio creado por el desarrollador del servicio. Para cada servicio constituyente de la aplicación se debe importar un manifiesto de servicio. Se invalida la configuración y se pueden declarar directivas para el manifiesto de servicio.
Atributo
Value
name
ServiceManifestImport
maxOccurs
sin enlazar
ServiceTemplates
Declara el conjunto de tipos de servicios permitidos que se pueden crear dinámicamente dentro de la instancia de aplicación. Los valores de configuración predeterminados, como el factor de replicación, se especifican y usan como plantilla para la creación de instancias de servicio.
Describe las directivas (recopilación de registros, ejecución predeterminada, mantenimiento y acceso de seguridad) que se van a aplicar en el nivel de aplicación.
Atributo
Value
content
4 elementos, 0 atributos
definido
globalmente
name
ApplicationPoliciesType
Origen 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>
Detalles del elemento de contenido
LogCollectionPolicies
Especifica si está habilitada la recopilación de registros. Solo funciona en un entorno de clúster de Azure.
Atributo
Value
name
LogCollectionPolicies
minOccurs
0
DefaultRunAsPolicy
Especifique una cuenta de usuario predeterminada para todos los paquetes de código de servicio que no tengan ningún elemento RunAsPolicy específico definido en la sección ServiceManifestImport.
Lista de directivas de seguridad aplicadas a recursos en el nivel de aplicación.
Atributo
Value
name
SecurityAccessPolicies
minOccurs
0
AzureBlobETWType complexType
Describe un destino de almacén de blobs de Azure para los eventos de ETW. Solo funciona en el entorno de Azure.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
AzureBlobETWType
Origen 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>
AzureBlobType complexType
Describe un destino de almacén de blobs de Azure para datos de diagnóstico. Solo funciona en el entorno de clúster de Azure.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
AzureBlobType
Origen 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>
Detalles del elemento de contenido
ClusterCertificate
El certificado usado para proteger la comunicación dentro del clúster.
Describe un paquete de código que admite un tipo de servicio definido. Cuando se crea una instancia de un servicio en uno de estos tipos de servicio, todos los paquetes de código declarados en este manifiesto se activan mediante la ejecución de sus puntos de entrada. Se espera que los procesos resultantes registren los tipos de servicio admitidos en tiempo de ejecución. Cuando hay varios paquetes de código, se activan todos cada vez que el sistema busca cualquiera de los tipos de servicios declarados.
Atributo
Value
content
3 elementos, 2 atributos
definido
globalmente
name
CodePackageType
Origen 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>
Detalles de atributos
IsShared
Indica si otros paquetes de código comparten el contenido de este paquete de código. En caso de que sea true, en una actualización de este paquete de código, se reiniciarán todos los paquetes de código. Actualmente, este atributo no se admite y su valor se ignorará.
Atributo
Value
name
IsShared
type
xs:boolean
default
false
IsActivator
Este atributo es solo para uso interno.
Atributo
Value
name
IsActivator
type
xs:boolean
default
false
Detalles del elemento de contenido
SetupEntryPoint
Es un punto de entrada con privilegios que se ejecuta de forma predeterminada con las mismas credenciales que Service Fabric (normalmente, la cuenta NETWORKSERVICE) antes que cualquier otro punto de entrada. El archivo ejecutable especificado por EntryPoint suele ser el host de servicios de ejecución prolongada. La presencia de un punto de entrada de configuración independiente evita tener que ejecutar el host de servicio con privilegios elevados durante largos períodos de tiempo.
Describe las invalidaciones de configuración de un paquete de configuración determinado en el manifiesto de servicio importado.
Atributo
Value
content
1 elemento, 1 atributo
definido
globalmente
name
ConfigOverrideType
Origen 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>
Detalles de atributos
Nombre
Nombre del paquete de configuración del manifiesto de servicio que contiene la configuración que se va a invalidar.
Declara una carpeta, designada por el atributo Name, que contiene un archivo Settings.xml. Este archivo contiene secciones de configuración del par clave-valor definida por el usuario que el proceso puede volver a leer en tiempo de ejecución. Durante una actualización, si solo ha cambiado la versión de ConfigPackage, no se reiniciará el proceso en ejecución. En su lugar, una devolución de llamada notifica el proceso que los ajustes de configuración han cambiado, por lo que pueden volver a cargarse de forma dinámica.
Atributo
Value
content
0 elementos, 4 atributos
definido
globalmente
name
ConfigPackageDescriptionType
Origen 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>
Declara una carpeta, denominada por el atributo Nombre, debajo de PackageRoot que contiene un archivo Settings.xml. Este archivo contiene secciones de configuración del par clave-valor definida por el usuario que el proceso puede volver a leer en tiempo de ejecución. Durante una actualización, si solo ha cambiado la versión de ConfigPackage, no se reiniciará el proceso en ejecución. En su lugar, una devolución de llamada notifica el proceso que los ajustes de configuración han cambiado, por lo que pueden volver a cargarse de forma dinámica.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
ConfigPackageType
Origen 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>
ContainerCertificateType complexType
Especifica información sobre un certificado X509 que se va a exponer en el entorno del contenedor. El certificado debe instalarse en el almacén LocalMachine de todos los nodos de clúster.
Cuando la aplicación se inicia, el entorno de tiempo de ejecución lee el certificado y genera un archivo PFX y una contraseña (en Windows) o un archivo PEM (en Linux).
En el contenedor se puede acceder a la contraseña y al archivo PFX con las variables de entorno Certificates_ServicePackageName_CodePackageName_CertName_PFX y Certificates_ServicePackageName_CodePackageName_CertName_Password. En el contenedor se puede acceder al archivo PEM con las variables de entorno Certificates_ServicePackageName_CodePackageName_CertName_PEM y Certificates_ServicePackageName_CodePackageName_CertName_PrivateKey.
Atributo
Value
content
0 elementos, 8 atributos
definido
globalmente
name
ContainerCertificateType
Origen 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>
Detalles de atributos
X509StoreName
Nombre de almacén del certificado X509.
Atributo
Value
name
X509StoreName
type
xs:string
default
My
X509FindValue
Huella digital del certificado X509.
Atributo
Value
name
X509FindValue
type
xs:string
use
opcional
DataPackageRef
Nombre del paquete de datos que tiene los archivos de certificado.
Atributo
Value
name
DataPackageRef
type
xs:string
use
opcional
DataPackageVersion
Versión del paquete de datos que tiene los archivos de certificado.
Atributo
Value
name
DataPackageVersion
type
xs:string
use
opcional
RelativePath
Ruta de acceso relativa al archivo de certificado en el paquete de datos.
Atributo
Value
name
RelativePath
type
xs:string
use
opcional
Contraseña
Contraseña o clave privada para el certificado.
Atributo
Value
name
Contraseña
type
xs:string
use
opcional
IsPasswordEncrypted
En caso de que sea true, el valor de la contraseña se cifra.
Atributo
Value
name
IsPasswordEncrypted
type
xs:boolean
default
false
Nombre
Identificador de la información específica del certificado. Este nombre se usa para establecer la variable de entorno del contenedor.
Atributo
Value
name
Nombre
type
xs:string
use
requerido
ContainerHealthConfigType complexType
Especifica las opciones de integración de HEALTHCHECK de Docker para el contenedor.
Atributo
Value
content
0 elemento(s), 2 atributo(s)
definido
globalmente
name
ContainerHealthConfigType
Origen 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>
Detalles de atributos
IncludeDockerHealthStatusInSystemHealthReport
Si el contenedor tiene HEALTHCHECK habilitado y Docker notifica el evento health_status para este contenedor, Service Fabric incluirá esto como parte del estado notificado del sistema. Si health_status es incorrecto, Service Fabric notificará una advertencia de estado. De forma predeterminada, se establece en true.
Atributo
Value
name
IncludeDockerHealthStatusInSystemHealthReport
type
xs:boolean
use
opcional
default
true
RestartContainerOnUnhealthyDockerHealthStatus
Si el contenedor tiene HEALTHCHECK habilitado y Docker notifica el evento health_status para este contenedor, Service Fabric reiniciará el contenedor si el evento health_status notificado por Docker es incorrecto.
De forma predeterminada, se establece en false.
Atributo
Value
name
RestartContainerOnUnhealthyDockerHealthStatus
type
xs:boolean
use
opcional
default
false
ContainerHostEntryPointType complexType
Atributo
Value
content
4 elementos, 0 atributos
definido
globalmente
name
ContainerHostEntryPointType
Origen 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>
Pase una lista de comandos delimitados por comas al contenedor.
Atributo
Value
name
Comandos:
type
xs:string
minOccurs
0
maxOccurs
1
EntryPoint
Atributo
Value
name
EntryPoint
type
xs:string
minOccurs
0
maxOccurs
1
FromSource
Atributo
Value
name
FromSource
type
xs:string
minOccurs
0
maxOccurs
1
ContainerHostPoliciesType complexType
Atributo
Value
content
10 elementos, 8 atributos
definido
globalmente
name
ContainerHostPoliciesType
Origen 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>
Detalles de atributos
CodePackageRef
Atributo
Value
name
CodePackageRef
use
requerido
UseDefaultRepositoryCredentials
Use las credenciales del repositorio predeterminadas especificadas en clusterManifest.xml, en lugar de las credenciales especificadas en la etiqueta "RepositoryCredentials" en ApplicationManifest.xml.
Atributo
Value
name
UseDefaultRepositoryCredentials
type
xs:string
use
opcional
default
false
UseTokenAuthenticationCredentials
Use autenticación de token de MSI (o un punto de conexión personalizado especificado) para obtener un token usado para la autenticación.
Atributo
Value
name
UseTokenAuthenticationCredentials
type
xs:string
use
opcional
default
false
Aislamiento
Modo de aislamiento del contenedor. Los valores válidos son default, process o Hyper-V (solo se admite para contenedores de Windows).
Atributo
Value
name
Aislamiento
use
opcional
type
xs:string
Hostname
Especifica el nombre de host del contenedor.
Atributo
Value
name
Hostname
use
opcional
type
xs:string
ContainersRetentionCount
Número de contenedores que se van a omitir cuando el contenedor desaparezca repetidamente. De manera predeterminada, este valor se establece en 0, por lo que no se omitirá ningún contenedor.
Atributo
Value
name
ContainersRetentionCount
use
opcional
type
xs:string
default
0
AutoRemove
Marca que indica si se producirá automáticamente la eliminación de contenedores (true) o no (false) si se termina el contenedor. Si es false, SF quita manualmente los contenedores.
Atributo
Value
name
AutoRemove
use
opcional
type
xs:string
RunInteractive
Ejecuta el contenedor con la marca interactiva habilitada. Los valores válidos son true o false. El valor predeterminado es false.
Atributo
Value
name
RunInteractive
use
opcional
type
xs:string
Detalles del elemento de contenido
RepositoryCredentials
Las credenciales del repositorio de imágenes de contenedor del que extraer imágenes.
<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>
Detalles de atributos
EndpointRef
Nombre del punto de conexión, que se debe declarar en la sección de recursos del manifiesto de servicio.
Atributo
Value
name
EndpointRef
ContainerNetworkPolicyType complexType
Describe la asociación entre un paquete de servicio y una red de contenedor y, opcionalmente, la asociación entre los puntos de conexión del paquete de servicio y la red de contenedor.
Atributo
Value
content
1 elemento, 1 atributo
definido
globalmente
name
ContainerNetworkPolicyType
Origen 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>
Detalles de atributos
NetworkRef
El nombre de la red de contenedor (distingue entre mayúsculas y minúsculas). Debe ser el nombre de una red de contenedor ya creada o nombres reservados, como "Open" o "NAT".
Atributo
Value
name
NetworkRef
use
requerido
Detalles del elemento de contenido
EndpointBinding
Especifica un punto de conexión que se debe exponer en la red del contenedor.
<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>
Detalles de atributos
Source
La carpeta de origen que puede ser una carpeta de la máquina virtual que hospeda los contenedores o un almacén remoto persistente.
Atributo
Value
name
Source
use
requerido
Destination
La ubicación a la que el origen está asignado dentro del contenedor en ejecución. Por lo tanto, el destino no puede ser una ubicación que ya exista dentro del contenedor.
Atributo
Value
name
Destination
use
requerido
Controlador
El nombre de controlador para el complemento de volúmenes de Azure Files es "sfazurefile".
Atributo
Value
name
Controlador
use
opcional
IsReadOnly
Atributo
Value
name
IsReadOnly
type
xs:boolean
default
false
Detalles del elemento de contenido
DriverOption
Opciones de controlador que se pasan al controlador.
Declara una carpeta, denominada por el atributo Nombre, debajo de PackageRoot que contiene archivos de datos estáticos que el proceso en tiempo de ejecución va a consumir. Service Fabric reciclará todos los archivos EXE y DLLHOST especificados en los paquetes de host y soporte técnico cuando cualquiera de los paquetes de datos enumerados en el manifiesto de servicio se actualice.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
DataPackageType
Origen 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>
DebugParametersType complexType
Especifica información sobre el depurador que debe asociarse cuando se active el paquete de código.
Punto de entrada omitido para los contenedores de forma que se pueda iniciar el depurador.
Atributo
Value
name
ContainerEntryPoint
type
xs:string
minOccurs
0
maxOccurs
sin enlazar
ContainerMountedVolume
Volúmenes que se van a montar dentro del contenedor.
Atributo
Value
name
ContainerMountedVolume
type
xs:string
minOccurs
0
maxOccurs
sin enlazar
ContainerEnvironmentBlock
EnvironmentBlock para contenedores.
Atributo
Value
name
ContainerEnvironmentBlock
type
xs:string
minOccurs
0
maxOccurs
sin enlazar
ContainerLabel
Las etiquetas de los contenedores en el formato clave=valor.
Atributo
Value
name
ContainerLabel
type
xs:string
minOccurs
0
maxOccurs
sin enlazar
DefaultServicesType complexType
Declara instancias de servicio que se crean automáticamente cada vez que se crea una instancia de una aplicación en este tipo de aplicación.
Atributo
Value
content
2 elementos, 0 atributos
definido
globalmente
name
DefaultServicesType
Origen 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>
Detalles del elemento de contenido
Servicio
Declara que un servicio se cree automáticamente cuando se crea una instancia de la aplicación.
Atributo
Value
name
Servicio
ServiceGroup
Una colección de servicios que se colocan juntos automáticamente, por lo que también se mueven juntos durante la conmutación por error o la administración de recursos.
Atributo
Value
name
ServiceGroup
DiagnosticsType complexType
Describe la configuración de diagnóstico de las aplicaciones.
Atributo
Value
content
3 elementos, 0 atributos
definido
globalmente
name
DiagnosticsType
Origen 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>
Detalles del elemento de contenido
CrashDumpSource
Especifica la colección de volcados de memoria. Se recopilan volcados de memoria para los ejecutables que hospedan los paquetes de código de todos los servicios que pertenecen a la aplicación.
Atributo
Value
name
CrashDumpSource
minOccurs
0
ETWSource
Especifica la colección de seguimiento de ETW. Los seguimientos de ETW se recopilan para los proveedores que registran todos los servicios que pertenecen a la aplicación.
Atributo
Value
name
ETWSource
minOccurs
0
FolderSource
Especifica la colección de contenido de una determinada carpeta en el nodo local.
Atributo
Value
name
FolderSource
minOccurs
0
maxOccurs
sin enlazar
DllHostEntryPointType complexType
No se admite, no debe usarse. Se proporciona compatibilidad con hospedaje de DLL (punto de entrada de ensamblado) mediante el proceso FWP.exe. Service Fabric inicia el proceso de trabajo de tejido (FWP.exe) y carga el ensamblado como parte del proceso de activación.
Atributo
Value
content
2 elementos, 1 atributo
definido
globalmente
name
DllHostEntryPointType
Origen 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>
Detalles de atributos
IsolationPolicy
No se admite, no debe usarse. Define la directiva de aislamiento para las bibliotecas DLL no administradas y los ensamblados administrados cargados en DllHost.
Opciones de controlador que se pasan al controlador. El complemento de volumen de Azure Files es compatible con las siguientes opciones de controlador: shareName (el recurso compartido de archivos de Azure Files que proporciona el volumen para el contenedor), storageAccountName (la cuenta de almacenamiento de Azure que contiene el recurso compartido de Azure Files), storageAccountKey (tecla de acceso para la cuenta de almacenamiento de Azure que contiene el recurso compartido de archivos de Azure Files).
Estas tres opciones de controlador son obligatorias.
Atributo
Value
content
0 elementos, 4 atributos
definido
globalmente
name
DriverOptionType
Origen 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>
Detalles de atributos
Nombre
El nombre de la opción de controlador.
Atributo
Value
name
Nombre
type
xs:string
use
requerido
Value
El valor de la opción de controlador.
Atributo
Value
name
Value
type
xs:string
use
requerido
IsEncrypted
Atributo
Value
name
IsEncrypted
type
xs:string
use
opcional
default
false
Tipo
Este valor define la protección del valor del atributo. Puede ser SecretsStoreRef/Encrypted/PlainText.
Si se establece en SecretsStoreRef, el valor hace referencia a un secreto almacenado cifrado en la instancia SecureStore del clúster, cuya referencia se elimina y que se descifra durante la activación.
Si se establece en Encrypted, el desarrollador de la aplicación es responsable de crear un certificado y de usar el cmdlet Invoke-ServiceFabricEncryptSecret para cifrar la información confidencial.
Atributo
Value
name
Tipo
type
xs:string
use
opcional
default
PlainText
EndpointBindingPolicyType complexType
Atributo
Value
content
0 elemento(s), 2 atributo(s)
definido
globalmente
name
EndpointBindingPolicyType
Origen 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>
Detalles de atributos
EndpointRef
Nombre del punto de conexión, que se debe declarar en la sección de recursos del manifiesto de servicio. Si usa HTTPS, no utilice el mismo puerto y certificado para distintas instancias de servicio (independientes de la aplicación) implementadas en el mismo nodo. Al actualizar dos servicios diferentes que usan el mismo puerto en diferentes instancias de aplicación, se producirá un error de actualización.
Atributo
Value
name
EndpointRef
CertificateRef
Nombre del certificado del punto de conexión, declarado en la sección de certificados, que se va a devolver al cliente.
Atributo
Value
name
CertificateRef
use
requerido
EndpointCertificateType complexType
Especifica información sobre un certificado X509 usado para proteger un punto de conexión.
Atributo
Value
content
0 elementos, 3 atributos
definido
globalmente
name
EndpointCertificateType
Origen 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>
Detalles de atributos
X509StoreName
Nombre de almacén del certificado X509.
Atributo
Value
name
X509StoreName
type
xs:string
default
My
X509FindValue
Huella digital del certificado X509.
Atributo
Value
name
X509FindValue
use
requerido
Nombre
Atributo
Value
name
Nombre
type
xs:string
use
opcional
EndpointOverrideType complexType
Atributo
Value
content
0 elementos, 6 atributos
definido
globalmente
name
EndpointOverrideType
Origen 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>
Detalles de atributos
Nombre
Nombre del punto de conexión que se va a invalidar. Una cadena.
Atributo
Value
name
Nombre
use
requerido
Port
Número de puerto del punto de conexión. Invalida el valor del manifiesto de servicio.
Atributo
Value
name
Port
type
xs:string
Protocolo
Protocolo del punto de conexión. Invalida el valor del manifiesto de servicio. Los puntos de conexión HTTPS también deben tener un valor EndpointCertificate y un valor EndpointBindingPolicy declarados en el manifiesto de aplicación. No se puede cambiar el protocolo más tarde en una actualización de la aplicación.
Atributo
Value
name
Protocolo
type
xs:string
use
opcional
Tipo
Tipo del punto de conexión. Invalida el valor del manifiesto de servicio. Los puntos de conexión de entrada se utilizan para exponer el puerto en el exterior, mientras que los puntos de conexión internos se usan para la comunicación dentro de la aplicación.
Atributo
Value
name
Tipo
type
xs:string
use
opcional
UriScheme
Esquema de URI. Invalida el valor del manifiesto de servicio. Por ejemplo, "http", "https" o "ftp".
Atributo
Value
name
UriScheme
use
opcional
PathSuffix
Sufijo de ruta de acceso. Por ejemplo, "/myapp1". Invalida el valor del manifiesto de servicio.
Atributo
Value
name
PathSuffix
use
opcional
ComplexType EndpointType
Define un punto de conexión para el servicio. Se pueden solicitar puertos específicos. Si no se especifica explícitamente el puerto, se asigna uno del intervalo de puertos de aplicación reservados. Es posible asignar números de puerto diferentes a réplicas de servicio que se ejecutan en diferentes nodos de clúster, mientras que las réplicas del mismo servicio que se ejecuta en el mismo nodo comparten el mismo puerto. Las réplicas de servicio pueden usar tales puertos con fines diversos como la replicación o la escucha de solicitudes de cliente.
Atributo
Value
content
0 elementos, 8 atributos
definido
globalmente
name
EndpointType
Origen 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>
Detalles de atributos
Nombre
Nombre del punto de conexión.
Atributo
Value
name
Nombre
use
requerido
Protocolo
El protocolo para el punto de conexión: http, https, tcp o udp. Los puntos de conexión HTTPS también deben tener un valor EndpointCertificate y un valor EndpointBindingPolicy declarados en el manifiesto de aplicación. No se puede cambiar el protocolo más tarde en una actualización de la aplicación.
Atributo
Value
name
Protocolo
use
opcional
default
tcp
Tipo
Tipo del punto de conexión. Los puntos de conexión de entrada se utilizan para exponer el puerto en el exterior, mientras que los puntos de conexión internos se usan para la comunicación dentro de la aplicación.
Atributo
Value
name
Tipo
use
opcional
default
Interno
CodePackageRef
Nombre del paquete de código que utilizará este punto de conexión.
Atributo
Value
name
CodePackageRef
use
opcional
CertificateRef
No se debe usar, ya que no se admite este atributo.
Atributo
Value
name
CertificateRef
Port
El puerto se reemplazará por un puerto determinado por Microsoft Azure Service Fabric después del registro en Http.sys o BFE.
Atributo
Value
name
Port
UriScheme
Esquema de URI. Por ejemplo, "http", "https" o "ftp".
Atributo
Value
name
UriScheme
PathSuffix
Sufijo de ruta de acceso. Por ejemplo, "/myapp1".
Atributo
Value
name
PathSuffix
EntryPointDescriptionType complexType
El archivo ejecutable especificado por EntryPoint suele ser el host de servicios de ejecución prolongada. La presencia de un punto de entrada de configuración independiente evita tener que ejecutar el host de servicio con privilegios elevados durante largos períodos de tiempo. El archivo ejecutable especificado por EntryPoint se ejecuta después de que SetupEntryPoint se cierra correctamente. El proceso resultante se supervisa y reinicia (comenzando de nuevo con SetupEntryPoint) si alguna vez finaliza o se bloquea.
Atributo
Value
content
3 elementos, 0 atributos
definido
globalmente
name
EntryPointDescriptionType
Origen 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>
Detalles de atributos
Nombre
Nombre de la variable de entorno.
Atributo
Value
name
Nombre
type
xs:string
use
requerido
Value
Atributo
Value
name
Value
Tipo
Tipo de la variable de entorno. Puede ser PlainText/Encrypted/SecretsStoreRef.
Si se establece en SecretsStoreRef, se recupera el valor de referencia de SecretStore.
Si se establece en Encrypted, el desarrollador de la aplicación es responsable de crear un certificado y de usar el cmdlet Invoke-ServiceFabricEncryptSecret para cifrar la información confidencial.
Atributo
Value
name
Tipo
use
opcional
default
PlainText
EnvironmentVariablesType complexType
Pase variables de entorno al contenedor o exe.
Atributo
Value
content
1 elemento, 0 atributos
definido
globalmente
name
EnvironmentVariablesType
Origen 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>
Detalles de atributos
IsExternalExecutable
Es true si el archivo ejecutable es externo al paquete de aplicación. Se omite la comprobación de existencia del programa en el paquete de aplicación.
Atributo
Value
name
IsExternalExecutable
type
xs:boolean
default
false
Detalles del elemento de contenido
Programa
El nombre del archivo ejecutable. Por ejemplo, "MySetup.bat" o "MyServiceHost.exe".
Atributo
Value
name
Programa
type
xs:string
Argumentos
Atributo
Value
name
Argumentos
type
xs:string
minOccurs
0
WorkingFolder
Atributo
Value
name
WorkingFolder
default
Work
minOccurs
0
ConsoleRedirection
Advertencia. No use la redirección de consola en una aplicación de producción, solo se usa para la depuración y el desarrollo locales. Redirige la salida de la consola del script de inicio a un archivo de salida en la carpeta de aplicación denominada "log", en el nodo del clúster donde se implementa y ejecuta la aplicación.
Atributo
Value
name
ConsoleRedirection
minOccurs
0
ExtensionsType complexType
Describe las extensiones que pueden aplicarse a otros elementos.
Atributo
Value
content
1 elemento, 0 atributos
definido
globalmente
name
ExtensionsType
Origen 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>
Detalles del elemento de contenido
Extensión
Atributo
Value
name
Extensión
minOccurs
0
maxOccurs
sin enlazar
FabricCertificateType complexType
Especifica la información del certificado.
Atributo
Value
content
0 elementos, 5 atributos
definido
globalmente
name
FabricCertificateType
Origen 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>
Detalles de atributos
X509StoreName
Nombre de almacén del certificado X509.
Atributo
Value
name
X509StoreName
type
xs:string
default
My
X509FindType
Se utiliza solo cuando la credencial es X509. Especifica cómo buscar el certificado: por el nombre o por la huella digital.
Atributo
Value
name
X509FindType
default
FindByThumbprint
X509FindValue
Se utiliza solo cuando la credencial es X509. Es la huella digital o el nombre real del certificado.
Atributo
Value
name
X509FindValue
use
requerido
X509FindValueSecondary
Se utiliza solo cuando la credencial es X509. Es la huella digital o el nombre real del certificado.
<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>
Detalles del elemento de contenido
SharedLogFilePath
Define la ruta de acceso al registro compartido.
Atributo
Value
name
SharedLogFilePath
minOccurs
0
SharedLogFileId
GUID específico que se usará como identificador de registro compartido.
Atributo
Value
name
SharedLogFileId
minOccurs
0
SharedLogFileSizeInMB
Define el tamaño del registro compartido.
Atributo
Value
name
SharedLogFileSizeInMB
minOccurs
0
FabricNodeType complexType
Describe un nodo de Microsoft Azure Service Fabric.
Atributo
Value
content
0 elementos, 6 atributos
definido
globalmente
name
FabricNodeType
Origen 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>
Detalles de atributos
NodeName
Nombre de la instancia del nodo.
Atributo
Value
name
NodeName
type
xs:string
use
requerido
IPAddressOrFQDN
Dirección IP o FQDN de la máquina en la que se debe colocar este nodo.
Atributo
Value
name
IPAddressOrFQDN
type
xs:string
use
requerido
IsSeedNode
Marca que indica si este es un nodo raíz o no.
Atributo
Value
name
IsSeedNode
type
xs:boolean
default
false
NodeTypeRef
Nombre del tipo de nodo definido en la sección NodeTypes.
Atributo
Value
name
NodeTypeRef
type
xs:string
use
requerido
FaultDomain
Dominio de error de este nodo.
Atributo
Value
name
FaultDomain
type
xs:anyURI
use
opcional
UpgradeDomain
Dominio de actualización de este nodo.
Atributo
Value
name
UpgradeDomain
type
xs:anyURI
use
opcional
FileStoreETWType complexType
Describe un destino de almacén de archivos para los eventos de ETW. Solo funciona en entornos locales.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
FileStoreETWType
Origen 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>
FileStoreType complexType
Describe un destino de almacén de archivos de datos de diagnóstico. Funciona únicamente en un entorno de clúster independiente.
Atributo
Value
content
1 elemento, 2 atributos
definido
globalmente
name
FileStoreType
Origen 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>
Detalles de atributos
AccountType
Especifica el tipo de cuenta.
Atributo
Value
name
AccountType
type
xs:string
PasswordEncrypted
Especifica si la contraseña está cifrada o es texto sin formato.
Atributo
Value
name
PasswordEncrypted
type
xs:string
Detalles del elemento de contenido
None
Atributo
Value
ref
Parámetros
minOccurs
0
ImageOverridesType complexType
Es posible que los contenedores Windows Server no sean compatibles con las distintas versiones del sistema operativo. Puede especificar varias imágenes de sistema operativo por contenedor y etiquetarlas con las versiones de compilación del sistema operativo. Obtenga la versión de compilación del sistema operativo ejecutando "winver" en un símbolo del sistema de Windows. Si el sistema operativo subyacente tiene la versión de compilación 16299 (versión Windows Server 1709), Service Fabric seleccionará la imagen de contenedor etiquetada con Os="16299". Se supone que una imagen de contenedor no etiquetada funcionará con todas las versiones del sistema operativo y que reemplazará la imagen especificada en el manifiesto de servicio.
Atributo
Value
content
1 elemento, 0 atributos
definido
globalmente
name
ImageOverridesType
Origen 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>
Detalles del elemento de contenido
Imagen
Imagen de contenedor correspondiente al número de versión de compilación del sistema operativo que se iniciará. Si el atributo del sistema operativo no está especificado, se supone que la imagen de contenedor funcionará en todas las versiones del sistema operativo y que reemplazará la imagen especificada en el manifiesto de servicio.
<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>
Detalles de atributos
Nombre
Nombre de la imagen de contenedor.
Atributo
Value
name
Nombre
type
xs:string
use
requerido
Os
Versión de compilación del sistema operativo. Por ejemplo, la versión de compilación de Windows Server 1709 es 16299.
Atributo
Value
name
Os
type
xs:string
use
opcional
InfrastructureInformationType complexType
Contiene la información de infraestructura para este clúster de Microsoft Azure Service Fabric.
Atributo
Value
content
1 elemento, 0 atributos
definido
globalmente
name
InfrastructureInformationType
Origen 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>
Detalles del elemento de contenido
NodeList
Atributo
Value
name
NodeList
InfrastructureNodeType complexType
Describe una información de infraestructura necesaria.
Atributo
Value
content
2 elementos, 7 atributos
definido
globalmente
name
InfrastructureNodeType
Origen 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>
Detalles de atributos
NodeName
Nombre de la instancia del nodo.
Atributo
Value
name
NodeName
type
xs:string
use
requerido
IPAddressOrFQDN
Dirección IP o FQDN de la máquina en la que se debe colocar este nodo.
Atributo
Value
name
IPAddressOrFQDN
type
xs:string
use
requerido
RoleOrTierName
Nombre del rol que se vincula con la referencia del tipo de nodo definida en la sección NodeTypes.
Atributo
Value
name
RoleOrTierName
type
xs:string
use
requerido
NodeTypeRef
Nombre del tipo de nodo definido en la sección NodeTypes.
Atributo
Value
name
NodeTypeRef
type
xs:string
use
requerido
IsSeedNode
Indica si el nodo es un nodo raíz.
Atributo
Value
name
IsSeedNode
type
xs:boolean
use
opcional
default
false
FaultDomain
Dominio de error de este nodo.
Atributo
Value
name
FaultDomain
type
xs:anyURI
use
opcional
UpgradeDomain
Dominio de actualización de este nodo.
Atributo
Value
name
UpgradeDomain
type
xs:anyURI
use
opcional
Detalles del elemento de contenido
Puntos de conexión
Describe los puntos de conexión asociados a este tipo de nodo.
Un recurso en el que se debe equilibrar este servicio, como el uso de memoria o CPU. Incluye información sobre la cantidad de ese recurso que consume cada réplica o instancia de este servicio de forma predeterminada.
Atributo
Value
content
0 elementos, 5 atributos
definido
globalmente
name
LoadMetricType
Origen 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>
Detalles de atributos
Nombre
Un identificador único para la métrica en el clúster desde la perspectiva de Cluster Resource Manager.
Atributo
Value
name
Nombre
use
requerido
DefaultLoad
Cantidad predeterminada de carga que este servicio sin estado crea para esta métrica.
Atributo
Value
name
DefaultLoad
type
xs:long
use
opcional
default
0
PrimaryDefaultLoad
Cantidad predeterminada de carga que este servicio aplicará para esta métrica cuando se trate de una réplica principal.
Atributo
Value
name
PrimaryDefaultLoad
type
xs:long
use
opcional
default
0
SecondaryDefaultLoad
Cantidad predeterminada de carga que este servicio aplicará para esta métrica cuando se trate de una réplica secundaria.
Atributo
Value
name
SecondaryDefaultLoad
type
xs:long
use
opcional
default
0
Peso
Determina el peso de la métrica con respecto a las otras métricas que están configuradas para este servicio. Durante el tiempo de ejecución, si dos métricas terminan en conflicto, Cluster Resource Manager prefiere la métrica con mayor peso. Un valor de cero deshabilita el equilibrio de carga para esta métrica.
Atributo
Value
name
Peso
LocalStoreETWType complexType
Describe un destino de almacén en el nodo para eventos de ETW.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
LocalStoreETWType
Origen 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>
LocalStoreType complexType
Describe un destino de almacén en el nodo para datos de diagnóstico.
Atributo
Value
content
1 elemento, 0 atributos
definido
globalmente
name
LocalStoreType
Origen 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>
Detalles del elemento de contenido
None
Atributo
Value
ref
Parámetros
minOccurs
0
LogicalDirectoryType complexType
Describe un elemento LogicalDirectoryType.
Atributo
Value
content
0 elementos, 3 atributos
definido
globalmente
name
LogicalDirectoryType
Origen 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>
Detalles de atributos
LogicalDirectoryName
Nombre de LogicalDirectory.
Atributo
Value
name
LogicalDirectoryName
type
xs:string
use
requerido
MappedTo
Ruta de acceso de LogicalDirectory.
Atributo
Value
name
MappedTo
type
xs:string
use
requerido
Context
Atributo
Value
name
Context
use
opcional
default
application
ManagedAssemblyType complexType
No se admite, no debe usarse. El nombre del ensamblado administrado (por ejemplo, Queue.dll), que se hospedará.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
ManagedAssemblyType
Origen 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
Describe las directivas de red, incluidas las directivas de la red de contenedor para el paquete de servicio.
Atributo
Value
content
1 elemento, 0 atributos
definido
globalmente
name
NetworkPoliciesType
Origen 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>
Detalles del elemento de contenido
ContainerNetworkPolicy
Describe las directivas de red de contenedor para el paquete de servicio.
Indica si se debe compartir un paquete de código, configuración o datos entre las instancias de servicio del mismo tipo de servicio.
Atributo
Value
content
0 elemento(s), 2 atributo(s)
definido
globalmente
name
PackageSharingPolicyType
Origen 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>
Detalles de atributos
PackageRef
Nombre del paquete de datos, configuración o código que se va a compartir. Debe coincidir con el nombre del paquete que se define en el manifiesto de servicio.
Atributo
Value
name
PackageRef
Ámbito
Atributo
Value
name
Ámbito
default
None
ParameterType complexType
Atributo
Value
content
0 elementos, 1 atributo
definido
globalmente
name
ParameterType
Origen 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>
<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>
Detalles de atributos
PasswordEncrypted
Especifica si la contraseña está cifrada o es texto sin formato. Este atributo está en desuso. Use el atributo "Type" para indicar la contraseña cifrada.
Atributo
Value
name
PasswordEncrypted
type
xs:boolean
use
opcional
Email
Atributo
Value
name
Email
Tipo
Este valor define el tipo de contraseña que ha especificado en el atributo "Password". Puede ser SecretsStoreRef/Encrypted/PlainText.
Si se establece en SecretsStoreRef, se recupera el valor de referencia de SecretStore.
Si se establece en Encrypted, el desarrollador de la aplicación es responsable de crear un certificado y de usar el cmdlet Invoke-ServiceFabricEncryptSecret para cifrar la información confidencial.
Atributo
Value
name
Tipo
type
xs:string
use
opcional
ResourceGovernancePolicyType complexType
Limita los recursos que se pueden usar en el host y declara los límites de recursos para un paquete de código de servicio.
Atributo
Value
content
0 elementos, 12 atributos
definido
globalmente
name
ResourceGovernancePolicyType
Origen 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>
Detalles de atributos
CodePackageRef
Atributo
Value
name
CodePackageRef
use
requerido
MemoryInMB
Límites de la memoria en MB. Debe ser un entero positivo. Los paquetes de código (contenedores o procesos) no pueden asignar más memoria de la que establece este límite; si se intenta, el resultado es una excepción de memoria insuficiente.
Atributo
Value
name
MemoryInMB
type
xs:string
use
opcional
default
0
MemorySwapInMB
La cantidad total de memoria de intercambio que puede utilizarse, en MB. Debe ser un entero positivo.
Atributo
Value
name
MemorySwapInMB
type
xs:string
use
opcional
default
0
MemoryReservationInMB
El límite flexible (en MB) para la gobernanza de memoria que se aplica únicamente cuando se detecta contención de la memoria en el nodo. Debe ser un entero positivo.
Atributo
Value
name
MemoryReservationInMB
type
xs:string
use
opcional
default
0
CpuShares
Peso relativo de CPU. Debe ser un entero positivo.
Atributo
Value
name
CpuShares
type
xs:string
use
opcional
default
0
CpuPercent
Porcentaje que se puede utilizar de las CPU disponibles (solo para Windows). Debe ser un entero positivo. Si se especifican los límites de CPU para el Service Pack, se omite este parámetro.
Atributo
Value
name
CpuPercent
type
xs:string
use
opcional
default
0
MaximumIOps
Máxima tasa de E/S (lectura y escritura) en términos de IOPS que se puede usar. Debe ser un entero positivo.
Atributo
Value
name
MaximumIOps
type
xs:string
use
opcional
default
0
MaximumIOBandwidth
Máximo de E/S (bytes por segundo) que se puede usar (lectura y escritura). Debe ser un entero positivo.
Atributo
Value
name
MaximumIOBandwidth
type
xs:string
use
opcional
default
0
BlockIOWeight
Peso de E/S en bloque, en relación con otros paquetes de código. Debe ser un entero positivo comprendido entre 10 y 1000.
Atributo
Value
name
BlockIOWeight
type
xs:string
use
opcional
default
0
DiskQuotaInMB
Cuota de disco para los contenedores. Debe ser un entero positivo.
Atributo
Value
name
DiskQuotaInMB
type
xs:string
use
opcional
default
0
KernelMemoryInMB
Límites de memoria del kernel en bytes. Debe ser un entero positivo. Tenga en cuenta que esto es específico de Linux, y Docker en Windows generará un error si se establece.
Atributo
Value
name
KernelMemoryInMB
type
xs:string
use
opcional
default
0
ShmSizeInMB
Tamaño de/dev/shm en bytes. Si se omite, el sistema usa 64 MB. Debe ser un entero positivo. Tenga en cuenta que esto es específico de Linux, sin embargo, Docker NO generará un error si se especifica. Simplemente se omite.
Atributo
Value
name
ShmSizeInMB
type
xs:string
use
opcional
default
0
ResourceOverridesType complexType
Especifica las invalidaciones de recursos para los puntos de conexión declarados en recursos de manifiesto de servicio.
Atributo
Value
content
1 elemento, 0 atributos
definido
globalmente
name
ResourceOverridesType
Origen 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>
Detalles del elemento de contenido
Puntos de conexión
Los puntos de conexión de servicio que se invalidarán.
Atributo
Value
name
Puntos de conexión
minOccurs
0
ResourcesType complexType
Describe los recursos utilizados por este servicio, que se pueden declarar sin modificar el código compilado y cambiar cuando se implemente el servicio. El acceso a estos recursos se controla mediante las secciones Entidades de seguridad y Directivas del manifiesto de aplicación.
Atributo
Value
content
1 elemento, 0 atributos
definido
globalmente
name
ResourcesType
Origen 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>
Detalles del elemento de contenido
Puntos de conexión
Define los puntos de conexión del servicio.
Atributo
Value
name
Puntos de conexión
minOccurs
0
RunAsPolicyType complexType
Especifica el usuario local o la cuenta del sistema local que ejecutará un paquete de código de servicio. Se admiten cuentas de dominio en implementaciones de Windows Server donde esté disponible Microsoft Entra ID. De forma predeterminada, las aplicaciones se ejecutan con la cuenta con la que se ejecuta el proceso Fabric.exe. Las aplicaciones también pueden ejecutarse con otras cuentas, lo que se debe declarar en la sección Entidades de seguridad. Si se aplica una directiva RunAs a un servicio y el manifiesto de servicio declara que hay recursos de puntos de conexión con el protocolo HTTP, es preciso especificar también una directiva SecurityAccessPolicy para asegurarse de que los puertos asignados a dichos puntos de conexión aparezcan correctamente en la lista de control de acceso de la cuenta de usuario RunAs en la que se ejecuta el servicio. Para un punto de conexión HTTPS, también debe definir un elemento EndpointBindingPolicy para indicar el nombre del certificado que se devuelve al cliente.
Atributo
Value
content
0 elementos, 3 atributos
definido
globalmente
name
RunAsPolicyType
Origen 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>
Detalles de atributos
CodePackageRef
Nombre del paquete de código. Debe coincidir con el nombre de CodePackage que se especifica en el manifiesto de servicio.
Atributo
Value
name
CodePackageRef
use
requerido
UserRef
La cuenta de usuario según la que se ejecutará el paquete de código de servicio. La cuenta de usuario debe declararse en la sección de entidades de seguridad. A menudo, es preferible ejecutar el punto de entrada de configuración mediante una cuenta de sistema local en lugar de usar una cuenta de administrador.
Atributo
Value
name
UserRef
use
requerido
EntryPointType
La configuración es el valor de SetupEntryPoint que se declara en el manifiesto de servicio, el punto de entrada con privilegios que se ejecuta antes que cualquier otro punto de entrada. Main es el punto de entrada que se declara en el manifiesto de servicio, normalmente el host del servicio de ejecución prolongada. All se refiere a todos los puntos de entrada.
Atributo
Value
name
EntryPointType
use
opcional
default
Principal
ScalingPolicyType complexType
Una descripción de directiva de escalado que consta de un desencadenador y de un mecanismo de escalado.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
ScalingPolicyType
Origen 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>
SecurityAccessPolicyType complexType
Concede permisos de acceso a una entidad de seguridad en un recurso (por ejemplo, un punto de conexión) definido en un manifiesto de servicio. Por lo general, resulta muy útil controlar y restringir el acceso de los servicios a diferentes recursos con el fin de reducir los riesgos de seguridad. Esto es especialmente importante cuando la aplicación se crea a partir de una colección de servicios de un catálogo de soluciones, desarrollados por distintas personas.
Atributo
Value
content
0 elementos, 4 atributos
definido
globalmente
name
SecurityAccessPolicyType
Origen 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>
Detalles de atributos
ResourceRef
Recurso al que se concede acceso, declarado y configurado en el manifiesto de servicio.
Atributo
Value
name
ResourceRef
use
requerido
PrincipalRef
El usuario o grupo al que se asignan derechos de acceso a un recurso debe declararse en la sección de entidades de seguridad.
Atributo
Value
name
PrincipalRef
use
requerido
GrantRights
Los derechos que se van a conceder: Lectura, Cambio, Completo. El valor predeterminado es Lectura.
Atributo
Value
name
GrantRights
default
Lectura
ResourceType
Tipo de recurso, que se define en la sección Recursos del manifiesto de servicio. Punto de conexión o certificado.
Describe las entidades de seguridad (usuarios, grupos) necesarias para que esta aplicación ejecute servicios y proteja recursos. Se hace referencia a las entidades de seguridad en las secciones de directivas.
Atributo
Value
content
2 elementos, 0 atributos
definido
globalmente
name
SecurityPrincipalsType
Origen 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>
Detalles del elemento de contenido
Grupos
Declara un conjunto de grupos como entidades de seguridad, a las que se puede hacer referencia en las directivas. Los grupos son útiles si hay varios usuarios para distintos puntos de entrada de servicio y es preciso que tengan ciertos privilegios comunes disponibles en el nivel de grupo.
Atributo
Value
name
Grupos
minOccurs
0
Usuarios
Declara un conjunto de usuarios como entidades de seguridad, a las que se puede hacer referencia en las directivas.
Describe la configuración de diagnóstico de los componentes de este manifiesto del servicio.
Atributo
Value
content
1 elemento, 0 atributos
definido
globalmente
name
ServiceDiagnosticsType
Origen 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>
Detalles del elemento de contenido
ETW
Describe la configuración de ETW para los componentes de este manifiesto del servicio.
Atributo
Value
name
ETW
minOccurs
0
ServiceFabricRuntimeAccessPolicyType complexType
Atributo
Value
content
0 elemento(s), 2 atributo(s)
definido
globalmente
name
ServiceFabricRuntimeAccessPolicyType
Origen 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>
Detalles de atributos
RemoveServiceFabricRuntimeAccess
Indica si la información específica del Runtime de Fabric debe exponerse a los paquetes de código en el paquete de servicio.
Atributo
Value
name
RemoveServiceFabricRuntimeAccess
type
xs:boolean
default
false
UseServiceFabricReplicatedStore
Indica si se debe usar el almacén de bloques replicado de Service Fabric para proporcionar el volumen para los contenedores en el paquete de servicio.
Atributo
Value
name
UseServiceFabricReplicatedStore
type
xs:boolean
default
false
ServiceGroupMemberType complexType
Atributo
Value
content
1 elemento, 2 atributos
definido
globalmente
name
ServiceGroupMemberType
Origen 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>
Detalles de atributos
ServiceTypeName
Tipo del miembro del grupo de servicios.
Atributo
Value
name
ServiceTypeName
use
requerido
Nombre
Nombre del miembro del grupo de servicios relativo al nombre del grupo de servicios.
Atributo
Value
name
Nombre
use
requerido
Detalles del elemento de contenido
LoadMetrics
Carga las métricas notificadas por este servicio.
Atributo
Value
name
LoadMetrics
minOccurs
0
ServiceGroupTypeType complexType
Tipo base que describe un elemento ServiceGroupType con estado o sin estado.
Atributo
Value
content
4 elementos, 2 atributos
definido
globalmente
name
ServiceGroupTypeType
Origen 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>
Detalles de atributos
ServiceGroupTypeName
Identificador de tipo definido por el usuario para un grupo de servicios, por ejemplo, "ActorQueueSGType". Este valor se utiliza en el archivo ApplicationManifest.xml para identificar el grupo de servicios.
Atributo
Value
name
ServiceGroupTypeName
use
requerido
UseImplicitFactory
Especifica si la instancia del grupo de servicios se crea con el generador implícito. En caso de que sea false (valor predeterminado), uno de los paquetes de código debe registrar el generador del grupo de servicios.
Atributo
Value
name
UseImplicitFactory
type
xs:boolean
use
opcional
Detalles del elemento de contenido
LoadMetrics
Carga las métricas notificadas por este servicio.
Atributo
Value
name
LoadMetrics
minOccurs
0
PlacementConstraints
Restricciones para la colocación de los servicios que forman parte de este paquete.
Atributo
Value
name
PlacementConstraints
type
xs:string
minOccurs
0
ServiceGroupMembers
Tipos de miembros de este tipo de grupo de servicio.
Atributo
Value
name
ServiceGroupMembers
minOccurs
0
maxOccurs
1
None
Atributo
Value
ref
Extensiones
minOccurs
0
ServiceManifestImportPoliciesType complexType
Describe las directivas (enlace de punto de conexión, uso compartido de paquetes, ejecutar como y acceso de seguridad) que se van a aplicar en el manifiesto de servicio importado.
Atributo
Value
content
11 elementos, 0 atributos
definido
globalmente
name
ServiceManifestImportPoliciesType
Origen 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>
Importa el manifiesto de servicio por referencia. Actualmente el archivo de manifiesto de servicio (ServiceManifest.xml) debe estar presente en el paquete de compilación.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
ServiceManifestRefType
Origen 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>
ServiceManifestType complexType
Describe mediante declaración el tipo de servicio y la versión. Enumera los paquetes de código, configuración y datos que se pueden actualizar de manera independiente que, juntos, constituyen un paquete de servicio para admitir uno o más tipos de servicio. También se especifican los recursos, la configuración de diagnóstico y los metadatos de servicio, como el tipo de servicio, las propiedades de mantenimiento y las métricas de equilibrio de carga.
Atributo
Value
content
7 elementos, 1 atributo
definido
globalmente
name
ServiceManifestType
Origen 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>
Detalles de atributos
ManifestId
Identificador de este manifiesto de servicio, una cadena no estructurada.
Atributo
Value
name
ManifestId
use
opcional
default
type
xs:string
Detalles del elemento de contenido
Descripción
Texto que describe este servicio.
Atributo
Value
name
Description
type
xs:string
minOccurs
0
ServiceTypes
Define los tipos de servicios que son compatibles con CodePackage en este manifiesto. Cuando se crea una instancia de un servicio en uno de estos tipos de servicio, todos los paquetes de código declarados en este manifiesto se activan mediante la ejecución de sus puntos de entrada. Los tipos de servicio se declaran en el nivel de manifiesto y no en el nivel de paquete de código.
<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>
Detalles de atributos
CpuCores
Límite de CPU en número de núcleos lógicos. Debe ser un entero positivo.
Atributo
Value
name
CpuCores
type
xs:string
use
opcional
default
0
MemoryInMB
Límites de la memoria en MB. Debe ser un entero positivo.
Atributo
Value
name
MemoryInMB
type
xs:string
use
opcional
default
0
ServicePackageType complexType
ServicePackage representa una unidad con control de versiones de implementación y activación. La versión de ServicePackage se determina según la versión del manifiesto y la versión de las invalidaciones.
Tipo base que define un servicio de Microsoft Azure Service Fabric.
Atributo
Value
content
5 elementos, 2 atributos
definido
globalmente
name
ServiceType
Origen 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>
Detalles de atributos
ServiceTypeName
Nombre del tipo de servicio, declarado en el manifiesto de servicio, del que se creará una instancia.
Atributo
Value
name
ServiceTypeName
use
requerido
DefaultMoveCost
Especifica el costo predeterminado del traslado de este servicio.
Atributo
Value
name
DefaultMoveCost
Detalles del elemento de contenido
LoadMetrics
Carga la métrica notificada por este servicio, usada para los servicios de equilibrio de recursos.
Atributo
Value
name
LoadMetrics
minOccurs
0
PlacementConstraints
Se usa para controlar en qué nodos del clúster se puede ejecutar un servicio. Un par clave-valor que describe el nombre de la propiedad del nodo y los requisitos del servicio del valor. Se pueden agrupar instrucciones individuales con una sencilla lógica booleana para crear la restricción necesaria. Por ejemplo, "(FirmwareVersion>12 && InDMZ == True)".
Attribute
Value
name
PlacementConstraints
type
xs:string
minOccurs
0
ServiceCorrelations
Define relaciones de afinidad entre servicios.
Atributo
Value
name
ServiceCorrelations
minOccurs
0
ServicePlacementPolicies
Declara las directivas de colocación de un servicio. Resulta útil cuando el clúster abarca distancias geográficas o regiones geopolíticas.
Atributo
Value
name
ServicePlacementPolicies
minOccurs
0
ServiceScalingPolicies
Declara las directivas de escalado de un servicio. Es útil para escalar dinámicamente el servicio según las necesidades.
Atributo
Value
name
ServiceScalingPolicies
minOccurs
0
TagsRequiredToPlace
Declara las etiquetas necesarias para la selección de ubicación de un servicio. Resulta útil para influir dinámicamente en la selección de ubicación del servicio.
Atributo
Value
name
TagsRequiredToPlace
minOccurs
0
TagRequiredToRun
Declara las etiquetas necesarias para la selección de ubicación y ejecución de un servicio. Resulta útil para influir dinámicamente en la selección de ubicación y ejecución del servicio.
<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>
Detalles de atributos
MaxPercentUnhealthyServices
Especifica el porcentaje máximo tolerado de servicios incorrectos antes de que la aplicación se considere incorrecta. Porcentaje predeterminado: 0.
Atributo
Value
name
MaxPercentUnhealthyServices
type
xs:string
use
opcional
default
0
MaxPercentUnhealthyPartitionsPerService
Especifica el porcentaje máximo tolerado de particiones incorrectas antes de que un servicio se considere incorrecto. Porcentaje predeterminado: 0.
Atributo
Value
name
MaxPercentUnhealthyPartitionsPerService
type
xs:string
use
opcional
default
0
MaxPercentUnhealthyReplicasPerPartition
Especifica el porcentaje máximo tolerado de réplicas incorrectas antes de que una partición se considere incorrecta. Porcentaje predeterminado: 0.
Atributo
Value
name
MaxPercentUnhealthyReplicasPerPartition
type
xs:string
use
opcional
default
0
ServiceTypeType complexType
Tipo base que describe un tipo de servicio con estado o sin estado.
Atributo
Value
content
4 elementos, 1 atributo
definido
globalmente
name
ServiceTypeType
Origen 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>
Detalles de atributos
ServiceTypeName
Identificador de tipo definido por el usuario para un servicio. Por ejemplo, "QueueType" o "CalculatorType". Este valor se utiliza en el archivo ApplicationManifest.xml para identificar el servicio.
Atributo
Value
name
ServiceTypeName
use
requerido
Detalles del elemento de contenido
LoadMetrics
Carga las métricas notificadas por este servicio.
Atributo
Value
name
LoadMetrics
minOccurs
0
PlacementConstraints
Se usa para controlar en qué nodos del clúster se puede ejecutar un servicio. Un par clave-valor que describe el nombre de la propiedad del nodo y los requisitos del servicio del valor. Se pueden agrupar instrucciones individuales con una sencilla lógica booleana para crear la restricción necesaria. Por ejemplo, "(FirmwareVersion>12 && InDMZ == True)".
Attribute
Value
name
PlacementConstraints
type
xs:string
minOccurs
0
ServicePlacementPolicies
Declara las directivas de colocación de un servicio. Resulta útil cuando el clúster abarca distancias geográficas o regiones geopolíticas.
Declara los valores de configuración de un manifiesto de servicio que se van a invalidar. Consta de una o más secciones de pares clave-valor. Los valores de parámetro se pueden cifrar mediante el cmdlet Invoke-ServiceFabricEncryptSecret.
Atributo
Value
content
1 elemento, 0 atributos
definido
globalmente
name
SettingsOverridesType
Origen 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>
Detalles del elemento de contenido
Sección
Una sección del archivo Settings.xml para invalidar.
Atributo
Value
name
Sección
maxOccurs
sin enlazar
SettingsType complexType
Describe la configuración definida por el usuario de un componente de servicio o una aplicación. Consta de una o más secciones de pares clave-valor.
Atributo
Value
content
1 elemento, 0 atributos
definido
globalmente
name
SettingsType
Origen 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>
Detalles del elemento de contenido
Sección
Una sección con nombre definida por el usuario.
Atributo
Value
name
Sección
minOccurs
0
maxOccurs
sin enlazar
StatefulServiceGroupType complexType
Define un grupo de servicio con estado.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
StatefulServiceGroupType
Origen 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>
StatefulServiceGroupTypeType complexType
Describe un tipo de grupo de servicio con estado.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
StatefulServiceGroupTypeType
Origen 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>
StatefulServiceType complexType
Define un servicio con estado.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
StatefulServiceType
Origen 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>
StatefulServiceTypeType complexType
Describe un tipo de servicio con estado.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
StatefulServiceTypeType
Origen 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>
StatelessServiceGroupType complexType
Define un grupo de servicio sin estado.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
StatelessServiceGroupType
Origen 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>
StatelessServiceGroupTypeType complexType
Describe un tipo de grupo de servicio sin estado.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
StatelessServiceGroupTypeType
Origen 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>
StatelessServiceType complexType
Define un servicio sin estado.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
StatelessServiceType
Origen 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>
StatelessServiceTypeType complexType
Describe un tipo de servicio sin estado.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
StatelessServiceTypeType
Origen 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>
No se admite, no debe usarse. El nombre del ensamblado no administrado (por ejemplo, Queue.dll), que se hospedará.
Atributo
Value
content
0 elementos, 0 atributos
definido
globalmente
name
UnmanagedDllType
Origen 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>
WindowsFabricDeploymentInformation complexType
Atributo
Value
content
0 elementos, 11 atributos
definido
globalmente
name
WindowsFabricDeploymentInformation
Origen 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>
Detalles de atributos
InstanceId
Esta es la instancia de destino del nodo.
Atributo
Value
name
InstanceId
type
xs:string
use
opcional
MSILocation
Esta es la ruta de acceso completa de la ubicación de MSI.
Atributo
Value
name
MSILocation
type
xs:string
use
opcional
ClusterManifestLocation
Esta es la ruta de acceso completa de la ubicación del manifiesto de clúster.
Atributo
Value
name
ClusterManifestLocation
type
xs:string
use
opcional
InfrastructureManifestLocation
Ubicación del manifiesto de infraestructura que se genera internamente.
Atributo
Value
name
InfrastructureManifestLocation
type
xs:string
use
opcional
TargetVersion
Esta es la versión de destino de la implementación.
Atributo
Value
name
TargetVersion
type
xs:string
use
opcional
NodeName
Este es el nombre del nodo donde va a tener lugar la actualización de Fabric
Atributo
Value
name
NodeName
type
xs:string
use
opcional
RemoveNodeState
Marca que indica si debe llamarse a la API RemoveNodeState después de quitar la configuración del nodo.
Atributo
Value
name
RemoveNodeState
type
xs:boolean
use
opcional
default
false
UpgradeEntryPointExe
Nombre del archivo ejecutable que utiliza el servicio de instalador para llevar a cabo la actualización.
Atributo
Value
name
UpgradeEntryPointExe
type
xs:string
use
opcional
UpgradeEntryPointExeParameters
Parámetros para el archivo ejecutable del punto de entrada del programa de instalación.
Atributo
Value
name
UpgradeEntryPointExeParameters
type
xs:string
use
opcional
UndoUpgradeEntryPointExe
Nombre del archivo ejecutable que utiliza el servicio de instalador para deshacer la actualización.
Atributo
Value
name
UndoUpgradeEntryPointExe
type
xs:string
use
opcional
UndoUpgradeEntryPointExeParameters
Parámetros para el archivo ejecutable del punto de entrada del programa de instalación.