Compartir a través de


Clústeres Microsoft.ServiceFabric 2019-03-01-preview

Definición de recursos de Bicep

El tipo de recurso de clústeres se puede implementar con operaciones destinadas a:

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@2019-03-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    addOnFeatures: [
      'string'
    ]
    azureActiveDirectory: {
      clientApplication: 'string'
      clusterApplication: 'string'
      tenantId: 'string'
    }
    certificate: {
      thumbprint: 'string'
      thumbprintSecondary: 'string'
      x509StoreName: 'string'
    }
    certificateCommonNames: {
      commonNames: [
        {
          certificateCommonName: 'string'
          certificateIssuerThumbprint: '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'
    }
    eventStoreServiceEnabled: bool
    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'
    }
    reverseProxyCertificateCommonNames: {
      commonNames: [
        {
          certificateCommonName: 'string'
          certificateIssuerThumbprint: 'string'
        }
      ]
      x509StoreName: 'string'
    }
    upgradeDescription: {
      deltaHealthPolicy: {
        applicationDeltaHealthPolicies: {
          {customized property}: {
            defaultServiceTypeDeltaHealthPolicy: {
              maxPercentDeltaUnhealthyServices: int
            }
            serviceTypeDeltaHealthPolicies: {
              {customized property}: {
                maxPercentDeltaUnhealthyServices: int
              }
            }
          }
        }
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
      }
      forceRestart: bool
      healthCheckRetryTimeout: 'string'
      healthCheckStableDuration: 'string'
      healthCheckWaitDuration: 'string'
      healthPolicy: {
        applicationHealthPolicies: {
          {customized property}: {
            defaultServiceTypeHealthPolicy: {
              maxPercentUnhealthyServices: int
            }
            serviceTypeHealthPolicies: {
              {customized property}: {
                maxPercentUnhealthyServices: int
              }
            }
          }
        }
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
      }
      upgradeDomainTimeout: 'string'
      upgradeReplicaSetCheckTimeout: 'string'
      upgradeTimeout: 'string'
    }
    upgradeMode: 'string'
    vmImage: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

ApplicationDeltaHealthPolicy

Nombre Descripción Valor
defaultServiceTypeDeltaHealthPolicy La directiva de mantenimiento delta que se usa de forma predeterminada para evaluar el estado de un tipo de servicio al actualizar el clúster. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies Mapa con la directiva de mantenimiento delta de tipo de servicio por nombre de tipo de servicio. El mapa está vacío de forma predeterminada. ServiceTypeDeltaHealthPolicyMap

ApplicationDeltaHealthPolicyMap

Nombre Descripción Valor

ApplicationHealthPolicy

Nombre Descripción Valor
defaultServiceTypeHealthPolicy La directiva de mantenimiento usada de forma predeterminada para evaluar el estado de un tipo de servicio. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Mapa con la directiva de mantenimiento del tipo de servicio por nombre de tipo de servicio. El mapa está vacío de forma predeterminada. ServiceTypeHealthPolicyMap

ApplicationHealthPolicyMap

Nombre Descripción Valor

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 de cliente. string (obligatorio)
certificateIssuerThumbprint Huella digital del emisor del certificado de cliente. string (obligatorio)
isAdmin Indica si el certificado de cliente tiene acceso de administrador al clúster. Los clientes que no son administradores solo pueden realizar operaciones de solo lectura en el clúster. bool (obligatorio)

ClientCertificateThumbprint

Nombre Descripción Valor
certificateThumbprint Huella digital del certificado de cliente. string (obligatorio)
isAdmin Indica si el certificado de cliente tiene acceso de administrador al clúster. Los clientes que no son administradores solo pueden realizar operaciones de solo lectura en el clúster. bool (obligatorio)

ClusterHealthPolicy

Nombre Descripción Valor
applicationHealthPolicies Define el mapa de directivas de mantenimiento de la aplicación que se usa para evaluar el estado de una aplicación o una de sus entidades secundarias. ApplicationHealthPolicyMap
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.

El porcentaje representa el porcentaje máximo tolerado de aplicaciones que pueden ser incorrectos antes de que el clúster se considere en error.
Si se respeta el porcentaje, pero hay al menos una aplicación incorrecta, el estado se evalúa como Advertencia.
Esto se calcula dividiendo el número de aplicaciones incorrectas en el número total de instancias de aplicación en el clúster, excluyendo las aplicaciones de tipos de aplicación que se incluyen en ApplicationTypeHealthPolicyMap.
El cálculo se redondea hasta tolerar un error en un número reducido de aplicaciones. El porcentaje predeterminado es cero.
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.

El porcentaje representa el porcentaje máximo tolerado de nodos que pueden ser incorrectos antes de que el clúster se considere en error.
Si se respeta el porcentaje, pero hay al menos un nodo incorrecto, el estado se evalúa como Advertencia.
El porcentaje se calcula dividiendo el número de nodos incorrectos en el número total de nodos del clúster.
El cálculo se redondea hasta tolerar un error en un número reducido de nodos. El porcentaje predeterminado es cero.

En clústeres grandes, algunos nodos siempre estarán inactivos o fuera para reparaciones, por lo que este porcentaje debe configurarse para tolerarlo.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100

ClusterProperties

Nombre Descripción Valor
addOnFeatures Lista de características de complementos que se van a habilitar en el clúster. Matriz de cadenas que contiene cualquiera de:
"BackupRestoreService"
"DnsService"
'RepairManager'
'ResourceMonitorService'
azureActiveDirectory Configuración de autenticación de AAD del clúster. azureActiveDirectory
certificado Certificado que se va a usar para proteger el clúster. El certificado proporcionado se usará para la seguridad del nodo al nodo dentro del clúster, el certificado SSL para el punto de conexión de administración del clúster y el cliente de administración predeterminado. certificateDescription
certificateCommonNames Describe una lista de certificados de servidor a los que hace referencia el nombre común que se usan para proteger el clúster. ServerCertificateCommonNames
clientCertificateCommonNames Lista de certificados de cliente a los que se hace referencia por nombre común que pueden administrar el clúster. ClientCertificateCommonName[]
clientCertificateThumbprints Lista de certificados de cliente a los que hace referencia la huella digital que pueden administrar el clúster. clientCertificateThumbprint[]
clusterCodeVersion La versión en tiempo de ejecución de Service Fabric del clúster. Esta propiedad solo puede establecer el usuario cuando upgradeMode está establecido en "Manual". Para obtener una lista de las versiones disponibles de Service Fabric para los nuevos clústeres, use ClusterVersion API. Para obtener la lista de versiones disponibles para los clústeres existentes, use availableClusterVersions. cuerda
diagnosticsStorageAccountConfig Información de la cuenta de almacenamiento para almacenar registros de diagnóstico de Service Fabric. DiagnosticsStorageAccountConfig
eventStoreServiceEnabled Indica si el servicio de almacén de eventos está habilitado. Bool
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 en el clúster. nodeTypeDescription[] (obligatorio)
reliabilityLevel El nivel de confiabilidad establece el tamaño del conjunto de réplicas de los servicios del sistema. Obtenga información sobre ReliabilityLevel.

- Ninguno: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 1. Esto solo se debe usar para los clústeres de prueba.
- Bronze: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 3. Esto solo se debe usar para los clústeres de prueba.
- Silver: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 5.
- Gold: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 7.
- Platinum: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 9.
'Bronce'
'Oro'
'Ninguno'
'Platinum'
'Plata'
reverseProxyCertificate El certificado de servidor usado por el proxy inverso. certificateDescription
reverseProxyCertificateCommonNames Describe una lista de certificados de servidor a los que hace referencia el nombre común que se usan para proteger el clúster. ServerCertificateCommonNames
upgradeDescription Directiva que se va a usar al actualizar el clúster. ClusterUpgradePolicy
upgradeMode Modo de actualización del clúster cuando hay disponible una nueva versión en tiempo de ejecución de Service Fabric.

- Automático: el clúster se actualizará automáticamente a la versión más reciente del entorno de ejecución de Service Fabric en cuanto esté disponible.
- Manual: el clúster no se actualizará automáticamente a la versión más reciente del entorno de ejecución de Service Fabric. El clúster se actualiza estableciendo la propiedad clusterCodeVersion en el recurso de clúster.
'Automático'
'Manual'
vmImage La imagen de máquina virtual VM VMSS se ha configurado con. Se pueden usar nombres genéricos como Windows o Linux. cuerda

ClusterUpgradeDeltaHealthPolicy

Nombre Descripción Valor
applicationDeltaHealthPolicies Define el mapa de directivas de mantenimiento delta de la aplicación que se usa para evaluar el estado de una aplicación o de una de sus entidades secundarias al actualizar el clúster. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications Porcentaje máximo permitido de degradación del estado de las aplicaciones permitida durante las actualizaciones del clúster.
La diferencia se mide entre el estado de las aplicaciones al principio de la actualización y el estado de las aplicaciones en el momento de la evaluación de estado.
La comprobación se realiza después de cada finalización de actualización del dominio de actualización para asegurarse de que el estado global del clúster está dentro de los límites tolerados. Los servicios del sistema no se incluyen en esto.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100 (obligatorio)
maxPercentDeltaUnhealthyNodes Porcentaje máximo permitido de degradación del estado de los nodos permitido durante las actualizaciones del clúster.
La diferencia se mide entre el estado de los nodos al principio de la actualización y el estado de los nodos en el momento de la evaluación de estado.
La comprobación se realiza después de cada finalización de actualización del dominio de actualización para asegurarse de que el estado global del clúster está dentro de los límites tolerados.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100 (obligatorio)
maxPercentUpgradeDomainDeltaUnhealthyNodes El porcentaje máximo permitido de degradación del estado de los nodos de dominio de actualización permitido durante las actualizaciones del clúster.
La diferencia se mide entre el estado de los nodos de dominio de actualización al principio de la actualización y el estado de los nodos de dominio de actualización en el momento de la evaluación de estado.
La comprobación se realiza después de completar cada actualización de dominio de actualización para todos los dominios de actualización completados para asegurarse de que el estado de los dominios de actualización está dentro de los límites tolerados.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100 (obligatorio)

ClusterUpgradePolicy

Nombre Descripción Valor
deltaHealthPolicy Directiva de mantenimiento delta del clúster que se usa al actualizar el clúster. clusterUpgradeDeltaHealthPolicy
forceRestart Si es true, los procesos se reinician con fuerza durante la actualización incluso cuando la versión del código no ha cambiado (la actualización solo cambia la configuración o los datos). Bool
healthCheckRetryTimeout Cantidad de tiempo para volver a intentar la evaluación del estado cuando la aplicación o el clúster no son correctos antes de revertir la actualización. El tiempo de espera puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
healthCheckStableDuration La cantidad de tiempo que la aplicación o el clúster deben permanecer en buen estado antes de que la actualización continúe con el siguiente dominio de actualización. La duración puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
healthCheckWaitDuration Período de tiempo que debe esperar después de completar un dominio de actualización antes de realizar comprobaciones de estado. La duración puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
healthPolicy Directiva de mantenimiento del clúster que se usa al actualizar el clúster. ClusterHealthPolicy (obligatorio)
upgradeDomainTimeout Cantidad de tiempo que cada dominio de actualización tiene que completarse antes de revertir la actualización. El tiempo de espera puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
upgradeReplicaSetCheckTimeout Cantidad máxima de tiempo para bloquear el procesamiento de un dominio de actualización y evitar la pérdida de disponibilidad cuando hay problemas inesperados. Cuando expire este tiempo de espera, el procesamiento del dominio de actualización continuará independientemente de los problemas de pérdida de disponibilidad. El tiempo de espera se restablece al principio de cada dominio de actualización. El tiempo de espera puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
upgradeTimeout La cantidad de tiempo que tiene que completarse la actualización general antes de revertir la actualización. El tiempo de espera puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)

