Clústeres Microsoft.ServiceFabric 2016-09-01
Definición de recursos de Bicep
El tipo de recurso de clústeres se puede implementar con operaciones destinadas a:
- grupos de recursos: consulte comandos de implementación de grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.ServiceFabric/clusters, agregue lo siguiente a la plantilla de Bicep.
resource symbolicname 'Microsoft.ServiceFabric/clusters@2016-09-01' = {
location: 'string'
name: 'string'
properties: {
azureActiveDirectory: {
clientApplication: 'string'
clusterApplication: 'string'
tenantId: 'string'
}
certificate: {
thumbprint: 'string'
thumbprintSecondary: 'string'
x509StoreName: 'string'
}
clientCertificateCommonNames: [
{
certificateCommonName: 'string'
certificateIssuerThumbprint: 'string'
isAdmin: bool
}
]
clientCertificateThumbprints: [
{
certificateThumbprint: 'string'
isAdmin: bool
}
]
clusterCodeVersion: 'string'
diagnosticsStorageAccountConfig: {
blobEndpoint: 'string'
protectedAccountKeyName: 'string'
queueEndpoint: 'string'
storageAccountName: 'string'
tableEndpoint: 'string'
}
fabricSettings: [
{
name: 'string'
parameters: [
{
name: 'string'
value: 'string'
}
]
}
]
managementEndpoint: 'string'
nodeTypes: [
{
applicationPorts: {
endPort: int
startPort: int
}
capacities: {
{customized property}: 'string'
}
clientConnectionEndpointPort: int
durabilityLevel: 'string'
ephemeralPorts: {
endPort: int
startPort: int
}
httpGatewayEndpointPort: int
isPrimary: bool
name: 'string'
placementProperties: {
{customized property}: 'string'
}
reverseProxyEndpointPort: int
vmInstanceCount: int
}
]
reliabilityLevel: 'string'
reverseProxyCertificate: {
thumbprint: 'string'
thumbprintSecondary: 'string'
x509StoreName: 'string'
}
upgradeDescription: {
deltaHealthPolicy: {
maxPercentDeltaUnhealthyApplications: int
maxPercentDeltaUnhealthyNodes: int
maxPercentUpgradeDomainDeltaUnhealthyNodes: int
}
forceRestart: bool
healthCheckRetryTimeout: 'string'
healthCheckStableDuration: 'string'
healthCheckWaitDuration: 'string'
healthPolicy: {
maxPercentUnhealthyApplications: int
maxPercentUnhealthyNodes: int
}
overrideUserUpgradePolicy: bool
upgradeDomainTimeout: 'string'
upgradeReplicaSetCheckTimeout: 'string'
upgradeTimeout: 'string'
}
upgradeMode: 'string'
vmImage: 'string'
}
tags: {
{customized property}: 'string'
}
}
Valores de propiedad
AzureActiveDirectory
Nombre | Descripción | Valor |
---|---|---|
clientApplication | Identificador de aplicación cliente de Azure Active Directory | cuerda |
clusterApplication | Identificador de aplicación del clúster de Azure Active Directory | cuerda |
tenantId | Identificador de inquilino de Azure Active Directory | cuerda |
CertificateDescription
Nombre | Descripción | Valor |
---|---|---|
Huella digital | Huella digital del certificado principal | string (obligatorio) |
thumbprintSecondary | Huella digital del certificado secundario | cuerda |
x509StoreName | Ubicación del almacén de certificados local | 'AddressBook' 'AuthRoot' "CertificateAuthority" 'No permitido' "Mi" 'Raíz' 'TrustedPeople' "TrustedPublisher" |
ClientCertificateCommonName
Nombre | Descripción | Valor |
---|---|---|
certificateCommonName | Nombre común del certificado al que se va a conceder acceso; tenga cuidado de usar nombres comunes de caracteres comodín | string (obligatorio) |
certificateIssuerThumbprint | Huella digital del emisor de certificados | string (obligatorio) |
isAdmin | Es este certificado que se usa para el acceso de administrador desde el cliente, si es false, se usa o solo consulta el acceso. | bool (obligatorio) |
ClientCertificateThumbprint
Nombre | Descripción | Valor |
---|---|---|
certificateThumbprint | Huella digital del certificado | string (obligatorio) |
isAdmin | Es este certificado que se usa para el acceso de administrador desde el cliente, si es false, se usa o solo consulta el acceso | bool (obligatorio) |
ClusterHealthPolicy
Nombre | Descripción | Valor |
---|---|---|
maxPercentUnhealthyApplications | Porcentaje máximo permitido de aplicaciones incorrectas antes de notificar un error. Por ejemplo, para permitir que 10% de aplicaciones sean incorrectos, este valor sería 10. | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
maxPercentUnhealthyNodes | Porcentaje máximo permitido de nodos incorrectos antes de notificar un error. Por ejemplo, para permitir que 10% de nodos sean incorrectos, este valor sería 10. | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
ClusterProperties
Nombre | Descripción | Valor |
---|---|---|
azureActiveDirectory | Configuración para habilitar la autenticación de AAD en el clúster | azureActiveDirectory |
certificado | Este certificado principal se usará como nodo de clúster para la seguridad del nodo, el certificado SSL para el punto de conexión de administración de clústeres y el cliente de administración predeterminado. | certificateDescription |
clientCertificateCommonNames | Lista de certificados de cliente para confiar en función de nombres comunes | ClientCertificateCommonName[] |
clientCertificateThumbprints | Los detalles de la huella digital del cliente , se usan para el acceso de cliente para la operación del clúster. | clientCertificateThumbprint[] |
clusterCodeVersion | La versión de código de ServiceFabric que se ejecuta en el clúster | cuerda |
diagnosticsStorageAccountConfig | Detalles de configuración de la cuenta de diagnóstico de almacenamiento | DiagnosticsStorageAccountConfig |
fabricSettings | Lista de opciones de tejido personalizadas para configurar el clúster. | SettingsSectionDescription[] |
managementEndpoint | Punto de conexión de administración http del clúster | string (obligatorio) |
nodeTypes | Lista de tipos de nodo que componen el clúster | nodeTypeDescription[] (obligatorio) |
reliabilityLevel | El nivel de confiabilidad del clúster indica el tamaño del conjunto de réplicas del servicio del sistema. | 'Bronce' 'Oro' 'Platinum' 'Plata' |
reverseProxyCertificate | El certificado de servidor usado por el proxy inverso | certificateDescription |
upgradeDescription | Directiva que se va a usar al actualizar el clúster. | ClusterUpgradePolicy |
upgradeMode | El modo de actualización del clúster indica si el sistema inicia automáticamente la actualización del tejido. | 'Automático' 'Manual' |
vmImage | El nombre de vm image VMSS se ha configurado con. Se pueden usar nombres genéricos como Windows o Linux. | cuerda |
ClusterUpgradeDeltaHealthPolicy
Nombre | Descripción | Valor |
---|---|---|
maxPercentDeltaUnhealthyApplications | Porcentaje adicional de aplicaciones incorrectas | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 (obligatorio) |
maxPercentDeltaUnhealthyNodes | Porcentaje de nodos incorrectos adicionales | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 (obligatorio) |
maxPercentUpgradeDomainDeltaUnhealthyNodes | Porcentaje de nodos incorrectos adicionales por dominio de actualización | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 (obligatorio) |
ClusterUpgradePolicy
Nombre | Descripción | Valor |
---|---|---|
deltaHealthPolicy | Directiva de mantenimiento delta | clusterUpgradeDeltaHealthPolicy |
forceRestart | Forzar que el nodo se reinicie o no | Bool |
healthCheckRetryTimeout | El período de tiempo que las comprobaciones de estado pueden producir errores continuamente, representa .Net TimeSpan. | string (obligatorio) |
healthCheckStableDuration | El período de tiempo que las comprobaciones de estado deben pasar continuamente, representa .Net TimeSpan. | string (obligatorio) |
healthCheckWaitDuration | El período de tiempo que debe esperar después de completar un dominio de actualización antes de realizar comprobaciones de estado, representa .Net TimeSpan. | string (obligatorio) |
healthPolicy | Directiva de mantenimiento del clúster | ClusterHealthPolicy (obligatorio) |
overrideUserUpgradePolicy | Usar la directiva de actualización definida por el usuario o no | Bool |
upgradeDomainTimeout | El tiempo de espera de cualquier dominio de actualización, representa .Net TimeSpan. | string (obligatorio) |
upgradeReplicaSetCheckTimeout | Tiempo de espera para que se complete la actualización del conjunto de réplicas, representa .Net TimeSpan. | string (obligatorio) |
upgradeTimeout | El tiempo de espera de actualización representa .Net TimeSpan. | string (obligatorio) |
DiagnosticsStorageAccountConfig
Nombre | Descripción | Valor |
---|---|---|
blobEndpoint | Punto de conexión de blob de la cuenta de almacenamiento de diagnóstico | string (obligatorio) |
protectedAccountKeyName | Nombre de clave de almacenamiento de diagnóstico protegido | string (obligatorio) |
queueEndpoint | Punto de conexión de cola de la cuenta de almacenamiento de diagnóstico | string (obligatorio) |
storageAccountName | Nombre de la cuenta de almacenamiento de diagnósticos | string (obligatorio) |
tableEndpoint | Punto de conexión de tabla de la cuenta de almacenamiento de diagnóstico | string (obligatorio) |
EndpointRangeDescription
Nombre | Descripción | Valor |
---|---|---|
endPort | Puerto final de un intervalo de puertos | int (obligatorio) |
startPort | Puerto inicial de un intervalo de puertos | int (obligatorio) |
Microsoft.ServiceFabric/clusters
Nombre | Descripción | Valor |
---|---|---|
ubicación | Ubicación del recurso. | string (obligatorio) |
nombre | El nombre del recurso | string (obligatorio) |
Propiedades | Propiedades del recurso de clúster | clusterProperties de |
Etiquetas | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
NodeTypeDescription
Nombre | Descripción | Valor |
---|---|---|
applicationPorts | Puertos usados por las aplicaciones | endpointRangeDescription de |
Capacidades | Las etiquetas de capacidad aplicadas a los nodos del tipo de nodo, el administrador de recursos de clúster usa estas etiquetas para comprender la cantidad de un recurso que tiene un nodo. | nodeTypeDescriptionCapacities |
clientConnectionEndpointPort | Puerto de punto de conexión de administración de clústeres TCP | int (obligatorio) |
durabilityLevel | Nivel de durabilidad del tipo de nodo | 'Bronce' 'Oro' 'Plata' |
ephemeralPorts | Puertos de aplicación asignados por el sistema | endpointRangeDescription de |
httpGatewayEndpointPort | Puerto de punto de conexión de administración de clústeres HTTP | int (obligatorio) |
isPrimary | Marque esto como el tipo de nodo principal. | bool (obligatorio) |
nombre | Nombre del tipo de nodo | string (obligatorio) |
placementProperties | Las etiquetas de selección de ubicación aplicadas a los nodos del tipo de nodo, que se pueden usar para indicar dónde se deben ejecutar determinados servicios (carga de trabajo). | NodeTypeDescriptionPlacementProperties |
reverseProxyEndpointPort | Punto de conexión usado por el proxy inverso | Int |
vmInstanceCount | Número de instancias de nodo en el tipo de nodo | Int Restricciones: Valor mínimo = 1 Valor máximo = 2147483647 (obligatorio) |
NodeTypeDescriptionCapacities
Nombre | Descripción | Valor |
---|
NodeTypeDescriptionPlacementProperties
Nombre | Descripción | Valor |
---|
ResourceTags
Nombre | Descripción | Valor |
---|
SettingsParameterDescription
Nombre | Descripción | Valor |
---|---|---|
nombre | Nombre de la propiedad settings | string (obligatorio) |
valor | Valor de la propiedad | string (obligatorio) |
SettingsSectionDescription
Nombre | Descripción | Valor |
---|---|---|
nombre | El nombre de la sección de configuración | string (obligatorio) |
Parámetros | Colección de opciones de configuración de la sección, cada configuración es una tupla que consta de nombre y valor de configuración | SettingsParameterDescription[] (obligatorio) |
Ejemplos de uso
Módulos comprobados de Azure
Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.
Módulo | Descripción |
---|---|
de clúster de Service Fabric | Módulo de recursos de AVM para el clúster de Service Fabric |
Ejemplos de inicio rápido de Azure
Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.
Archivo de Bicep | Descripción |
---|---|
Implementación de un clúster seguro de 5 nodos | Esta plantilla le permite implementar un clúster seguro de Service Fabric de 5 nodos que ejecuta Windows Server 2019 Datacenter en un vmSS de tamaño de Standard_D2_v2. |
Definición de recursos de plantilla de ARM
El tipo de recurso de clústeres se puede implementar con operaciones destinadas a:
- grupos de recursos: consulte comandos de implementación de grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.ServiceFabric/clusters, agregue el siguiente JSON a la plantilla.
{
"type": "Microsoft.ServiceFabric/clusters",
"apiVersion": "2016-09-01",
"name": "string",
"location": "string",
"properties": {
"azureActiveDirectory": {
"clientApplication": "string",
"clusterApplication": "string",
"tenantId": "string"
},
"certificate": {
"thumbprint": "string",
"thumbprintSecondary": "string",
"x509StoreName": "string"
},
"clientCertificateCommonNames": [
{
"certificateCommonName": "string",
"certificateIssuerThumbprint": "string",
"isAdmin": "bool"
}
],
"clientCertificateThumbprints": [
{
"certificateThumbprint": "string",
"isAdmin": "bool"
}
],
"clusterCodeVersion": "string",
"diagnosticsStorageAccountConfig": {
"blobEndpoint": "string",
"protectedAccountKeyName": "string",
"queueEndpoint": "string",
"storageAccountName": "string",
"tableEndpoint": "string"
},
"fabricSettings": [
{
"name": "string",
"parameters": [
{
"name": "string",
"value": "string"
}
]
}
],
"managementEndpoint": "string",
"nodeTypes": [
{
"applicationPorts": {
"endPort": "int",
"startPort": "int"
},
"capacities": {
"{customized property}": "string"
},
"clientConnectionEndpointPort": "int",
"durabilityLevel": "string",
"ephemeralPorts": {
"endPort": "int",
"startPort": "int"
},
"httpGatewayEndpointPort": "int",
"isPrimary": "bool",
"name": "string",
"placementProperties": {
"{customized property}": "string"
},
"reverseProxyEndpointPort": "int",
"vmInstanceCount": "int"
}
],
"reliabilityLevel": "string",
"reverseProxyCertificate": {
"thumbprint": "string",
"thumbprintSecondary": "string",
"x509StoreName": "string"
},
"upgradeDescription": {
"deltaHealthPolicy": {
"maxPercentDeltaUnhealthyApplications": "int",
"maxPercentDeltaUnhealthyNodes": "int",
"maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
},
"forceRestart": "bool",
"healthCheckRetryTimeout": "string",
"healthCheckStableDuration": "string",
"healthCheckWaitDuration": "string",
"healthPolicy": {
"maxPercentUnhealthyApplications": "int",
"maxPercentUnhealthyNodes": "int"
},
"overrideUserUpgradePolicy": "bool",
"upgradeDomainTimeout": "string",
"upgradeReplicaSetCheckTimeout": "string",
"upgradeTimeout": "string"
},
"upgradeMode": "string",
"vmImage": "string"
},
"tags": {
"{customized property}": "string"
}
}
Valores de propiedad
AzureActiveDirectory
Nombre | Descripción | Valor |
---|---|---|
clientApplication | Identificador de aplicación cliente de Azure Active Directory | cuerda |
clusterApplication | Identificador de aplicación del clúster de Azure Active Directory | cuerda |
tenantId | Identificador de inquilino de Azure Active Directory | cuerda |
CertificateDescription
Nombre | Descripción | Valor |
---|---|---|
Huella digital | Huella digital del certificado principal | string (obligatorio) |
thumbprintSecondary | Huella digital del certificado secundario | cuerda |
x509StoreName | Ubicación del almacén de certificados local | 'AddressBook' 'AuthRoot' "CertificateAuthority" 'No permitido' "Mi" 'Raíz' 'TrustedPeople' "TrustedPublisher" |
ClientCertificateCommonName
Nombre | Descripción | Valor |
---|---|---|
certificateCommonName | Nombre común del certificado al que se va a conceder acceso; tenga cuidado de usar nombres comunes de caracteres comodín | string (obligatorio) |
certificateIssuerThumbprint | Huella digital del emisor de certificados | string (obligatorio) |
isAdmin | Es este certificado que se usa para el acceso de administrador desde el cliente, si es false, se usa o solo consulta el acceso. | bool (obligatorio) |
ClientCertificateThumbprint
Nombre | Descripción | Valor |
---|---|---|
certificateThumbprint | Huella digital del certificado | string (obligatorio) |
isAdmin | Es este certificado que se usa para el acceso de administrador desde el cliente, si es false, se usa o solo consulta el acceso | bool (obligatorio) |
ClusterHealthPolicy
Nombre | Descripción | Valor |
---|---|---|
maxPercentUnhealthyApplications | Porcentaje máximo permitido de aplicaciones incorrectas antes de notificar un error. Por ejemplo, para permitir que 10% de aplicaciones sean incorrectos, este valor sería 10. | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
maxPercentUnhealthyNodes | Porcentaje máximo permitido de nodos incorrectos antes de notificar un error. Por ejemplo, para permitir que 10% de nodos sean incorrectos, este valor sería 10. | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
ClusterProperties
Nombre | Descripción | Valor |
---|---|---|
azureActiveDirectory | Configuración para habilitar la autenticación de AAD en el clúster | azureActiveDirectory |
certificado | Este certificado principal se usará como nodo de clúster para la seguridad del nodo, el certificado SSL para el punto de conexión de administración de clústeres y el cliente de administración predeterminado. | certificateDescription |
clientCertificateCommonNames | Lista de certificados de cliente para confiar en función de nombres comunes | ClientCertificateCommonName[] |
clientCertificateThumbprints | Los detalles de la huella digital del cliente , se usan para el acceso de cliente para la operación del clúster. | clientCertificateThumbprint[] |
clusterCodeVersion | La versión de código de ServiceFabric que se ejecuta en el clúster | cuerda |
diagnosticsStorageAccountConfig | Detalles de configuración de la cuenta de diagnóstico de almacenamiento | DiagnosticsStorageAccountConfig |
fabricSettings | Lista de opciones de tejido personalizadas para configurar el clúster. | SettingsSectionDescription[] |
managementEndpoint | Punto de conexión de administración http del clúster | string (obligatorio) |
nodeTypes | Lista de tipos de nodo que componen el clúster | nodeTypeDescription[] (obligatorio) |
reliabilityLevel | El nivel de confiabilidad del clúster indica el tamaño del conjunto de réplicas del servicio del sistema. | 'Bronce' 'Oro' 'Platinum' 'Plata' |
reverseProxyCertificate | El certificado de servidor usado por el proxy inverso | certificateDescription |
upgradeDescription | Directiva que se va a usar al actualizar el clúster. | ClusterUpgradePolicy |
upgradeMode | El modo de actualización del clúster indica si el sistema inicia automáticamente la actualización del tejido. | 'Automático' 'Manual' |
vmImage | El nombre de vm image VMSS se ha configurado con. Se pueden usar nombres genéricos como Windows o Linux. | cuerda |
ClusterUpgradeDeltaHealthPolicy
Nombre | Descripción | Valor |
---|---|---|
maxPercentDeltaUnhealthyApplications | Porcentaje adicional de aplicaciones incorrectas | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 (obligatorio) |
maxPercentDeltaUnhealthyNodes | Porcentaje de nodos incorrectos adicionales | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 (obligatorio) |
maxPercentUpgradeDomainDeltaUnhealthyNodes | Porcentaje de nodos incorrectos adicionales por dominio de actualización | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 (obligatorio) |
ClusterUpgradePolicy
Nombre | Descripción | Valor |
---|---|---|
deltaHealthPolicy | Directiva de mantenimiento delta | clusterUpgradeDeltaHealthPolicy |
forceRestart | Forzar que el nodo se reinicie o no | Bool |
healthCheckRetryTimeout | El período de tiempo que las comprobaciones de estado pueden producir errores continuamente, representa .Net TimeSpan. | string (obligatorio) |
healthCheckStableDuration | El período de tiempo que las comprobaciones de estado deben pasar continuamente, representa .Net TimeSpan. | string (obligatorio) |
healthCheckWaitDuration | El período de tiempo que debe esperar después de completar un dominio de actualización antes de realizar comprobaciones de estado, representa .Net TimeSpan. | string (obligatorio) |
healthPolicy | Directiva de mantenimiento del clúster | ClusterHealthPolicy (obligatorio) |
overrideUserUpgradePolicy | Usar la directiva de actualización definida por el usuario o no | Bool |
upgradeDomainTimeout | El tiempo de espera de cualquier dominio de actualización, representa .Net TimeSpan. | string (obligatorio) |
upgradeReplicaSetCheckTimeout | Tiempo de espera para que se complete la actualización del conjunto de réplicas, representa .Net TimeSpan. | string (obligatorio) |
upgradeTimeout | El tiempo de espera de actualización representa .Net TimeSpan. | string (obligatorio) |
DiagnosticsStorageAccountConfig
Nombre | Descripción | Valor |
---|---|---|
blobEndpoint | Punto de conexión de blob de la cuenta de almacenamiento de diagnóstico | string (obligatorio) |
protectedAccountKeyName | Nombre de clave de almacenamiento de diagnóstico protegido | string (obligatorio) |
queueEndpoint | Punto de conexión de cola de la cuenta de almacenamiento de diagnóstico | string (obligatorio) |
storageAccountName | Nombre de la cuenta de almacenamiento de diagnósticos | string (obligatorio) |
tableEndpoint | Punto de conexión de tabla de la cuenta de almacenamiento de diagnóstico | string (obligatorio) |
EndpointRangeDescription
Nombre | Descripción | Valor |
---|---|---|
endPort | Puerto final de un intervalo de puertos | int (obligatorio) |
startPort | Puerto inicial de un intervalo de puertos | int (obligatorio) |
Microsoft.ServiceFabric/clusters
Nombre | Descripción | Valor |
---|---|---|
apiVersion | La versión de api | '2016-09-01' |
ubicación | Ubicación del recurso. | string (obligatorio) |
nombre | El nombre del recurso | string (obligatorio) |
Propiedades | Propiedades del recurso de clúster | clusterProperties de |
Etiquetas | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
tipo | El tipo de recurso | "Microsoft.ServiceFabric/clusters" |
NodeTypeDescription
Nombre | Descripción | Valor |
---|---|---|
applicationPorts | Puertos usados por las aplicaciones | endpointRangeDescription de |
Capacidades | Las etiquetas de capacidad aplicadas a los nodos del tipo de nodo, el administrador de recursos de clúster usa estas etiquetas para comprender la cantidad de un recurso que tiene un nodo. | nodeTypeDescriptionCapacities |
clientConnectionEndpointPort | Puerto de punto de conexión de administración de clústeres TCP | int (obligatorio) |
durabilityLevel | Nivel de durabilidad del tipo de nodo | 'Bronce' 'Oro' 'Plata' |
ephemeralPorts | Puertos de aplicación asignados por el sistema | endpointRangeDescription de |
httpGatewayEndpointPort | Puerto de punto de conexión de administración de clústeres HTTP | int (obligatorio) |
isPrimary | Marque esto como el tipo de nodo principal. | bool (obligatorio) |
nombre | Nombre del tipo de nodo | string (obligatorio) |
placementProperties | Las etiquetas de selección de ubicación aplicadas a los nodos del tipo de nodo, que se pueden usar para indicar dónde se deben ejecutar determinados servicios (carga de trabajo). | NodeTypeDescriptionPlacementProperties |
reverseProxyEndpointPort | Punto de conexión usado por el proxy inverso | Int |
vmInstanceCount | Número de instancias de nodo en el tipo de nodo | Int Restricciones: Valor mínimo = 1 Valor máximo = 2147483647 (obligatorio) |
NodeTypeDescriptionCapacities
Nombre | Descripción | Valor |
---|
NodeTypeDescriptionPlacementProperties
Nombre | Descripción | Valor |
---|
ResourceTags
Nombre | Descripción | Valor |
---|
SettingsParameterDescription
Nombre | Descripción | Valor |
---|---|---|
nombre | Nombre de la propiedad settings | string (obligatorio) |
valor | Valor de la propiedad | string (obligatorio) |
SettingsSectionDescription
Nombre | Descripción | Valor |
---|---|---|
nombre | El nombre de la sección de configuración | string (obligatorio) |
Parámetros | Colección de opciones de configuración de la sección, cada configuración es una tupla que consta de nombre y valor de configuración | SettingsParameterDescription[] (obligatorio) |
Ejemplos de uso
Plantillas de inicio rápido de Azure
Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.
Plantilla | Descripción |
---|---|
Implementación de un clúster seguro de 3 nodos con grupos de seguridad de red habilitados |
Esta plantilla le permite implementar un clúster seguro de Service Fabric de 3 nodos que ejecuta el centro de datos de Windows Server 2016 en una máquina virtual de tamaño de Standard_D2. Usar esta plantilla permite controlar el tráfico de red entrante y saliente mediante grupos de seguridad de red. |
Implementación de un clúster seguro de 5 nodos |
Esta plantilla le permite implementar un clúster seguro de Service Fabric de 5 nodos que ejecuta Windows Server 2019 Datacenter en un vmSS de tamaño de Standard_D2_v2. |
Implementación de un clúster de 5 nodos de Ubuntu Service Fabric |
Esta plantilla permite implementar un clúster seguro de Service Fabric de 5 nodos que ejecuta Ubuntu en un vmSS de tamaño de Standard_D2_V2. |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso de clústeres se puede implementar con operaciones destinadas a:
- grupos de recursos de
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.ServiceFabric/clusters, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceFabric/clusters@2016-09-01"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
azureActiveDirectory = {
clientApplication = "string"
clusterApplication = "string"
tenantId = "string"
}
certificate = {
thumbprint = "string"
thumbprintSecondary = "string"
x509StoreName = "string"
}
clientCertificateCommonNames = [
{
certificateCommonName = "string"
certificateIssuerThumbprint = "string"
isAdmin = bool
}
]
clientCertificateThumbprints = [
{
certificateThumbprint = "string"
isAdmin = bool
}
]
clusterCodeVersion = "string"
diagnosticsStorageAccountConfig = {
blobEndpoint = "string"
protectedAccountKeyName = "string"
queueEndpoint = "string"
storageAccountName = "string"
tableEndpoint = "string"
}
fabricSettings = [
{
name = "string"
parameters = [
{
name = "string"
value = "string"
}
]
}
]
managementEndpoint = "string"
nodeTypes = [
{
applicationPorts = {
endPort = int
startPort = int
}
capacities = {
{customized property} = "string"
}
clientConnectionEndpointPort = int
durabilityLevel = "string"
ephemeralPorts = {
endPort = int
startPort = int
}
httpGatewayEndpointPort = int
isPrimary = bool
name = "string"
placementProperties = {
{customized property} = "string"
}
reverseProxyEndpointPort = int
vmInstanceCount = int
}
]
reliabilityLevel = "string"
reverseProxyCertificate = {
thumbprint = "string"
thumbprintSecondary = "string"
x509StoreName = "string"
}
upgradeDescription = {
deltaHealthPolicy = {
maxPercentDeltaUnhealthyApplications = int
maxPercentDeltaUnhealthyNodes = int
maxPercentUpgradeDomainDeltaUnhealthyNodes = int
}
forceRestart = bool
healthCheckRetryTimeout = "string"
healthCheckStableDuration = "string"
healthCheckWaitDuration = "string"
healthPolicy = {
maxPercentUnhealthyApplications = int
maxPercentUnhealthyNodes = int
}
overrideUserUpgradePolicy = bool
upgradeDomainTimeout = "string"
upgradeReplicaSetCheckTimeout = "string"
upgradeTimeout = "string"
}
upgradeMode = "string"
vmImage = "string"
}
})
}
Valores de propiedad
AzureActiveDirectory
Nombre | Descripción | Valor |
---|---|---|
clientApplication | Identificador de aplicación cliente de Azure Active Directory | cuerda |
clusterApplication | Identificador de aplicación del clúster de Azure Active Directory | cuerda |
tenantId | Identificador de inquilino de Azure Active Directory | cuerda |
CertificateDescription
Nombre | Descripción | Valor |
---|---|---|
Huella digital | Huella digital del certificado principal | string (obligatorio) |
thumbprintSecondary | Huella digital del certificado secundario | cuerda |
x509StoreName | Ubicación del almacén de certificados local | 'AddressBook' 'AuthRoot' "CertificateAuthority" 'No permitido' "Mi" 'Raíz' 'TrustedPeople' "TrustedPublisher" |
ClientCertificateCommonName
Nombre | Descripción | Valor |
---|---|---|
certificateCommonName | Nombre común del certificado al que se va a conceder acceso; tenga cuidado de usar nombres comunes de caracteres comodín | string (obligatorio) |
certificateIssuerThumbprint | Huella digital del emisor de certificados | string (obligatorio) |
isAdmin | Es este certificado que se usa para el acceso de administrador desde el cliente, si es false, se usa o solo consulta el acceso. | bool (obligatorio) |
ClientCertificateThumbprint
Nombre | Descripción | Valor |
---|---|---|
certificateThumbprint | Huella digital del certificado | string (obligatorio) |
isAdmin | Es este certificado que se usa para el acceso de administrador desde el cliente, si es false, se usa o solo consulta el acceso | bool (obligatorio) |
ClusterHealthPolicy
Nombre | Descripción | Valor |
---|---|---|
maxPercentUnhealthyApplications | Porcentaje máximo permitido de aplicaciones incorrectas antes de notificar un error. Por ejemplo, para permitir que 10% de aplicaciones sean incorrectos, este valor sería 10. | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
maxPercentUnhealthyNodes | Porcentaje máximo permitido de nodos incorrectos antes de notificar un error. Por ejemplo, para permitir que 10% de nodos sean incorrectos, este valor sería 10. | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
ClusterProperties
Nombre | Descripción | Valor |
---|---|---|
azureActiveDirectory | Configuración para habilitar la autenticación de AAD en el clúster | azureActiveDirectory |
certificado | Este certificado principal se usará como nodo de clúster para la seguridad del nodo, el certificado SSL para el punto de conexión de administración de clústeres y el cliente de administración predeterminado. | certificateDescription |
clientCertificateCommonNames | Lista de certificados de cliente para confiar en función de nombres comunes | ClientCertificateCommonName[] |
clientCertificateThumbprints | Los detalles de la huella digital del cliente , se usan para el acceso de cliente para la operación del clúster. | clientCertificateThumbprint[] |
clusterCodeVersion | La versión de código de ServiceFabric que se ejecuta en el clúster | cuerda |
diagnosticsStorageAccountConfig | Detalles de configuración de la cuenta de diagnóstico de almacenamiento | DiagnosticsStorageAccountConfig |
fabricSettings | Lista de opciones de tejido personalizadas para configurar el clúster. | SettingsSectionDescription[] |
managementEndpoint | Punto de conexión de administración http del clúster | string (obligatorio) |
nodeTypes | Lista de tipos de nodo que componen el clúster | nodeTypeDescription[] (obligatorio) |
reliabilityLevel | El nivel de confiabilidad del clúster indica el tamaño del conjunto de réplicas del servicio del sistema. | 'Bronce' 'Oro' 'Platinum' 'Plata' |
reverseProxyCertificate | El certificado de servidor usado por el proxy inverso | certificateDescription |
upgradeDescription | Directiva que se va a usar al actualizar el clúster. | ClusterUpgradePolicy |
upgradeMode | El modo de actualización del clúster indica si el sistema inicia automáticamente la actualización del tejido. | 'Automático' 'Manual' |
vmImage | El nombre de vm image VMSS se ha configurado con. Se pueden usar nombres genéricos como Windows o Linux. | cuerda |
ClusterUpgradeDeltaHealthPolicy
Nombre | Descripción | Valor |
---|---|---|
maxPercentDeltaUnhealthyApplications | Porcentaje adicional de aplicaciones incorrectas | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 (obligatorio) |
maxPercentDeltaUnhealthyNodes | Porcentaje de nodos incorrectos adicionales | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 (obligatorio) |
maxPercentUpgradeDomainDeltaUnhealthyNodes | Porcentaje de nodos incorrectos adicionales por dominio de actualización | Int Restricciones: Valor mínimo = 0 Valor máximo = 100 (obligatorio) |
ClusterUpgradePolicy
Nombre | Descripción | Valor |
---|---|---|
deltaHealthPolicy | Directiva de mantenimiento delta | clusterUpgradeDeltaHealthPolicy |
forceRestart | Forzar que el nodo se reinicie o no | Bool |
healthCheckRetryTimeout | El período de tiempo que las comprobaciones de estado pueden producir errores continuamente, representa .Net TimeSpan. | string (obligatorio) |
healthCheckStableDuration | El período de tiempo que las comprobaciones de estado deben pasar continuamente, representa .Net TimeSpan. | string (obligatorio) |
healthCheckWaitDuration | El período de tiempo que debe esperar después de completar un dominio de actualización antes de realizar comprobaciones de estado, representa .Net TimeSpan. | string (obligatorio) |
healthPolicy | Directiva de mantenimiento del clúster | ClusterHealthPolicy (obligatorio) |
overrideUserUpgradePolicy | Usar la directiva de actualización definida por el usuario o no | Bool |
upgradeDomainTimeout | El tiempo de espera de cualquier dominio de actualización, representa .Net TimeSpan. | string (obligatorio) |
upgradeReplicaSetCheckTimeout | Tiempo de espera para que se complete la actualización del conjunto de réplicas, representa .Net TimeSpan. | string (obligatorio) |
upgradeTimeout | El tiempo de espera de actualización representa .Net TimeSpan. | string (obligatorio) |
DiagnosticsStorageAccountConfig
Nombre | Descripción | Valor |
---|---|---|
blobEndpoint | Punto de conexión de blob de la cuenta de almacenamiento de diagnóstico | string (obligatorio) |
protectedAccountKeyName | Nombre de clave de almacenamiento de diagnóstico protegido | string (obligatorio) |
queueEndpoint | Punto de conexión de cola de la cuenta de almacenamiento de diagnóstico | string (obligatorio) |
storageAccountName | Nombre de la cuenta de almacenamiento de diagnósticos | string (obligatorio) |
tableEndpoint | Punto de conexión de tabla de la cuenta de almacenamiento de diagnóstico | string (obligatorio) |
EndpointRangeDescription
Nombre | Descripción | Valor |
---|---|---|
endPort | Puerto final de un intervalo de puertos | int (obligatorio) |
startPort | Puerto inicial de un intervalo de puertos | int (obligatorio) |
Microsoft.ServiceFabric/clusters
Nombre | Descripción | Valor |
---|---|---|
ubicación | Ubicación del recurso. | string (obligatorio) |
nombre | El nombre del recurso | string (obligatorio) |
Propiedades | Propiedades del recurso de clúster | clusterProperties de |
Etiquetas | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. |
tipo | El tipo de recurso | "Microsoft.ServiceFabric/clusters@2016-09-01" |
NodeTypeDescription
Nombre | Descripción | Valor |
---|---|---|
applicationPorts | Puertos usados por las aplicaciones | endpointRangeDescription de |
Capacidades | Las etiquetas de capacidad aplicadas a los nodos del tipo de nodo, el administrador de recursos de clúster usa estas etiquetas para comprender la cantidad de un recurso que tiene un nodo. | nodeTypeDescriptionCapacities |
clientConnectionEndpointPort | Puerto de punto de conexión de administración de clústeres TCP | int (obligatorio) |
durabilityLevel | Nivel de durabilidad del tipo de nodo | 'Bronce' 'Oro' 'Plata' |
ephemeralPorts | Puertos de aplicación asignados por el sistema | endpointRangeDescription de |
httpGatewayEndpointPort | Puerto de punto de conexión de administración de clústeres HTTP | int (obligatorio) |
isPrimary | Marque esto como el tipo de nodo principal. | bool (obligatorio) |
nombre | Nombre del tipo de nodo | string (obligatorio) |
placementProperties | Las etiquetas de selección de ubicación aplicadas a los nodos del tipo de nodo, que se pueden usar para indicar dónde se deben ejecutar determinados servicios (carga de trabajo). | NodeTypeDescriptionPlacementProperties |
reverseProxyEndpointPort | Punto de conexión usado por el proxy inverso | Int |
vmInstanceCount | Número de instancias de nodo en el tipo de nodo | Int Restricciones: Valor mínimo = 1 Valor máximo = 2147483647 (obligatorio) |
NodeTypeDescriptionCapacities
Nombre | Descripción | Valor |
---|
NodeTypeDescriptionPlacementProperties
Nombre | Descripción | Valor |
---|
ResourceTags
Nombre | Descripción | Valor |
---|
SettingsParameterDescription
Nombre | Descripción | Valor |
---|---|---|
nombre | Nombre de la propiedad settings | string (obligatorio) |
valor | Valor de la propiedad | string (obligatorio) |
SettingsSectionDescription
Nombre | Descripción | Valor |
---|---|---|
nombre | El nombre de la sección de configuración | string (obligatorio) |
Parámetros | Colección de opciones de configuración de la sección, cada configuración es una tupla que consta de nombre y valor de configuración | SettingsParameterDescription[] (obligatorio) |