Microsoft.ServiceFabric clusters/applications 2020-12-01-preview
Definición de recursos de Bicep
El tipo de recurso clusters/applications 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/applications, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.ServiceFabric/clusters/applications@2020-12-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
properties: {
managedIdentities: [
{
name: 'string'
principalId: 'string'
}
]
maximumNodes: int
metrics: [
{
maximumCapacity: int
name: 'string'
reservationCapacity: int
totalApplicationCapacity: int
}
]
minimumNodes: int
parameters: {
{customized property}: 'string'
}
removeApplicationCapacity: bool
typeName: 'string'
typeVersion: 'string'
upgradePolicy: {
applicationHealthPolicy: {
considerWarningAsError: bool
defaultServiceTypeHealthPolicy: {
maxPercentUnhealthyPartitionsPerService: int
maxPercentUnhealthyReplicasPerPartition: int
maxPercentUnhealthyServices: int
}
maxPercentUnhealthyDeployedApplications: int
serviceTypeHealthPolicyMap: {
{customized property}: {
maxPercentUnhealthyPartitionsPerService: int
maxPercentUnhealthyReplicasPerPartition: int
maxPercentUnhealthyServices: int
}
}
}
forceRestart: bool
recreateApplication: bool
rollingUpgradeMonitoringPolicy: {
failureAction: 'string'
healthCheckRetryTimeout: 'string'
healthCheckStableDuration: 'string'
healthCheckWaitDuration: 'string'
upgradeDomainTimeout: 'string'
upgradeTimeout: 'string'
}
upgradeMode: 'string'
upgradeReplicaSetCheckTimeout: 'string'
}
}
}
Valores de propiedad
clusters/applications
Nombre | Descripción | Value |
---|---|---|
name | El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en Bicep. |
string (obligatorio) |
ubicación | Estará en desuso en nueva API, la ubicación del recurso depende del recurso primario. | string |
etiquetas | Etiquetas de recursos de Azure. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
primario | En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario. Para más información, consulte Recurso secundario fuera del recurso primario. |
Nombre simbólico del recurso de tipo: clústeres |
identidad | Describe las identidades administradas de un recurso de Azure. | ManagedIdentity |
properties | Propiedades del recurso de aplicación. | ApplicationResourceProperties |
ManagedIdentity
Nombre | Descripción | Value |
---|---|---|
type | Tipo de identidad administrada para el recurso. | 'Ninguno' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
userAssignedIdentities | Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
UserAssignedIdentityMap |
UserAssignedIdentityMap
Nombre | Descripción | Valor |
---|---|---|
{propiedad personalizada} | UserAssignedIdentity |
UserAssignedIdentity
Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.
ApplicationResourceProperties
Nombre | Descripción | Valor |
---|---|---|
managedIdentities | Lista de identidades asignadas por el usuario para la aplicación, cada una asignada a un nombre descriptivo. | ApplicationUserAssignedIdentity[] |
maximumNodes | El número máximo de nodos que Service Fabric reserva como capacidad para esta aplicación. Tenga en cuenta que esto no significa que los servicios de esta aplicación estarán colocados en todos estos nodos. De forma predeterminada, el valor de esta propiedad es cero y significa que los servicios se pueden colocar en cualquier nodo. | int Restricciones: Valor mínimo = 0 |
Métricas | Lista de la descripción de la métrica de capacidad de la aplicación. | ApplicationMetricDescription[] |
minimumNodes | El número mínimo de nodos que Service Fabric reserva como capacidad para esta aplicación. Tenga en cuenta que esto no significa que los servicios de esta aplicación estarán colocados en todos estos nodos. Si esta propiedad está establecida en cero, no se reservará ninguna capacidad. El valor de esta propiedad no puede ser mayor que el valor de la propiedad MaximumNodes. | int Restricciones: Valor mínimo = 0 |
parámetros | Lista de parámetros de aplicación con valores invalidados de sus valores predeterminados especificados en el manifiesto de aplicación. | ApplicationParameterList |
removeApplicationCapacity | Quite la configuración actual de la capacidad de la aplicación. | bool |
typeName | El nombre del tipo de aplicación tal y como se define en el manifiesto de aplicación. | string |
typeVersion | La versión del tipo de aplicación, tal como se define en el manifiesto de aplicación. | string |
upgradePolicy | Describe la directiva para una actualización de aplicación supervisada. | ApplicationUpgradePolicy |
ApplicationUserAssignedIdentity
Nombre | Descripción | Value |
---|---|---|
name | Nombre descriptivo de la identidad asignada por el usuario. | string (obligatorio) |
principalId | Identificador de entidad de seguridad de la identidad asignada por el usuario. | string (obligatorio) |
ApplicationMetricDescription
Nombre | Descripción | Valor |
---|---|---|
maximumCapacity | Capacidad máxima de nodo para la aplicación de Service Fabric. Esta es la carga máxima para una instancia de esta aplicación en un solo nodo. Incluso si la capacidad del nodo es mayor que este valor, Service Fabric limitará la carga total de servicios dentro de la aplicación en cada nodo a este valor. Si se establece en cero, la capacidad de esta métrica es ilimitada en cada nodo. Al crear una nueva aplicación con la capacidad de aplicación definida, el producto de MaximumNodes y este valor siempre debe ser menor o igual que TotalApplicationCapacity. Al actualizar la aplicación existente con capacidad de aplicación, el producto de MaximumNodes y este valor siempre debe ser menor o igual que TotalApplicationCapacity. |
int |
name | El nombre de la métrica. | string |
reservationCapacity | Capacidad de reserva de nodo para la aplicación de Service Fabric. Esta es la cantidad de carga que está reservada en los nodos que tienen instancias de esta aplicación. Si se especifica MinimumNodes, el producto de estos valores será la capacidad reservada en el clúster para la aplicación. Si se establece en cero, no se reserva ninguna capacidad para esta métrica. Al establecer la capacidad de la aplicación o al actualizar la capacidad de la aplicación; este valor debe ser menor o igual que MaximumCapacity para cada métrica. |
int |
totalApplicationCapacity | Capacidad de métrica total para la aplicación de Service Fabric. Esta es la capacidad de métrica total de esta aplicación en el clúster. Service Fabric intentará limitar la suma de cargas de servicios dentro de la aplicación a este valor. Al crear una nueva aplicación con capacidad de aplicación definida, el producto de MaximumNodes y MaximumCapacity siempre debe ser menor o igual que este valor. |
int |
ApplicationParameterList
Nombre | Descripción | Valor |
---|---|---|
{propiedad personalizada} | string |
ApplicationUpgradePolicy
Nombre | Descripción | Valor |
---|---|---|
applicationHealthPolicy | Define una directiva de mantenimiento que se usa para evaluar el estado de una aplicación o de una de sus entidades secundarias. | ArmApplicationHealthPolicy |
forceRestart | Si es true, los procesos se reinician forzosamente 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 |
recreateApplication | Determina si la aplicación se debe volver a crear al actualizar. Si value=true, no se permiten el resto de los parámetros de la directiva de actualización y se producirá una pérdida de disponibilidad. | bool |
rollingUpgradeMonitoringPolicy | La directiva que se usa para supervisar la actualización de la aplicación | ArmRollingUpgradeMonitoringPolicy |
upgradeMode | El modo usado para supervisar el mantenimiento durante una actualización gradual. Los valores son UnmonitoredAuto, UnmonitoredManual y Monitored. | 'No válido' "Supervisado" "UnmonitoredAuto" 'UnmonitoredManual' |
upgradeReplicaSetCheckTimeout | El período de tiempo máximo para bloquear el procesamiento de un dominio de actualización y evitar la pérdida de disponibilidad cuando hay problemas inesperados. Cuando este tiempo de espera expire, el procesamiento del dominio de actualización se llevará a cabo independientemente de los problemas de pérdida de disponibilidad. El tiempo de espera se restablece al principio de cada dominio de actualización. Los valores válidos oscilan entre 0 y 42949672925, ambos inclusive. (entero de 32 bits sin signo). | string |
ArmApplicationHealthPolicy
Nombre | Descripción | Valor |
---|---|---|
considerWarningAsError | Indica si las advertencias se tratan con el mismo nivel de gravedad que los errores. | bool |
defaultServiceTypeHealthPolicy | La directiva de mantenimiento que se usa de forma predeterminada para evaluar el estado de un tipo de servicio. | ArmServiceTypeHealthPolicy |
maxPercentUnhealthyDeployedApplications | El porcentaje máximo permitido de aplicaciones implementadas con un estado incorrecto. Los valores permitidos son valores byte de cero a 100. El porcentaje representa el porcentaje máximo tolerado de las aplicaciones implementadas que pueden ser incorrectas antes de que la aplicación se considere en error. Esto se calcula dividiendo el número de aplicaciones implementadas en mal estado en el número de nodos en los que la aplicación se implementa actualmente en el clúster. El cálculo se redondea hacia arriba para tolerar un error en números reducidos de nodos. El porcentaje predeterminado es cero. |
int |
serviceTypeHealthPolicyMap | Mapa con la directiva de mantenimiento de tipo de servicio por nombre de tipo de servicio. La asignación está vacía de forma predeterminada. | ArmServiceTypeHealthPolicyMap |
ArmServiceTypeHealthPolicy
Nombre | Descripción | Valor |
---|---|---|
maxPercentUnhealthyPartitionsPerService | El porcentaje máximo de particiones por servicio que puede ser incorrecto antes de que la aplicación se considere en error. | int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
maxPercentUnhealthyReplicasPerPartition | El porcentaje máximo de réplicas por partición que se permite que sea incorrecto antes de que la aplicación se considere en error. | int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
maxPercentUnhealthyServices | El porcentaje máximo de servicios que pueden ser incorrectos antes de que la aplicación se considere en error. | int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
ArmServiceTypeHealthPolicyMap
Nombre | Descripción | Valor |
---|---|---|
{propiedad personalizada} | ArmServiceTypeHealthPolicy |
ArmRollingUpgradeMonitoringPolicy
Nombre | Descripción | Valor |
---|---|---|
failureAction | Modo de activación del paquete de servicio | 'Manual' 'Reversión' |
healthCheckRetryTimeout | La cantidad de tiempo que se reintentan las evaluaciones de mantenimiento cuando la aplicación o el clúster no tienen un estado correcto antes de que se ejecute FailureAction. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
healthCheckStableDuration | La cantidad de tiempo que la aplicación o el clúster deben tener un estado correcto antes de que la actualización continúe con el siguiente dominio de actualización. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
healthCheckWaitDuration | La cantidad de tiempo de espera después de completar un dominio de actualización antes de aplicar directivas de mantenimiento. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
upgradeDomainTimeout | El período de tiempo del que dispone cada dominio de actualización para completarse antes de la ejecución de FailureAction. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
upgradeTimeout | El período de tiempo en el que se debe completar la actualización general antes de que se ejecute FailureAction. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
Definición de recursos de plantilla de ARM
El tipo de recurso clusters/applications 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/applications, agregue el siguiente json a la plantilla.
{
"type": "Microsoft.ServiceFabric/clusters/applications",
"apiVersion": "2020-12-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"properties": {
"managedIdentities": [
{
"name": "string",
"principalId": "string"
}
],
"maximumNodes": "int",
"metrics": [
{
"maximumCapacity": "int",
"name": "string",
"reservationCapacity": "int",
"totalApplicationCapacity": "int"
}
],
"minimumNodes": "int",
"parameters": {
"{customized property}": "string"
},
"removeApplicationCapacity": "bool",
"typeName": "string",
"typeVersion": "string",
"upgradePolicy": {
"applicationHealthPolicy": {
"considerWarningAsError": "bool",
"defaultServiceTypeHealthPolicy": {
"maxPercentUnhealthyPartitionsPerService": "int",
"maxPercentUnhealthyReplicasPerPartition": "int",
"maxPercentUnhealthyServices": "int"
},
"maxPercentUnhealthyDeployedApplications": "int",
"serviceTypeHealthPolicyMap": {
"{customized property}": {
"maxPercentUnhealthyPartitionsPerService": "int",
"maxPercentUnhealthyReplicasPerPartition": "int",
"maxPercentUnhealthyServices": "int"
}
}
},
"forceRestart": "bool",
"recreateApplication": "bool",
"rollingUpgradeMonitoringPolicy": {
"failureAction": "string",
"healthCheckRetryTimeout": "string",
"healthCheckStableDuration": "string",
"healthCheckWaitDuration": "string",
"upgradeDomainTimeout": "string",
"upgradeTimeout": "string"
},
"upgradeMode": "string",
"upgradeReplicaSetCheckTimeout": "string"
}
}
}
Valores de propiedad
clusters/applications
Nombre | Descripción | Value |
---|---|---|
type | Tipo de recurso | "Microsoft.ServiceFabric/clusters/applications" |
apiVersion | La versión de la API de recursos | "2020-12-01-preview" |
name | El nombre del recurso Consulte cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM json. |
string (obligatorio) |
ubicación | Estará en desuso en la NUEVA API, la ubicación del recurso depende del recurso primario. | string |
etiquetas | Etiquetas de recursos de Azure. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
identidad | Describe las identidades administradas de un recurso de Azure. | ManagedIdentity |
properties | Propiedades del recurso de aplicación. | ApplicationResourceProperties |
ManagedIdentity
Nombre | Descripción | Value |
---|---|---|
type | Tipo de identidad administrada para el recurso. | 'Ninguno' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
userAssignedIdentities | Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
UserAssignedIdentityMap |
UserAssignedIdentityMap
Nombre | Descripción | Valor |
---|---|---|
{propiedad personalizada} | UserAssignedIdentity |
UserAssignedIdentity
Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.
ApplicationResourceProperties
Nombre | Descripción | Valor |
---|---|---|
managedIdentities | Lista de identidades asignadas por el usuario para la aplicación, cada una asignada a un nombre descriptivo. | ApplicationUserAssignedIdentity[] |
maximumNodes | El número máximo de nodos que Service Fabric reserva como capacidad para esta aplicación. Tenga en cuenta que esto no significa que los servicios de esta aplicación estarán colocados en todos estos nodos. De forma predeterminada, el valor de esta propiedad es cero y significa que los servicios se pueden colocar en cualquier nodo. | int Restricciones: Valor mínimo = 0 |
Métricas | Lista de la descripción de la métrica de capacidad de la aplicación. | ApplicationMetricDescription[] |
minimumNodes | El número mínimo de nodos que Service Fabric reserva como capacidad para esta aplicación. Tenga en cuenta que esto no significa que los servicios de esta aplicación estarán colocados en todos estos nodos. Si esta propiedad está establecida en cero, no se reservará ninguna capacidad. El valor de esta propiedad no puede ser mayor que el valor de la propiedad MaximumNodes. | int Restricciones: Valor mínimo = 0 |
parámetros | Lista de parámetros de aplicación con valores invalidados de sus valores predeterminados especificados en el manifiesto de aplicación. | ApplicationParameterList |
removeApplicationCapacity | Quite la configuración actual de la capacidad de la aplicación. | bool |
typeName | Nombre del tipo de aplicación tal y como se define en el manifiesto de aplicación. | string |
typeVersion | La versión del tipo de aplicación, tal como se define en el manifiesto de aplicación. | string |
upgradePolicy | Describe la directiva para una actualización de aplicación supervisada. | ApplicationUpgradePolicy |
ApplicationUserAssignedIdentity
Nombre | Descripción | Value |
---|---|---|
name | Nombre descriptivo de la identidad asignada por el usuario. | string (obligatorio) |
principalId | Identificador principal de la identidad asignada por el usuario. | string (obligatorio) |
ApplicationMetricDescription
Nombre | Descripción | Valor |
---|---|---|
maximumCapacity | Capacidad máxima de nodo para la aplicación de Service Fabric. Esta es la carga máxima para una instancia de esta aplicación en un solo nodo. Incluso si la capacidad del nodo es mayor que este valor, Service Fabric limitará la carga total de servicios dentro de la aplicación en cada nodo a este valor. Si se establece en cero, la capacidad de esta métrica es ilimitada en cada nodo. Al crear una aplicación con capacidad de aplicación definida, el producto de MaximumNodes y este valor siempre debe ser menor o igual que TotalApplicationCapacity. Al actualizar la aplicación existente con capacidad de aplicación, el producto de MaximumNodes y este valor siempre debe ser menor o igual que TotalApplicationCapacity. |
int |
name | El nombre de la métrica. | string |
reservationCapacity | Capacidad de reserva de nodo para la aplicación de Service Fabric. Esta es la cantidad de carga que está reservada en los nodos que tienen instancias de esta aplicación. Si se especifica MinimumNodes, el producto de estos valores será la capacidad reservada en el clúster para la aplicación. Si se establece en cero, no se reserva ninguna capacidad para esta métrica. Al establecer la capacidad de la aplicación o al actualizar la capacidad de la aplicación; este valor debe ser menor o igual que MaximumCapacity para cada métrica. |
int |
totalApplicationCapacity | Capacidad de métrica total para la aplicación de Service Fabric. Esta es la capacidad de métrica total de esta aplicación en el clúster. Service Fabric intentará limitar la suma de cargas de servicios dentro de la aplicación a este valor. Al crear una nueva aplicación con capacidad de aplicación definida, el producto de MaximumNodes y MaximumCapacity siempre debe ser menor o igual que este valor. |
int |
ApplicationParameterList
Nombre | Descripción | Valor |
---|---|---|
{propiedad personalizada} | string |
ApplicationUpgradePolicy
Nombre | Descripción | Valor |
---|---|---|
applicationHealthPolicy | Define una directiva de mantenimiento que se usa para evaluar el estado de una aplicación o de una de sus entidades secundarias. | ArmApplicationHealthPolicy |
forceRestart | Si es true, los procesos se reinician forzosamente 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 |
recreateApplication | Determina si la aplicación se debe volver a crear al actualizar. Si value=true, no se permiten el resto de los parámetros de la directiva de actualización y se producirá una pérdida de disponibilidad. | bool |
rollingUpgradeMonitoringPolicy | La directiva que se usa para supervisar la actualización de la aplicación | ArmRollingUpgradeMonitoringPolicy |
upgradeMode | El modo usado para supervisar el mantenimiento durante una actualización gradual. Los valores son UnmonitoredAuto, UnmonitoredManual y Monitored. | 'No válido' "Supervisado" "UnmonitoredAuto" 'UnmonitoredManual' |
upgradeReplicaSetCheckTimeout | El período de tiempo máximo para bloquear el procesamiento de un dominio de actualización y evitar la pérdida de disponibilidad cuando hay problemas inesperados. Cuando este tiempo de espera expire, el procesamiento del dominio de actualización se llevará a cabo independientemente de los problemas de pérdida de disponibilidad. El tiempo de espera se restablece al principio de cada dominio de actualización. Los valores válidos oscilan entre 0 y 42949672925, ambos inclusive. (entero de 32 bits sin signo). | string |
ArmApplicationHealthPolicy
Nombre | Descripción | Valor |
---|---|---|
considerWarningAsError | Indica si las advertencias se tratan con el mismo nivel de gravedad que los errores. | bool |
defaultServiceTypeHealthPolicy | La directiva de mantenimiento que se usa de forma predeterminada para evaluar el estado de un tipo de servicio. | ArmServiceTypeHealthPolicy |
maxPercentUnhealthyDeployedApplications | El porcentaje máximo permitido de aplicaciones implementadas con un estado incorrecto. Los valores permitidos son valores byte de cero a 100. El porcentaje representa el porcentaje máximo tolerado de las aplicaciones implementadas que pueden ser incorrectas antes de que la aplicación se considere en error. Esto se calcula dividiendo el número de aplicaciones implementadas en mal estado en el número de nodos en los que la aplicación se implementa actualmente en el clúster. El cálculo se redondea hacia arriba para tolerar un error en números reducidos de nodos. El porcentaje predeterminado es cero. |
int |
serviceTypeHealthPolicyMap | Mapa con la directiva de mantenimiento de tipo de servicio por nombre de tipo de servicio. La asignación está vacía de forma predeterminada. | ArmServiceTypeHealthPolicyMap |
ArmServiceTypeHealthPolicy
Nombre | Descripción | Valor |
---|---|---|
maxPercentUnhealthyPartitionsPerService | El porcentaje máximo de particiones por servicio que puede ser incorrecto antes de que la aplicación se considere en error. | int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
maxPercentUnhealthyReplicasPerPartition | El porcentaje máximo de réplicas por partición que se permite que sea incorrecto antes de que la aplicación se considere en error. | int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
maxPercentUnhealthyServices | El porcentaje máximo de servicios que pueden ser incorrectos antes de que la aplicación se considere en error. | int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
ArmServiceTypeHealthPolicyMap
Nombre | Descripción | Valor |
---|---|---|
{propiedad personalizada} | ArmServiceTypeHealthPolicy |
ArmRollingUpgradeMonitoringPolicy
Nombre | Descripción | Valor |
---|---|---|
failureAction | Modo de activación del paquete de servicio | 'Manual' 'Reversión' |
healthCheckRetryTimeout | La cantidad de tiempo que se reintentan las evaluaciones de mantenimiento cuando la aplicación o el clúster no tienen un estado correcto antes de que se ejecute FailureAction. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
healthCheckStableDuration | La cantidad de tiempo que la aplicación o el clúster deben tener un estado correcto antes de que la actualización continúe con el siguiente dominio de actualización. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
healthCheckWaitDuration | La cantidad de tiempo de espera después de completar un dominio de actualización antes de aplicar directivas de mantenimiento. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
upgradeDomainTimeout | El período de tiempo del que dispone cada dominio de actualización para completarse antes de la ejecución de FailureAction. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
upgradeTimeout | El período de tiempo en el que se debe completar la actualización general antes de que se ejecute FailureAction. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso clusters/applications se puede implementar con operaciones que tienen como destino:
- 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/applications, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceFabric/clusters/applications@2020-12-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
managedIdentities = [
{
name = "string"
principalId = "string"
}
]
maximumNodes = int
metrics = [
{
maximumCapacity = int
name = "string"
reservationCapacity = int
totalApplicationCapacity = int
}
]
minimumNodes = int
parameters = {
{customized property} = "string"
}
removeApplicationCapacity = bool
typeName = "string"
typeVersion = "string"
upgradePolicy = {
applicationHealthPolicy = {
considerWarningAsError = bool
defaultServiceTypeHealthPolicy = {
maxPercentUnhealthyPartitionsPerService = int
maxPercentUnhealthyReplicasPerPartition = int
maxPercentUnhealthyServices = int
}
maxPercentUnhealthyDeployedApplications = int
serviceTypeHealthPolicyMap = {
{customized property} = {
maxPercentUnhealthyPartitionsPerService = int
maxPercentUnhealthyReplicasPerPartition = int
maxPercentUnhealthyServices = int
}
}
}
forceRestart = bool
recreateApplication = bool
rollingUpgradeMonitoringPolicy = {
failureAction = "string"
healthCheckRetryTimeout = "string"
healthCheckStableDuration = "string"
healthCheckWaitDuration = "string"
upgradeDomainTimeout = "string"
upgradeTimeout = "string"
}
upgradeMode = "string"
upgradeReplicaSetCheckTimeout = "string"
}
}
})
}
Valores de propiedad
clusters/applications
Nombre | Descripción | Value |
---|---|---|
type | Tipo de recurso | "Microsoft.ServiceFabric/clusters/applications@2020-12-01-preview" |
name | El nombre del recurso | string (obligatorio) |
ubicación | Estará en desuso en la NUEVA API, la ubicación del recurso depende del recurso primario. | string |
parent_id | Identificador del recurso que es el elemento primario de este recurso. | Identificador del recurso de tipo: clústeres |
etiquetas | Etiquetas de recursos de Azure. | Diccionario de nombres y valores de etiqueta. |
identidad | Describe las identidades administradas de un recurso de Azure. | ManagedIdentity |
properties | Propiedades del recurso de la aplicación. | ApplicationResourceProperties |
ManagedIdentity
Nombre | Descripción | Value |
---|---|---|
type | Tipo de identidad administrada para el recurso. | "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
identity_ids | Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidades de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
Matriz de identificadores de identidad de usuario. |
UserAssignedIdentityMap
Nombre | Descripción | Valor |
---|---|---|
{propiedad personalizada} | UserAssignedIdentity |
UserAssignedIdentity
Este objeto no contiene ninguna propiedad que se va a establecer durante la implementación. Todas las propiedades son ReadOnly.
ApplicationResourceProperties
Nombre | Descripción | Valor |
---|---|---|
managedIdentities | Lista de identidades asignadas por el usuario para la aplicación, cada una asignada a un nombre descriptivo. | ApplicationUserAssignedIdentity[] |
maximumNodes | El número máximo de nodos que Service Fabric reserva como capacidad para esta aplicación. Tenga en cuenta que esto no significa que los servicios de esta aplicación estarán colocados en todos estos nodos. De forma predeterminada, el valor de esta propiedad es cero y significa que los servicios se pueden colocar en cualquier nodo. | int Restricciones: Valor mínimo = 0 |
Métricas | Lista de la descripción de métricas de capacidad de la aplicación. | ApplicationMetricDescription[] |
minimumNodes | El número mínimo de nodos que Service Fabric reserva como capacidad para esta aplicación. Tenga en cuenta que esto no significa que los servicios de esta aplicación estarán colocados en todos estos nodos. Si esta propiedad está establecida en cero, no se reservará ninguna capacidad. El valor de esta propiedad no puede ser mayor que el valor de la propiedad MaximumNodes. | int Restricciones: Valor mínimo = 0 |
parámetros | Lista de parámetros de aplicación con valores invalidados de sus valores predeterminados especificados en el manifiesto de aplicación. | ApplicationParameterList |
removeApplicationCapacity | Quite la configuración actual de la capacidad de la aplicación. | bool |
typeName | Nombre del tipo de aplicación tal y como se define en el manifiesto de aplicación. | string |
typeVersion | La versión del tipo de aplicación, tal como se define en el manifiesto de aplicación. | string |
upgradePolicy | Describe la directiva para una actualización de aplicación supervisada. | ApplicationUpgradePolicy |
ApplicationUserAssignedIdentity
Nombre | Descripción | Value |
---|---|---|
name | Nombre descriptivo de la identidad asignada por el usuario. | string (obligatorio) |
principalId | Identificador principal de la identidad asignada por el usuario. | string (obligatorio) |
ApplicationMetricDescription
Nombre | Descripción | Valor |
---|---|---|
maximumCapacity | Capacidad máxima de nodo para la aplicación de Service Fabric. Esta es la carga máxima para una instancia de esta aplicación en un solo nodo. Incluso si la capacidad del nodo es mayor que este valor, Service Fabric limitará la carga total de servicios dentro de la aplicación en cada nodo a este valor. Si se establece en cero, la capacidad de esta métrica es ilimitada en cada nodo. Al crear una aplicación con capacidad de aplicación definida, el producto de MaximumNodes y este valor siempre debe ser menor o igual que TotalApplicationCapacity. Al actualizar la aplicación existente con capacidad de aplicación, el producto de MaximumNodes y este valor siempre debe ser menor o igual que TotalApplicationCapacity. |
int |
name | El nombre de la métrica. | string |
reservationCapacity | Capacidad de reserva de nodo para la aplicación de Service Fabric. Esta es la cantidad de carga que está reservada en los nodos que tienen instancias de esta aplicación. Si se especifica MinimumNodes, el producto de estos valores será la capacidad reservada en el clúster para la aplicación. Si se establece en cero, no se reserva ninguna capacidad para esta métrica. Al establecer la capacidad de la aplicación o al actualizar la capacidad de la aplicación; este valor debe ser menor o igual que MaximumCapacity para cada métrica. |
int |
totalApplicationCapacity | Capacidad total de métricas para la aplicación de Service Fabric. Esta es la capacidad total de métricas para esta aplicación en el clúster. Service Fabric intentará limitar la suma de cargas de servicios dentro de la aplicación a este valor. Al crear una nueva aplicación con capacidad de aplicación definida, el producto de MaximumNodes y MaximumCapacity siempre debe ser menor o igual que este valor. |
int |
ApplicationParameterList
Nombre | Descripción | Valor |
---|---|---|
{propiedad personalizada} | string |
ApplicationUpgradePolicy
Nombre | Descripción | Valor |
---|---|---|
applicationHealthPolicy | Define una directiva de mantenimiento que se usa para evaluar el estado de una aplicación o una de sus entidades secundarias. | ArmApplicationHealthPolicy |
forceRestart | Si es true, los procesos se reinician forzosamente 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 |
createApplication | Determina si la aplicación se debe volver a crear al actualizar. Si value=true, no se permiten el resto de los parámetros de la directiva de actualización y se producirá una pérdida de disponibilidad. | bool |
rollingUpgradeMonitoringPolicy | Directiva que se usa para supervisar la actualización de la aplicación | ArmRollingUpgradeMonitoringPolicy |
upgradeMode | El modo usado para supervisar el mantenimiento durante una actualización gradual. Los valores son UnmonitoredAuto, UnmonitoredManual y Monitored. | "No válido" "Supervisado" "UnmonitoredAuto" "UnmonitoredManual" |
upgradeReplicaSetCheckTimeout | El período de tiempo máximo para bloquear el procesamiento de un dominio de actualización y evitar la pérdida de disponibilidad cuando hay problemas inesperados. Cuando este tiempo de espera expire, el procesamiento del dominio de actualización se llevará a cabo independientemente de los problemas de pérdida de disponibilidad. El tiempo de espera se restablece al principio de cada dominio de actualización. Los valores válidos oscilan entre 0 y 42949672925, ambos inclusive. (entero de 32 bits sin signo). | string |
ArmApplicationHealthPolicy
Nombre | Descripción | Valor |
---|---|---|
considerWarningAsError | Indica si las advertencias se tratan con el mismo nivel de gravedad que los errores. | bool |
defaultServiceTypeHealthPolicy | La directiva de mantenimiento que se usa de forma predeterminada para evaluar el estado de un tipo de servicio. | ArmServiceTypeHealthPolicy |
maxPercentUnhealthyDeployedApplications | El porcentaje máximo permitido de aplicaciones implementadas con un estado incorrecto. Los valores permitidos son valores byte de cero a 100. El porcentaje representa el porcentaje máximo tolerado de las aplicaciones implementadas que pueden ser incorrectas antes de que la aplicación se considere en error. Esto se calcula dividiendo el número de aplicaciones implementadas en mal estado en el número de nodos en los que la aplicación se implementa actualmente en el clúster. El cálculo se redondea hacia arriba para tolerar un error en números reducidos de nodos. El porcentaje predeterminado es cero. |
int |
serviceTypeHealthPolicyMap | Mapa con la directiva de mantenimiento de tipo de servicio por nombre de tipo de servicio. La asignación está vacía de forma predeterminada. | ArmServiceTypeHealthPolicyMap |
ArmServiceTypeHealthPolicy
Nombre | Descripción | Valor |
---|---|---|
maxPercentUnhealthyPartitionsPerService | El porcentaje máximo de particiones por servicio que puede ser incorrecto antes de que la aplicación se considere en error. | int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
maxPercentUnhealthyReplicasPerPartition | El porcentaje máximo de réplicas por partición que se permite que sea incorrecto antes de que la aplicación se considere en error. | int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
maxPercentUnhealthyServices | El porcentaje máximo de servicios que pueden ser incorrectos antes de que la aplicación se considere en error. | int Restricciones: Valor mínimo = 0 Valor máximo = 100 |
ArmServiceTypeHealthPolicyMap
Nombre | Descripción | Valor |
---|---|---|
{propiedad personalizada} | ArmServiceTypeHealthPolicy |
ArmRollingUpgradeMonitoringPolicy
Nombre | Descripción | Valor |
---|---|---|
failureAction | Modo de activación del paquete de servicio | "Manual" "Reversión" |
healthCheckRetryTimeout | La cantidad de tiempo que se reintentan las evaluaciones de mantenimiento cuando la aplicación o el clúster no tienen un estado correcto antes de que se ejecute FailureAction. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
healthCheckStableDuration | La cantidad de tiempo que la aplicación o el clúster deben tener un estado correcto antes de que la actualización continúe con el siguiente dominio de actualización. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
healthCheckWaitDuration | La cantidad de tiempo de espera después de completar un dominio de actualización antes de aplicar directivas de mantenimiento. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
upgradeDomainTimeout | El período de tiempo del que dispone cada dominio de actualización para completarse antes de la ejecución de FailureAction. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |
upgradeTimeout | El período de tiempo en el que se debe completar la actualización general antes de que se ejecute FailureAction. En primer lugar se interpreta como una cadena que representa una duración ISO 8601. Si se produce un error, se interpreta como un número que representa el total de milisegundos. | string |