DiagnosticsStorageAccountConfig

Nombre Descripción Valor
blobEndpoint Punto de conexión de blob de la cuenta de azure Storage. string (obligatorio)
protectedAccountKeyName Nombre de clave de almacenamiento de diagnósticos protegido. string (obligatorio)
queueEndpoint Punto de conexión de cola de la cuenta de azure Storage. string (obligatorio)
storageAccountName Nombre de la cuenta de Almacenamiento de Azure. string (obligatorio)
tableEndpoint Punto de conexión de tabla de la cuenta de azure Storage. 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 de Azure. 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 Intervalo de puertos desde los que el clúster asignó el puerto a las aplicaciones de Service Fabric. 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 recursos 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. Obtenga información sobre DurabilityLevel.

- Bronce - Sin privilegios. Este es el valor predeterminado.
- Silver: los trabajos de infraestructura se pueden pausar durante un período de 10 minutos por UD.
- Gold: los trabajos de infraestructura se pueden pausar durante una duración de 2 horas por UD. La durabilidad Gold solo se puede habilitar en Sku de máquina virtual de nodo completo, como D15_V2, G5, etc.
'Bronce'
'Oro'
'Plata'
ephemeralPorts El intervalo de puertos efímeros con los que deben configurarse los nodos de este tipo de nodo. endpointRangeDescription de
httpGatewayEndpointPort Puerto de punto de conexión de administración de clústerES HTTP. int (obligatorio)
isPrimary Tipo de nodo en el que se ejecutarán los servicios del sistema. Solo se debe marcar un tipo de nodo como principal. El tipo de nodo principal no se puede eliminar ni cambiar para los clústeres existentes. 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 deben ejecutarse determinados servicios (carga de trabajo). NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort Punto de conexión utilizado por el proxy inverso. Int
vmInstanceCount Número de nodos del tipo de nodo. Este recuento debe coincidir con la propiedad de capacidad en el recurso VirtualMachineScaleSet correspondiente. 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

