Share via

Clusters/applications Microsoft.ServiceFabric 2019-06-01-preview

  • Article

Définition de ressource Bicep

Le type de ressource clusters/applications peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.ServiceFabric/clusters/applications, ajoutez le Bicep suivant à votre modèle.

resource symbolicname 'Microsoft.ServiceFabric/clusters/applications@2019-06-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
      rollingUpgradeMonitoringPolicy: {
        failureAction: 'string'
        healthCheckRetryTimeout: 'string'
        healthCheckStableDuration: 'string'
        healthCheckWaitDuration: 'string'
        upgradeDomainTimeout: 'string'
        upgradeTimeout: 'string'
      }
      upgradeReplicaSetCheckTimeout: 'string'
    }
  }
}

Valeurs de propriétés

clusters/applications

Nom Description Valeur
name Nom de la ressource

Découvrez comment définir des noms et des types pour des ressources enfants dans Bicep.		 string (obligatoire)
location Elle sera déconseillée dans Nouvelle API, l’emplacement de la ressource dépend de la ressource parente. string
tags Balises de ressource Azure. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
parent Dans Bicep, vous pouvez spécifier la ressource parente pour une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez Ressource enfant en dehors de la ressource parente.		 Nom symbolique de la ressource de type : clusters
identité Décrit les identités managées pour une ressource Azure. ManagedIdentity
properties Propriétés de la ressource d’application. ApplicationResourceProperties

ManagedIdentity

Nom Description Valeur
type Type d’identité managée pour la ressource. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Liste des identités utilisateur associées à la ressource. Les références de clé du dictionnaire d’identité utilisateur seront des ID de ressource ARM au format :
« /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».
 UserAssignedIdentityMap

UserAssignedIdentityMap

Nom Description Valeur
{propriété personnalisée} userAssignedIdentity

userAssignedIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

ApplicationResourceProperties

Nom Description Valeur
managedIdentities Liste des identités affectées par l’utilisateur pour l’application, chacune mappée à un nom convivial. ApplicationUserAssignedIdentity[]
maximumNodes Nombre maximal de nœuds sur lesquels Service Fabric réserve de la capacité pour cette application. Notez que cela ne signifie pas que les services de cette application sont placés sur tous les nœuds. Par défaut, la valeur de cette propriété est zéro, ce qui signifie que les services peuvent être placés sur n’importe quel nœud. int

Contraintes :
Valeur minimale = 0
Mesures Liste de la description des métriques de capacité d’application. ApplicationMetricDescription[]
minimumNodes Nombre minimal de nœuds sur lesquels Service Fabric réserve de la capacité pour cette application. Notez que cela ne signifie pas que les services de cette application sont placés sur tous les nœuds. Si cette propriété est définie sur zéro, aucune capacité n’est réservée. La valeur de cette propriété ne peut pas être supérieure à la valeur de la propriété MaximumNodes. int

Contraintes :
Valeur minimale = 0
parameters Liste des paramètres d’application avec des valeurs remplacées à partir de leurs valeurs par défaut spécifiées dans le manifeste de l’application. ApplicationParameterList
removeApplicationCapacity Supprimez les paramètres de capacité d’application actuels. bool
typeName Nom du type d’application tel que défini dans le manifeste de l’application. string
typeVersion Version du type d’application indiquée dans le manifeste de l’application. string
upgradePolicy Décrit la stratégie pour une mise à niveau d’application supervisée. ApplicationUpgradePolicy

ApplicationUserAssignedIdentity

Nom Description Valeur
name Nom convivial de l’identité affectée par l’utilisateur. string (obligatoire)
principalId ID principal de l’identité affectée par l’utilisateur. string (obligatoire)

ApplicationMetricDescription

