Clústeres Microsoft.ServiceFabric 2016-09-01

Artículo
10/03/2024

Definición de recursos de Bicep

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

Grupos de recursos: consulte los comandos de implementación del grupo de recursos.

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.ServiceFabric/clusters, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.ServiceFabric/clusters@2016-09-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  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

clusters

Nombre	Descripción	Value
name	El nombre del recurso	string (obligatorio) Límite de caracteres: 4-23 Caracteres válidos: Letras minúsculas, números y guiones. Comience con una letra minúscula. Termine con una letra minúscula o un número.
ubicación	Ubicación del recurso	string (obligatorio)
etiquetas	Etiquetas del recurso.	Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
properties	Propiedades del recurso de clúster	ClusterProperties

ClusterProperties

Nombre	Descripción	Valor
azureActiveDirectory	La 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 en los que 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	string
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' 'Silver'
reverseProxyCertificate	El certificado de servidor utilizado 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 o no.	'Automático' 'Manual'
vmImage	El nombre de vm image VMSS se ha configurado con. Se pueden usar nombres genéricos como Windows o Linux.	string

AzureActiveDirectory

Nombre	Descripción	Valor
clientApplication	Identificador de aplicación cliente de Azure Active Directory	string
clusterApplication	Identificador de aplicación del clúster de Azure Active Directory	string
tenantId	Identificador de inquilino de Azure Active Directory	string

CertificateDescription

Nombre	Descripción	Valor
thumbprint	Huella digital del certificado principal	string (obligatorio)
thumbprintSecondary	Huella digital del certificado secundario	string
x509StoreName	Ubicación del almacén de certificados local	'AddressBook' 'AuthRoot' "CertificateAuthority" 'No permitido' "Mi" 'Root' "TrustedPeople" "TrustedPublisher"

ClientCertificateCommonName

Nombre	Descripción	Valor
certificateCommonName	Nombre común del certificado al que se va a conceder acceso; tenga cuidado con el uso de 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 de 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)

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óstico	string (obligatorio)
tableEndpoint	Punto de conexión de tabla de la cuenta de almacenamiento de diagnóstico	string (obligatorio)

SettingsSectionDescription

Nombre	Descripción	Value
name	Nombre de la sección de configuración	string (obligatorio)
parámetros	Colección de configuraciones de la sección, cada configuración es una tupla que consta de nombre y valor de configuración	SettingsParameterDescription[] (obligatorio)

SettingsParameterDescription

Nombre	Descripción	Value
name	Nombre de la propiedad de configuración	string (obligatorio)
value	El valor de la propiedad.	string (obligatorio)

NodeTypeDescription

Nombre	Descripción	Valor
applicationPorts	Puertos usados por las aplicaciones	EndpointRangeDescription
capacities	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 del punto de conexión de administración del clúster TCP	int (obligatorio)
durabilityLevel	Nivel de durabilidad del tipo de nodo	'Bronce' 'Oro' 'Plata'
ephemeralPorts	Puertos de aplicación asignados por el sistema	EndpointRangeDescription
httpGatewayEndpointPort	Puerto del punto de conexión de administración del clúster HTTP	int (obligatorio)
isPrimary	Marcar esto como el tipo de nodo principal	bool (obligatorio)
name	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 usado por el proxy inverso	int
vmInstanceCount	Número de instancias de nodo en el tipo de nodo	int (obligatorio) Restricciones: Valor mínimo = 1 Valor máximo = 2147483647

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)

NodeTypeDescriptionCapacities

Nombre	Descripción	Valor
{propiedad personalizada}		string

NodeTypeDescriptionPlacementProperties

Nombre	Descripción	Valor
{propiedad personalizada}		string

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 timeSpan de .Net.	string (obligatorio)
healthCheckStableDuration	El período de tiempo que las comprobaciones de estado deben pasar continuamente, representa timeSpan de .Net.	string (obligatorio)
healthCheckWaitDuration	El período de tiempo que se debe esperar después de completar un dominio de actualización antes de realizar comprobaciones de estado, representa timeSpan de .Net.	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 timeSpan de .Net.	string (obligatorio)
upgradeTimeout	El tiempo de espera de actualización, representa timeSpan de .Net.	string (obligatorio)

ClusterUpgradeDeltaHealthPolicy

Nombre	Descripción	Valor
maxPercentDeltaUnhealthyApplications	Porcentaje adicional de aplicaciones incorrectas	int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 100
maxPercentDeltaUnhealthyNodes	Porcentaje adicional de nodos incorrectos	int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes	Porcentaje de nodos incorrectos adicionales por dominio de actualización	int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 100