ServerCertificateCommonName

Nombre Descripción Valor
certificateCommonName Nombre común del certificado de servidor. string (obligatorio)
certificateIssuerThumbprint Huella digital del emisor del certificado de servidor. string (obligatorio)

ServerCertificateCommonNames

Nombre Descripción Valor
commonNames Lista de certificados de servidor a los que se hace referencia por nombre común que se usan para proteger el clúster. ServerCertificateCommonName[]
x509StoreName Ubicación del almacén de certificados local. 'AddressBook'
'AuthRoot'
"CertificateAuthority"
'No permitido'
"Mi"
'Raíz'
'TrustedPeople'
"TrustedPublisher"

ServiceTypeDeltaHealthPolicy

Nombre Descripción Valor
maxPercentDeltaUnhealthyServices Porcentaje máximo permitido de degradación del estado de los servicios permitido durante las actualizaciones del clúster.
La diferencia se mide entre el estado de los servicios al principio de la actualización y el estado de los servicios en el momento de la evaluación de estado.
La comprobación se realiza después de cada finalización de actualización del dominio de actualización para asegurarse de que el estado global del clúster está dentro de los límites tolerados.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100

ServiceTypeDeltaHealthPolicyMap

Nombre Descripción Valor

ServiceTypeHealthPolicy

Nombre Descripción Valor
maxPercentUnhealthyServices El porcentaje máximo de servicios permitidos para ser incorrectos antes de que la aplicación se considere en error. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100

ServiceTypeHealthPolicyMap

Nombre Descripción Valor

SettingsParameterDescription

Nombre Descripción Valor
nombre Nombre del parámetro de la configuración del tejido. string (obligatorio)
valor Valor de parámetro de la configuración del tejido. string (obligatorio)

SettingsSectionDescription