Nom Description Valeur
maximumCapacity Capacité de nœud maximale pour l’application Service Fabric.
Il s’agit de la charge maximale pour un instance de cette application sur un seul nœud. Même si la capacité du nœud est supérieure à cette valeur, Service Fabric limite la charge totale des services au sein de l’application sur chaque nœud à cette valeur.
Si la valeur est zéro, la capacité de cette métrique est illimitée sur chaque nœud.
Lors de la création d’une application avec une capacité d’application définie, le produit de MaximumNodes et cette valeur doivent toujours être inférieurs ou égaux à TotalApplicationCapacity.
Lors de la mise à jour d’une application existante avec la capacité de l’application, le produit de MaximumNodes et cette valeur doivent toujours être inférieurs ou égaux à TotalApplicationCapacity.		 int
name Nom de la mesure. string
reservationCapacity Capacité de réservation de nœud pour l’application Service Fabric.
Il s’agit de la quantité de charge qui est réservée sur les nœuds qui ont des instances de cette application.
Si MinimumNodes est spécifié, le produit de ces valeurs sera la capacité réservée dans le cluster pour l’application.
Si la valeur est zéro, aucune capacité n’est réservée à cette métrique.
Lors de la définition de la capacité de l’application ou de la mise à jour de la capacité de l’application ; cette valeur doit être inférieure ou égale à MaximumCapacity pour chaque métrique.		 int
totalApplicationCapacity Capacité de métrique totale pour l’application Service Fabric.
Il s’agit de la capacité de métrique totale de cette application dans le cluster. Service Fabric tente de limiter la somme des charges de services au sein de l’application à cette valeur.
Lors de la création d’une application avec une capacité d’application définie, le produit de MaximumNodes et MaximumCapacity doit toujours être inférieur ou égal à cette valeur.
 int

ApplicationParameterList

Nom Description Valeur
{propriété personnalisée} string

ApplicationUpgradePolicy

Nom Description Valeur
applicationHealthPolicy Définit une stratégie d’intégrité utilisée pour évaluer l’intégrité d’une application ou de l’une de ses entités enfants. ArmApplicationHealthPolicy
forceRestart Si la valeur est true, les processus sont redémarrés de force pendant la mise à niveau, même lorsque la version du code n’a pas changé (la mise à niveau modifie uniquement la configuration ou les données). bool
rollingUpgradeMonitoringPolicy Stratégie utilisée pour surveiller la mise à niveau de l’application ArmRollingUpgradeMonitoringPolicy
upgradeReplicaSetCheckTimeout Durée maximale pendant laquelle bloquer le traitement d’un domaine de mise à niveau et éviter la perte de disponibilité en cas de problèmes inattendus. Lorsque ce délai d’attente expire, le traitement du domaine de mise à niveau se poursuit, indépendamment des problèmes de perte de disponibilité. Le délai d’expiration est réinitialisé au début de chaque domaine de mise à niveau. Les valeurs valides sont comprises entre 0 et 42949672925 inclus. (entier 32 bits non signé). string

ArmApplicationHealthPolicy

Nom Description Valeur
considerWarningAsError Indique si les avertissements sont traités avec le même niveau de gravité que les erreurs. bool
defaultServiceTypeHealthPolicy Stratégie d’intégrité utilisée par défaut pour évaluer l’intégrité d’un type de service. ArmServiceTypeHealthPolicy
maxPercentUnhealthyDeployedApplications Pourcentage maximal autorisé d’applications déployées non saines. Les valeurs autorisées sont des valeurs d’octet comprises entre zéro et 100.
Le pourcentage représente le pourcentage maximal toléré d’applications déployées qui peuvent être non saines avant que l’application ne soit considérée comme étant en erreur.
Cela est calculé en divisant le nombre d’applications déployées non saines sur le nombre de nœuds sur lesquels l’application est actuellement déployée dans le cluster.
Le calcul est arrondi pour tolérer une défaillance sur un petit nombre de nœuds. Le pourcentage par défaut est zéro.		 int
serviceTypeHealthPolicyMap Mapper avec la stratégie d’intégrité de type de service par nom de type de service. Par défaut, le mappage est vide. ArmServiceTypeHealthPolicyMap

ArmServiceTypeHealthPolicy

Nom Description Valeur
maxPercentUnhealthyPartitionsPerService Pourcentage maximal de partitions par service autorisé à être défectueux avant que votre application ne soit considérée comme étant en erreur. int

Contraintes :
Valeur minimale = 0
Valeur maximale = 100
maxPercentUnhealthyReplicasPerPartition Pourcentage maximal de réplicas par partition autorisé à être défectueux avant que votre application ne soit considérée comme étant en erreur. int