ClusterHealthPolicy

Nombre	Descripción	Valor
maxPercentUnhealthyApplications	El porcentaje máximo permitido de aplicaciones en mal estado antes de informar de un error. Por ejemplo, para permitir el 10 % de las aplicaciones en mal estado, este valor sería 10.	int Restricciones: Valor mínimo = 0 Valor máximo = 100
maxPercentUnhealthyNodes	El porcentaje máximo permitido de nodos en mal estado antes de informar de un error. Por ejemplo, para permitir el 10 % de los nodos en mal estado, este valor sería 10.	int Restricciones: Valor mínimo = 0 Valor máximo = 100

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 de Ubuntu Service Fabric de 5 nodos	Esta plantilla le permite implementar un clúster de Service Fabric de 5 nodos seguro que ejecuta Ubuntu en una máquina virtual de tamaño de Standard_D2_V2.
Implementación de un clúster seguro de 5 nodos	Esta plantilla permite implementar un clúster seguro de Service Fabric de 5 nodos que ejecuta Windows Server 2019 Datacenter en un VMSS de tamaño Standard_D2_v2.
Implementación de un clúster seguro de tipo de nodo 3 con grupos de seguridad de red habilitados	Esta plantilla permite implementar un clúster seguro de Service Fabric de tipo de nodo 3 que ejecuta el centro de datos de Windows Server 2016 en una máquina virtual de tamaño Standard_D2. Use esta plantilla para controlar el tráfico de red entrante y saliente mediante grupos de seguridad de red.

Definición de recursos de plantilla de ARM

El tipo de recurso clusters se puede implementar con operaciones que tienen como destino:

Grupos de recursos: consulte los comandos de implementación del grupo de recursos.

Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.

Formato de los recursos

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",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "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

clusters

Nombre	Descripción	Value
type	Tipo de recurso	"Microsoft.ServiceFabric/clusters"
apiVersion	La versión de la API de recursos	'2016-09-01'
name	El nombre del recurso	string (obligatorio) Límite de caracteres: 4-23 Caracteres válidos: Letras minúsculas, números y guiones. Comience con una letra minúscula. Termine con una letra minúscula o un número.
ubicación	Ubicación del recurso	string (obligatorio)
etiquetas	Etiquetas del recurso.	Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
properties	Propiedades del recurso de clúster	ClusterProperties

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 del clúster y el cliente de administración predeterminado.	CertificateDescription
clientCertificateCommonNames	Lista de certificados de cliente en los que 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	string
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' 'Silver'
reverseProxyCertificate	El certificado de servidor utilizado 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 o no.	'Automático' 'Manual'
vmImage	El nombre de vm image VMSS se ha configurado con. Se pueden usar nombres genéricos como Windows o Linux.	string

AzureActiveDirectory

Nombre	Descripción	Valor
clientApplication	Identificador de aplicación cliente de Azure Active Directory	string
clusterApplication	Identificador de aplicación del clúster de Azure Active Directory	string
tenantId	Identificador de inquilino de Azure Active Directory	string

CertificateDescription

Nombre	Descripción	Valor
thumbprint	Huella digital del certificado principal	string (obligatorio)
thumbprintSecondary	Huella digital del certificado secundario	string
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 con el uso de 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 de 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)

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óstico	string (obligatorio)
tableEndpoint	Punto de conexión de tabla de la cuenta de almacenamiento de diagnóstico	string (obligatorio)

SettingsSectionDescription

Nombre	Descripción	Value
name	Nombre de la sección de configuración	string (obligatorio)
parámetros	Colección de configuraciones de la sección, cada configuración es una tupla que consta de nombre y valor de configuración	SettingsParameterDescription[] (obligatorio)

SettingsParameterDescription

Nombre	Descripción	Value
name	Nombre de la propiedad de configuración	string (obligatorio)
value	El valor de la propiedad.	string (obligatorio)

NodeTypeDescription

Nombre	Descripción	Valor
applicationPorts	Puertos usados por las aplicaciones	EndpointRangeDescription
capacities	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 del punto de conexión de administración del clúster TCP	int (obligatorio)
durabilityLevel	Nivel de durabilidad del tipo de nodo	'Bronce' 'Oro' 'Plata'
ephemeralPorts	Puertos de aplicación asignados por el sistema	EndpointRangeDescription
httpGatewayEndpointPort	Puerto del punto de conexión de administración del clúster HTTP	int (obligatorio)
isPrimary	Marcar esto como el tipo de nodo principal	bool (obligatorio)
name	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 usado por el proxy inverso	int
vmInstanceCount	Número de instancias de nodo en el tipo de nodo	int (obligatorio) Restricciones: Valor mínimo = 1 Valor máximo = 2147483647

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)