Nombre Descripción Valor
nombre Nombre de sección de la configuración del tejido. string (obligatorio)
Parámetros Colección de parámetros de la sección . SettingsParameterDescription[] (obligatorio)

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa 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:

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": "2019-03-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "addOnFeatures": [ "string" ],
    "azureActiveDirectory": {
      "clientApplication": "string",
      "clusterApplication": "string",
      "tenantId": "string"
    },
    "certificate": {
      "thumbprint": "string",
      "thumbprintSecondary": "string",
      "x509StoreName": "string"
    },
    "certificateCommonNames": {
      "commonNames": [
        {
          "certificateCommonName": "string",
          "certificateIssuerThumbprint": "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"
    },
    "eventStoreServiceEnabled": "bool",
    "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"
    },
    "reverseProxyCertificateCommonNames": {
      "commonNames": [
        {
          "certificateCommonName": "string",
          "certificateIssuerThumbprint": "string"
        }
      ],
      "x509StoreName": "string"
    },
    "upgradeDescription": {
      "deltaHealthPolicy": {
        "applicationDeltaHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeDeltaHealthPolicy": {
              "maxPercentDeltaUnhealthyServices": "int"
            },
            "serviceTypeDeltaHealthPolicies": {
              "{customized property}": {
                "maxPercentDeltaUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
      },
      "forceRestart": "bool",
      "healthCheckRetryTimeout": "string",
      "healthCheckStableDuration": "string",
      "healthCheckWaitDuration": "string",
      "healthPolicy": {
        "applicationHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeHealthPolicy": {
              "maxPercentUnhealthyServices": "int"
            },
            "serviceTypeHealthPolicies": {
              "{customized property}": {
                "maxPercentUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int"
      },
      "upgradeDomainTimeout": "string",
      "upgradeReplicaSetCheckTimeout": "string",
      "upgradeTimeout": "string"
    },
    "upgradeMode": "string",
    "vmImage": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

ApplicationDeltaHealthPolicy

Nombre Descripción Valor
defaultServiceTypeDeltaHealthPolicy La directiva de mantenimiento delta que se usa de forma predeterminada para evaluar el estado de un tipo de servicio al actualizar el clúster. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies Mapa con la directiva de mantenimiento delta de tipo de servicio por nombre de tipo de servicio. El mapa está vacío de forma predeterminada. ServiceTypeDeltaHealthPolicyMap

ApplicationDeltaHealthPolicyMap

Nombre Descripción Valor

ApplicationHealthPolicy

Nombre Descripción Valor
defaultServiceTypeHealthPolicy La directiva de mantenimiento usada de forma predeterminada para evaluar el estado de un tipo de servicio. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Mapa con la directiva de mantenimiento del tipo de servicio por nombre de tipo de servicio. El mapa está vacío de forma predeterminada. ServiceTypeHealthPolicyMap

ApplicationHealthPolicyMap

Nombre Descripción Valor

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 de cliente. string (obligatorio)
certificateIssuerThumbprint Huella digital del emisor del certificado de cliente. string (obligatorio)
isAdmin Indica si el certificado de cliente tiene acceso de administrador al clúster. Los clientes que no son administradores solo pueden realizar operaciones de solo lectura en el clúster. bool (obligatorio)

ClientCertificateThumbprint

Nombre Descripción Valor
certificateThumbprint Huella digital del certificado de cliente. string (obligatorio)
isAdmin Indica si el certificado de cliente tiene acceso de administrador al clúster. Los clientes que no son administradores solo pueden realizar operaciones de solo lectura en el clúster. bool (obligatorio)

ClusterHealthPolicy

Nombre Descripción Valor
applicationHealthPolicies Define el mapa de directivas de mantenimiento de la aplicación que se usa para evaluar el estado de una aplicación o una de sus entidades secundarias. ApplicationHealthPolicyMap
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.

El porcentaje representa el porcentaje máximo tolerado de aplicaciones que pueden ser incorrectos antes de que el clúster se considere en error.
Si se respeta el porcentaje, pero hay al menos una aplicación incorrecta, el estado se evalúa como Advertencia.
Esto se calcula dividiendo el número de aplicaciones incorrectas en el número total de instancias de aplicación en el clúster, excluyendo las aplicaciones de tipos de aplicación que se incluyen en ApplicationTypeHealthPolicyMap.
El cálculo se redondea hasta tolerar un error en un número reducido de aplicaciones. El porcentaje predeterminado es cero.
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.

El porcentaje representa el porcentaje máximo tolerado de nodos que pueden ser incorrectos antes de que el clúster se considere en error.
Si se respeta el porcentaje, pero hay al menos un nodo incorrecto, el estado se evalúa como Advertencia.
El porcentaje se calcula dividiendo el número de nodos incorrectos en el número total de nodos del clúster.
El cálculo se redondea hasta tolerar un error en un número reducido de nodos. El porcentaje predeterminado es cero.

En clústeres grandes, algunos nodos siempre estarán inactivos o fuera para reparaciones, por lo que este porcentaje debe configurarse para tolerarlo.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100

ClusterProperties

Nombre Descripción Valor
addOnFeatures Lista de características de complementos que se van a habilitar en el clúster. Matriz de cadenas que contiene cualquiera de:
"BackupRestoreService"
"DnsService"
'RepairManager'
'ResourceMonitorService'
azureActiveDirectory Configuración de autenticación de AAD del clúster. azureActiveDirectory
certificado Certificado que se va a usar para proteger el clúster. El certificado proporcionado se usará para la seguridad del nodo al nodo dentro del clúster, el certificado SSL para el punto de conexión de administración del clúster y el cliente de administración predeterminado. certificateDescription
certificateCommonNames Describe una lista de certificados de servidor a los que hace referencia el nombre común que se usan para proteger el clúster. ServerCertificateCommonNames
clientCertificateCommonNames Lista de certificados de cliente a los que se hace referencia por nombre común que pueden administrar el clúster. ClientCertificateCommonName[]
clientCertificateThumbprints Lista de certificados de cliente a los que hace referencia la huella digital que pueden administrar el clúster. clientCertificateThumbprint[]
clusterCodeVersion La versión en tiempo de ejecución de Service Fabric del clúster. Esta propiedad solo puede establecer el usuario cuando upgradeMode está establecido en "Manual". Para obtener una lista de las versiones disponibles de Service Fabric para los nuevos clústeres, use ClusterVersion API. Para obtener la lista de versiones disponibles para los clústeres existentes, use availableClusterVersions. cuerda
diagnosticsStorageAccountConfig Información de la cuenta de almacenamiento para almacenar registros de diagnóstico de Service Fabric. DiagnosticsStorageAccountConfig
eventStoreServiceEnabled Indica si el servicio de almacén de eventos está habilitado. Bool
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 en el clúster. nodeTypeDescription[] (obligatorio)
reliabilityLevel El nivel de confiabilidad establece el tamaño del conjunto de réplicas de los servicios del sistema. Obtenga información sobre ReliabilityLevel.

- Ninguno: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 1. Esto solo se debe usar para los clústeres de prueba.
- Bronze: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 3. Esto solo se debe usar para los clústeres de prueba.
- Silver: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 5.
- Gold: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 7.
- Platinum: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 9.
'Bronce'
'Oro'
'Ninguno'
'Platinum'
'Plata'
reverseProxyCertificate El certificado de servidor usado por el proxy inverso. certificateDescription
reverseProxyCertificateCommonNames Describe una lista de certificados de servidor a los que hace referencia el nombre común que se usan para proteger el clúster. ServerCertificateCommonNames
upgradeDescription Directiva que se va a usar al actualizar el clúster. ClusterUpgradePolicy
upgradeMode Modo de actualización del clúster cuando hay disponible una nueva versión en tiempo de ejecución de Service Fabric.

- Automático: el clúster se actualizará automáticamente a la versión más reciente del entorno de ejecución de Service Fabric en cuanto esté disponible.
- Manual: el clúster no se actualizará automáticamente a la versión más reciente del entorno de ejecución de Service Fabric. El clúster se actualiza estableciendo la propiedad clusterCodeVersion en el recurso de clúster.
'Automático'
'Manual'
vmImage La imagen de máquina virtual VM VMSS se ha configurado con. Se pueden usar nombres genéricos como Windows o Linux. cuerda

ClusterUpgradeDeltaHealthPolicy

Nombre Descripción Valor
applicationDeltaHealthPolicies Define el mapa de directivas de mantenimiento delta de la aplicación que se usa para evaluar el estado de una aplicación o de una de sus entidades secundarias al actualizar el clúster. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications Porcentaje máximo permitido de degradación del estado de las aplicaciones permitida durante las actualizaciones del clúster.
La diferencia se mide entre el estado de las aplicaciones al principio de la actualización y el estado de las aplicaciones en el momento de la evaluación de estado.
La comprobación se realiza después de cada finalización de actualización del dominio de actualización para asegurarse de que el estado global del clúster está dentro de los límites tolerados. Los servicios del sistema no se incluyen en esto.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100 (obligatorio)
maxPercentDeltaUnhealthyNodes Porcentaje máximo permitido de degradación del estado de los nodos permitido durante las actualizaciones del clúster.
La diferencia se mide entre el estado de los nodos al principio de la actualización y el estado de los nodos en el momento de la evaluación de estado.
La comprobación se realiza después de cada finalización de actualización del dominio de actualización para asegurarse de que el estado global del clúster está dentro de los límites tolerados.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100 (obligatorio)
maxPercentUpgradeDomainDeltaUnhealthyNodes El porcentaje máximo permitido de degradación del estado de los nodos de dominio de actualización permitido durante las actualizaciones del clúster.
La diferencia se mide entre el estado de los nodos de dominio de actualización al principio de la actualización y el estado de los nodos de dominio de actualización en el momento de la evaluación de estado.
La comprobación se realiza después de completar cada actualización de dominio de actualización para todos los dominios de actualización completados para asegurarse de que el estado de los dominios de actualización está dentro de los límites tolerados.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100 (obligatorio)

ClusterUpgradePolicy

Nombre Descripción Valor
deltaHealthPolicy Directiva de mantenimiento delta del clúster que se usa al actualizar el clúster. clusterUpgradeDeltaHealthPolicy
forceRestart Si es true, los procesos se reinician con fuerza durante la actualización incluso cuando la versión del código no ha cambiado (la actualización solo cambia la configuración o los datos). Bool
healthCheckRetryTimeout Cantidad de tiempo para volver a intentar la evaluación del estado cuando la aplicación o el clúster no son correctos antes de revertir la actualización. El tiempo de espera puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
healthCheckStableDuration La cantidad de tiempo que la aplicación o el clúster deben permanecer en buen estado antes de que la actualización continúe con el siguiente dominio de actualización. La duración puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
healthCheckWaitDuration Período de tiempo que debe esperar después de completar un dominio de actualización antes de realizar comprobaciones de estado. La duración puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
healthPolicy Directiva de mantenimiento del clúster que se usa al actualizar el clúster. ClusterHealthPolicy (obligatorio)
upgradeDomainTimeout Cantidad de tiempo que cada dominio de actualización tiene que completarse antes de revertir la actualización. El tiempo de espera puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
upgradeReplicaSetCheckTimeout Cantidad máxima de tiempo para bloquear el procesamiento de un dominio de actualización y evitar la pérdida de disponibilidad cuando hay problemas inesperados. Cuando expire este tiempo de espera, el procesamiento del dominio de actualización continuará independientemente de los problemas de pérdida de disponibilidad. El tiempo de espera se restablece al principio de cada dominio de actualización. El tiempo de espera puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
upgradeTimeout La cantidad de tiempo que tiene que completarse la actualización general antes de revertir la actualización. El tiempo de espera puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)

DiagnosticsStorageAccountConfig

Nombre Descripción Valor
blobEndpoint Punto de conexión de blob de la cuenta de azure Storage. string (obligatorio)
protectedAccountKeyName Nombre de clave de almacenamiento de diagnósticos protegido. string (obligatorio)
queueEndpoint Punto de conexión de cola de la cuenta de azure Storage. string (obligatorio)
storageAccountName Nombre de la cuenta de Almacenamiento de Azure. string (obligatorio)
tableEndpoint Punto de conexión de tabla de la cuenta de azure Storage. 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 '2019-03-01-preview'
ubicación Ubicación del recurso de Azure. 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 Intervalo de puertos desde los que el clúster asignó el puerto a las aplicaciones de Service Fabric. 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 recursos 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. Obtenga información sobre DurabilityLevel.

- Bronce - Sin privilegios. Este es el valor predeterminado.
- Silver: los trabajos de infraestructura se pueden pausar durante un período de 10 minutos por UD.
- Gold: los trabajos de infraestructura se pueden pausar durante una duración de 2 horas por UD. La durabilidad Gold solo se puede habilitar en Sku de máquina virtual de nodo completo, como D15_V2, G5, etc.
'Bronce'
'Oro'
'Plata'
ephemeralPorts El intervalo de puertos efímeros con los que deben configurarse los nodos de este tipo de nodo. endpointRangeDescription de
httpGatewayEndpointPort Puerto de punto de conexión de administración de clústerES HTTP. int (obligatorio)
isPrimary Tipo de nodo en el que se ejecutarán los servicios del sistema. Solo se debe marcar un tipo de nodo como principal. El tipo de nodo principal no se puede eliminar ni cambiar para los clústeres existentes. 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 deben ejecutarse determinados servicios (carga de trabajo). NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort Punto de conexión utilizado por el proxy inverso. Int
vmInstanceCount Número de nodos del tipo de nodo. Este recuento debe coincidir con la propiedad de capacidad en el recurso VirtualMachineScaleSet correspondiente. 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

ServerCertificateCommonName

Nombre Descripción Valor
certificateCommonName Nombre común del certificado de servidor. string (obligatorio)
certificateIssuerThumbprint Huella digital del emisor del certificado de servidor. string (obligatorio)

ServerCertificateCommonNames

Nombre Descripción Valor
commonNames Lista de certificados de servidor a los que se hace referencia por nombre común que se usan para proteger el clúster. ServerCertificateCommonName[]
x509StoreName Ubicación del almacén de certificados local. 'AddressBook'
'AuthRoot'
"CertificateAuthority"
'No permitido'
"Mi"
'Raíz'
'TrustedPeople'
"TrustedPublisher"

ServiceTypeDeltaHealthPolicy

Nombre Descripción Valor
maxPercentDeltaUnhealthyServices Porcentaje máximo permitido de degradación del estado de los servicios permitido durante las actualizaciones del clúster.
La diferencia se mide entre el estado de los servicios al principio de la actualización y el estado de los servicios en el momento de la evaluación de estado.
La comprobación se realiza después de cada finalización de actualización del dominio de actualización para asegurarse de que el estado global del clúster está dentro de los límites tolerados.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100

ServiceTypeDeltaHealthPolicyMap

Nombre Descripción Valor

ServiceTypeHealthPolicy

Nombre Descripción Valor
maxPercentUnhealthyServices El porcentaje máximo de servicios permitidos para ser incorrectos antes de que la aplicación se considere en error. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100

ServiceTypeHealthPolicyMap

Nombre Descripción Valor

SettingsParameterDescription

Nombre Descripción Valor
nombre Nombre del parámetro de la configuración del tejido. string (obligatorio)
valor Valor de parámetro de la configuración del tejido. string (obligatorio)

SettingsSectionDescription

Nombre Descripción Valor
nombre Nombre de sección de la configuración del tejido. string (obligatorio)
Parámetros Colección de parámetros de la sección . SettingsParameterDescription[] (obligatorio)

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Implementación de un clúster seguro de 3 nodos con grupos de seguridad de red habilitados

Implementación en Azure
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

Implementación en Azure
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

Implementación en Azure
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@2019-03-01-preview"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      addOnFeatures = [
        "string"
      ]
      azureActiveDirectory = {
        clientApplication = "string"
        clusterApplication = "string"
        tenantId = "string"
      }
      certificate = {
        thumbprint = "string"
        thumbprintSecondary = "string"
        x509StoreName = "string"
      }
      certificateCommonNames = {
        commonNames = [
          {
            certificateCommonName = "string"
            certificateIssuerThumbprint = "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"
      }
      eventStoreServiceEnabled = bool
      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"
      }
      reverseProxyCertificateCommonNames = {
        commonNames = [
          {
            certificateCommonName = "string"
            certificateIssuerThumbprint = "string"
          }
        ]
        x509StoreName = "string"
      }
      upgradeDescription = {
        deltaHealthPolicy = {
          applicationDeltaHealthPolicies = {
            {customized property} = {
              defaultServiceTypeDeltaHealthPolicy = {
                maxPercentDeltaUnhealthyServices = int
              }
              serviceTypeDeltaHealthPolicies = {
                {customized property} = {
                  maxPercentDeltaUnhealthyServices = int
                }
              }
            }
          }
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
        }
        forceRestart = bool
        healthCheckRetryTimeout = "string"
        healthCheckStableDuration = "string"
        healthCheckWaitDuration = "string"
        healthPolicy = {
          applicationHealthPolicies = {
            {customized property} = {
              defaultServiceTypeHealthPolicy = {
                maxPercentUnhealthyServices = int
              }
              serviceTypeHealthPolicies = {
                {customized property} = {
                  maxPercentUnhealthyServices = int
                }
              }
            }
          }
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
        }
        upgradeDomainTimeout = "string"
        upgradeReplicaSetCheckTimeout = "string"
        upgradeTimeout = "string"
      }
      upgradeMode = "string"
      vmImage = "string"
    }
  })
}