Contraintes :
Valeur minimale = 0
Valeur maximale = 100
maxPercentUnhealthyServices Pourcentage maximal de services autorisés à être défectueux avant que votre application ne soit considérée comme étant en erreur. int

Contraintes :
Valeur minimale = 0
Valeur maximale = 100

ArmServiceTypeHealthPolicyMap

Nom Description Valeur
{propriété personnalisée} ArmServiceTypeHealthPolicy

ArmRollingUpgradeMonitoringPolicy

Nom Description Valeur
failureAction Mode d’activation du package de service 'Manuel'
'Rollback'
healthCheckRetryTimeout Durée pendant laquelle effectuer des tentatives d’évaluation d’intégrité lorsque l’application ou le cluster ne sont pas sains, avant l’exécution d’un action FailureAction. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string
healthCheckStableDuration Durée pendant laquelle l’application ou le cluster doivent rester sains avant que la mise à niveau ne passe au domaine de mise à niveau suivant. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string
healthCheckWaitDuration Délai d’attente entre l’achèvement d’un domaine de mise à niveau et l’application des stratégies d’intégrité. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string
upgradeDomainTimeout Durée d’exécution de chaque domaine de mise à niveau avant l’exécution de FailureAction. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string
upgradeTimeout Durée d’exécution de l’ensemble de la mise à niveau avant l’exécution de FailureAction. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string

Définition de ressources de modèle ARM

Le type de ressource clusters/applications peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.ServiceFabric/clusters/applications, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.ServiceFabric/clusters/applications",
  "apiVersion": "2019-06-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",
      "rollingUpgradeMonitoringPolicy": {
        "failureAction": "string",
        "healthCheckRetryTimeout": "string",
        "healthCheckStableDuration": "string",
        "healthCheckWaitDuration": "string",
        "upgradeDomainTimeout": "string",
        "upgradeTimeout": "string"
      },
      "upgradeReplicaSetCheckTimeout": "string"
    }
  }
}

Valeurs de propriétés

clusters/applications

Nom Description Valeur
type Type de ressource « Microsoft.ServiceFabric/clusters/applications »
apiVersion Version de l’API de ressource '2019-06-01-preview'
name Nom de la ressource

Découvrez comment définir des noms et des types pour des ressources enfants dans des modèles ARM JSON.		 chaîne (obligatoire)
location Il sera déprécié dans Nouvelle API, l’emplacement de la ressource dépend de la ressource parente. string
tags Balises de ressources Azure. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
identité Décrit les identités managées pour une ressource Azure. ManagedIdentity
properties Propriétés de la ressource d’application. ApplicationResourceProperties

ManagedIdentity

Nom Description Valeur
type Type d’identité managée pour la ressource. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Liste des identités d’utilisateur associées à la ressource. Les références de clé de dictionnaire d’identité utilisateur seront des ID de ressource ARM au format :
« /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».
 UserAssignedIdentityMap

UserAssignedIdentityMap

Nom Description Valeur
{propriété personnalisée} userAssignedIdentity

userAssignedIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

ApplicationResourceProperties

Nom Description Valeur
managedIdentities Liste des identités affectées par l’utilisateur pour l’application, chacune mappée à un nom convivial. ApplicationUserAssignedIdentity[]
maximumNodes Nombre maximal de nœuds sur lesquels Service Fabric réserve de la capacité pour cette application. Notez que cela ne signifie pas que les services de cette application sont placés sur tous les nœuds. Par défaut, la valeur de cette propriété est zéro, ce qui signifie que les services peuvent être placés sur n’importe quel nœud. int

Contraintes :
Valeur minimale = 0
Mesures Liste de la description des métriques de capacité de l’application. ApplicationMetricDescription[]
minimumNodes Nombre minimal de nœuds sur lesquels Service Fabric réserve de la capacité pour cette application. Notez que cela ne signifie pas que les services de cette application sont placés sur tous les nœuds. Si cette propriété est définie sur zéro, aucune capacité n’est réservée. La valeur de cette propriété ne peut pas être supérieure à la valeur de la propriété MaximumNodes. int

