Microsoft.ServiceFabric クラスター/アプリケーション 2023-11-01-preview
Bicep リソース定義
クラスター/アプリケーションのリソースの種類は、次を対象とする操作と共にデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.ServiceFabric/clusters/applications リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.ServiceFabric/clusters/applications@2023-11-01-preview' = {
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
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'
}
}
tags: {
{customized property}: 'string'
}
}
プロパティ値
ApplicationMetricDescription
名前 | 形容 | 価値 |
---|---|---|
maximumCapacity | Service Fabric アプリケーションの最大ノード容量。 これは、1 つのノード上のこのアプリケーションのインスタンスの最大負荷です。 ノードの容量がこの値を超える場合でも、Service Fabric は各ノード上のアプリケーション内のサービスの合計負荷をこの値に制限します。 0 に設定すると、このメトリックの容量は各ノードで無制限になります。 アプリケーション容量が定義された新しいアプリケーションを作成する場合、MaximumNodes の積とこの値は常に TotalApplicationCapacity 以下である必要があります。 アプリケーション容量を使用して既存のアプリケーションを更新する場合、MaximumNodes の積とこの値は常に TotalApplicationCapacity 以下である必要があります。 |
int |
名前 | メトリックの名前。 | 糸 |
reservationCapacity | Service Fabric アプリケーションのノード予約容量。 これは、このアプリケーションのインスタンスを持つノードで予約されている負荷の量です。 MinimumNodes が指定されている場合、これらの値の積は、アプリケーションのクラスターで予約されている容量になります。 ゼロに設定すると、このメトリック用に容量は予約されません。 アプリケーション容量を設定する場合、またはアプリケーション容量を更新する場合。この値は、メトリックごとに MaximumCapacity 以下である必要があります。 |
int |
totalApplicationCapacity | Service Fabric アプリケーションの合計メトリック容量。 これは、クラスター内のこのアプリケーションの合計メトリック容量です。 Service Fabric は、アプリケーション内のサービスの負荷の合計をこの値に制限しようとします。 アプリケーション容量が定義された新しいアプリケーションを作成する場合、MaximumNodes と MaximumCapacity の積は常にこの値以下である必要があります。 |
int |
ApplicationParameterList
名前 | 形容 | 価値 |
---|
ApplicationResourceProperties
名前 | 形容 | 価値 |
---|---|---|
managedIdentities | アプリケーションのユーザー割り当て ID の一覧。それぞれがフレンドリ名にマップされます。 | ApplicationUserAssignedIdentity[] |
maximumNodes | Service Fabric がこのアプリケーションの容量を予約するノードの最大数。 これは、このアプリケーションのサービスがすべてのノードに配置されるという意味ではないことに注意してください。 既定では、このプロパティの値は 0 であり、サービスを任意のノードに配置できることを意味します。 | int 制約: 最小値 = 0 |
メトリック | アプリケーション容量メトリックの説明の一覧。 | ApplicationMetricDescription[] |
minimumNodes | Service Fabric がこのアプリケーションの容量を予約するノードの最小数。 これは、このアプリケーションのサービスがすべてのノードに配置されるという意味ではないことに注意してください。 このプロパティが 0 に設定されている場合、容量は予約されません。 このプロパティの値は、MaximumNodes プロパティの値を超えることはできません。 | int 制約: 最小値 = 0 |
パラメーター | アプリケーション マニフェストで指定された既定値からオーバーライドされた値を持つアプリケーション パラメーターの一覧。 | ApplicationParameterList の |
removeApplicationCapacity | 現在のアプリケーション容量設定を削除します。 | bool |
typeName | アプリケーション マニフェストで定義されているアプリケーションの種類の名前。 | 糸 |
typeVersion | アプリケーション マニフェストで定義されているアプリケーションの種類のバージョン。 | 糸 |
upgradePolicy | 監視対象アプリケーションのアップグレードのポリシーについて説明します。 | ApplicationUpgradePolicy の |
ApplicationUpgradePolicy
名前 | 形容 | 価値 |
---|---|---|
applicationHealthPolicy | アプリケーションまたはその子エンティティの正常性を評価するために使用される正常性ポリシーを定義します。 | ArmApplicationHealthPolicy の |
forceRestart | true の場合、コード バージョンが変更されていない場合でも、アップグレード中にプロセスが強制的に再起動されます (アップグレードによって構成またはデータのみが変更されます)。 | bool |
recreateApplication | 更新時にアプリケーションを再作成するかどうかを決定します。 値が true の場合、アップグレード ポリシーパラメーターの残りの部分は許可されず、可用性が失われます。 | bool |
rollingUpgradeMonitoringPolicy | アプリケーションのアップグレードの監視に使用されるポリシー | ArmRollingUpgradeMonitoringPolicy |
upgradeMode | ローリング アップグレード中の正常性の監視に使用されるモード。 値は UnmonitoredAuto、UnmonitoredManual、Monitored です。 | 'Invalid' 'Monitored' 'UnmonitoredAuto' 'UnmonitoredManual' |
upgradeReplicaSetCheckTimeout | アップグレード ドメインの処理をブロックし、予期しない問題が発生した場合の可用性の損失を防ぐための最大時間。 このタイムアウトが切れると、可用性の損失の問題に関係なく、アップグレード ドメインの処理が続行されます。 タイムアウトは、各アップグレード ドメインの開始時にリセットされます。 有効な値は 0 ~ 42949672925です。 (符号なし 32 ビット整数)。 | 糸 |
ApplicationUserAssignedIdentity
名前 | 形容 | 価値 |
---|---|---|
名前 | ユーザー割り当て ID のフレンドリ名。 | string (必須) |
principalId | ユーザー割り当て ID のプリンシパル ID。 | string (必須) |
ArmApplicationHealthPolicy
名前 | 形容 | 価値 |
---|---|---|
considerWarningAsError | 警告がエラーと同じ重大度で処理されるかどうかを示します。 | bool |
defaultServiceTypeHealthPolicy | サービスの種類の正常性を評価するために既定で使用される正常性ポリシー。 | ArmServiceTypeHealthPolicy |
maxPercentUnhealthyDeployedApplications | 異常なデプロイ済みアプリケーションの最大許容割合。 使用できる値は、0 から 100 までのバイト値です。 この割合は、アプリケーションがエラーと見なされる前に異常になる可能性がある、デプロイされたアプリケーションの許容される最大割合を表します。 これは、異常にデプロイされたアプリケーションの数を、アプリケーションがクラスター内で現在デプロイされているノードの数で割ることによって計算されます。 計算は、少数のノードで 1 つの障害を許容するように切り上げられます。 既定のパーセンテージは 0 です。 |
int |
serviceTypeHealthPolicyMap | サービスの種類の名前ごとのサービスの種類の正常性ポリシーを含むマップ。 既定では、マップは空です。 | ArmServiceTypeHealthPolicyMap |
ArmRollingUpgradeMonitoringPolicy
名前 | 形容 | 価値 |
---|---|---|
failureAction | サービス パッケージのアクティブ化モード | 'Manual' 'Rollback' |
healthCheckRetryTimeout | FailureAction が実行されるまでにアプリケーションまたはクラスターが異常な場合に正常性評価を再試行する時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
healthCheckStableDuration | アップグレードが次のアップグレード ドメインに進む前に、アプリケーションまたはクラスターが正常な状態を維持する必要がある時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
healthCheckWaitDuration | アップグレード ドメインを完了してから正常性ポリシーを適用するまでの待機時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
upgradeDomainTimeout | FailureAction が実行されるまでに各アップグレード ドメインが完了する必要がある時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
upgradeTimeout | FailureAction が実行されるまでにアップグレード全体が完了する必要がある時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
ArmServiceTypeHealthPolicy
名前 | 形容 | 価値 |
---|---|---|
maxPercentUnhealthyPartitionsPerService | アプリケーションがエラーと見なされる前に、サービスごとのパーティションの最大割合が異常であることが許可されています。 | int 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyReplicasPerPartition | アプリケーションがエラーと見なされる前に、パーティションあたりのレプリカの最大割合が異常であることが許可されています。 | int 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyServices | アプリケーションがエラーと見なされる前に、サービスの異常が許容される最大割合。 | int 制約: 最小値 = 0 最大値 = 100 |
ArmServiceTypeHealthPolicyMap
名前 | 形容 | 価値 |
---|
ManagedIdentity
名前 | 形容 | 価値 |
---|---|---|
種類 | リソースのマネージド ID の種類。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | リソースに関連付けられているユーザー ID の一覧。 ユーザー ID ディクショナリ キー参照は、次の形式の ARM リソース ID になります。 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
UserAssignedIdentityMap の |
Microsoft.ServiceFabric/clusters/applications
名前 | 形容 | 価値 |
---|---|---|
同一性 | Azure リソースのマネージド ID について説明します。 | ManagedIdentity |
場所 | 新しい API では非推奨になります。リソースの場所は親リソースによって異なります。 | 糸 |
名前 | リソース名 | string (必須) |
親 | Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。 詳細については、「親リソースの外部 |
種類のリソースのシンボリック名: クラスター |
プロパティ | アプリケーション リソースのプロパティ。 | ApplicationResourceProperties の |
タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
ProxyResourceTags
名前 | 形容 | 価値 |
---|
UserAssignedIdentity
名前 | 形容 | 価値 |
---|
UserAssignedIdentityMap
名前 | 形容 | 価値 |
---|
ARM テンプレート リソース定義
クラスター/アプリケーションのリソースの種類は、次を対象とする操作と共にデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.ServiceFabric/clusters/applications リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.ServiceFabric/clusters/applications",
"apiVersion": "2023-11-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"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"
}
},
"tags": {
"{customized property}": "string"
}
}
プロパティ値
ApplicationMetricDescription
名前 | 形容 | 価値 |
---|---|---|
maximumCapacity | Service Fabric アプリケーションの最大ノード容量。 これは、1 つのノード上のこのアプリケーションのインスタンスの最大負荷です。 ノードの容量がこの値を超える場合でも、Service Fabric は各ノード上のアプリケーション内のサービスの合計負荷をこの値に制限します。 0 に設定すると、このメトリックの容量は各ノードで無制限になります。 アプリケーション容量が定義された新しいアプリケーションを作成する場合、MaximumNodes の積とこの値は常に TotalApplicationCapacity 以下である必要があります。 アプリケーション容量を使用して既存のアプリケーションを更新する場合、MaximumNodes の積とこの値は常に TotalApplicationCapacity 以下である必要があります。 |
int |
名前 | メトリックの名前。 | 糸 |
reservationCapacity | Service Fabric アプリケーションのノード予約容量。 これは、このアプリケーションのインスタンスを持つノードで予約されている負荷の量です。 MinimumNodes が指定されている場合、これらの値の積は、アプリケーションのクラスターで予約されている容量になります。 ゼロに設定すると、このメトリック用に容量は予約されません。 アプリケーション容量を設定する場合、またはアプリケーション容量を更新する場合。この値は、メトリックごとに MaximumCapacity 以下である必要があります。 |
int |
totalApplicationCapacity | Service Fabric アプリケーションの合計メトリック容量。 これは、クラスター内のこのアプリケーションの合計メトリック容量です。 Service Fabric は、アプリケーション内のサービスの負荷の合計をこの値に制限しようとします。 アプリケーション容量が定義された新しいアプリケーションを作成する場合、MaximumNodes と MaximumCapacity の積は常にこの値以下である必要があります。 |
int |
ApplicationParameterList
名前 | 形容 | 価値 |
---|
ApplicationResourceProperties
名前 | 形容 | 価値 |
---|---|---|
managedIdentities | アプリケーションのユーザー割り当て ID の一覧。それぞれがフレンドリ名にマップされます。 | ApplicationUserAssignedIdentity[] |
maximumNodes | Service Fabric がこのアプリケーションの容量を予約するノードの最大数。 これは、このアプリケーションのサービスがすべてのノードに配置されるという意味ではないことに注意してください。 既定では、このプロパティの値は 0 であり、サービスを任意のノードに配置できることを意味します。 | int 制約: 最小値 = 0 |
メトリック | アプリケーション容量メトリックの説明の一覧。 | ApplicationMetricDescription[] |
minimumNodes | Service Fabric がこのアプリケーションの容量を予約するノードの最小数。 これは、このアプリケーションのサービスがすべてのノードに配置されるという意味ではないことに注意してください。 このプロパティが 0 に設定されている場合、容量は予約されません。 このプロパティの値は、MaximumNodes プロパティの値を超えることはできません。 | int 制約: 最小値 = 0 |
パラメーター | アプリケーション マニフェストで指定された既定値からオーバーライドされた値を持つアプリケーション パラメーターの一覧。 | ApplicationParameterList の |
removeApplicationCapacity | 現在のアプリケーション容量設定を削除します。 | bool |
typeName | アプリケーション マニフェストで定義されているアプリケーションの種類の名前。 | 糸 |
typeVersion | アプリケーション マニフェストで定義されているアプリケーションの種類のバージョン。 | 糸 |
upgradePolicy | 監視対象アプリケーションのアップグレードのポリシーについて説明します。 | ApplicationUpgradePolicy の |
ApplicationUpgradePolicy
名前 | 形容 | 価値 |
---|---|---|
applicationHealthPolicy | アプリケーションまたはその子エンティティの正常性を評価するために使用される正常性ポリシーを定義します。 | ArmApplicationHealthPolicy の |
forceRestart | true の場合、コード バージョンが変更されていない場合でも、アップグレード中にプロセスが強制的に再起動されます (アップグレードによって構成またはデータのみが変更されます)。 | bool |
recreateApplication | 更新時にアプリケーションを再作成するかどうかを決定します。 値が true の場合、アップグレード ポリシーパラメーターの残りの部分は許可されず、可用性が失われます。 | bool |
rollingUpgradeMonitoringPolicy | アプリケーションのアップグレードの監視に使用されるポリシー | ArmRollingUpgradeMonitoringPolicy |
upgradeMode | ローリング アップグレード中の正常性の監視に使用されるモード。 値は UnmonitoredAuto、UnmonitoredManual、Monitored です。 | 'Invalid' 'Monitored' 'UnmonitoredAuto' 'UnmonitoredManual' |
upgradeReplicaSetCheckTimeout | アップグレード ドメインの処理をブロックし、予期しない問題が発生した場合の可用性の損失を防ぐための最大時間。 このタイムアウトが切れると、可用性の損失の問題に関係なく、アップグレード ドメインの処理が続行されます。 タイムアウトは、各アップグレード ドメインの開始時にリセットされます。 有効な値は 0 ~ 42949672925です。 (符号なし 32 ビット整数)。 | 糸 |
ApplicationUserAssignedIdentity
名前 | 形容 | 価値 |
---|---|---|
名前 | ユーザー割り当て ID のフレンドリ名。 | string (必須) |
principalId | ユーザー割り当て ID のプリンシパル ID。 | string (必須) |
ArmApplicationHealthPolicy
名前 | 形容 | 価値 |
---|---|---|
considerWarningAsError | 警告がエラーと同じ重大度で処理されるかどうかを示します。 | bool |
defaultServiceTypeHealthPolicy | サービスの種類の正常性を評価するために既定で使用される正常性ポリシー。 | ArmServiceTypeHealthPolicy |
maxPercentUnhealthyDeployedApplications | 異常なデプロイ済みアプリケーションの最大許容割合。 使用できる値は、0 から 100 までのバイト値です。 この割合は、アプリケーションがエラーと見なされる前に異常になる可能性がある、デプロイされたアプリケーションの許容される最大割合を表します。 これは、異常にデプロイされたアプリケーションの数を、アプリケーションがクラスター内で現在デプロイされているノードの数で割ることによって計算されます。 計算は、少数のノードで 1 つの障害を許容するように切り上げられます。 既定のパーセンテージは 0 です。 |
int |
serviceTypeHealthPolicyMap | サービスの種類の名前ごとのサービスの種類の正常性ポリシーを含むマップ。 既定では、マップは空です。 | ArmServiceTypeHealthPolicyMap |
ArmRollingUpgradeMonitoringPolicy
名前 | 形容 | 価値 |
---|---|---|
failureAction | サービス パッケージのアクティブ化モード | 'Manual' 'Rollback' |
healthCheckRetryTimeout | FailureAction が実行されるまでにアプリケーションまたはクラスターが異常な場合に正常性評価を再試行する時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
healthCheckStableDuration | アップグレードが次のアップグレード ドメインに進む前に、アプリケーションまたはクラスターが正常な状態を維持する必要がある時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
healthCheckWaitDuration | アップグレード ドメインを完了してから正常性ポリシーを適用するまでの待機時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
upgradeDomainTimeout | FailureAction が実行されるまでに各アップグレード ドメインが完了する必要がある時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
upgradeTimeout | FailureAction が実行されるまでにアップグレード全体が完了する必要がある時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
ArmServiceTypeHealthPolicy
名前 | 形容 | 価値 |
---|---|---|
maxPercentUnhealthyPartitionsPerService | アプリケーションがエラーと見なされる前に、サービスごとのパーティションの最大割合が異常であることが許可されています。 | int 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyReplicasPerPartition | アプリケーションがエラーと見なされる前に、パーティションあたりのレプリカの最大割合が異常であることが許可されています。 | int 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyServices | アプリケーションがエラーと見なされる前に、サービスの異常が許容される最大割合。 | int 制約: 最小値 = 0 最大値 = 100 |
ArmServiceTypeHealthPolicyMap
名前 | 形容 | 価値 |
---|
ManagedIdentity
名前 | 形容 | 価値 |
---|---|---|
種類 | リソースのマネージド ID の種類。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | リソースに関連付けられているユーザー ID の一覧。 ユーザー ID ディクショナリ キー参照は、次の形式の ARM リソース ID になります。 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
UserAssignedIdentityMap の |
Microsoft.ServiceFabric/clusters/applications
名前 | 形容 | 価値 |
---|---|---|
apiVersion | API のバージョン | '2023-11-01-preview' |
同一性 | Azure リソースのマネージド ID について説明します。 | ManagedIdentity |
場所 | 新しい API では非推奨になります。リソースの場所は親リソースによって異なります。 | 糸 |
名前 | リソース名 | string (必須) |
プロパティ | アプリケーション リソースのプロパティ。 | ApplicationResourceProperties の |
タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
種類 | リソースの種類 | 'Microsoft.ServiceFabric/clusters/applications' |
ProxyResourceTags
名前 | 形容 | 価値 |
---|
UserAssignedIdentity
名前 | 形容 | 価値 |
---|
UserAssignedIdentityMap
名前 | 形容 | 価値 |
---|
Terraform (AzAPI プロバイダー) リソース定義
クラスター/アプリケーションのリソースの種類は、次を対象とする操作と共にデプロイできます。
- リソース グループの
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.ServiceFabric/clusters/applications リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceFabric/clusters/applications@2023-11-01-preview"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
tags = {
{customized property} = "string"
}
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"
}
}
})
}
プロパティ値
ApplicationMetricDescription
名前 | 形容 | 価値 |
---|---|---|
maximumCapacity | Service Fabric アプリケーションの最大ノード容量。 これは、1 つのノード上のこのアプリケーションのインスタンスの最大負荷です。 ノードの容量がこの値を超える場合でも、Service Fabric は各ノード上のアプリケーション内のサービスの合計負荷をこの値に制限します。 0 に設定すると、このメトリックの容量は各ノードで無制限になります。 アプリケーション容量が定義された新しいアプリケーションを作成する場合、MaximumNodes の積とこの値は常に TotalApplicationCapacity 以下である必要があります。 アプリケーション容量を使用して既存のアプリケーションを更新する場合、MaximumNodes の積とこの値は常に TotalApplicationCapacity 以下である必要があります。 |
int |
名前 | メトリックの名前。 | 糸 |
reservationCapacity | Service Fabric アプリケーションのノード予約容量。 これは、このアプリケーションのインスタンスを持つノードで予約されている負荷の量です。 MinimumNodes が指定されている場合、これらの値の積は、アプリケーションのクラスターで予約されている容量になります。 ゼロに設定すると、このメトリック用に容量は予約されません。 アプリケーション容量を設定する場合、またはアプリケーション容量を更新する場合。この値は、メトリックごとに MaximumCapacity 以下である必要があります。 |
int |
totalApplicationCapacity | Service Fabric アプリケーションの合計メトリック容量。 これは、クラスター内のこのアプリケーションの合計メトリック容量です。 Service Fabric は、アプリケーション内のサービスの負荷の合計をこの値に制限しようとします。 アプリケーション容量が定義された新しいアプリケーションを作成する場合、MaximumNodes と MaximumCapacity の積は常にこの値以下である必要があります。 |
int |
ApplicationParameterList
名前 | 形容 | 価値 |
---|
ApplicationResourceProperties
名前 | 形容 | 価値 |
---|---|---|
managedIdentities | アプリケーションのユーザー割り当て ID の一覧。それぞれがフレンドリ名にマップされます。 | ApplicationUserAssignedIdentity[] |
maximumNodes | Service Fabric がこのアプリケーションの容量を予約するノードの最大数。 これは、このアプリケーションのサービスがすべてのノードに配置されるという意味ではないことに注意してください。 既定では、このプロパティの値は 0 であり、サービスを任意のノードに配置できることを意味します。 | int 制約: 最小値 = 0 |
メトリック | アプリケーション容量メトリックの説明の一覧。 | ApplicationMetricDescription[] |
minimumNodes | Service Fabric がこのアプリケーションの容量を予約するノードの最小数。 これは、このアプリケーションのサービスがすべてのノードに配置されるという意味ではないことに注意してください。 このプロパティが 0 に設定されている場合、容量は予約されません。 このプロパティの値は、MaximumNodes プロパティの値を超えることはできません。 | int 制約: 最小値 = 0 |
パラメーター | アプリケーション マニフェストで指定された既定値からオーバーライドされた値を持つアプリケーション パラメーターの一覧。 | ApplicationParameterList の |
removeApplicationCapacity | 現在のアプリケーション容量設定を削除します。 | bool |
typeName | アプリケーション マニフェストで定義されているアプリケーションの種類の名前。 | 糸 |
typeVersion | アプリケーション マニフェストで定義されているアプリケーションの種類のバージョン。 | 糸 |
upgradePolicy | 監視対象アプリケーションのアップグレードのポリシーについて説明します。 | ApplicationUpgradePolicy の |
ApplicationUpgradePolicy
名前 | 形容 | 価値 |
---|---|---|
applicationHealthPolicy | アプリケーションまたはその子エンティティの正常性を評価するために使用される正常性ポリシーを定義します。 | ArmApplicationHealthPolicy の |
forceRestart | true の場合、コード バージョンが変更されていない場合でも、アップグレード中にプロセスが強制的に再起動されます (アップグレードによって構成またはデータのみが変更されます)。 | bool |
recreateApplication | 更新時にアプリケーションを再作成するかどうかを決定します。 値が true の場合、アップグレード ポリシーパラメーターの残りの部分は許可されず、可用性が失われます。 | bool |
rollingUpgradeMonitoringPolicy | アプリケーションのアップグレードの監視に使用されるポリシー | ArmRollingUpgradeMonitoringPolicy |
upgradeMode | ローリング アップグレード中の正常性の監視に使用されるモード。 値は UnmonitoredAuto、UnmonitoredManual、Monitored です。 | 'Invalid' 'Monitored' 'UnmonitoredAuto' 'UnmonitoredManual' |
upgradeReplicaSetCheckTimeout | アップグレード ドメインの処理をブロックし、予期しない問題が発生した場合の可用性の損失を防ぐための最大時間。 このタイムアウトが切れると、可用性の損失の問題に関係なく、アップグレード ドメインの処理が続行されます。 タイムアウトは、各アップグレード ドメインの開始時にリセットされます。 有効な値は 0 ~ 42949672925です。 (符号なし 32 ビット整数)。 | 糸 |
ApplicationUserAssignedIdentity
名前 | 形容 | 価値 |
---|---|---|
名前 | ユーザー割り当て ID のフレンドリ名。 | string (必須) |
principalId | ユーザー割り当て ID のプリンシパル ID。 | string (必須) |
ArmApplicationHealthPolicy
名前 | 形容 | 価値 |
---|---|---|
considerWarningAsError | 警告がエラーと同じ重大度で処理されるかどうかを示します。 | bool |
defaultServiceTypeHealthPolicy | サービスの種類の正常性を評価するために既定で使用される正常性ポリシー。 | ArmServiceTypeHealthPolicy |
maxPercentUnhealthyDeployedApplications | 異常なデプロイ済みアプリケーションの最大許容割合。 使用できる値は、0 から 100 までのバイト値です。 この割合は、アプリケーションがエラーと見なされる前に異常になる可能性がある、デプロイされたアプリケーションの許容される最大割合を表します。 これは、異常にデプロイされたアプリケーションの数を、アプリケーションがクラスター内で現在デプロイされているノードの数で割ることによって計算されます。 計算は、少数のノードで 1 つの障害を許容するように切り上げられます。 既定のパーセンテージは 0 です。 |
int |
serviceTypeHealthPolicyMap | サービスの種類の名前ごとのサービスの種類の正常性ポリシーを含むマップ。 既定では、マップは空です。 | ArmServiceTypeHealthPolicyMap |
ArmRollingUpgradeMonitoringPolicy
名前 | 形容 | 価値 |
---|---|---|
failureAction | サービス パッケージのアクティブ化モード | 'Manual' 'Rollback' |
healthCheckRetryTimeout | FailureAction が実行されるまでにアプリケーションまたはクラスターが異常な場合に正常性評価を再試行する時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
healthCheckStableDuration | アップグレードが次のアップグレード ドメインに進む前に、アプリケーションまたはクラスターが正常な状態を維持する必要がある時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
healthCheckWaitDuration | アップグレード ドメインを完了してから正常性ポリシーを適用するまでの待機時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
upgradeDomainTimeout | FailureAction が実行されるまでに各アップグレード ドメインが完了する必要がある時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
upgradeTimeout | FailureAction が実行されるまでにアップグレード全体が完了する必要がある時間。 最初に、ISO 8601 期間を表す文字列として解釈されます。 失敗した場合、ミリ秒の合計数を表す数値として解釈されます。 | 糸 |
ArmServiceTypeHealthPolicy
名前 | 形容 | 価値 |
---|---|---|
maxPercentUnhealthyPartitionsPerService | アプリケーションがエラーと見なされる前に、サービスごとのパーティションの最大割合が異常であることが許可されています。 | int 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyReplicasPerPartition | アプリケーションがエラーと見なされる前に、パーティションあたりのレプリカの最大割合が異常であることが許可されています。 | int 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyServices | アプリケーションがエラーと見なされる前に、サービスの異常が許容される最大割合。 | int 制約: 最小値 = 0 最大値 = 100 |
ArmServiceTypeHealthPolicyMap
名前 | 形容 | 価値 |
---|
ManagedIdentity
名前 | 形容 | 価値 |
---|---|---|
種類 | リソースのマネージド ID の種類。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | リソースに関連付けられているユーザー ID の一覧。 ユーザー ID ディクショナリ キー参照は、次の形式の ARM リソース ID になります。 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
UserAssignedIdentityMap の |
Microsoft.ServiceFabric/clusters/applications
名前 | 形容 | 価値 |
---|---|---|
同一性 | Azure リソースのマネージド ID について説明します。 | ManagedIdentity |
場所 | 新しい API では非推奨になります。リソースの場所は親リソースによって異なります。 | 糸 |
名前 | リソース名 | string (必須) |
parent_id | このリソースの親であるリソースの ID。 | 種類のリソースの ID: クラスター |
プロパティ | アプリケーション リソースのプロパティ。 | ApplicationResourceProperties の |
タグ | リソース タグ | タグ名と値のディクショナリ。 |
種類 | リソースの種類 | "Microsoft.ServiceFabric/clusters/applications@2023-11-01-preview" |
ProxyResourceTags
名前 | 形容 | 価値 |
---|
UserAssignedIdentity
名前 | 形容 | 価値 |
---|
UserAssignedIdentityMap
名前 | 形容 | 価値 |
---|