Valores de propiedad

ApplicationDeltaHealthPolicy

Nombre Descripción Valor
defaultServiceTypeDeltaHealthPolicy La directiva de mantenimiento delta que se usa de forma predeterminada para evaluar el estado de un tipo de servicio al actualizar el clúster. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies Mapa con la directiva de mantenimiento delta de tipo de servicio por nombre de tipo de servicio. El mapa está vacío de forma predeterminada. ServiceTypeDeltaHealthPolicyMap

ApplicationDeltaHealthPolicyMap

Nombre Descripción Valor

ApplicationHealthPolicy

Nombre Descripción Valor
defaultServiceTypeHealthPolicy La directiva de mantenimiento usada de forma predeterminada para evaluar el estado de un tipo de servicio. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Mapa con la directiva de mantenimiento del tipo de servicio por nombre de tipo de servicio. El mapa está vacío de forma predeterminada. ServiceTypeHealthPolicyMap

ApplicationHealthPolicyMap

Nombre Descripción Valor

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 de cliente. string (obligatorio)
certificateIssuerThumbprint Huella digital del emisor del certificado de cliente. string (obligatorio)
isAdmin Indica si el certificado de cliente tiene acceso de administrador al clúster. Los clientes que no son administradores solo pueden realizar operaciones de solo lectura en el clúster. bool (obligatorio)