Contraintes :
Valeur minimale = 0
parameters Liste des paramètres d’application avec les valeurs remplacées à partir de leurs valeurs par défaut spécifiées dans le manifeste de l’application. ApplicationParameterList
removeApplicationCapacity Supprimez les paramètres de capacité d’application actuels. bool
typeName Nom du type d’application tel que défini dans le manifeste de l’application. string
typeVersion Version du type d’application indiquée dans le manifeste de l’application. string
upgradePolicy Décrit la stratégie pour une mise à niveau d’application surveillée. ApplicationUpgradePolicy

ApplicationUserAssignedIdentity

Nom Description Valeur
name Nom convivial de l’identité affectée par l’utilisateur. chaîne (obligatoire)
principalId ID principal de l’identité affectée par l’utilisateur. chaîne (obligatoire)

ApplicationMetricDescription

Nom Description Valeur
maximumCapacité Capacité de nœud maximale pour l’application Service Fabric.
Il s’agit de la charge maximale d’un instance de cette application sur un seul nœud. Même si la capacité du nœud est supérieure à cette valeur, Service Fabric limite la charge totale des services au sein de l’application sur chaque nœud à cette valeur.
Si la valeur est égale à zéro, la capacité de cette métrique est illimitée sur chaque nœud.
Lors de la création d’une application dont la capacité d’application est définie, le produit de MaximumNodes et cette valeur doivent toujours être inférieurs ou égaux à TotalApplicationCapacity.
Lors de la mise à jour d’une application existante avec la capacité de l’application, le produit de MaximumNodes et cette valeur doivent toujours être inférieurs ou égaux à TotalApplicationCapacity.		 int
name Nom de la mesure. string
reservationCapacité Capacité de réservation de nœud pour l’application Service Fabric.
Il s’agit de la quantité de charge qui est réservée sur les nœuds qui ont des instances de cette application.
Si MinimumNodes est spécifié, le produit de ces valeurs sera la capacité réservée dans le cluster pour l’application.
Si la valeur est égale à zéro, aucune capacité n’est réservée pour cette métrique.
Lors de la définition de la capacité de l’application ou de la mise à jour de la capacité de l’application ; cette valeur doit être inférieure ou égale à MaximumCapacity pour chaque métrique.		 int
totalApplicationCapacity Capacité de métrique totale pour l’application Service Fabric.
Il s’agit de la capacité de métrique totale de cette application dans le cluster. Service Fabric tente de limiter la somme des charges de services au sein de l’application à cette valeur.
Lors de la création d’une application avec la capacité d’application définie, le produit de MaximumNodes et MaximumCapacity doit toujours être inférieur ou égal à cette valeur.
 int

ApplicationParameterList

Nom Description Valeur
{propriété personnalisée} string

ApplicationUpgradePolicy

Nom Description Valeur
applicationHealthPolicy Définit une stratégie d’intégrité utilisée pour évaluer l’intégrité d’une application ou de l’une de ses entités enfants. ArmApplicationHealthPolicy
forceRestart Si la valeur est true, les processus sont redémarrés de force pendant la mise à niveau, même lorsque la version du code n’a pas changé (la mise à niveau modifie uniquement la configuration ou les données). bool
rollingUpgradeMonitoringPolicy Stratégie utilisée pour surveiller la mise à niveau de l’application ArmRollingUpgradeMonitoringPolicy
upgradeReplicaSetCheckTimeout Durée maximale pendant laquelle bloquer le traitement d’un domaine de mise à niveau et éviter la perte de disponibilité en cas de problèmes inattendus. Lorsque ce délai d’attente expire, le traitement du domaine de mise à niveau se poursuit, indépendamment des problèmes de perte de disponibilité. Le délai d’expiration est réinitialisé au début de chaque domaine de mise à niveau. Les valeurs valides sont comprises entre 0 et 42949672925 inclus. (entier 32 bits non signé). string

ArmApplicationHealthPolicy