NodeTypeDescriptionCapacities

Nombre	Descripción	Valor
{propiedad personalizada}		string

NodeTypeDescriptionPlacementProperties

Nombre	Descripción	Valor
{propiedad personalizada}		string

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 timeSpan de .Net.	string (obligatorio)
healthCheckStableDuration	El período de tiempo que las comprobaciones de estado deben pasar continuamente, representa timeSpan de .Net.	string (obligatorio)
healthCheckWaitDuration	El período de tiempo que se debe esperar después de completar un dominio de actualización antes de realizar comprobaciones de estado, representa TimeSpan de .Net.	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 timeSpan de .Net.	string (obligatorio)
upgradeTimeout	El tiempo de espera de actualización, representa timeSpan de .Net.	string (obligatorio)

ClusterUpgradeDeltaHealthPolicy

Nombre	Descripción	Valor
maxPercentDeltaUnhealthyApplications	Porcentaje adicional de aplicaciones incorrectas	int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 100
maxPercentDeltaUnhealthyNodes	Porcentaje adicional de nodos incorrectos	int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes	Porcentaje adicional de nodos incorrectos por dominio de actualización	int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 100

ClusterHealthPolicy

Nombre	Descripción	Valor
maxPercentUnhealthyApplications	El porcentaje máximo permitido de aplicaciones en mal estado antes de informar de un error. Por ejemplo, para permitir el 10 % de las aplicaciones en mal estado, este valor sería 10.	int Restricciones: Valor mínimo = 0 Valor máximo = 100
maxPercentUnhealthyNodes	El porcentaje máximo permitido de nodos en mal estado antes de informar de un error. Por ejemplo, para permitir el 10 % de los nodos en mal estado, este valor sería 10.	int Restricciones: Valor mínimo = 0 Valor máximo = 100

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 de Ubuntu Service Fabric de 5 nodos	Esta plantilla le permite implementar un clúster seguro de Service Fabric de 5 nodos que ejecuta Ubuntu en un VMSS de tamaño Standard_D2_V2.
Implementación de un clúster seguro de 5 nodos	Esta plantilla 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 seguro de 3 nodos con NSG 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.

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

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

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"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  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

clusters

Nombre	Descripción	Value
type	Tipo de recurso	"Microsoft.ServiceFabric/clusters@2016-09-01"
name	El nombre del recurso	string (obligatorio) Límite de caracteres: 4-23 Caracteres válidos: Letras minúsculas, números y guiones. Comience con una letra minúscula. Termine con una letra minúscula o un número.
ubicación	Ubicación del recurso	string (obligatorio)
parent_id	Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos.	string (obligatorio)
etiquetas	Etiquetas del recurso.	Diccionario de nombres y valores de etiqueta.
properties	Propiedades del recurso de clúster	ClusterProperties

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 del clúster y el cliente de administración predeterminado.	CertificateDescription
clientCertificateCommonNames	Lista de certificados de cliente en los que 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	string
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 utilizado 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 o no.	"Automático" "Manual"
vmImage	El nombre de la imagen de máquina virtual VMSS se ha configurado con. Se pueden usar nombres genéricos como Windows o Linux.	string

AzureActiveDirectory

Nombre	Descripción	Valor
clientApplication	Identificador de aplicación cliente de Azure Active Directory	string
clusterApplication	Identificador de aplicación del clúster de Azure Active Directory	string
tenantId	Identificador de inquilino de Azure Active Directory	string

CertificateDescription

Nombre	Descripción	Valor
thumbprint	Huella digital del certificado principal	string (obligatorio)
thumbprintSecondary	Huella digital del certificado secundario	string
x509StoreName	Ubicación del almacén de certificados local	"Libreta de direcciones" "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 con el uso de 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 de 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)

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óstico	string (obligatorio)
tableEndpoint	Punto de conexión de tabla de la cuenta de almacenamiento de diagnóstico	string (obligatorio)

SettingsSectionDescription

Nombre	Descripción	Value
name	Nombre de la sección de configuración	string (obligatorio)
parámetros	Colección de configuraciones de la sección, cada configuración es una tupla que consta de nombre y valor de configuración	SettingsParameterDescription[] (obligatorio)

SettingsParameterDescription

Nombre	Descripción	Value
name	Nombre de la propiedad de configuración	string (obligatorio)
value	El valor de la propiedad.	string (obligatorio)

NodeTypeDescription