ClientCertificateThumbprint

Nombre Descripción Valor
certificateThumbprint Huella digital del certificado de cliente. string (obligatorio)
isAdmin Indica si el certificado de cliente tiene acceso de administrador al clúster. Los clientes que no son administradores solo pueden realizar operaciones de solo lectura en el clúster. bool (obligatorio)

ClusterHealthPolicy

Nombre Descripción Valor
applicationHealthPolicies Define el mapa de directivas de mantenimiento de la aplicación que se usa para evaluar el estado de una aplicación o una de sus entidades secundarias. ApplicationHealthPolicyMap
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.

El porcentaje representa el porcentaje máximo tolerado de aplicaciones que pueden ser incorrectos antes de que el clúster se considere en error.
Si se respeta el porcentaje, pero hay al menos una aplicación incorrecta, el estado se evalúa como Advertencia.
Esto se calcula dividiendo el número de aplicaciones incorrectas en el número total de instancias de aplicación en el clúster, excluyendo las aplicaciones de tipos de aplicación que se incluyen en ApplicationTypeHealthPolicyMap.
El cálculo se redondea hasta tolerar un error en un número reducido de aplicaciones. El porcentaje predeterminado es cero.
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.

El porcentaje representa el porcentaje máximo tolerado de nodos que pueden ser incorrectos antes de que el clúster se considere en error.
Si se respeta el porcentaje, pero hay al menos un nodo incorrecto, el estado se evalúa como Advertencia.
El porcentaje se calcula dividiendo el número de nodos incorrectos en el número total de nodos del clúster.
El cálculo se redondea hasta tolerar un error en un número reducido de nodos. El porcentaje predeterminado es cero.