Nom Description Valeur
considerWarningAsError Indique si les avertissements sont traités avec le même niveau de gravité que les erreurs. bool
defaultServiceTypeHealthPolicy Stratégie d’intégrité utilisée par défaut pour évaluer l’intégrité d’un type de service. ArmServiceTypeHealthPolicy
maxPercentUnhealthyDeployedApplications Pourcentage maximal autorisé d’applications déployées non saines. Les valeurs autorisées sont des valeurs d’octet comprises entre zéro et 100.
Le pourcentage représente le pourcentage maximal toléré d’applications déployées qui peuvent être non saines avant que l’application ne soit considérée comme étant en erreur.
Cela est calculé en divisant le nombre d’applications déployées non saines sur le nombre de nœuds sur lesquels l’application est actuellement déployée dans le cluster.
Le calcul est arrondi pour tolérer une défaillance sur un petit nombre de nœuds. Le pourcentage par défaut est zéro.		 int
serviceTypeHealthPolicyMap Mapper avec la stratégie d’intégrité de type de service par nom de type de service. Par défaut, le mappage est vide. ArmServiceTypeHealthPolicyMap

ArmServiceTypeHealthPolicy

Nom Description Valeur
maxPercentUnhealthyPartitionsPerService Pourcentage maximal de partitions par service autorisées à être non saines avant que votre application ne soit considérée comme étant erronée. int

Contraintes :
Valeur minimale = 0
Valeur maximale = 100
maxPercentUnhealthyReplicasPerPartition Pourcentage maximal de réplicas par partition autorisé à être défectueux avant que votre application ne soit considérée comme étant erronée. int

Contraintes :
Valeur minimale = 0
Valeur maximale = 100
maxPercentUnhealthyServices Pourcentage maximal de services autorisés à être défectueux avant que votre application ne soit considérée comme étant erronée. int

Contraintes :
Valeur minimale = 0
Valeur maximale = 100

ArmServiceTypeHealthPolicyMap

Nom Description Valeur
{propriété personnalisée} ArmServiceTypeHealthPolicy

ArmRollingUpgradeMonitoringPolicy

Nom Description Valeur
failureAction Mode d’activation du package de services 'Manuel'
'Rollback'
healthCheckRetryTimeout Durée pendant laquelle effectuer des tentatives d’évaluation d’intégrité lorsque l’application ou le cluster ne sont pas sains, avant l’exécution d’un action FailureAction. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string
healthCheckStableDuration Durée pendant laquelle l’application ou le cluster doivent rester sains avant que la mise à niveau ne passe au domaine de mise à niveau suivant. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string
healthCheckWaitDuration Délai d’attente entre l’achèvement d’un domaine de mise à niveau et l’application des stratégies d’intégrité. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string
upgradeDomainTimeout Durée d’exécution de chaque domaine de mise à niveau avant l’exécution de FailureAction. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string
upgradeTimeout Durée d’exécution de l’ensemble de la mise à niveau avant l’exécution de FailureAction. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource clusters/applications peut être déployé avec des opérations qui ciblent :

  • Groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.ServiceFabric/clusters/applications, ajoutez le Terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/clusters/applications@2019-06-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
        rollingUpgradeMonitoringPolicy = {
          failureAction = "string"
          healthCheckRetryTimeout = "string"
          healthCheckStableDuration = "string"
          healthCheckWaitDuration = "string"
          upgradeDomainTimeout = "string"
          upgradeTimeout = "string"
        }
        upgradeReplicaSetCheckTimeout = "string"
      }
    }
  })
}

Valeurs de propriétés

clusters/applications

Nom Description Valeur
type Type de ressource « Microsoft.ServiceFabric/clusters/applications@2019-06-01-preview »
name Nom de la ressource chaîne (obligatoire)
location Il sera déprécié dans Nouvelle API, l’emplacement de la ressource dépend de la ressource parente. string
parent_id ID de la ressource qui est le parent de cette ressource. ID pour la ressource de type : clusters
tags Balises de ressources Azure. Dictionnaire de noms et de valeurs d’étiquettes.
identité Décrit les identités managées pour une ressource Azure. ManagedIdentity
properties Propriétés de la ressource d’application. ApplicationResourceProperties

ManagedIdentity

Nom Description Valeur
type Type d’identité managée pour la ressource. « SystemAssigned »
« SystemAssigned, UserAssigned »
« UserAssigned »
identity_ids Liste des identités d’utilisateur associées à la ressource. Les références de clé de dictionnaire d’identité utilisateur seront des ID de ressource ARM au format :
« /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».
 Tableau d’ID d’identité utilisateur.