Nombre	Descripción	Valor
applicationPorts	Puertos usados por las aplicaciones	EndpointRangeDescription
capacities	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 del punto de conexión de administración del clúster TCP	int (obligatorio)
durabilityLevel	Nivel de durabilidad del tipo de nodo	"Bronce" "Oro" «Plata»
ephemeralPorts	Puertos de aplicación asignados por el sistema	EndpointRangeDescription
httpGatewayEndpointPort	Puerto del punto de conexión de administración del clúster HTTP	int (obligatorio)
isPrimary	Marcar esto como el tipo de nodo principal	bool (obligatorio)
name	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 usado por el proxy inverso	int
vmInstanceCount	Número de instancias de nodo en el tipo de nodo	int (obligatorio) Restricciones: Valor mínimo = 1 Valor máximo = 2147483647

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)

NodeTypeDescriptionCapacities

Nombre	Descripción	Valor
{propiedad personalizada}		string

NodeTypeDescriptionPlacementProperties

Nombre	Descripción	Valor
{propiedad personalizada}		string

ClusterUpgradePolicy

Nombre	Descripción	Valor
deltaHealthPolicy	Directiva de mantenimiento de 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 timeSpan de .Net.	string (obligatorio)
healthCheckStableDuration	El período de tiempo que las comprobaciones de estado deben pasar continuamente, representa timeSpan de .Net.	string (obligatorio)
healthCheckWaitDuration	El período de tiempo que se debe esperar después de completar un dominio de actualización antes de realizar comprobaciones de estado, representa TimeSpan de .Net.	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 timeSpan de .Net.	string (obligatorio)
upgradeTimeout	El tiempo de espera de actualización, representa timeSpan de .Net.	string (obligatorio)

ClusterUpgradeDeltaHealthPolicy

Nombre	Descripción	Valor
maxPercentDeltaUnhealthyApplications	Porcentaje adicional de aplicaciones incorrectas	int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 100
maxPercentDeltaUnhealthyNodes	Porcentaje adicional de nodos incorrectos	int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes	Porcentaje adicional de nodos incorrectos por dominio de actualización	int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 100

ClusterHealthPolicy

Nombre	Descripción	Valor
maxPercentUnhealthyApplications	El porcentaje máximo permitido de aplicaciones en mal estado antes de informar de un error. Por ejemplo, para permitir el 10 % de las aplicaciones en mal estado, este valor sería 10.	int Restricciones: Valor mínimo = 0 Valor máximo = 100
maxPercentUnhealthyNodes	El porcentaje máximo permitido de nodos en mal estado antes de informar de un error. Por ejemplo, para permitir el 10 % de los nodos en mal estado, este valor sería 10.	int Restricciones: Valor mínimo = 0 Valor máximo = 100

Compartir a través de

Clústeres Microsoft.ServiceFabric 2016-09-01

Definición de recursos de Bicep

Formato de los recursos

Valores de propiedad

clusters

ClusterProperties

AzureActiveDirectory

CertificateDescription

ClientCertificateCommonName

ClientCertificateThumbprint

DiagnosticsStorageAccountConfig

SettingsSectionDescription

SettingsParameterDescription

NodeTypeDescription

EndpointRangeDescription

NodeTypeDescriptionCapacities

NodeTypeDescriptionPlacementProperties

ClusterUpgradePolicy

ClusterUpgradeDeltaHealthPolicy

ClusterHealthPolicy

Plantillas de inicio rápido

Definición de recursos de plantilla de ARM

Formato de los recursos

Valores de propiedad

clusters

ClusterProperties

AzureActiveDirectory

CertificateDescription

ClientCertificateCommonName

ClientCertificateThumbprint

DiagnosticsStorageAccountConfig

SettingsSectionDescription

SettingsParameterDescription

NodeTypeDescription

EndpointRangeDescription

NodeTypeDescriptionCapacities

NodeTypeDescriptionPlacementProperties

ClusterUpgradePolicy

ClusterUpgradeDeltaHealthPolicy

ClusterHealthPolicy

Plantillas de inicio rápido

Definición de recursos de Terraform (proveedor AzAPI)

Formato de los recursos

Valores de propiedad

clusters

ClusterProperties

AzureActiveDirectory

CertificateDescription

ClientCertificateCommonName

ClientCertificateThumbprint

DiagnosticsStorageAccountConfig

SettingsSectionDescription

SettingsParameterDescription

NodeTypeDescription

EndpointRangeDescription

NodeTypeDescriptionCapacities

NodeTypeDescriptionPlacementProperties

ClusterUpgradePolicy

ClusterUpgradeDeltaHealthPolicy

ClusterHealthPolicy

Comentarios

Recursos adicionales