En clústeres grandes, algunos nodos siempre estarán inactivos o fuera para reparaciones, por lo que este porcentaje debe configurarse para tolerarlo.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100

ClusterProperties

Nombre Descripción Valor
addOnFeatures Lista de características de complementos que se van a habilitar en el clúster. Matriz de cadenas que contiene cualquiera de:
"BackupRestoreService"
"DnsService"
'RepairManager'
'ResourceMonitorService'
azureActiveDirectory Configuración de autenticación de AAD del clúster. azureActiveDirectory
certificado Certificado que se va a usar para proteger el clúster. El certificado proporcionado se usará para la seguridad del nodo al nodo dentro del clúster, el certificado SSL para el punto de conexión de administración del clúster y el cliente de administración predeterminado. certificateDescription
certificateCommonNames Describe una lista de certificados de servidor a los que hace referencia el nombre común que se usan para proteger el clúster. ServerCertificateCommonNames
clientCertificateCommonNames Lista de certificados de cliente a los que se hace referencia por nombre común que pueden administrar el clúster. ClientCertificateCommonName[]
clientCertificateThumbprints Lista de certificados de cliente a los que hace referencia la huella digital que pueden administrar el clúster. clientCertificateThumbprint[]
clusterCodeVersion La versión en tiempo de ejecución de Service Fabric del clúster. Esta propiedad solo puede establecer el usuario cuando upgradeMode está establecido en "Manual". Para obtener una lista de las versiones disponibles de Service Fabric para los nuevos clústeres, use ClusterVersion API. Para obtener la lista de versiones disponibles para los clústeres existentes, use availableClusterVersions. cuerda
diagnosticsStorageAccountConfig Información de la cuenta de almacenamiento para almacenar registros de diagnóstico de Service Fabric. DiagnosticsStorageAccountConfig
eventStoreServiceEnabled Indica si el servicio de almacén de eventos está habilitado. Bool
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 en el clúster. nodeTypeDescription[] (obligatorio)
reliabilityLevel El nivel de confiabilidad establece el tamaño del conjunto de réplicas de los servicios del sistema. Obtenga información sobre ReliabilityLevel.

- Ninguno: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 1. Esto solo se debe usar para los clústeres de prueba.
- Bronze: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 3. Esto solo se debe usar para los clústeres de prueba.
- Silver: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 5.
- Gold: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 7.
- Platinum: ejecute los servicios del sistema con un recuento de conjuntos de réplicas de destino de 9.
'Bronce'
'Oro'
'Ninguno'
'Platinum'
'Plata'
reverseProxyCertificate El certificado de servidor usado por el proxy inverso. certificateDescription
reverseProxyCertificateCommonNames Describe una lista de certificados de servidor a los que hace referencia el nombre común que se usan para proteger el clúster. ServerCertificateCommonNames
upgradeDescription Directiva que se va a usar al actualizar el clúster. ClusterUpgradePolicy
upgradeMode Modo de actualización del clúster cuando hay disponible una nueva versión en tiempo de ejecución de Service Fabric.

- Automático: el clúster se actualizará automáticamente a la versión más reciente del entorno de ejecución de Service Fabric en cuanto esté disponible.
- Manual: el clúster no se actualizará automáticamente a la versión más reciente del entorno de ejecución de Service Fabric. El clúster se actualiza estableciendo la propiedad clusterCodeVersion en el recurso de clúster.
'Automático'
'Manual'
vmImage La imagen de máquina virtual VM VMSS se ha configurado con. Se pueden usar nombres genéricos como Windows o Linux. cuerda

ClusterUpgradeDeltaHealthPolicy

Nombre Descripción Valor
applicationDeltaHealthPolicies Define el mapa de directivas de mantenimiento delta de la aplicación que se usa para evaluar el estado de una aplicación o de una de sus entidades secundarias al actualizar el clúster. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications Porcentaje máximo permitido de degradación del estado de las aplicaciones permitida durante las actualizaciones del clúster.
La diferencia se mide entre el estado de las aplicaciones al principio de la actualización y el estado de las aplicaciones en el momento de la evaluación de estado.
La comprobación se realiza después de cada finalización de actualización del dominio de actualización para asegurarse de que el estado global del clúster está dentro de los límites tolerados. Los servicios del sistema no se incluyen en esto.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100 (obligatorio)
maxPercentDeltaUnhealthyNodes Porcentaje máximo permitido de degradación del estado de los nodos permitido durante las actualizaciones del clúster.
La diferencia se mide entre el estado de los nodos al principio de la actualización y el estado de los nodos en el momento de la evaluación de estado.
La comprobación se realiza después de cada finalización de actualización del dominio de actualización para asegurarse de que el estado global del clúster está dentro de los límites tolerados.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100 (obligatorio)
maxPercentUpgradeDomainDeltaUnhealthyNodes El porcentaje máximo permitido de degradación del estado de los nodos de dominio de actualización permitido durante las actualizaciones del clúster.
La diferencia se mide entre el estado de los nodos de dominio de actualización al principio de la actualización y el estado de los nodos de dominio de actualización en el momento de la evaluación de estado.
La comprobación se realiza después de completar cada actualización de dominio de actualización para todos los dominios de actualización completados para asegurarse de que el estado de los dominios de actualización está dentro de los límites tolerados.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100 (obligatorio)