UserAssignedIdentityMap

Nom Description Valeur
{propriété personnalisée} userAssignedIdentity

userAssignedIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

ApplicationResourceProperties

Nom Description Valeur
managedIdentities Liste des identités affectées par l’utilisateur pour l’application, chacune mappée à un nom convivial. ApplicationUserAssignedIdentity[]
maximumNodes Nombre maximal de nœuds sur lesquels Service Fabric réserve de la capacité pour cette application. Notez que cela ne signifie pas que les services de cette application sont placés sur tous les nœuds. Par défaut, la valeur de cette propriété est zéro, ce qui signifie que les services peuvent être placés sur n’importe quel nœud. int

Contraintes :
Valeur minimale = 0
Mesures Liste de la description des métriques de capacité de l’application. ApplicationMetricDescription[]
minimumNodes Nombre minimal de nœuds sur lesquels Service Fabric réserve de la capacité pour cette application. Notez que cela ne signifie pas que les services de cette application sont placés sur tous les nœuds. Si cette propriété est définie sur zéro, aucune capacité n’est réservée. La valeur de cette propriété ne peut pas être supérieure à la valeur de la propriété MaximumNodes. int

Contraintes :
Valeur minimale = 0
parameters Liste des paramètres d’application avec les valeurs remplacées à partir de leurs valeurs par défaut spécifiées dans le manifeste de l’application. ApplicationParameterList
removeApplicationCapacity Supprimez les paramètres de capacité d’application actuels. bool
typeName Nom du type d’application tel que défini dans le manifeste de l’application. string
typeVersion Version du type d’application indiquée dans le manifeste de l’application. string
upgradePolicy Décrit la stratégie pour une mise à niveau d’application surveillée. ApplicationUpgradePolicy

ApplicationUserAssignedIdentity

Nom Description Valeur
name Nom convivial de l’identité affectée par l’utilisateur. string (obligatoire)
principalId ID principal de l’identité affectée par l’utilisateur. string (obligatoire)

ApplicationMetricDescription

Nom Description Valeur
maximumCapacity Capacité de nœud maximale pour l’application Service Fabric.
Il s’agit de la charge maximale pour un instance de cette application sur un seul nœud. Même si la capacité du nœud est supérieure à cette valeur, Service Fabric limite la charge totale des services au sein de l’application sur chaque nœud à cette valeur.
Si la valeur est zéro, la capacité de cette métrique est illimitée sur chaque nœud.
Lors de la création d’une application avec une capacité d’application définie, le produit de MaximumNodes et cette valeur doivent toujours être inférieurs ou égaux à TotalApplicationCapacity.
Lors de la mise à jour d’une application existante avec la capacité de l’application, le produit de MaximumNodes et cette valeur doivent toujours être inférieurs ou égaux à TotalApplicationCapacity.		 int
name Nom de la mesure. string
reservationCapacity Capacité de réservation de nœud pour l’application Service Fabric.
Il s’agit de la quantité de charge qui est réservée sur les nœuds qui ont des instances de cette application.
Si MinimumNodes est spécifié, le produit de ces valeurs sera la capacité réservée dans le cluster pour l’application.
Si la valeur est zéro, aucune capacité n’est réservée à cette métrique.
Lors de la définition de la capacité de l’application ou de la mise à jour de la capacité de l’application ; cette valeur doit être inférieure ou égale à MaximumCapacity pour chaque métrique.		 int
totalApplicationCapacity Capacité de métrique totale pour l’application Service Fabric.
Il s’agit de la capacité de métrique totale de cette application dans le cluster. Service Fabric tente de limiter la somme des charges de services au sein de l’application à cette valeur.
Lors de la création d’une application avec une capacité d’application définie, le produit de MaximumNodes et MaximumCapacity doit toujours être inférieur ou égal à cette valeur.
 int

ApplicationParameterList

Nom Description Valeur
{propriété personnalisée} string

ApplicationUpgradePolicy

