Tipi complessi nell'XML Schema del modello di servizio
Articolo
complexType AppInstanceDefinitionType
Attributo
valore
content
1 elemento, 1 attributo
defined
a livello globale
name
AppInstanceDefinitionType
Origine 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>
Dettagli relativi agli attributi
Nome
Nome dell'applicazione da creare.
Attributo
valore
name
Nome
type
xs:string
use
Obbligatorio
Dettagli relativi agli elementi di contenuto
Parametri
Elenco dei parametri per l'applicazione, come definiti nel manifesto dell'applicazione, e dei rispettivi valori.
Attributo
valore
name
Parametri
complexType ApplicationHealthPolicyType
Descrive i criteri per valutare gli eventi di integrità segnalati per diverse entità correlate all'applicazione. Se non vengono specificati criteri, si presuppone che un'entità non sia integra se il report sull'integrità contiene un avviso o un errore.
Attributo
valore
content
2 elementi, 2 attributi
defined
a livello globale
name
ApplicationHealthPolicyType
Origine 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>
Dettagli relativi agli attributi
ConsiderWarningAsError
Specifica se considerare i report sull'integrità di tipo Warning come errori durante la valutazione dell'integrità. Valore predefinito: false.
Attributo
valore
name
ConsiderWarningAsError
type
xs:string
use
facoltative
impostazione predefinita
false
MaxPercentUnhealthyDeployedApplications
Specifica la percentuale massima tollerata di applicazioni distribuite che possono risultare non integre prima che per l'applicazione venga impostato lo stato Error. Questo valore viene calcolato dividendo il numero delle applicazioni distribuite non integre per il numero dei nodi in cui tali applicazioni sono attualmente distribuite nel cluster. Il calcolo viene arrotondato per eccesso per tollerare un errore su un numero limitato di nodi. Percentuale predefinita: 0.
Attributo
valore
name
MaxPercentUnhealthyDeployedApplications
type
xs:string
use
facoltative
impostazione predefinita
0
Dettagli relativi agli elementi di contenuto
DefaultServiceTypeHealthPolicy
Specifica i criteri di integrità predefiniti per il tipo di servizio, che sostituiranno i criteri di integrità predefiniti usati per tutti i tipi di servizio nell'applicazione.
Descrive in modo dichiarativo il tipo di applicazione e la versione. Per creare un tipo di applicazione viene fatto riferimento a uno o più manifesti di servizi costitutivi. È possibile eseguire l'override delle impostazioni di configurazione dei servizi costitutivi usando impostazioni dell'applicazione con parametri. È anche possibile dichiarare i servizi, i modelli di servizio, le entità di sicurezza, i criteri, la configurazione di diagnostica e i certificati predefiniti a livello di applicazione.
Attributo
valore
content
9 elementi, 0 attributi
defined
a livello globale
name
ApplicationManifestType
Origine 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>
Dettagli relativi agli elementi di contenuto
Descrizione
Testo che descrive l'applicazione.
Attributo
valore
name
Descrizione
type
xs:string
minOccurs
0
Parametri
Dichiara i parametri usati nel manifesto dell'applicazione. Il valore di questi parametri può essere specificato durante la creazione di un'istanza dell'applicazione e può essere usato per eseguire l'override delle impostazioni di configurazione dell'applicazione o del servizio.
Attributo
valore
name
Parametri
minOccurs
0
ServiceManifestImport
Importa un manifesto del servizio creato dallo sviluppatore di servizi. È necessario importare un manifesto del servizio per ogni servizio che costituisce l'applicazione. Per il manifesto del servizio è possibile dichiarare criteri e override di configurazione.
Attributo
valore
name
ServiceManifestImport
maxOccurs
unbounded
ServiceTemplates
Dichiara il set dei tipi di servizio consentiti che è possibile creare in modo dinamico all'interno dell'istanza dell'applicazione. Valori di configurazione predefiniti, come il fattore di replica, vengono specificati e usati come modello per creare istanze dei servizi.
Descrive i criteri (raccolta dei log, account RunAs predefinito, integrità e accesso sicuro) da applicare a livello di applicazione.
Attributo
valore
content
4 elementi, 0 attributi
defined
a livello globale
name
ApplicationPoliciesType
Origine 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>
Dettagli relativi agli elementi di contenuto
LogCollectionPolicies
Specifica se la raccolta dei log è abilitata. Funziona solo in un ambiente cluster di Azure.
Attributo
valore
name
LogCollectionPolicies
minOccurs
0
DefaultRunAsPolicy
Specifica un account utente predefinito per tutti i pacchetti di codice di servizi per cui non è definito un elemento RunAsPolicy specifico nella sezione ServiceManifestImport.
Elenco dei criteri di sicurezza applicati alle risorse a livello di applicazione.
Attributo
valore
name
SecurityAccessPolicies
minOccurs
0
complexType AzureBlobETWType
Descrive la destinazione di un archivio BLOB di Azure per gli eventi ETW. Funziona solo nell'ambiente Azure.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
AzureBlobETWType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="AzureBlobETWType">
<xs:annotation>
<xs:documentation>Describes an Azure blob store destination for ETW events. Works only in Azure environment.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="AzureBlobType">
<xs:attributeGroup ref="LevelFilter"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType AzureBlobType
Descrive la destinazione di un archivio BLOB di Azure per i dati di diagnostica. Funziona solo in ambienti cluster di Azure.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
AzureBlobType
Origine 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>
Dettagli relativi agli elementi di contenuto
ClusterCertificate
Certificato usato per proteggere le comunicazioni all'interno del cluster.
Descrive un pacchetto di codice che supporta un tipo di servizio definito. Quando viene creata un'istanza di un servizio sulla base di uno di questi tipi di servizi, tutti i pacchetti di codice dichiarati nel manifesto vengono attivati eseguendo i relativi punti di ingresso. I processi risultanti devono registrare i tipi di servizi supportati in fase di esecuzione. Quando sono presenti più pacchetti di codice, vengono tutti attivati ogni volta che il sistema cerca uno dei tipi di servizio dichiarati.
Attributo
valore
content
3 elementi, 2 attributi
defined
a livello globale
name
CodePackageType
Origine 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>
Dettagli relativi agli attributi
IsShared
Indica se il contenuto di questo pacchetto di codice è condiviso da altri pacchetti di codice. Se è true, in caso di aggiornamento di questo pacchetto di codice, tutti i pacchetti di codice verranno riavviati. Questo attributo non è attualmente supportato e il valore verrà ignorato.
Attributo
valore
name
IsShared
type
xs:boolean
impostazione predefinita
false
IsActivator
Attributo solo per uso interno.
Attributo
valore
name
IsActivator
type
xs:boolean
impostazione predefinita
false
Dettagli relativi agli elementi di contenuto
SetupEntryPoint
Punto di ingresso con privilegi che viene eseguito per impostazione predefinita con le stesse credenziali di Service Fabric (in genere l'account NETWORKSERVICE) prima di qualsiasi altro punto di ingresso. L'eseguibile specificato da EntryPoint è in genere l'host servizio a esecuzione prolungata. La presenza di un punto di ingresso di configurazione separato consente di evitare di dover eseguire l'host del servizio con privilegi elevati per lunghi periodi di tempo.
Descrive gli override di configurazione per un particolare pacchetto di configurazione nel manifesto del servizio importato.
Attributo
valore
content
1 elemento, 1 attributo
defined
a livello globale
name
ConfigOverrideType
Origine 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>
Dettagli relativi agli attributi
Nome
Nome del pacchetto di configurazione nel manifesto del servizio che contiene le impostazioni da sovrascrivere.
Dichiara una cartella, denominata dall'attributo Name, che contiene un file Settings.xml. Questo file contiene sezioni di impostazioni di coppie chiave-valore che possono essere lette dal processo in fase di esecuzione. Se durante un aggiornamento viene modificata solo la versione del pacchetto di configurazione, il processo in esecuzione non viene riavviato. Un callback piuttosto notifica al processo che le impostazioni di configurazione sono cambiate affinché vengano ricaricate in modo dinamico.
Attributo
valore
content
0 elementi, 4 attributi
defined
a livello globale
name
ConfigPackageDescriptionType
Origine 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>
Dettagli relativi agli attributi
Nome
Nome dell'elemento con versione.
Attributo
valore
name
Nome
use
Obbligatorio
SectionName
Nome della sezione del file Settings.xml ConfigPackage.
Dichiara una cartella, denominata dall'attributo Name in PackageRoot, che contiene un file Settings.xml. Questo file contiene sezioni di impostazioni di coppie chiave-valore che possono essere lette dal processo in fase di esecuzione. Se durante un aggiornamento viene modificata solo la versione del pacchetto di configurazione, il processo in esecuzione non viene riavviato. Un callback piuttosto notifica al processo che le impostazioni di configurazione sono cambiate affinché vengano ricaricate in modo dinamico.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
ConfigPackageType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ConfigPackageType">
<xs:annotation>
<xs:documentation>Declares a folder, named by the Name attribute, and PackageRoot that contains a Settings.xml file. This file contains sections of user-defined, key-value pair settings that the process can read back at run time. During an upgrade, if only the ConfigPackage version has changed, then the running process is not restarted. Instead, a callback notifies the process that configuration settings have changed so they can be reloaded dynamically.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="VersionedName"/>
</xs:complexType>
complexType ContainerCertificateType
Specifica le informazioni su un certificato X509 che deve essere esposto all'ambiente del contenitore. Questo certificato deve essere installato nell'archivio LocalMachine di tutti i nodi del cluster.
All'avvio dell'applicazione, il runtime legge il certificato e genera un file PFX e una password (in Windows) o un file PEM (in Linux).
Il file PFX e la password sono accessibili nel contenitore usando le variabili di ambiente Certificates_ServicePackageName_CodePackageName_CertName_PFX e Certificates_ServicePackageName_CodePackageName_CertName_Password. Il file PFX è accessibile nel contenitore usando le variabili di ambiente Certificates_ServicePackageName_CodePackageName_CertName_PEM e Certificates_ServicePackageName_CodePackageName_CertName_PrivateKey.
Attributo
valore
content
0 elementi, 8 attributi
defined
a livello globale
name
ContainerCertificateType
Origine 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>
Dettagli relativi agli attributi
X509StoreName
Nome dell'archivio del certificato X509.
Attributo
valore
name
X509StoreName
type
xs:string
impostazione predefinita
My
X509FindValue
Identificazione personale del certificato X509.
Attributo
valore
name
X509FindValue
type
xs:string
use
facoltative
DataPackageRef
Nome del pacchetto di dati che contiene i file di certificato.
Attributo
valore
name
DataPackageRef
type
xs:string
use
facoltative
DataPackageVersion
Versione del pacchetto di dati che contiene i file di certificato.
Attributo
valore
name
DataPackageVersion
type
xs:string
use
facoltative
RelativePath
Percorso relativo del file di certificato all'interno del pacchetto di dati.
Attributo
valore
name
RelativePath
type
xs:string
use
facoltative
Password
Password/chiave privata per il certificato.
Attributo
valore
name
Password
type
xs:string
use
facoltative
IsPasswordEncrypted
Se è true, il valore della password è crittografato.
Attributo
valore
name
IsPasswordEncrypted
type
xs:boolean
impostazione predefinita
false
Nome
Identificatore delle informazioni sul certificato specifico. Questo nome viene usato per impostare la variabile di ambiente nel contenitore.
Attributo
valore
name
Nome
type
xs:string
use
Obbligatorio
complexType ContainerHealthConfigType
Specifica le opzioni di integrazione docker HEALTHCHECK per il contenitore.
Attributo
valore
content
0 elementi, 2 attributi
defined
a livello globale
name
ContainerHealthConfigType
Origine 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>
Dettagli relativi agli attributi
IncludeDockerHealthStatusInSystemHealthReport
Se nel contenitore è abilitato il docker HEALTHCHECK che segnala l'evento relativo allo stato integrità per questo contenitore, Service Fabric lo includerà come parte del sistema che ha segnalato l'integrità. Service Fabric segnalerà un avviso di integrità se lo stato non è ritenuto integro. Per impostazione predefinita, è impostato su True.
Attributo
valore
name
IncludeDockerHealthStatusInSystemHealthReport
type
xs:boolean
use
facoltative
impostazione predefinita
true
RestartContainerOnUnhealthyDockerHealthStatus
Se nel contenitore è abilitato il docker HEALTHCHECK che segnala l'evento relativo allo stato integrità per questo contenitore, Service Fabric riavvierà il contenitore se il docker ha segnalato che lo stato non è integro.
Per impostazione predefinita, il valore è impostato su False.
Attributo
valore
name
RestartContainerOnUnhealthyDockerHealthStatus
type
xs:boolean
use
facoltative
impostazione predefinita
false
complexType ContainerHostEntryPointType
Attributo
valore
content
4 elementi, 0 attributi
defined
a livello globale
name
ContainerHostEntryPointType
Origine 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>
Passa un elenco di comandi delimitato da virgole al contenitore.
Attributo
valore
name
Comandi
type
xs:string
minOccurs
0
maxOccurs
1
EntryPoint
Attributo
valore
name
EntryPoint
type
xs:string
minOccurs
0
maxOccurs
1
FromSource
Attributo
valore
name
FromSource
type
xs:string
minOccurs
0
maxOccurs
1
complexType ContainerHostPoliciesType
Attributo
valore
content
10 elementi, 8 attributi
defined
a livello globale
name
ContainerHostPoliciesType
Origine 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>
Dettagli relativi agli attributi
CodePackageRef
Attributo
valore
name
CodePackageRef
use
Obbligatorio
UseDefaultRepositoryCredentials
Consente di usare le credenziali del repository predefinite specificate in clusterManifest.xml invece delle credenziali specificate nel tag "RepositoryCredentials" in ApplicationManifest.xml.
Attributo
valore
name
UseDefaultRepositoryCredentials
type
xs:string
use
facoltative
impostazione predefinita
false
UseTokenAuthenticationCredentials
Consente di usare l'autenticazione tramite token MSI (o un endpoint specificato personalizzato) per ottenere un token per l'autenticazione.
Attributo
valore
name
UseTokenAuthenticationCredentials
type
xs:string
use
facoltative
impostazione predefinita
false
Isolamento
Modalità di isolamento per il contenitore. I valori validi sono predefiniti, elaborano o Hyper-V (supportato solo per i contenitori Windows).
Attributo
valore
name
Isolamento
use
facoltative
type
xs:string
Hostname (Nome host)
Specificare il nome host per il contenitore.
Attributo
valore
name
Hostname (Nome host)
use
facoltative
type
xs:string
ContainersRetentionCount
Numero di contenitori da lasciare indietro quando un contenitore scade ripetutamente. Per impostazione predefinita questo elemento è impostato su 0, vale dire che nessun contenitore viene lasciato indietro.
Attributo
valore
name
ContainersRetentionCount
use
facoltative
type
xs:string
impostazione predefinita
0
AutoRemove
Flag che indica se la rimozione dei contenitori avviene automaticamente (true) o meno (false) se il contenitore viene terminato. Se false, Service Fabric rimuove manualmente i contenitori.
Attributo
valore
name
AutoRemove
use
facoltative
type
xs:string
RunInteractive
Eseguire il contenitore con il flag interattivo abilitato. I valori validi sono true/false. False è l'impostazione predefinita.
Attributo
valore
name
RunInteractive
use
facoltative
type
xs:string
Dettagli relativi agli elementi di contenuto
RepositoryCredentials
Credenziali per il repository di immagini contenitore da cui eseguire il pull di immagini.
<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>
Dettagli relativi agli attributi
EndpointRef
Nome dell'endpoint, che deve essere dichiarato nella sezione Resources nel manifesto del servizio.
Attributo
valore
name
EndpointRef
ComplexType ContainerNetworkPolicyType
Descrive l'associazione tra un pacchetto del servizio e una rete di contenitori e, facoltativamente, l'associazione tra gli endpoint del pacchetto del servizio e la rete di contenitori.
Attributo
valore
content
1 elemento, 1 attributo
defined
a livello globale
name
ContainerNetworkPolicyType
Origine 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>
Dettagli relativi agli attributi
NetworkRef
Nome della rete di contenitori (senza distinzione tra maiuscole e minuscole). Deve essere il nome di una rete di contenitori già creata o un nome riservato, tra cui "Open" o "NAT".
Attributo
valore
name
NetworkRef
use
Obbligatorio
Dettagli relativi agli elementi di contenuto
EndpointBinding
Specifica un endpoint che deve essere esposto nella rete di contenitori.
<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>
Dettagli relativi agli attributi
Origine
Cartella di origine che può essere una cartella nella macchina virtuale che ospita i contenitori o un archivio remoto persistente.
Attributo
valore
name
Source
use
Obbligatorio
Destinazione
Percorso in cui viene eseguito il mapping dell'origine all'interno del contenitore in esecuzione. La destinazione non può quindi essere un percorso già esistente all'interno del contenitore.
Attributo
valore
name
Destinazione
use
Obbligatorio
Driver
Il nome del driver per il plug-in di volume di File di Azure è "sfazurefile".
Dichiara una cartella, il cui nome è definito dall'attributo Name, in PackageRoot che contiene file di dati statici che devono essere utilizzati dal processo in fase di esecuzione. In caso di aggiornamento di uno dei pacchetti di dati elencati nel manifesto del servizio, Service Fabric riciclerà tutti i file EXE e DLLHOST specificati nei pacchetti host e per il supporto.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
DataPackageType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="DataPackageType">
<xs:annotation>
<xs:documentation>Declares a folder, named by the Name attribute, under PackageRoot which contains static data files to be consumed by the process at runtime. Service Fabric will recycle all EXEs and DLLHOSTs specified in the host and support packages when any of the data packages listed in the service manifest are upgraded.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="VersionedName"/>
</xs:complexType>
complexType DebugParametersType
Specifica le informazioni sul debugger da collegare quando si attiva il pacchetto di codice.
Punto di ingresso per i contenitori sottoposto a override per consentire l'avvio del debugger.
Attributo
valore
name
ContainerEntryPoint
type
xs:string
minOccurs
0
maxOccurs
unbounded
ContainerMountedVolume
Volumi da montare all'interno del contenitore.
Attributo
valore
name
ContainerMountedVolume
type
xs:string
minOccurs
0
maxOccurs
unbounded
ContainerEnvironmentBlock
Blocco di ambiente per i contenitori.
Attributo
valore
name
ContainerEnvironmentBlock
type
xs:string
minOccurs
0
maxOccurs
unbounded
ContainerLabel
Etichette per i contenitori nel formato key=value.
Attributo
valore
name
ContainerLabel
type
xs:string
minOccurs
0
maxOccurs
unbounded
complexType DefaultServicesType
Dichiara le istanze dei servizi create automaticamente ogni volta che viene creata un'istanza di un'applicazione sulla base di questo tipo di applicazione.
Attributo
valore
content
2 elementi, 0 attributi
defined
a livello globale
name
DefaultServicesType
Origine 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>
Dettagli relativi agli elementi di contenuto
Service
Dichiara un servizio da creare automaticamente quando viene creata un'istanza dell'applicazione.
Attributo
valore
name
Service
ServiceGroup
Raccolta di servizi che devono essere individuati automaticamente insieme, in modo da essere anche spostati insieme durante il failover o la gestione delle risorse.
Attributo
valore
name
ServiceGroup
complexType DiagnosticsType
Descrive le impostazioni di diagnostica per le applicazioni.
Attributo
valore
content
3 elementi, 0 attributi
defined
a livello globale
name
DiagnosticsType
Origine 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>
Dettagli relativi agli elementi di contenuto
CrashDumpSource
Specifica la raccolta di dump di arresto anomalo del sistema. Vengono raccolti dump di arresto anomalo del sistema per gli eseguibili che ospitano i pacchetti di codice di tutti i servizi appartenenti all'applicazione.
Attributo
valore
name
CrashDumpSource
minOccurs
0
ETWSource
Specifica la raccolta delle tracce ETW. Le tracce ETW vengono raccolte per i provider registrati da tutti i servizi appartenenti all'applicazione.
Attributo
valore
name
ETWSource
minOccurs
0
FolderSource
Specifica la raccolta del contenuto di una particolare cartella nel nodo locale.
Attributo
valore
name
FolderSource
minOccurs
0
maxOccurs
unbounded
complexType DllHostEntryPointType
Non supportato. Non usare. Il supporto dell'hosting di DLL (punto di ingresso dell'assembly) viene offerto tramite il processo FWP.exe. Service Fabric avvia Fabric Worker Process (FWP.exe) e carica l'assembly nel corso del processo di attivazione.
Attributo
valore
content
2 elementi, 1 attributo
defined
a livello globale
name
DllHostEntryPointType
Origine 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>
Dettagli relativi agli attributi
IsolationPolicy
Non supportato. Non usare. Definisce i criteri di isolamento per le DLL non gestite e gli assembly gestiti caricati in DllHost.
Opzioni del driver da passare al driver. Il plug-in di volume di File di Azure supporta le opzioni di driver seguenti: shareName (la condivisione file di File di Azure che specifica il volume per il contenitore), storageAccountName (l'account di archiviazione di Azure che contiene la condivisione file di File di Azure), storageAccountKey (la chiave di accesso per l'account di archiviazione di Azure che contiene la condivisione file di File di Azure).
Le tre opzioni del driver riportate sopra sono obbligatorie.
Attributo
valore
content
0 elementi, 4 attributi
defined
a livello globale
name
DriverOptionType
Origine 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>
Dettagli relativi agli attributi
Nome
Nome dell'opzione del driver.
Attributo
valore
name
Nome
type
xs:string
use
Obbligatorio
valore
Valore dell'opzione del driver.
Attributo
valore
name
valore
type
xs:string
use
Obbligatorio
IsEncrypted
Attributo
valore
name
IsEncrypted
type
xs:string
use
facoltative
impostazione predefinita
false
Type
Questo valore definisce la protezione del valore dell'attributo. Potrebbe trattarsi di SecretsStoreRef/Encrypted/PlainText.
Se impostato su SecretsStoreRef, il valore fa riferimento a un segreto archiviato crittografato nell'archivio protetto del cluster, che viene de-referenziato e decrittografato all'attivazione.
Se impostato su Encrypted, lo sviluppatore dell'applicazione è responsabile della creazione di un certificato e dell'uso del cmdlet Invoke-ServiceFabricEncryptSecret per crittografare le informazioni riservate.
Attributo
valore
name
Type
type
xs:string
use
facoltative
impostazione predefinita
PlainText
complexType EndpointBindingPolicyType
Attributo
valore
content
0 elementi, 2 attributi
defined
a livello globale
name
EndpointBindingPolicyType
Origine 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>
Dettagli relativi agli attributi
EndpointRef
Nome dell'endpoint, che deve essere dichiarato nella sezione Resources nel manifesto del servizio. Quando si usa HTTPS, non usare la stessa porta e lo stesso certificato per diverse istanze del servizio (indipendenti dall'applicazione) distribuite nello stesso nodo. L'aggiornamento di due servizi diversi mediante la stessa porta in istanze dell'applicazione diverse comporterà un errore di aggiornamento.
Attributo
valore
name
EndpointRef
CertificateRef
Nome del certificato dell'endpoint, dichiarato nella sezione Certificates, da restituire al client.
Attributo
valore
name
CertificateRef
use
Obbligatorio
complexType EndpointCertificateType
Specifica le informazioni su un certificato X509 usato per proteggere un endpoint.
Attributo
valore
content
0 elementi, 3 attributi
defined
a livello globale
name
EndpointCertificateType
Origine 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>
Dettagli relativi agli attributi
X509StoreName
Nome dell'archivio del certificato X509.
Attributo
valore
name
X509StoreName
type
xs:string
impostazione predefinita
My
X509FindValue
Identificazione personale del certificato X509.
Attributo
valore
name
X509FindValue
use
Obbligatorio
Nome
Attributo
valore
name
Nome
type
xs:string
use
facoltative
complexType EndpointOverrideType
Attributo
valore
content
0 elementi, 6 attributi
defined
a livello globale
name
EndpointOverrideType
Origine 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>
Dettagli relativi agli attributi
Nome
Nome dell'endpoint di cui eseguire l'override. Stringa .
Attributo
valore
name
Nome
use
Obbligatorio
Port
Numero di porta per l'endpoint. Esegue l'override del valore nel manifesto del servizio.
Attributo
valore
name
Porta
type
xs:string
Protocollo
Protocollo per l'endpoint. Esegue l'override del valore nel manifesto del servizio. Per gli endpoint HTTPS è inoltre necessario dichiarare un EndpointCertificate e un EndpointBindingPolicy nel manifesto dell'applicazione. Il protocollo non può essere modificato in un secondo momento durante un aggiornamento dell'applicazione.
Attributo
valore
name
Protocollo
type
xs:string
use
facoltative
Type
Tipo dell'endpoint. Esegue l'override del valore nel manifesto del servizio. Gli endpoint di input vengono usati per esporre la porta all'esterno, gli endpoint interni vengono usati per la comunicazione all'interno dell'applicazione.
Attributo
valore
name
Type
type
xs:string
use
facoltative
UriScheme
Schema URI, Esegue l'override del valore nel manifesto del servizio. ad esempio "http", "https" o "ftp".
Attributo
valore
name
UriScheme
use
facoltative
PathSuffix
Suffisso del percorso, ad esempio "/myapp1". Esegue l'override del valore nel manifesto del servizio.
Attributo
valore
name
PathSuffix
use
facoltative
complexType EndpointType
Definisce un endpoint per il servizio. Possono essere richieste porte specifiche. Se non viene specificata in modo esplicito una porta, ne viene assegnata una dall'intervallo di porte riservate dell'applicazione. Alle repliche del servizio eseguite in diversi nodi del cluster possono essere assegnati diversi numeri di porta, mentre le repliche dello stesso servizio eseguite nello stesso nodo condividono la stessa porta. Le porte possono essere usate dalle repliche del servizio per vari scopi, ad esempio per la replica o l'ascolto delle richieste client.
Attributo
valore
content
0 elementi, 8 attributi
defined
a livello globale
name
EndpointType
Origine 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>
Dettagli relativi agli attributi
Nome
Nome dell'endpoint.
Attributo
valore
name
Nome
use
Obbligatorio
Protocollo
Protocollo per l'endpoint: http, https, tcp o udp. Per gli endpoint HTTPS è inoltre necessario dichiarare un EndpointCertificate e un EndpointBindingPolicy nel manifesto dell'applicazione. Il protocollo non può essere modificato in un secondo momento durante un aggiornamento dell'applicazione.
Attributo
valore
name
Protocollo
use
facoltative
impostazione predefinita
tcp
Type
Tipo dell'endpoint. Gli endpoint di input vengono usati per esporre la porta all'esterno, gli endpoint interni vengono usati per la comunicazione all'interno dell'applicazione.
Attributo
valore
name
Type
use
facoltative
impostazione predefinita
Internal
CodePackageRef
Nome del pacchetto di codice che userà questo endpoint.
Attributo
valore
name
CodePackageRef
use
facoltative
CertificateRef
Da non usare. Questo attributo non è supportato.
Attributo
valore
name
CertificateRef
Port
La porta verrà sostituita con una porta specificata da Microsoft Azure Service Fabric dopo la registrazione con Http.sys o BFE.
Attributo
valore
name
Porta
UriScheme
Schema URI, ad esempio "http", "https" o "ftp".
Attributo
valore
name
UriScheme
PathSuffix
Suffisso del percorso, ad esempio "/myapp1".
Attributo
valore
name
PathSuffix
complexType EntryPointDescriptionType
L'eseguibile specificato da EntryPoint è in genere l'host servizio a esecuzione prolungata. La presenza di un punto di ingresso di configurazione separato consente di evitare di dover eseguire l'host del servizio con privilegi elevati per lunghi periodi di tempo. L'eseguibile specificato da EntryPoint viene eseguito dopo che SetupEntryPoint termina correttamente. Il processo risultante viene monitorato e riavviato (iniziando di nuovo con SetupEntryPoint) se termina o si arresta in modo anomalo.
Attributo
valore
content
3 elementi, 0 attributi
defined
a livello globale
name
EntryPointDescriptionType
Origine 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>
Dettagli relativi agli attributi
Nome
Nome della variabile di ambiente.
Attributo
valore
name
Nome
type
xs:string
use
Obbligatorio
valore
Attributo
valore
name
valore
Type
Tipo per la variabile di ambiente. Può essere PlainText/Encrypted/SecretsStoreRef.
Se impostato su SecretsStoreRef, il valore di riferimento viene recuperato da SecretStore.
Se impostato su Encrypted, lo sviluppatore dell'applicazione è responsabile della creazione di un certificato e dell'uso del cmdlet Invoke-ServiceFabricEncryptSecret per crittografare le informazioni riservate.
Attributo
valore
name
Type
use
facoltative
impostazione predefinita
PlainText
complexType EnvironmentVariablesType
Passa le variabili di ambiente al contenitore o all'eseguibile.
Attributo
valore
content
1 elemento, 0 attributi
defined
a livello globale
name
EnvironmentVariablesType
Origine 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>
Dettagli relativi agli attributi
IsExternalExecutable
True se il file eseguibile è esterno al pacchetto dell'applicazione. La verifica dell'esistenza del programma nel pacchetto dell'applicazione viene ignorata.
Attributo
valore
name
IsExternalExecutable
type
xs:boolean
impostazione predefinita
false
Dettagli relativi agli elementi di contenuto
Programma
Nome dell'eseguibile. Ad esempio, "MySetup.bat" o "MyServiceHost.exe".
Attributo
valore
name
Programma
type
xs:string
Argomenti
Attributo
valore
name
Argomenti
type
xs:string
minOccurs
0
WorkingFolder
Attributo
valore
name
WorkingFolder
impostazione predefinita
Lavoro
minOccurs
0
ConsoleRedirection
Avviso Non usare il reindirizzamento della console in un'applicazione di produzione, ma solo per attività di sviluppo e debug in locale. Reindirizza l'output della console dallo script di avvio a un file di output nella cartella dell'applicazione denominata "log" nel nodo del cluster in cui viene distribuita ed eseguita l'applicazione.
Attributo
valore
name
ConsoleRedirection
minOccurs
0
complexType ExtensionsType
Descrive le estensioni che è possibile applicare ad altri elementi.
Attributo
valore
content
1 elemento, 0 attributi
defined
a livello globale
name
ExtensionsType
Origine 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>
Dettagli relativi agli elementi di contenuto
Estensione
Attributo
valore
name
Estensione
minOccurs
0
maxOccurs
unbounded
complexType FabricCertificateType
Specifica le informazioni sul certificato.
Attributo
valore
content
0 elementi, 5 attributi
defined
a livello globale
name
FabricCertificateType
Origine 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>
Dettagli relativi agli attributi
X509StoreName
Nome dell'archivio del certificato X509.
Attributo
valore
name
X509StoreName
type
xs:string
impostazione predefinita
My
X509FindType
Viene usato solo quando la credenziale è X509. Specifica come trovare il certificato, ovvero in base al nome o all'identificazione personale.
Attributo
valore
name
X509FindType
impostazione predefinita
FindByThumbprint
X509FindValue
Viene usato solo quando la credenziale è X509. Si tratta del nome effettivo o dell'identificazione personale effettiva del certificato.
Attributo
valore
name
X509FindValue
use
Obbligatorio
X509FindValueSecondary
Viene usato solo quando la credenziale è X509. Si tratta del nome effettivo o dell'identificazione personale effettiva del certificato.
<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>
Dettagli relativi agli elementi di contenuto
SharedLogFilePath
Definisce il percorso del log condiviso.
Attributo
valore
name
SharedLogFilePath
minOccurs
0
SharedLogFileId
GUID specifico da usare come ID log condiviso.
Attributo
valore
name
SharedLogFileId
minOccurs
0
SharedLogFileSizeInMB
Definisce le dimensioni del log condiviso.
Attributo
valore
name
SharedLogFileSizeInMB
minOccurs
0
complexType FabricNodeType
Descrive un nodo di Microsoft Azure Service Fabric.
Attributo
valore
content
0 elementi, 6 attributi
defined
a livello globale
name
FabricNodeType
Origine 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>
Dettagli relativi agli attributi
NodeName
Nome dell'istanza del nodo.
Attributo
valore
name
NodeName
type
xs:string
use
Obbligatorio
IPAddressOrFQDN
Indirizzo IP o nome FQDN del computer in cui inserire questo nodo.
Attributo
valore
name
IPAddressOrFQDN
type
xs:string
use
Obbligatorio
IsSeedNode
Flag che indica se il nodo è o meno un nodo di inizializzazione.
Attributo
valore
name
IsSeedNode
type
xs:boolean
impostazione predefinita
false
NodeTypeRef
Nome del tipo di nodo definito nella sezione NodeTypes.
Attributo
valore
name
NodeTypeRef
type
xs:string
use
Obbligatorio
FaultDomain
Dominio di errore di questo nodo.
Attributo
valore
name
FaultDomain
type
xs:anyURI
use
facoltative
UpgradeDomain
Dominio di aggiornamento di questo nodo.
Attributo
valore
name
UpgradeDomain
type
xs:anyURI
use
facoltative
complexType FileStoreETWType
Descrive la destinazione di un archivio file per gli eventi ETW. Funziona solo in ambienti locali.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
FileStoreETWType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="FileStoreETWType">
<xs:annotation>
<xs:documentation>Describes a file store destination for ETW events. Works only in on-premises environment.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="FileStoreType">
<xs:attributeGroup ref="LevelFilter"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType FileStoreType
Descrive la destinazione di un archivio file per i dati di diagnostica. Funziona solo in un ambiente cluster autonomo.
Attributo
valore
content
1 elemento, 2 attributi
defined
a livello globale
name
FileStoreType
Origine 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>
Dettagli relativi agli attributi
AccountType
Specifica il tipo di account.
Attributo
valore
name
AccountType
type
xs:string
PasswordEncrypted
Specifica se la password è crittografata o in testo normale.
Attributo
valore
name
PasswordEncrypted
type
xs:string
Dettagli relativi agli elementi di contenuto
None
Attributo
valore
ref
Parametri
minOccurs
0
complexType ImageOverridesType
I contenitori di Windows Server potrebbero non essere compatibili nelle diverse versioni del sistema operativo. È possibile specificare più immagini del sistema operativo per ogni contenitore e contrassegnarle con le versioni della build del sistema operativo. Ottenere la versione della build del sistema operativo eseguendo "winver" al prompt dei comandi di Windows. Se la versione della build del sistema operativo sottostante è 16299 (Windows Server versione 1709), Service Fabric seleziona l'immagine del contenitore contrassegnata da Os="16299". Si presuppone che se un'immagine contenitore non è contrassegnata possa funzionare in tutte le versioni del sistema operativo e possa eseguire l'override dell'immagine specificata nel manifesto del servizio.
Attributo
valore
content
1 elemento, 0 attributi
defined
a livello globale
name
ImageOverridesType
Origine 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>
Dettagli relativi agli elementi di contenuto
Immagine
Immagine del contenitore corrispondente al numero di versione della build del sistema operativo da avviare. Se l'attributo del sistema operativo non è specificato, si presuppone che l'immagine del contenitore possa funzionare in tutte le versioni del sistema operativo ed eseguire l'override dell'immagine specificata nel manifesto del servizio.
<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>
Dettagli relativi agli attributi
Nome
Nome dell'immagine del contenitore.
Attributo
valore
name
Nome
type
xs:string
use
Obbligatorio
Sistema operativo
Versione della build del sistema operativo, ad esempio, la versione della build della versione di Windows Server 1709 è 16299.
Attributo
valore
name
Sistema operativo
type
xs:string
use
facoltative
complexType InfrastructureInformationType
Contiene le informazioni sull'infrastruttura per il cluster di Microsoft Azure Service Fabric.
Attributo
valore
content
1 elemento, 0 attributi
defined
a livello globale
name
InfrastructureInformationType
Origine 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>
Dettagli relativi agli elementi di contenuto
NodeList
Attributo
valore
name
NodeList
complexType InfrastructureNodeType
Descrive le informazioni sull'infrastruttura necessarie.
Attributo
valore
content
2 elementi, 7 attributi
defined
a livello globale
name
InfrastructureNodeType
Origine 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>
Dettagli relativi agli attributi
NodeName
Nome dell'istanza del nodo.
Attributo
valore
name
NodeName
type
xs:string
use
Obbligatorio
IPAddressOrFQDN
Indirizzo IP o nome FQDN del computer in cui inserire questo nodo.
Attributo
valore
name
IPAddressOrFQDN
type
xs:string
use
Obbligatorio
RoleOrTierName
Nome del ruolo che si collega al riferimento del tipo di nodo definito nella sezione NodeTypes.
Attributo
valore
name
RoleOrTierName
type
xs:string
use
Obbligatorio
NodeTypeRef
Nome del tipo di nodo definito nella sezione NodeTypes.
Attributo
valore
name
NodeTypeRef
type
xs:string
use
Obbligatorio
IsSeedNode
Indica se il nodo è un nodo di inizializzazione.
Attributo
valore
name
IsSeedNode
type
xs:boolean
use
facoltative
impostazione predefinita
false
FaultDomain
Dominio di errore di questo nodo.
Attributo
valore
name
FaultDomain
type
xs:anyURI
use
facoltative
UpgradeDomain
Dominio di aggiornamento di questo nodo.
Attributo
valore
name
UpgradeDomain
type
xs:anyURI
use
facoltative
Dettagli relativi agli elementi di contenuto
Endpoint
Descrive gli endpoint associati a questo tipo di nodo.
Risorsa per cui il servizio deve essere bilanciato, come utilizzo di CPU o memoria. Include informazioni sulla quantità della risorsa che viene utilizzata per impostazione predefinita da ogni replica o istanza del servizio.
Attributo
valore
content
0 elementi, 5 attributi
defined
a livello globale
name
LoadMetricType
Origine 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>
Dettagli relativi agli attributi
Nome
Identificatore univoco per la metrica all'interno del cluster dalla prospettiva di Gestione risorse cluster.
Attributo
valore
name
Nome
use
Obbligatorio
DefaultLoad
Quantità predefinita di carico creata dal servizio senza stato per questa metrica.
Attributo
valore
name
DefaultLoad
type
xs:long
use
facoltative
impostazione predefinita
0
PrimaryDefaultLoad
Quantità predefinita di carico usata da questo servizio per questa metrica quando si tratta di una replica primaria.
Attributo
valore
name
PrimaryDefaultLoad
type
xs:long
use
facoltative
impostazione predefinita
0
SecondaryDefaultLoad
Quantità predefinita di carico usata da questo servizio per questa metrica quando si tratta di una replica secondaria.
Attributo
valore
name
SecondaryDefaultLoad
type
xs:long
use
facoltative
impostazione predefinita
0
Peso
Determina il peso della metrica in relazione alle altre metriche configurate per questo servizio. Durante la fase di esecuzione, se due metriche entrano in conflitto, Gestione risorse cluster sceglie la metrica con il peso maggiore. Il valore zero disattiva il bilanciamento del carico per questa metrica.
Attributo
valore
name
Weight
complexType LocalStoreETWType
Descrive una destinazione di archiviazione nel nodo per gli eventi ETW.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
LocalStoreETWType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="LocalStoreETWType">
<xs:annotation>
<xs:documentation>Describes a store destination within the node for ETW events.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="LocalStoreType">
<xs:attributeGroup ref="LevelFilter"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType LocalStoreType
Descrive una destinazione di archiviazione nel nodo per i dati di diagnostica.
Attributo
valore
content
1 elemento, 0 attributi
defined
a livello globale
name
LocalStoreType
Origine 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>
Dettagli relativi agli elementi di contenuto
None
Attributo
valore
ref
Parametri
minOccurs
0
complexType LogicalDirectoryType
Descrive un tipo di directory logica.
Attributo
valore
content
0 elementi, 3 attributi
defined
a livello globale
name
LogicalDirectoryType
Origine 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>
Dettagli relativi agli attributi
LogicalDirectoryName
Nome della directory logica.
Attributo
valore
name
LogicalDirectoryName
type
xs:string
use
Obbligatorio
MappedTo
Percorso della directory logica.
Attributo
valore
name
MappedTo
type
xs:string
use
Obbligatorio
Contesto
Attributo
valore
name
Contesto
use
facoltative
impostazione predefinita
applicazione
complexType ManagedAssemblyType
Non supportato. Non usare. Nome dell'assembly gestito da ospitare (ad esempio, Queue.dll).
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
ManagedAssemblyType
Origine 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>
ComplexType NetworkPoliciesType
Descrive i criteri di rete, inclusi i criteri di rete dei contenitori per il pacchetto del servizio.
Attributo
valore
content
1 elemento, 0 attributi
defined
a livello globale
name
NetworkPoliciesType
Origine 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>
Dettagli relativi agli elementi di contenuto
ContainerNetworkPolicy
Descrive i criteri di rete dei contenitori per il pacchetto del servizio.
Indica se un pacchetto di codice, di configurazione o di dati deve essere condiviso tra le istanze del servizio dello stesso tipo di servizio.
Attributo
valore
content
0 elementi, 2 attributi
defined
a livello globale
name
PackageSharingPolicyType
Origine 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>
Dettagli relativi agli attributi
PackageRef
Nome del pacchetto di codice, configurazione o dati da condividere. Deve corrispondere al nome del pacchetto definito nel manifesto del servizio.
Attributo
valore
name
PackageRef
Ambito
Attributo
valore
name
Ambito
impostazione predefinita
None
complexType ParameterType
Attributo
valore
content
0 elementi, 1 attributo
defined
a livello globale
name
ParameterType
Origine 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>
Dettagli relativi agli attributi
IsEncrypted
Se è true, il valore di questo parametro è crittografato.
<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>
Dettagli relativi agli attributi
PasswordEncrypted
Specifica se la password è crittografata o in testo normale. Questo attributo è deprecato. Usare l'attributo "Type" per indicare una password crittografata.
Attributo
valore
name
PasswordEncrypted
type
xs:boolean
use
facoltative
E-mail
Attributo
valore
name
E-mail
Type
Questo valore definisce il tipo di password specificato nell'attributo 'Password'. Può essere SecretsStoreRef/Encrypted/PlainText.
Se impostato su SecretsStoreRef, il valore di riferimento viene recuperato da SecretStore.
Se impostato su Encrypted, lo sviluppatore dell'applicazione è responsabile della creazione di un certificato e dell'uso del cmdlet Invoke-ServiceFabricEncryptSecret per crittografare le informazioni riservate.
Attributo
valore
name
Type
type
xs:string
use
facoltative
complexType ResourceGovernancePolicyType
Limita le risorse che possono essere usate nell'host e dichiara i limiti delle risorse per un pacchetto di codice del servizio.
Attributo
valore
content
0 elementi, 12 attributi
defined
a livello globale
name
ResourceGovernancePolicyType
Origine 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>
Dettagli relativi agli attributi
CodePackageRef
Attributo
valore
name
CodePackageRef
use
Obbligatorio
MemoryInMB
Limite della memoria espresso in MB. Deve essere un intero positivo. I pacchetti di codice (contenitori o pacchetti) non sono in grado di allocare una quantità di memoria superiore a questo limite. Un'operazione di questo tipo genererebbe un'eccezione di memoria esaurita.
Attributo
valore
name
MemoryInMB
type
xs:string
use
facoltative
impostazione predefinita
0
MemorySwapInMB
Quantità totale di memoria di scambio che è possibile usare, espressa in MB. Deve essere un intero positivo.
Attributo
valore
name
MemorySwapInMB
type
xs:string
use
facoltative
impostazione predefinita
0
MemoryReservationInMB
Limite flessibile (in MB) per la governance della memoria che viene applicato solo quando si verificano problemi di contesa della memoria sul nodo. Deve essere un intero positivo.
Attributo
valore
name
MemoryReservationInMB
type
xs:string
use
facoltative
impostazione predefinita
0
CpuShares
Peso relativo della CPU. Deve essere un intero positivo.
Attributo
valore
name
CpuShares
type
xs:string
use
facoltative
impostazione predefinita
0
CpuPercent
Percentuale utilizzabile di CPU disponibili (solo Windows). Deve essere un intero positivo. Se vengono specificati dei limiti di CPU per il pacchetto del servizio, questo parametro viene ignorato.
Attributo
valore
name
CpuPercent
type
xs:string
use
facoltative
impostazione predefinita
0
MaximumIOps
Velocità massima di I/O (lettura e scrittura) in termini di operazioni di I/O al secondo che è possibile usare. Deve essere un intero positivo.
Attributo
valore
name
MaximumIOps
type
xs:string
use
facoltative
impostazione predefinita
0
MaximumIOBandwidth
Valore massimo di I/O (byte al secondo) che può essere usato (lettura e scrittura). Deve essere un intero positivo.
Attributo
valore
name
MaximumIOBandwidth
type
xs:string
use
facoltative
impostazione predefinita
0
BlockIOWeight
Peso di I/O del blocco rispetto ad altri pacchetto di codice. Deve essere un intero positivo compreso tra 10 e 1000.
Attributo
valore
name
BlockIOWeight
type
xs:string
use
facoltative
impostazione predefinita
0
DiskQuotaInMB
Quota del disco per i contenitori. Deve essere un intero positivo.
Attributo
valore
name
DiskQuotaInMB
type
xs:string
use
facoltative
impostazione predefinita
0
KernelMemoryInMB
Limiti della memoria kernel in byte. Deve essere un intero positivo. Questo valore è specifico di Linux e se impostato in Docker in Windows causa un errore.
Attributo
valore
name
KernelMemoryInMB
type
xs:string
use
facoltative
impostazione predefinita
0
ShmSizeInMB
Dimensioni di /dev/shm in byte. Se il valore viene omesso, il sistema usa 64 MB. Deve essere un intero positivo. Questo valore è specifico di Linux, ma se impostato in Docker non causa un errore. Viene semplicemente ignorato.
Attributo
valore
name
ShmSizeInMB
type
xs:string
use
facoltative
impostazione predefinita
0
complexType ResourceOverridesType
Specifica gli override di risorse per gli endpoint dichiarati nelle risorse del manifesto del servizio.
Attributo
valore
content
1 elemento, 0 attributi
defined
a livello globale
name
ResourceOverridesType
Origine 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>
Dettagli relativi agli elementi di contenuto
Endpoint
Uno o più endpoint di servizio di cui eseguire l'override.
Attributo
valore
name
Endpoint
minOccurs
0
complexType ResourcesType
Descrive le risorse usate dal servizio, che possono essere dichiarate senza modificare il codice compilato ed essere modificate quando il servizio viene distribuito. L'accesso a queste risorse è controllato tramite le sezioni Principals e Policies del manifesto dell'applicazione.
Attributo
valore
content
1 elemento, 0 attributi
defined
a livello globale
name
ResourcesType
Origine 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>
Dettagli relativi agli elementi di contenuto
Endpoint
Definisce gli endpoint per il servizio.
Attributo
valore
name
Endpoint
minOccurs
0
complexType RunAsPolicyType
Specifica l'account utente o di sistema locale con cui verrà eseguito il pacchetto di codice di un servizio. Gli account di dominio sono supportati nelle distribuzioni di Windows Server in cui è disponibile Microsoft Entra ID. Per impostazione predefinita, le applicazioni vengono eseguite con l'account con cui viene eseguito il processo Fabric.exe. Possono essere eseguite anche con altri account, che devono essere dichiarati nella sezione Principals. Se si applicano criteri RunAs a un servizio e il manifesto del servizio dichiara risorse endpoint con il protocollo HTTP, è necessario specificare anche un elemento SecurityAccessPolicy per garantire che le porte allocate a questi endpoint siano correttamente inserite nell'elenco di controllo di accesso per l'account utente RunAs con cui viene eseguito il servizio. Per un endpoint HTTPS, è necessario anche definire un elemento EndpointBindingPolicy per indicare il nome del certificato da restituire al client.
Attributo
valore
content
0 elementi, 3 attributi
defined
a livello globale
name
RunAsPolicyType
Origine 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>
Dettagli relativi agli attributi
CodePackageRef
Nome del pacchetto di codice. Deve corrispondere al nome del pacchetto di codice specificato nel manifesto del servizio.
Attributo
valore
name
CodePackageRef
use
Obbligatorio
UserRef
Account utente con cui verrà eseguito il pacchetto di codice del servizio. L'account utente deve essere dichiarato nella sezione Principals. È spesso preferibile eseguire il punto di ingresso dell'installazione usando un account di sistema locale invece di un account amministratore.
Attributo
valore
name
UserRef
use
Obbligatorio
EntryPointType
Il programma di installazione è il punto di ingresso dell'installazione dichiarato nel manifesto del servizio, il punto di ingresso con privilegi che viene eseguito prima di qualsiasi altro punto di ingresso. Main è il punto di ingresso dichiarato nel manifesto del servizio, in genere l'host del servizio a esecuzione prolungata. All indica tutti i punti di ingresso.
Attributo
valore
name
EntryPointType
use
facoltative
impostazione predefinita
Principale
complexType ScalingPolicyType
Descrizione dei criteri di ridimensionamento costituita da un trigger e un meccanismo per il ridimensionamento.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
ScalingPolicyType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ScalingPolicyType">
<xs:annotation>
<xs:documentation>A scaling policy description consisting of a trigger and a mechanism for scaling. </xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:group ref="ScalingPolicyTriggerGroup"/>
<xs:group ref="ScalingPolicyMechanismGroup"/>
</xs:sequence>
</xs:complexType>
complexType SecurityAccessPolicyType
Concede a un entità di sicurezza le autorizzazioni di accesso per una risorsa (ad esempio, un endpoint) definita in un manifesto del servizio. È in genere molto utile per controllare e limitare l'accesso dei servizi a diverse risorse e ridurre così al minimo i rischi per la sicurezza. È importante soprattutto quando l'applicazione è basata su una raccolta di servizi di un marketplace sviluppati da altri sviluppatori.
Attributo
valore
content
0 elementi, 4 attributi
defined
a livello globale
name
SecurityAccessPolicyType
Origine 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>
Dettagli relativi agli attributi
ResourceRef
Risorsa a cui si concede l'accesso a utenti o gruppi, dichiarata e configurata nel manifesto del servizio.
Attributo
valore
name
ResourceRef
use
Obbligatorio
PrincipalRef
Utente o gruppo a cui vengono assegnati i diritti di accesso a una risorsa. Deve essere dichiarato nella sezione Principals.
Attributo
valore
name
PrincipalRef
use
Obbligatorio
GrantRights
Diritti di concessione: lettura, modifica o completo. Il valore predefinito è Read.
Attributo
valore
name
GrantRights
impostazione predefinita
Lettura
ResourceType
Tipo di risorsa definito nella sezione Resources del manifesto del servizio. Può essere un endpoint o un certificato.
Descrive le entità di sicurezza (utenti o gruppi) necessarie per l'applicazione allo scopo di eseguire i servizi e proteggere le risorse. Alle entità di sicurezza viene fatto riferimento nelle sezioni dei criteri.
Attributo
valore
content
2 elementi, 0 attributi
defined
a livello globale
name
SecurityPrincipalsType
Origine 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>
Dettagli relativi agli elementi di contenuto
Gruppi
Dichiara un set di gruppi come entità di sicurezza a cui può essere fatto riferimento nei criteri. I gruppi sono utili quando sono presenti più utenti per punti di ingresso del servizio differenti che devono avere determinati privilegi comuni disponibili a livello di gruppo.
Attributo
valore
name
Gruppi
minOccurs
0
Utenti
Dichiara un set di utenti come entità di sicurezza a cui può essere fatto riferimento nei criteri.
Descrive le impostazioni di diagnostica per i componenti del manifesto del servizio.
Attributo
valore
content
1 elemento, 0 attributi
defined
a livello globale
name
ServiceDiagnosticsType
Origine 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>
Dettagli relativi agli elementi di contenuto
ETW
Descrive le impostazioni di ETW per i componenti del manifesto del servizio.
Attributo
valore
name
ETW
minOccurs
0
ComplexType ServiceFabricRuntimeAccessPolicyType
Attributo
valore
content
0 elementi, 2 attributi
defined
a livello globale
name
ServiceFabricRuntimeAccessPolicyType
Origine 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>
Dettagli relativi agli attributi
RemoveServiceFabricRuntimeAccess
Indica se le informazioni specifiche del runtime di Fabric devono essere esposte ai pacchetti di codice nel pacchetto del servizio.
Attributo
valore
name
RemoveServiceFabricRuntimeAccess
type
xs:boolean
impostazione predefinita
false
UseServiceFabricReplicatedStore
Indica se l'elemento blockstore replicato di Service Fabric deve essere usato per fornire volumi per i contenitori nel pacchetto del servizio.
Attributo
valore
name
UseServiceFabricReplicatedStore
type
xs:boolean
impostazione predefinita
false
complexType ServiceGroupMemberType
Attributo
valore
content
1 elemento, 2 attributi
defined
a livello globale
name
ServiceGroupMemberType
Origine 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>
Dettagli relativi agli attributi
ServiceTypeName
Tipo del membro del gruppo di servizi.
Attributo
valore
name
ServiceTypeName
use
Obbligatorio
Nome
Nome del membro del gruppo di servizi rispetto al nome del gruppo di servizi.
Attributo
valore
name
Nome
use
Obbligatorio
Dettagli relativi agli elementi di contenuto
LoadMetrics
Metriche di carico restituite dal servizio.
Attributo
valore
name
LoadMetrics
minOccurs
0
complexType ServiceGroupTypeType
Tipo di base che descrive un tipo di gruppo di servizi con stato o senza stato.
Attributo
valore
content
4 elementi, 2 attributi
defined
a livello globale
name
ServiceGroupTypeType
Origine 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>
Dettagli relativi agli attributi
ServiceGroupTypeName
Identificatore di tipo definito dall'utente per un gruppo di servizi, ad esempio "ActorQueueSGType". Questo valore viene usato nel file ApplicationManifest.xml per identificare il gruppo di servizi.
Attributo
valore
name
ServiceGroupTypeName
use
Obbligatorio
UseImplicitFactory
Specifica se l'istanza del gruppo di servizi viene creata dalla factory implicita. Se è false (impostazione predefinita), uno dei pacchetti di codice deve registrare la factory del gruppo di servizi.
Attributo
valore
name
UseImplicitFactory
type
xs:boolean
use
facoltative
Dettagli relativi agli elementi di contenuto
LoadMetrics
Metriche di carico restituite dal servizio.
Attributo
valore
name
LoadMetrics
minOccurs
0
PlacementConstraints
Vincoli per il posizionamento dei servizi inclusi nel pacchetto.
Attributo
valore
name
PlacementConstraints
type
xs:string
minOccurs
0
ServiceGroupMembers
Tipi di membro di questo tipo di gruppo di servizi.
Attributo
valore
name
ServiceGroupMembers
minOccurs
0
maxOccurs
1
None
Attributo
valore
ref
Estensioni
minOccurs
0
complexType ServiceManifestImportPoliciesType
Descrive i criteri (binding degli endpoint, condivisione dei pacchetti, RunAs e accesso sicuro) da applicare nel manifesto del servizio importato.
Attributo
valore
content
11 elementi, 0 attributi
defined
a livello globale
name
ServiceManifestImportPoliciesType
Origine 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 il manifesto del servizio per riferimento. Attualmente, il file manifesto del servizio (ServiceManifest.xml) deve essere incluso nel pacchetto della build.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
ServiceManifestRefType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="ServiceManifestRefType">
<xs:annotation>
<xs:documentation>Imports the service manifest by reference. Currently the service manifest file (ServiceManifest.xml) must be present in the build package.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="ServiceManifestIdentifier"/>
</xs:complexType>
complexType ServiceManifestType
Descrive in modo dichiarativo il tipo di servizio e la versione. Elenca i pacchetti di codice, di configurazione e di dati aggiornabili in modo indipendente che insieme costituiscono un pacchetto del servizio per il supporto di uno o più tipi di servizio. Vengono specificati anche le risorse, le impostazioni di diagnostica e i metadati del servizio, ad esempio il tipo di servizio, le proprietà di integrità e le metriche di bilanciamento del carico.
Attributo
valore
content
7 elementi, 1 attributo
defined
a livello globale
name
ServiceManifestType
Origine 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>
Dettagli relativi agli attributi
ManifestId
Identificatore di questo manifesto del servizio, sotto forma di stringa non strutturata.
Attributo
valore
name
ManifestId
use
facoltative
impostazione predefinita
type
xs:string
Dettagli relativi agli elementi di contenuto
Descrizione
Testo che descrive il servizio.
Attributo
valore
name
Descrizione
type
xs:string
minOccurs
0
ServiceTypes
Definisce i tipi di servizio supportati da un elemento CodePackage nel manifesto. Quando viene creata un'istanza di un servizio sulla base di uno di questi tipi di servizi, tutti i pacchetti di codice dichiarati nel manifesto vengono attivati eseguendo i relativi punti di ingresso. I tipi di servizi sono dichiarati a livello di manifesto e non a livello di pacchetto di codice.
<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>
Dettagli relativi agli attributi
CpuCores
Limite della CPU espresso in numero di core logici. Deve essere un intero positivo.
Attributo
valore
name
CpuCores
type
xs:string
use
facoltative
impostazione predefinita
0
MemoryInMB
Limite della memoria espresso in MB. Deve essere un intero positivo.
Attributo
valore
name
MemoryInMB
type
xs:string
use
facoltative
impostazione predefinita
0
complexType ServicePackageType
Il pacchetto del servizio rappresenta un'unità di distribuzione e attivazione con versione. La versione del pacchetto del servizio è determinata in base alla versione del manifesto e alla versione degli override.
Tipo di base che definisce un servizio di Microsoft Azure Service Fabric.
Attributo
valore
content
5 elementi, 2 attributi
defined
a livello globale
name
ServiceType
Origine 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>
Dettagli relativi agli attributi
ServiceTypeName
Nome del tipo di servizio, dichiarato nel manifesto del servizio, di cui verrà creata un'istanza.
Attributo
valore
name
ServiceTypeName
use
Obbligatorio
DefaultMoveCost
Specifica il costo predefinito dello spostamento per questo servizio.
Attributo
valore
name
DefaultMoveCost
Dettagli relativi agli elementi di contenuto
LoadMetrics
Metriche di carico restituite dal servizio, usate per i servizi di bilanciamento delle risorse.
Attributo
valore
name
LoadMetrics
minOccurs
0
PlacementConstraints
Viene usato per controllare in quali nodi del cluster può essere eseguito un servizio. Una coppia chiave-valore descrive il nome della proprietà del nodo e i requisiti del servizio per il valore. Le singole istruzioni possono essere raggruppate con logica booleana semplice per creare il vincolo necessario. Ad esempio, "(FirmwareVersion>12 && InDMZ == True)".
Attributo
valore
name
PlacementConstraints
type
xs:string
minOccurs
0
ServiceCorrelations
Definisce le relazioni di affinità tra i servizi.
Attributo
valore
name
ServiceCorrelations
minOccurs
0
ServicePlacementPolicies
Dichiara i criteri di posizionamento per un servizio. È utile quando il cluster copre vaste aree geografiche e/o diverse aree geopolitiche.
Attributo
valore
name
ServicePlacementPolicies
minOccurs
0
ServiceScalingPolicies
Dichiara i criteri di ridimensionamento per un servizio. Utile per ridimensionare in modo dinamico il servizio in base alle esigenze.
Attributo
valore
name
ServiceScalingPolicies
minOccurs
0
TagsRequiredToPlace
Dichiara i tag necessari per il posizionamento di un servizio. Utile per influenzare in modo dinamico il posizionamento del servizio.
Attributo
valore
name
TagsRequiredToPlace
minOccurs
0
TagRequiredToRun
Dichiara i tag necessari per il posizionamento e l'esecuzione di un servizio. Utile per influenzare in modo dinamico il posizionamento e l'esecuzione del servizio.
<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>
Dettagli relativi agli attributi
MaxPercentUnhealthyServices
Specifica la percentuale massima tollerata di servizi che possono risultare non integri prima che l'applicazione venga considerata non integra. Percentuale predefinita: 0.
Attributo
valore
name
MaxPercentUnhealthyServices
type
xs:string
use
facoltative
impostazione predefinita
0
MaxPercentUnhealthyPartitionsPerService
Specifica la percentuale massima tollerata di partizioni che possono risultare non integre prima che un servizio venga considerato non integro. Percentuale predefinita: 0.
Attributo
valore
name
MaxPercentUnhealthyPartitionsPerService
type
xs:string
use
facoltative
impostazione predefinita
0
MaxPercentUnhealthyReplicasPerPartition
Specifica la percentuale massima tollerata di repliche che possono risultare non integre prima che una partizione venga considerata non integra. Percentuale predefinita: 0.
Attributo
valore
name
MaxPercentUnhealthyReplicasPerPartition
type
xs:string
use
facoltative
impostazione predefinita
0
complexType ServiceTypeType
Tipo di base che descrive un tipo di servizio con stato o senza stato.
Attributo
valore
content
4 elementi, 1 attributo
defined
a livello globale
name
ServiceTypeType
Origine 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>
Dettagli relativi agli attributi
ServiceTypeName
Identificatore del tipo definito dall'utente per un servizio. ad esempio "QueueType" o "CalculatorType". Questo valore viene usato nel file ApplicationManifest.xml per identificare il servizio.
Attributo
valore
name
ServiceTypeName
use
Obbligatorio
Dettagli relativi agli elementi di contenuto
LoadMetrics
Metriche di carico restituite dal servizio.
Attributo
valore
name
LoadMetrics
minOccurs
0
PlacementConstraints
Viene usato per controllare in quali nodi del cluster può essere eseguito un servizio. Una coppia chiave-valore descrive il nome della proprietà del nodo e i requisiti del servizio per il valore. Le singole istruzioni possono essere raggruppate con logica booleana semplice per creare il vincolo necessario. Ad esempio, "(FirmwareVersion>12 && InDMZ == True)".
Attributo
valore
name
PlacementConstraints
type
xs:string
minOccurs
0
ServicePlacementPolicies
Dichiara i criteri di posizionamento per un servizio. È utile quando il cluster copre vaste aree geografiche e/o diverse aree geopolitiche.
Dichiara le impostazioni di configurazione di un manifesto del servizio di cui deve essere seguito l'override. Include una o più sezioni di coppie chiave-valore. I valori dei parametri possono essere crittografati con il cmdlet Invoke-ServiceFabricEncryptSecret.
Attributo
valore
content
1 elemento, 0 attributi
defined
a livello globale
name
SettingsOverridesType
Origine 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>
Dettagli relativi agli elementi di contenuto
Sezione
Sezione del file Settings.xml di cui eseguire l'override.
Attributo
valore
name
Sezione
maxOccurs
unbounded
complexType SettingsType
Descrive le impostazioni definite dall'utente per un componente del servizio o un'applicazione. Include una o più sezioni di coppie chiave-valore.
Attributo
valore
content
1 elemento, 0 attributi
defined
a livello globale
name
SettingsType
Origine 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>
Dettagli relativi agli elementi di contenuto
Sezione
Sezione denominata definita dall'utente.
Attributo
valore
name
Sezione
minOccurs
0
maxOccurs
unbounded
complexType StatefulServiceGroupType
Definisce un gruppo di servizi con stato.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
StatefulServiceGroupType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatefulServiceGroupType">
<xs:annotation>
<xs:documentation>Defines a stateful service group.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="StatefulServiceType">
<xs:sequence>
<xs:element name="Members" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Member services of this service group</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Member" type="ServiceGroupMemberType" minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType StatefulServiceGroupTypeType
Descrive un tipo di gruppo di servizi con stato.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
StatefulServiceGroupTypeType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatefulServiceGroupTypeType">
<xs:annotation>
<xs:documentation>Describes a stateful service group type.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="ServiceGroupTypeType">
<xs:attribute name="HasPersistedState" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>True if the service group has state that needs to be persisted.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType StatefulServiceType
Definisce un servizio con stato.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
StatefulServiceType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatefulServiceType">
<xs:annotation>
<xs:documentation>Defines a stateful service.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="ServiceType">
<xs:attribute name="TargetReplicaSetSize" type="xs:string" default="1">
<xs:annotation>
<xs:documentation>Desired replica set size for the partitions of this stateful service. Must be a positive integer. This is a target size; a replica set is still functional with less members. The quorum is a majority based quorum.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="MinReplicaSetSize" type="xs:string" default="1">
<xs:annotation>
<xs:documentation>Minimum number of replicas required in the replica set to allow writes. Must be positive integer less than TargetReplicaSetSize. </xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="ReplicaRestartWaitDurationSeconds" type="xs:string" use="optional" default="">
<xs:annotation>
<xs:documentation>The duration between when a replica goes down and when a new replica is created. When a persistent replica goes down, this timer starts. When it expires Service Fabric will create a new replica on any node in the cluster.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="QuorumLossWaitDurationSeconds" type="xs:string" use="optional" default="">
<xs:annotation>
<xs:documentation>The maximum duration for which a partition is allowed to be in a state of quorum loss. If the partition is still in quorum loss after this duration, the partition is recovered from quorum loss by considering the down replicas as lost. Note that this can potentially incur data loss.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="StandByReplicaKeepDurationSeconds" type="xs:string" use="optional" default="">
<xs:annotation>
<xs:documentation>How long StandBy replicas should be maintained before being removed. Sometimes a replica will be down for longer than the ReplicaRestartWaitDuration. In these cases a new replica will be built to replace it. Sometimes however the loss is not permanent and the persistent replica is eventually recovered. This now constitutes a StandBy replica.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType StatefulServiceTypeType
Descrive un tipo di servizio con stato.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
StatefulServiceTypeType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatefulServiceTypeType">
<xs:annotation>
<xs:documentation>Describes a stateful service type.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="ServiceTypeType">
<xs:attribute name="HasPersistedState" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>True if the service has state that needs to be persisted on the local disk.</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="UseImplicitHost" type="xs:boolean" default="false">
<xs:annotation>
<xs:documentation>Specifies if the service type should be implemented implicitly as a guest executable. Guest executables are used for hosting any type of applications (such as Node.js or Java) or legacy applications that do not implement the Service Fabric service interfaces.</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType StatelessServiceGroupType
Definisce un gruppo di servizi senza stato.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
StatelessServiceGroupType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatelessServiceGroupType">
<xs:annotation>
<xs:documentation>Defines a stateless service group.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="StatelessServiceType">
<xs:sequence>
<xs:element name="Members" minOccurs="1" maxOccurs="1">
<xs:annotation>
<xs:documentation>Member services of this service group</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="Member" type="ServiceGroupMemberType" minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType StatelessServiceGroupTypeType
Descrive un tipo di gruppo di servizi senza stato.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
StatelessServiceGroupTypeType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatelessServiceGroupTypeType">
<xs:annotation>
<xs:documentation>Describes a stateless service group type.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="ServiceGroupTypeType"/>
</xs:complexContent>
</xs:complexType>
complexType StatelessServiceType
Definisce un servizio senza stato.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
StatelessServiceType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="StatelessServiceType">
<xs:annotation>
<xs:documentation>Defines a stateless service.</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="ServiceType">
<xs:attribute name="InstanceCount" type="xs:string" default="1">
<xs:annotation>
<xs:documentation>Number of instances required for this stateless service (positive integer).</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:complexContent>
</xs:complexType>
complexType StatelessServiceTypeType
Descrive un tipo di servizio senza stato.
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
StatelessServiceTypeType
Origine 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>
Non supportato. Non usare. Nome dell'assembly non gestito da ospitare (ad esempio, Queue.dll).
Attributo
valore
content
0 elementi, 0 attributi
defined
a livello globale
name
UnmanagedDllType
Origine XML
<xs:complexType xmlns:xs="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/2011/01/fabric" name="UnmanagedDllType">
<xs:annotation>
<xs:documentation>Unsupported, do not use. The name of unmanaged assembly (for example, Queue.dll), to host.</xs:documentation>
</xs:annotation>
<xs:simpleContent>
<xs:extension base="xs:string"/>
</xs:simpleContent>
</xs:complexType>
complexType WindowsFabricDeploymentInformation
Attributo
valore
content
0 elementi, 11 attributi
defined
a livello globale
name
WindowsFabricDeploymentInformation
Origine 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>
Dettagli relativi agli attributi
InstanceId
Si tratta dell'istanza di destinazione del nodo.
Attributo
valore
name
InstanceId
type
xs:string
use
facoltative
MSILocation
Percorso completo della posizione dell'entità del servizio gestita.
Attributo
valore
name
MSILocation
type
xs:string
use
facoltative
ClusterManifestLocation
Percorso completo della posizione del manifesto del cluster.
Attributo
valore
name
ClusterManifestLocation
type
xs:string
use
facoltative
InfrastructureManifestLocation
Posizione del manifesto dell'infrastruttura generato internamente.
Attributo
valore
name
InfrastructureManifestLocation
type
xs:string
use
facoltative
TargetVersion
Versione di destinazione della distribuzione.
Attributo
valore
name
TargetVersion
type
xs:string
use
facoltative
NodeName
Nome del nodo in cui verrà eseguito l'aggiornamento di Fabric
Attributo
valore
name
NodeName
type
xs:string
use
facoltative
RemoveNodeState
Flag che indica se è necessario chiamare l'API RemoveNodeState dopo la rimozione della configurazione del nodo.
Attributo
valore
name
RemoveNodeState
type
xs:boolean
use
facoltative
impostazione predefinita
false
UpgradeEntryPointExe
Nome del file con estensione exe usato dal servizio di installazione per eseguire l'aggiornamento.
Attributo
valore
name
UpgradeEntryPointExe
type
xs:string
use
facoltative
UpgradeEntryPointExeParameters
Parametri del file con estensione exe del punto di ingresso dell'installazione.
Attributo
valore
name
UpgradeEntryPointExeParameters
type
xs:string
use
facoltative
UndoUpgradeEntryPointExe
Nome del file con estensione exe usato dal servizio di installazione per annullare l'aggiornamento.
Attributo
valore
name
UndoUpgradeEntryPointExe
type
xs:string
use
facoltative
UndoUpgradeEntryPointExeParameters
Parametri del file con estensione exe del punto di ingresso dell'installazione.