Microsoft.ServiceFabric managedclusters/applications 2023-12-01-preview
- La plus récente
- 2024-04-01
- 2024-02-01-preview
- 2023-12-01-preview
- 2023-11-01-preview
- 2023-09-01-preview
- 2023-07-01-preview
- Préversion du 01/03/2023
- 2023-02-01-preview
- 2022-10-01-preview
- 2022-08-01-preview
- 2022-06-01-preview
- 2022-02-01-preview
- 2022-01-01
- 2021-11-01-preview
- 2021-07-01-preview
- 2021-05-01
- 2021-01-01-preview
Définition de ressource Bicep
Le type de ressource managedclusters/applications peut être déployé avec des opérations qui ciblent :
- Groupes de ressources - Voir commandes de déploiement de groupe de ressources
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/managedclusters/applications, ajoutez le Bicep suivant à votre modèle.
resource symbolicname 'Microsoft.ServiceFabric/managedclusters/applications@2023-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'
}
]
parameters: {
{customized property}: '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
instanceCloseDelayDuration: int
recreateApplication: bool
rollingUpgradeMonitoringPolicy: {
failureAction: 'string'
healthCheckRetryTimeout: 'string'
healthCheckStableDuration: 'string'
healthCheckWaitDuration: 'string'
upgradeDomainTimeout: 'string'
upgradeTimeout: 'string'
}
upgradeMode: 'string'
upgradeReplicaSetCheckTimeout: int
}
version: 'string'
}
}
Valeurs de propriétés
managedclusters/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 | 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 : managedclusters |
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[] |
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 |
upgradePolicy | Décrit la stratégie pour une mise à niveau d’application supervisée. | ApplicationUpgradePolicy |
version | Version du type d’application indiquée dans le manifeste de l’application. Ce nom doit être l’ID de ressource Arm complet pour la version du type d’application référencé. |
string |
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) |
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. | ApplicationHealthPolicy |
forceRestart | Si la valeur est true, les processus sont redémarrés de force pendant la mise à niveau même si la version du code n’a pas changé (la mise à niveau modifie uniquement la configuration ou les données). | bool |
instanceCloseDelayDuration | Durée en secondes, pour attendre qu’une instance sans état soit fermée, pour permettre aux requêtes actives de s’écouler correctement. Cela s’applique lorsque le instance se ferme pendant la mise à niveau de l’application/du cluster, uniquement pour les instances dont la durée de délai n’est pas nulle configurée dans la description du service. | int |
recréerApplication | Détermine si l’application doit être recréée lors de la mise à jour. Si value=true, les autres paramètres de stratégie de mise à niveau ne sont pas autorisés. | bool |
rollingUpgradeMonitoringPolicy | Stratégie utilisée pour surveiller la mise à niveau de l’application | RollingUpgradeMonitoringPolicy |
upgradeMode | Mode utilisé pour surveiller l’intégrité pendant une mise à niveau propagée. Les valeurs sont Monitor et UnmonitoredAuto. | 'Surveillé' 'UnmonitoredAuto' |
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é). | int |
ApplicationHealthPolicy
Nom | Description | Valeur |
---|---|---|
considerWarningAsError | Indique si les avertissements sont traités avec le même niveau de gravité que les erreurs. | bool (obligatoire) |
defaultServiceTypeHealthPolicy | Stratégie d’intégrité utilisée par défaut pour évaluer l’intégrité d’un type de service. | ServiceTypeHealthPolicy |
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 défectueuses 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 par rapport au 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 (obligatoire) |
serviceTypeHealthPolicyMap | Mappage avec la stratégie d’intégrité de type de service par nom de type de service. Par défaut, le mappage est vide. | ServiceTypeHealthPolicyMap |
ServiceTypeHealthPolicy
Nom | Description | Valeur |
---|---|---|
maxPercentUnhealthyPartitionsPerService | Pourcentage maximal autorisé de partitions non saines par service. Le pourcentage représente le pourcentage maximal toléré de partitions qui peuvent être défectueuses avant que le service ne soit considéré comme étant en erreur. Si le pourcentage est respecté, mais qu’il existe au moins une partition non saine, l’intégrité est évaluée comme Avertissement. Le pourcentage est calculé en divisant le nombre de partitions non saines par rapport au nombre total de partitions dans le service. Le calcul s’arrondit pour tolérer un échec sur un petit nombre de partitions. |
int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 100 |
maxPercentUnhealthyReplicasPerPartition | Pourcentage maximal autorisé de réplicas défectueux par partition. Le pourcentage représente le pourcentage maximal toléré de réplicas qui peuvent être défectueux avant que la partition ne soit considérée comme étant en erreur. Si le pourcentage est respecté, mais qu’il existe au moins un réplica défectueux, l’intégrité est évaluée comme Avertissement. Le pourcentage est calculé en divisant le nombre de réplicas défectueux par rapport au nombre total de réplicas dans la partition. Le calcul s’arrondit pour tolérer une défaillance sur un petit nombre de réplicas. |
int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 100 |
maxPercentUnhealthyServices | Pourcentage maximal autorisé de services défectueux. Le pourcentage représente le pourcentage maximal toléré de services qui peuvent être défectueux avant que l’application ne soit considérée comme étant en erreur. Si le pourcentage est respecté, mais qu’il existe au moins un service défectueux, l’intégrité est évaluée comme Avertissement. Cela est calculé en divisant le nombre de services défectueux du type de service spécifique par rapport au nombre total de services du type de service spécifique. Le calcul s’arrondit pour tolérer une défaillance sur un petit nombre de services. |
int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 100 |
ServiceTypeHealthPolicyMap
Nom | Description | Valeur |
---|---|---|
{propriété personnalisée} | ServiceTypeHealthPolicy |
RollingUpgradeMonitoringPolicy
Nom | Description | Valeur |
---|---|---|
failureAction | Action de compensation à effectuer quand une mise à niveau de type Surveillé détecte des violations de stratégie de surveillance ou de stratégie d’intégrité. Non valide indique que l’action d’échec n’est pas valide. La restauration spécifie que la mise à niveau commencera automatiquement à être rétablie. Manual indique que la mise à niveau bascule vers le mode de mise à niveau UnmonitoredManual. | 'Manuel' 'Rollback' (obligatoire) |
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 interprétée comme une chaîne représentant une durée ISO 8601 au format suivant « hh :mm :ss.fff ». | chaîne (obligatoire) |
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 interprétée comme une chaîne représentant une durée ISO 8601 au format suivant « hh :mm :ss.fff ». | chaîne (obligatoire) |
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 interprétée comme une chaîne représentant une durée ISO 8601 au format suivant « hh :mm :ss.fff ». | chaîne (obligatoire) |
upgradeDomainTimeout | Durée d’exécution de chaque domaine de mise à niveau avant l’exécution de FailureAction. Ne peut pas dépasser 12 heures. Elle est interprétée comme une chaîne représentant une durée ISO 8601 au format suivant « hh :mm :ss.fff ». | chaîne (obligatoire) |
upgradeTimeout | Durée d’exécution de l’ensemble de la mise à niveau avant l’exécution de FailureAction. Ne peut pas dépasser 12 heures. Elle est interprétée comme une chaîne représentant une durée ISO 8601 au format suivant « hh :mm :ss.fff ». | chaîne (obligatoire) |
Définition de ressources de modèle ARM
Le type de ressource managedclusters/applications peut être déployé avec des opérations qui ciblent :
- Groupes de ressources - Voir commandes de déploiement de 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/managedclusters/applications, ajoutez le JSON suivant à votre modèle.
{
"type": "Microsoft.ServiceFabric/managedclusters/applications",
"apiVersion": "2023-12-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"properties": {
"managedIdentities": [
{
"name": "string",
"principalId": "string"
}
],
"parameters": {
"{customized property}": "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",
"instanceCloseDelayDuration": "int",
"recreateApplication": "bool",
"rollingUpgradeMonitoringPolicy": {
"failureAction": "string",
"healthCheckRetryTimeout": "string",
"healthCheckStableDuration": "string",
"healthCheckWaitDuration": "string",
"upgradeDomainTimeout": "string",
"upgradeTimeout": "string"
},
"upgradeMode": "string",
"upgradeReplicaSetCheckTimeout": "int"
},
"version": "string"
}
}
Valeurs de propriétés
managedclusters/applications
Nom | Description | Valeur |
---|---|---|
type | Type de ressource | « Microsoft.ServiceFabric/managedclusters/applications » |
apiVersion | Version de l’API de ressource | « 2023-12-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 | 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[] |
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 |
upgradePolicy | Décrit la stratégie pour une mise à niveau d’application surveillée. | ApplicationUpgradePolicy |
version | Version du type d’application indiquée dans le manifeste de l’application. Ce nom doit être l’ID de ressource Arm complet pour la version de type d’application référencée. |
string |
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) |
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. | ApplicationHealthPolicy |
forceRestart | Si la valeur est true, les processus sont redémarrés de force pendant la mise à niveau même si la version du code n’a pas changé (la mise à niveau modifie uniquement la configuration ou les données). | bool |
instanceCloseDelayDuration | Durée en secondes, pour attendre qu’une instance sans état soit fermée, pour permettre aux requêtes actives de s’écouler correctement. Cela s’applique lorsque le instance se ferme pendant la mise à niveau de l’application/du cluster, uniquement pour les instances dont la durée de délai n’est pas nulle configurée dans la description du service. | int |
recréerApplication | Détermine si l’application doit être recréée lors de la mise à jour. Si value=true, les autres paramètres de stratégie de mise à niveau ne sont pas autorisés. | bool |
rollingUpgradeMonitoringPolicy | Stratégie utilisée pour surveiller la mise à niveau de l’application | RollingUpgradeMonitoringPolicy |
upgradeMode | Mode utilisé pour surveiller l’intégrité pendant une mise à niveau propagée. Les valeurs sont Monitor et UnmonitoredAuto. | 'Surveillé' 'UnmonitoredAuto' |
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é). | int |
ApplicationHealthPolicy
Nom | Description | Valeur |
---|---|---|
considerWarningAsError | Indique si les avertissements sont traités avec le même niveau de gravité que les erreurs. | bool (obligatoire) |
defaultServiceTypeHealthPolicy | Stratégie d’intégrité utilisée par défaut pour évaluer l’intégrité d’un type de service. | ServiceTypeHealthPolicy |
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 défectueuses 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 par rapport au 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 (obligatoire) |
serviceTypeHealthPolicyMap | Mappage avec la stratégie d’intégrité de type de service par nom de type de service. Par défaut, le mappage est vide. | ServiceTypeHealthPolicyMap |
ServiceTypeHealthPolicy
Nom | Description | Valeur |
---|---|---|
maxPercentUnhealthyPartitionsPerService | Pourcentage maximal autorisé de partitions non saines par service. Le pourcentage représente le pourcentage maximal toléré de partitions qui peuvent être défectueuses avant que le service ne soit considéré comme étant en erreur. Si le pourcentage est respecté, mais qu’il existe au moins une partition non saine, l’intégrité est évaluée comme Avertissement. Le pourcentage est calculé en divisant le nombre de partitions non saines par rapport au nombre total de partitions dans le service. Le calcul s’arrondit pour tolérer un échec sur un petit nombre de partitions. |
int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 100 |
maxPercentUnhealthyReplicasPerPartition | Pourcentage maximal autorisé de réplicas non sains par partition. Le pourcentage représente le pourcentage maximal toléré de réplicas qui peuvent être défectueux avant que la partition ne soit considérée comme étant erronée. Si le pourcentage est respecté, mais qu’il existe au moins un réplica non sain, l’intégrité est évaluée en tant qu’avertissement. Le pourcentage est calculé en divisant le nombre de réplicas non sains par rapport au nombre total de réplicas dans la partition. Le calcul s’arrondit pour tolérer un échec sur un petit nombre de réplicas. |
int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 100 |
maxPercentUnhealthyServices | Pourcentage maximal autorisé de services non sains. Le pourcentage représente le pourcentage maximal toléré de services qui peuvent être défectueux avant que l’application ne soit considérée comme étant erronée. Si le pourcentage est respecté mais qu’il existe au moins un service non sain, l’intégrité est évaluée comme Avertissement. Cela est calculé en divisant le nombre de services non sains du type de service spécifique par rapport au nombre total de services du type de service spécifique. Le calcul s’arrondit pour tolérer une défaillance sur un petit nombre de services. |
int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 100 |
ServiceTypeHealthPolicyMap
Nom | Description | Valeur |
---|---|---|
{propriété personnalisée} | ServiceTypeHealthPolicy |
RollingUpgradeMonitoringPolicy
Nom | Description | Valeur |
---|---|---|
failureAction | Action de compensation à effectuer quand une mise à niveau de type Surveillé détecte des violations de stratégie de surveillance ou de stratégie d’intégrité. Non valide indique que l’action d’échec n’est pas valide. La restauration spécifie que la mise à niveau commencera automatiquement à restaurer. Manuel indique que la mise à niveau passera en mode de mise à niveau UnmonitoredManual. | 'Manuel' 'Rollback' (obligatoire) |
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 interprétée comme une chaîne représentant une durée ISO 8601 au format « hh :mm :ss.fff ». | string (obligatoire) |
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 interprétée comme une chaîne représentant une durée ISO 8601 au format « hh :mm :ss.fff ». | string (obligatoire) |
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 interprétée comme une chaîne représentant une durée ISO 8601 au format « hh :mm :ss.fff ». | string (obligatoire) |
upgradeDomainTimeout | Durée d’exécution de chaque domaine de mise à niveau avant l’exécution de FailureAction. Ne peut pas dépasser 12 heures. Elle est interprétée comme une chaîne représentant une durée ISO 8601 au format « hh :mm :ss.fff ». | string (obligatoire) |
upgradeTimeout | Durée d’exécution de l’ensemble de la mise à niveau avant l’exécution de FailureAction. Ne peut pas dépasser 12 heures. Elle est interprétée comme une chaîne représentant une durée ISO 8601 au format « hh :mm :ss.fff ». | string (obligatoire) |
Définition de ressource Terraform (fournisseur AzAPI)
Le type de ressource managedclusters/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 d’API, consultez journal des modifications.
Format des ressources
Pour créer une ressource Microsoft.ServiceFabric/managedclusters/applications, ajoutez le Terraform suivant à votre modèle.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceFabric/managedclusters/applications@2023-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"
}
]
parameters = {
{customized property} = "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
instanceCloseDelayDuration = int
recreateApplication = bool
rollingUpgradeMonitoringPolicy = {
failureAction = "string"
healthCheckRetryTimeout = "string"
healthCheckStableDuration = "string"
healthCheckWaitDuration = "string"
upgradeDomainTimeout = "string"
upgradeTimeout = "string"
}
upgradeMode = "string"
upgradeReplicaSetCheckTimeout = int
}
version = "string"
}
})
}
Valeurs de propriétés
managedclusters/applications
Nom | Description | Valeur |
---|---|---|
type | Type de ressource | « Microsoft.ServiceFabric/managedclusters/applications@2023-12-01-preview » |
name | Nom de la ressource | string (obligatoire) |
location | 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 de ressource de type : managedclusters |
tags | Balises de ressource 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[] |
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 |
upgradePolicy | Décrit la stratégie pour une mise à niveau d’application surveillée. | ApplicationUpgradePolicy |
version | Version du type d’application indiquée dans le manifeste de l’application. Ce nom doit être l’ID de ressource Arm complet pour la version de type d’application référencée. |
string |
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) |
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. | ApplicationHealthPolicy |
forceRestart | Si la valeur est true, les processus sont redémarrés de force pendant la mise à niveau même si la version du code n’a pas changé (la mise à niveau modifie uniquement la configuration ou les données). | bool |
instanceCloseDelayDuration | Durée en secondes, pour attendre qu’une instance sans état soit fermée, pour permettre aux requêtes actives de s’écouler correctement. Cela s’applique lorsque le instance se ferme pendant la mise à niveau de l’application/du cluster, uniquement pour les instances dont la durée de délai n’est pas nulle configurée dans la description du service. | int |
recréerApplication | Détermine si l’application doit être recréée lors de la mise à jour. Si value=true, les autres paramètres de stratégie de mise à niveau ne sont pas autorisés. | bool |
rollingUpgradeMonitoringPolicy | Stratégie utilisée pour surveiller la mise à niveau de l’application | RollingUpgradeMonitoringPolicy |
upgradeMode | Mode utilisé pour surveiller l’intégrité pendant une mise à niveau propagée. Les valeurs sont Monitor et UnmonitoredAuto. | « Surveillé » « UnmonitoredAuto » |
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é). | int |
ApplicationHealthPolicy
Nom | Description | Valeur |
---|---|---|
considerWarningAsError | Indique si les avertissements sont traités avec le même niveau de gravité que les erreurs. | bool (obligatoire) |
defaultServiceTypeHealthPolicy | Stratégie d’intégrité utilisée par défaut pour évaluer l’intégrité d’un type de service. | ServiceTypeHealthPolicy |
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 défectueuses 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 par rapport au 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 (obligatoire) |
serviceTypeHealthPolicyMap | Mappage avec la stratégie d’intégrité de type de service par nom de type de service. Par défaut, le mappage est vide. | ServiceTypeHealthPolicyMap |
ServiceTypeHealthPolicy
Nom | Description | Valeur |
---|---|---|
maxPercentUnhealthyPartitionsPerService | Pourcentage maximal autorisé de partitions non saines par service. Le pourcentage représente le pourcentage maximal toléré de partitions qui peuvent être non saines avant que le service ne soit considéré comme étant en erreur. Si le pourcentage est respecté, mais qu’il existe au moins une partition non saine, l’intégrité est évaluée en tant qu’avertissement. Le pourcentage est calculé en divisant le nombre de partitions non saines par rapport au nombre total de partitions dans le service. Le calcul s’arrondit pour tolérer un échec sur un petit nombre de partitions. |
int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 100 |
maxPercentUnhealthyReplicasPerPartition | Pourcentage maximal autorisé de réplicas non sains par partition. Le pourcentage représente le pourcentage maximal toléré de réplicas qui peuvent être défectueux avant que la partition ne soit considérée comme étant erronée. Si le pourcentage est respecté, mais qu’il existe au moins un réplica non sain, l’intégrité est évaluée en tant qu’avertissement. Le pourcentage est calculé en divisant le nombre de réplicas non sains par rapport au nombre total de réplicas dans la partition. Le calcul s’arrondit pour tolérer un échec sur un petit nombre de réplicas. |
int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 100 |
maxPercentUnhealthyServices | Pourcentage maximal autorisé de services non sains. Le pourcentage représente le pourcentage maximal toléré de services qui peuvent être défectueux avant que l’application ne soit considérée comme étant erronée. Si le pourcentage est respecté mais qu’il existe au moins un service non sain, l’intégrité est évaluée comme Avertissement. Cela est calculé en divisant le nombre de services non sains du type de service spécifique par rapport au nombre total de services du type de service spécifique. Le calcul s’arrondit pour tolérer une défaillance sur un petit nombre de services. |
int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 100 |
ServiceTypeHealthPolicyMap
Nom | Description | Valeur |
---|---|---|
{propriété personnalisée} | ServiceTypeHealthPolicy |
RollingUpgradeMonitoringPolicy
Nom | Description | Valeur |
---|---|---|
failureAction | Action de compensation à effectuer quand une mise à niveau de type Surveillé détecte des violations de stratégie de surveillance ou de stratégie d’intégrité. Non valide indique que l’action d’échec n’est pas valide. La restauration spécifie que la mise à niveau commencera automatiquement à restaurer. Manuel indique que la mise à niveau passera en mode de mise à niveau UnmonitoredManual. | « Manuel » « Restauration » (obligatoire) |
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 interprétée comme une chaîne représentant une durée ISO 8601 au format « hh :mm :ss.fff ». | string (obligatoire) |
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 interprétée comme une chaîne représentant une durée ISO 8601 au format « hh :mm :ss.fff ». | string (obligatoire) |
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 interprétée comme une chaîne représentant une durée ISO 8601 au format « hh :mm :ss.fff ». | string (obligatoire) |
upgradeDomainTimeout | Durée d’exécution de chaque domaine de mise à niveau avant l’exécution de FailureAction. Ne peut pas dépasser 12 heures. Elle est interprétée comme une chaîne représentant une durée ISO 8601 au format « hh :mm :ss.fff ». | string (obligatoire) |
upgradeTimeout | Durée d’exécution de l’ensemble de la mise à niveau avant l’exécution de FailureAction. Ne peut pas dépasser 12 heures. Elle est interprétée comme une chaîne représentant une durée ISO 8601 au format « hh :mm :ss.fff ». | string (obligatoire) |