Nom Description Valeur
applicationHealthPolicy Définit une stratégie d’intégrité utilisée pour évaluer l’intégrité d’une application ou de l’une de ses entités enfants. ArmApplicationHealthPolicy
forceRestart Si la valeur est true, les processus sont redémarrés de force pendant la mise à niveau, même lorsque la version du code n’a pas changé (la mise à niveau modifie uniquement la configuration ou les données). bool
rollingUpgradeMonitoringPolicy Stratégie utilisée pour surveiller la mise à niveau de l’application ArmRollingUpgradeMonitoringPolicy
upgradeReplicaSetCheckTimeout Durée maximale pendant laquelle bloquer le traitement d’un domaine de mise à niveau et éviter la perte de disponibilité en cas de problèmes inattendus. Lorsque ce délai d’attente expire, le traitement du domaine de mise à niveau se poursuit, indépendamment des problèmes de perte de disponibilité. Le délai d’expiration est réinitialisé au début de chaque domaine de mise à niveau. Les valeurs valides sont comprises entre 0 et 42949672925 inclus. (entier 32 bits non signé). string

ArmApplicationHealthPolicy

Nom Description Valeur
considerWarningAsError Indique si les avertissements sont traités avec le même niveau de gravité que les erreurs. bool
defaultServiceTypeHealthPolicy Stratégie d’intégrité utilisée par défaut pour évaluer l’intégrité d’un type de service. ArmServiceTypeHealthPolicy
maxPercentUnhealthyDeployedApplications Pourcentage maximal autorisé d’applications déployées non saines. Les valeurs autorisées sont des valeurs d’octet comprises entre zéro et 100.
Le pourcentage représente le pourcentage maximal toléré d’applications déployées qui peuvent être non saines avant que l’application ne soit considérée comme étant en erreur.
Cela est calculé en divisant le nombre d’applications déployées non saines sur le nombre de nœuds sur lesquels l’application est actuellement déployée dans le cluster.
Le calcul est arrondi pour tolérer une défaillance sur un petit nombre de nœuds. Le pourcentage par défaut est zéro.		 int
serviceTypeHealthPolicyMap Mapper avec la stratégie d’intégrité de type de service par nom de type de service. Par défaut, le mappage est vide. ArmServiceTypeHealthPolicyMap

ArmServiceTypeHealthPolicy

Nom Description Valeur
maxPercentUnhealthyPartitionsPerService Pourcentage maximal de partitions par service autorisées à être non saines avant que votre application ne soit considérée comme étant erronée. int

Contraintes :
Valeur minimale = 0
Valeur maximale = 100
maxPercentUnhealthyReplicasPerPartition Pourcentage maximal de réplicas par partition autorisé à être défectueux avant que votre application ne soit considérée comme étant erronée. int

Contraintes :
Valeur minimale = 0
Valeur maximale = 100
maxPercentUnhealthyServices Pourcentage maximal de services autorisés à être défectueux avant que votre application ne soit considérée comme étant erronée. int

Contraintes :
Valeur minimale = 0
Valeur maximale = 100

ArmServiceTypeHealthPolicyMap

Nom Description Valeur
{propriété personnalisée} ArmServiceTypeHealthPolicy

ArmRollingUpgradeMonitoringPolicy

Nom Description Valeur
failureAction Mode d’activation du package de services « Manuel »
« Restauration »
healthCheckRetryTimeout Durée pendant laquelle effectuer des tentatives d’évaluation d’intégrité lorsque l’application ou le cluster ne sont pas sains, avant l’exécution d’un action FailureAction. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string
healthCheckStableDuration Durée pendant laquelle l’application ou le cluster doivent rester sains avant que la mise à niveau ne passe au domaine de mise à niveau suivant. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string
healthCheckWaitDuration Délai d’attente entre l’achèvement d’un domaine de mise à niveau et l’application des stratégies d’intégrité. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string
upgradeDomainTimeout Durée d’exécution de chaque domaine de mise à niveau avant l’exécution de FailureAction. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string
upgradeTimeout Durée d’exécution de l’ensemble de la mise à niveau avant l’exécution de FailureAction. Elle est d’abord interprétée en tant que chaîne représentant une durée ISO 8601. Si cette tentative échoue, elle est interprétée comme un nombre représentant le nombre total de millisecondes. string