ClusterUpgradePolicy

Nombre Descripción Valor
deltaHealthPolicy Directiva de mantenimiento delta del clúster que se usa al actualizar el clúster. clusterUpgradeDeltaHealthPolicy
forceRestart Si es true, los procesos se reinician con fuerza durante la actualización incluso cuando la versión del código no ha cambiado (la actualización solo cambia la configuración o los datos). Bool
healthCheckRetryTimeout Cantidad de tiempo para volver a intentar la evaluación del estado cuando la aplicación o el clúster no son correctos antes de revertir la actualización. El tiempo de espera puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
healthCheckStableDuration La cantidad de tiempo que la aplicación o el clúster deben permanecer en buen estado antes de que la actualización continúe con el siguiente dominio de actualización. La duración puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
healthCheckWaitDuration Período de tiempo que debe esperar después de completar un dominio de actualización antes de realizar comprobaciones de estado. La duración puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
healthPolicy Directiva de mantenimiento del clúster que se usa al actualizar el clúster. ClusterHealthPolicy (obligatorio)
upgradeDomainTimeout Cantidad de tiempo que cada dominio de actualización tiene que completarse antes de revertir la actualización. El tiempo de espera puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
upgradeReplicaSetCheckTimeout Cantidad máxima de tiempo para bloquear el procesamiento de un dominio de actualización y evitar la pérdida de disponibilidad cuando hay problemas inesperados. Cuando expire este tiempo de espera, el procesamiento del dominio de actualización continuará independientemente de los problemas de pérdida de disponibilidad. El tiempo de espera se restablece al principio de cada dominio de actualización. El tiempo de espera puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)
upgradeTimeout La cantidad de tiempo que tiene que completarse la actualización general antes de revertir la actualización. El tiempo de espera puede estar en formato hh:mm:ss o en formato d.hh:mm:ss.ms. string (obligatorio)

DiagnosticsStorageAccountConfig

Nombre Descripción Valor
blobEndpoint Punto de conexión de blob de la cuenta de azure Storage. string (obligatorio)
protectedAccountKeyName Nombre de clave de almacenamiento de diagnósticos protegido. string (obligatorio)
queueEndpoint Punto de conexión de cola de la cuenta de azure Storage. string (obligatorio)
storageAccountName Nombre de la cuenta de Almacenamiento de Azure. string (obligatorio)
tableEndpoint Punto de conexión de tabla de la cuenta de azure Storage. 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 de Azure. 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@2019-03-01-preview"

NodeTypeDescription

Nombre Descripción Valor
applicationPorts Intervalo de puertos desde los que el clúster asignó el puerto a las aplicaciones de Service Fabric. 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 recursos 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. Obtenga información sobre DurabilityLevel.

- Bronce - Sin privilegios. Este es el valor predeterminado.
- Silver: los trabajos de infraestructura se pueden pausar durante un período de 10 minutos por UD.
- Gold: los trabajos de infraestructura se pueden pausar durante una duración de 2 horas por UD. La durabilidad Gold solo se puede habilitar en Sku de máquina virtual de nodo completo, como D15_V2, G5, etc.
'Bronce'
'Oro'
'Plata'
ephemeralPorts El intervalo de puertos efímeros con los que deben configurarse los nodos de este tipo de nodo. endpointRangeDescription de
httpGatewayEndpointPort Puerto de punto de conexión de administración de clústerES HTTP. int (obligatorio)
isPrimary Tipo de nodo en el que se ejecutarán los servicios del sistema. Solo se debe marcar un tipo de nodo como principal. El tipo de nodo principal no se puede eliminar ni cambiar para los clústeres existentes. 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 deben ejecutarse determinados servicios (carga de trabajo). NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort Punto de conexión utilizado por el proxy inverso. Int
vmInstanceCount Número de nodos del tipo de nodo. Este recuento debe coincidir con la propiedad de capacidad en el recurso VirtualMachineScaleSet correspondiente. 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

ServerCertificateCommonName

Nombre Descripción Valor
certificateCommonName Nombre común del certificado de servidor. string (obligatorio)
certificateIssuerThumbprint Huella digital del emisor del certificado de servidor. string (obligatorio)

ServerCertificateCommonNames

Nombre Descripción Valor
commonNames Lista de certificados de servidor a los que se hace referencia por nombre común que se usan para proteger el clúster. ServerCertificateCommonName[]
x509StoreName Ubicación del almacén de certificados local. 'AddressBook'
'AuthRoot'
"CertificateAuthority"
'No permitido'
"Mi"
'Raíz'
'TrustedPeople'
"TrustedPublisher"

ServiceTypeDeltaHealthPolicy

Nombre Descripción Valor
maxPercentDeltaUnhealthyServices Porcentaje máximo permitido de degradación del estado de los servicios permitido durante las actualizaciones del clúster.
La diferencia se mide entre el estado de los servicios al principio de la actualización y el estado de los servicios en el momento de la evaluación de estado.
La comprobación se realiza después de cada finalización de actualización del dominio de actualización para asegurarse de que el estado global del clúster está dentro de los límites tolerados.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100

ServiceTypeDeltaHealthPolicyMap

Nombre Descripción Valor

ServiceTypeHealthPolicy

Nombre Descripción Valor
maxPercentUnhealthyServices El porcentaje máximo de servicios permitidos para ser incorrectos antes de que la aplicación se considere en error. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 100

ServiceTypeHealthPolicyMap

Nombre Descripción Valor

SettingsParameterDescription

Nombre Descripción Valor
nombre Nombre del parámetro de la configuración del tejido. string (obligatorio)
valor Valor de parámetro de la configuración del tejido. string (obligatorio)

SettingsSectionDescription

Nombre Descripción Valor
nombre Nombre de sección de la configuración del tejido. string (obligatorio)
Parámetros Colección de parámetros de la sección . SettingsParameterDescription[] (obligatorio)