Microsoft.ServiceFabric 클러스터/애플리케이션 2021-06-01
Bicep 리소스 정의
클러스터/애플리케이션 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령을 참조하세요.
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.ServiceFabric/clusters/applications 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.ServiceFabric/clusters/applications@2021-06-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
properties: {
managedIdentities: [
{
name: 'string'
principalId: 'string'
}
]
maximumNodes: int
metrics: [
{
maximumCapacity: int
name: 'string'
reservationCapacity: int
totalApplicationCapacity: int
}
]
minimumNodes: int
parameters: {
{customized property}: 'string'
}
removeApplicationCapacity: bool
typeName: 'string'
typeVersion: 'string'
upgradePolicy: {
applicationHealthPolicy: {
considerWarningAsError: bool
defaultServiceTypeHealthPolicy: {
maxPercentUnhealthyPartitionsPerService: int
maxPercentUnhealthyReplicasPerPartition: int
maxPercentUnhealthyServices: int
}
maxPercentUnhealthyDeployedApplications: int
serviceTypeHealthPolicyMap: {
{customized property}: {
maxPercentUnhealthyPartitionsPerService: int
maxPercentUnhealthyReplicasPerPartition: int
maxPercentUnhealthyServices: int
}
}
}
forceRestart: bool
recreateApplication: bool
rollingUpgradeMonitoringPolicy: {
failureAction: 'string'
healthCheckRetryTimeout: 'string'
healthCheckStableDuration: 'string'
healthCheckWaitDuration: 'string'
upgradeDomainTimeout: 'string'
upgradeTimeout: 'string'
}
upgradeMode: 'string'
upgradeReplicaSetCheckTimeout: 'string'
}
}
}
속성 값
clusters/applications
| Name | Description | 값 |
|---|---|---|
| name | 리소스 이름 Bicep에서 자식 리소스의 이름과 형식을 설정하는 방법을 참조하세요. |
string(필수) |
| 위치 | 새 API에서는 더 이상 사용되지 않으며, 리소스 위치는 부모 리소스에 따라 달라집니다. | 문자열 |
| tags | Azure 리소스 태그. | 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요. |
| 부모(parent) | Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가하면 됩니다. 자세한 내용은 부모 리소스 외부의 자식 리소스를 참조하세요. |
형식의 리소스에 대한 기호화된 이름: 클러스터 |
| identity | Azure 리소스의 관리 ID에 대해 설명합니다. | ManagedIdentity |
| properties | 애플리케이션 리소스 속성입니다. | ApplicationResourceProperties |
ManagedIdentity
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스에 대한 관리 ID의 유형입니다. | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
| userAssignedIdentities | 리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 다음과 같은 형식의 ARM 리소스 ID입니다. '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
UserAssignedIdentityMap |
UserAssignedIdentityMap
| Name | Description | 값 |
|---|---|---|
| {customized property} | UserAssignedIdentity |
UserAssignedIdentity
이 개체에는 배포 중에 설정할 속성이 포함되어 있지 않습니다. 모든 속성은 ReadOnly입니다.
ApplicationResourceProperties
| Name | Description | 값 |
|---|---|---|
| managedIdentities | 애플리케이션에 대한 사용자 할당 ID 목록이며, 각 ID는 식별 이름에 매핑됩니다. | ApplicationUserAssignedIdentity[] |
| maximumNodes | Service Fabric이 이 애플리케이션에 대해 용량을 예약하는 노드의 최대 수입니다. 이 애플리케이션의 서비스가 모든 해당 노드에 배치되지는 않습니다. 기본적으로 이 속성의 값은 0이며 모든 노드에 서비스를 배치할 수 있음을 의미합니다. | int 제약 조건: 최소값 = 0 |
| 메트릭 | 애플리케이션 용량 메트릭 설명 목록입니다. | ApplicationMetricDescription[] |
| minimumNodes | Service Fabric이 이 애플리케이션에 대해 용량을 예약하는 노드의 최소 수입니다. 이 애플리케이션의 서비스가 모든 해당 노드에 배치되지는 않습니다. 이 속성을 0으로 설정하면 용량이 예약되지 않습니다. 이 속성의 값은 MaximumNodes 속성 값보다 많을 수 없습니다. | int 제약 조건: 최소값 = 0 |
| 매개 변수 | 애플리케이션 매니페스트에 지정된 기본값에서 재정의된 값이 있는 애플리케이션 매개 변수 목록입니다. | ApplicationParameterList |
| removeApplicationCapacity | 현재 애플리케이션 용량 설정을 제거합니다. | bool |
| typeName | 애플리케이션 매니페스트에 정의된 애플리케이션 유형 이름입니다. | string |
| typeVersion | 애플리케이션 매니페스트에서 정의된 애플리케이션 유형의 버전입니다. | string |
| upgradePolicy | 모니터링되는 애플리케이션 업그레이드에 대한 정책을 설명합니다. | ApplicationUpgradePolicy |
ApplicationUserAssignedIdentity
| Name | Description | 값 |
|---|---|---|
| name | 사용자 할당 ID의 식별 이름입니다. | string(필수) |
| principalId | 사용자 할당 ID의 보안 주체 ID입니다. | string(필수) |
ApplicationMetricDescription
| Name | Description | 값 |
|---|---|---|
| maximumCapacity | Service Fabric 애플리케이션의 최대 노드 용량입니다. 단일 노드에서 이 애플리케이션의 instance 최대 로드입니다. 노드 용량이 이 값보다 크더라도 Service Fabric은 각 노드의 애플리케이션 내에서 서비스의 총 부하를 이 값으로 제한합니다. 0으로 설정하면 이 메트릭의 용량은 각 노드에서 무제한입니다. 애플리케이션 용량이 정의된 새 애플리케이션을 만들 때 MaximumNodes 및 이 값의 제품은 항상 TotalApplicationCapacity보다 작거나 같아야 합니다. 애플리케이션 용량으로 기존 애플리케이션을 업데이트할 때 MaximumNodes 및 이 값의 제품은 항상 TotalApplicationCapacity보다 작거나 같아야 합니다. |
int |
| name | 메트릭의 이름입니다. | string |
| reservationCapacity | Service Fabric 애플리케이션의 노드 예약 용량입니다. 이 애플리케이션의 인스턴스가 있는 노드에서 예약된 로드 양입니다. MinimumNodes가 지정된 경우 이러한 값의 곱은 애플리케이션에 대한 클러스터에 예약된 용량이 됩니다. 0으로 설정하면 이 메트릭에 대해 예약된 용량이 없습니다. 애플리케이션 용량을 설정하거나 애플리케이션 용량을 업데이트할 때 이 값은 각 메트릭의 MaximumCapacity보다 작거나 같아야 합니다. |
int |
| totalApplicationCapacity | Service Fabric 애플리케이션의 총 메트릭 용량입니다. 클러스터에서 이 애플리케이션의 총 메트릭 용량입니다. Service Fabric은 애플리케이션 내에서 서비스 로드의 합계를 이 값으로 제한하려고 합니다. 애플리케이션 용량이 정의된 새 애플리케이션을 만들 때 MaximumNodes 및 MaximumCapacity의 제품은 항상 이 값보다 작거나 같아야 합니다. |
int |
ApplicationParameterList
| Name | Description | 값 |
|---|---|---|
| {사용자 지정 속성} | 문자열 |
ApplicationUpgradePolicy
| Name | Description | 값 |
|---|---|---|
| applicationHealthPolicy | 애플리케이션 또는 해당 자식 엔터티 중 하나의 상태를 평가하는 데 사용되는 상태 정책을 정의합니다. | ArmApplicationHealthPolicy |
| forceRestart | true이면 코드 버전이 변경되지 않은 경우에도 업그레이드 중에 프로세스가 강제로 다시 시작됩니다(업그레이드는 구성 또는 데이터만 변경됨). | bool |
| recreateApplication | 업데이트할 때 애플리케이션을 다시 만들어야 하는지 여부를 결정합니다. value=true이면 나머지 업그레이드 정책 매개 변수는 허용되지 않으며 가용성 손실이 발생합니다. | bool |
| rollingUpgradeMonitoringPolicy | 애플리케이션 업그레이드를 모니터링하는 데 사용되는 정책 | ArmRollingUpgradeMonitoringPolicy |
| upgradeMode | 롤링 업그레이드 동안 상태를 모니터링하는 데 사용되는 모드입니다. 값은 UnmonitoredAuto, UnmonitoredManual 및 Monitored입니다. | '유효하지 않음' '모니터링됨' 'UnmonitoredAuto' 'UnmonitoredManual' |
| upgradeReplicaSetCheckTimeout | 예기치 않은 문제가 있을 때 업그레이드 도메인의 처리를 차단하고 가용성의 손실을 방지하는 최대 시간입니다. 이 시간 제한이 만료되면 가용성 손실 문제와 상관없이 업그레이드 도메인 처리가 진행됩니다. 시간 제한은 각 업그레이드 도메인의 시작 시 다시 설정됩니다. 유효한 값은 0과 42949672925(포함) 사이입니다. (부호 없는 32비트 정수). | string |
ArmApplicationHealthPolicy
| Name | Description | 값 |
|---|---|---|
| considerWarningAsError | 경고가 오류와 동일한 심각도로 처리되는지 여부를 나타냅니다. | bool |
| defaultServiceTypeHealthPolicy | 기본적으로 서비스 유형의 상태를 평가하는 데 사용되는 상태 정책입니다. | ArmServiceTypeHealthPolicy |
| maxPercentUnhealthyDeployedApplications | 비정상적인 배포 애플리케이션의 최대 허용치입니다. 허용되는 값은 0에서 100까지의 바이트 값입니다. 백분율은 애플리케이션이 오류로 간주되기 전에 비정상일 수 있는 배포된 애플리케이션의 허용되는 최대 백분율을 나타냅니다. 이는 비정상 배포된 애플리케이션 수를 클러스터에서 애플리케이션이 현재 배포된 노드 수에 따라 나누어 계산됩니다. 계산값은 적은 수의 노드에서 오류 하나를 허용할 수 있도록 반올림됩니다. 기본 비율은 0입니다. |
int |
| serviceTypeHealthPolicyMap | 서비스 유형 이름당 서비스 유형 상태 정책이 있는 맵입니다. 맵은 기본적으로 비어 있습니다. | ArmServiceTypeHealthPolicyMap |
ArmServiceTypeHealthPolicy
| Name | Description | 값 |
|---|---|---|
| maxPercentUnhealthyPartitionsPerService | 애플리케이션이 오류로 간주되기 전에 비정상으로 허용되는 서비스당 파티션의 최대 백분율입니다. | int 제약 조건: 최소값 = 0 최대값 = 100 |
| maxPercentUnhealthyReplicasPerPartition | 애플리케이션이 오류로 간주되기 전에 비정상으로 허용되는 파티션당 복제본의 최대 백분율입니다. | int 제약 조건: 최소값 = 0 최대값 = 100 |
| maxPercentUnhealthyServices | 애플리케이션이 오류로 간주되기 전에 비정상 상태가 될 수 있는 서비스의 최대 백분율입니다. | int 제약 조건: 최소값 = 0 최대값 = 100 |
ArmServiceTypeHealthPolicyMap
| Name | Description | 값 |
|---|---|---|
| {customized property} | ArmServiceTypeHealthPolicy |
ArmRollingUpgradeMonitoringPolicy
| Name | Description | 값 |
|---|---|---|
| failureAction | 서비스 패키지의 활성화 모드 | '수동' '롤백' |
| healthCheckRetryTimeout | 애플리케이션이나 클러스터가 정상 상태가 아닌 경우 FailureAction이 실행되기 전에 상태 평가를 다시 시도하는 기간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | string |
| healthCheckStableDuration | 업그레이드가 다음 업그레이드 도메인으로 진행되기 전에 애플리케이션 또는 클러스터가 정상 상태로 유지되어야 하는 시간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | string |
| healthCheckWaitDuration | 업그레이드 도메인을 완료한 후 상태 정책을 적용하기 전에 대기하는 시간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | string |
| upgradeDomainTimeout | FailureAction이 실행되기 전에 각 업그레이드 도메인이 완료해야 하는 시간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | string |
| upgradeTimeout | FailureAction이 실행되기 전에 전체 업그레이드를 완료해야 하는 시간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | string |
ARM 템플릿 리소스 정의
클러스터/애플리케이션 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령을 참조하세요.
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.ServiceFabric/clusters/applications 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.ServiceFabric/clusters/applications",
"apiVersion": "2021-06-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"properties": {
"managedIdentities": [
{
"name": "string",
"principalId": "string"
}
],
"maximumNodes": "int",
"metrics": [
{
"maximumCapacity": "int",
"name": "string",
"reservationCapacity": "int",
"totalApplicationCapacity": "int"
}
],
"minimumNodes": "int",
"parameters": {
"{customized property}": "string"
},
"removeApplicationCapacity": "bool",
"typeName": "string",
"typeVersion": "string",
"upgradePolicy": {
"applicationHealthPolicy": {
"considerWarningAsError": "bool",
"defaultServiceTypeHealthPolicy": {
"maxPercentUnhealthyPartitionsPerService": "int",
"maxPercentUnhealthyReplicasPerPartition": "int",
"maxPercentUnhealthyServices": "int"
},
"maxPercentUnhealthyDeployedApplications": "int",
"serviceTypeHealthPolicyMap": {
"{customized property}": {
"maxPercentUnhealthyPartitionsPerService": "int",
"maxPercentUnhealthyReplicasPerPartition": "int",
"maxPercentUnhealthyServices": "int"
}
}
},
"forceRestart": "bool",
"recreateApplication": "bool",
"rollingUpgradeMonitoringPolicy": {
"failureAction": "string",
"healthCheckRetryTimeout": "string",
"healthCheckStableDuration": "string",
"healthCheckWaitDuration": "string",
"upgradeDomainTimeout": "string",
"upgradeTimeout": "string"
},
"upgradeMode": "string",
"upgradeReplicaSetCheckTimeout": "string"
}
}
}
속성 값
clusters/applications
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스 종류 | 'Microsoft.ServiceFabric/clusters/applications' |
| apiVersion | 리소스 api 버전 | '2021-06-01' |
| name | 리소스 이름 JSON ARM 템플릿에서 자식 리소스의 이름 및 형식을 설정하는 방법을 참조하세요. |
string(필수) |
| 위치 | 새 API에서는 더 이상 사용되지 않으며, 리소스 위치는 부모 리소스에 따라 달라집니다. | string |
| tags | Azure 리소스 태그. | 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요. |
| identity | Azure 리소스의 관리 ID에 대해 설명합니다. | ManagedIdentity |
| properties | 애플리케이션 리소스 속성입니다. | ApplicationResourceProperties |
ManagedIdentity
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스의 관리 ID 유형입니다. | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
| userAssignedIdentities | 리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 양식의 ARM 리소스 ID입니다. '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
UserAssignedIdentityMap |
UserAssignedIdentityMap
| Name | Description | 값 |
|---|---|---|
| {사용자 지정 속성} | UserAssignedIdentity |
UserAssignedIdentity
이 개체에는 배포 중에 설정할 속성이 포함되어 있지 않습니다. 모든 속성은 ReadOnly입니다.
ApplicationResourceProperties
| Name | Description | 값 |
|---|---|---|
| managedIdentities | 애플리케이션에 대한 사용자 할당 ID 목록이며, 각 ID는 친숙한 이름으로 매핑됩니다. | ApplicationUserAssignedIdentity[] |
| maximumNodes | Service Fabric이 이 애플리케이션에 대해 용량을 예약하는 노드의 최대 수입니다. 이 애플리케이션의 서비스가 모든 해당 노드에 배치되지는 않습니다. 기본적으로 이 속성의 값은 0이며 서비스가 모든 노드에 배치될 수 있음을 의미합니다. | int 제약 조건: 최소값 = 0 |
| 메트릭 | 애플리케이션 용량 메트릭 설명 목록입니다. | ApplicationMetricDescription[] |
| minimumNodes | Service Fabric이 이 애플리케이션에 대해 용량을 예약하는 노드의 최소 수입니다. 이 애플리케이션의 서비스가 모든 해당 노드에 배치되지는 않습니다. 이 속성을 0으로 설정하면 용량이 예약되지 않습니다. 이 속성의 값은 MaximumNodes 속성 값보다 많을 수 없습니다. | int 제약 조건: 최소값 = 0 |
| 매개 변수 | 애플리케이션 매니페스트에 지정된 기본값에서 재정의된 값이 있는 애플리케이션 매개 변수 목록입니다. | ApplicationParameterList |
| removeApplicationCapacity | 현재 애플리케이션 용량 설정을 제거합니다. | bool |
| typeName | 애플리케이션 매니페스트에 정의된 애플리케이션 유형 이름입니다. | string |
| typeVersion | 애플리케이션 매니페스트에서 정의된 애플리케이션 유형의 버전입니다. | string |
| upgradePolicy | 모니터링되는 애플리케이션 업그레이드에 대한 정책을 설명합니다. | ApplicationUpgradePolicy |
ApplicationUserAssignedIdentity
| Name | Description | 값 |
|---|---|---|
| name | 사용자 할당 ID의 식별 이름입니다. | string(필수) |
| principalId | 사용자 할당 ID의 보안 주체 ID입니다. | string(필수) |
ApplicationMetricDescription
| Name | Description | 값 |
|---|---|---|
| maximumCapacity | Service Fabric 애플리케이션의 최대 노드 용량입니다. 단일 노드에서 이 애플리케이션의 instance 최대 로드입니다. 노드 용량이 이 값보다 크더라도 Service Fabric은 각 노드의 애플리케이션 내에서 서비스의 총 부하를 이 값으로 제한합니다. 0으로 설정하면 이 메트릭의 용량은 각 노드에서 무제한입니다. 애플리케이션 용량이 정의된 새 애플리케이션을 만들 때 MaximumNodes 및 이 값의 제품은 항상 TotalApplicationCapacity보다 작거나 같아야 합니다. 애플리케이션 용량으로 기존 애플리케이션을 업데이트할 때 MaximumNodes 및 이 값의 제품은 항상 TotalApplicationCapacity보다 작거나 같아야 합니다. |
int |
| name | 메트릭의 이름입니다. | string |
| reservationCapacity | Service Fabric 애플리케이션의 노드 예약 용량입니다. 이 애플리케이션의 인스턴스가 있는 노드에서 예약된 로드 양입니다. MinimumNodes가 지정된 경우 이러한 값의 곱은 애플리케이션에 대한 클러스터에 예약된 용량이 됩니다. 0으로 설정하면 이 메트릭에 대해 예약된 용량이 없습니다. 애플리케이션 용량을 설정하거나 애플리케이션 용량을 업데이트할 때 이 값은 각 메트릭의 MaximumCapacity보다 작거나 같아야 합니다. |
int |
| totalApplicationCapacity | Service Fabric 애플리케이션의 총 메트릭 용량입니다. 클러스터에서 이 애플리케이션의 총 메트릭 용량입니다. Service Fabric은 애플리케이션 내의 서비스 로드 합계를 이 값으로 제한하려고 합니다. 애플리케이션 용량이 정의된 새 애플리케이션을 만들 때 MaximumNodes 및 MaximumCapacity의 곱은 항상 이 값보다 작거나 같아야 합니다. |
int |
ApplicationParameterList
| Name | Description | 값 |
|---|---|---|
| {customized property} | 문자열 |
ApplicationUpgradePolicy
| Name | Description | 값 |
|---|---|---|
| applicationHealthPolicy | 애플리케이션 또는 해당 자식 엔터티 중 하나의 상태를 평가하는 데 사용되는 상태 정책을 정의합니다. | ArmApplicationHealthPolicy |
| forceRestart | true이면 코드 버전이 변경되지 않은 경우에도 업그레이드 중에 프로세스가 강제로 다시 시작됩니다(업그레이드는 구성 또는 데이터만 변경됨). | bool |
| recreateApplication | 업데이트할 때 애플리케이션을 다시 만들어야 하는지 여부를 결정합니다. value=true이면 나머지 업그레이드 정책 매개 변수는 허용되지 않으며 가용성 손실이 발생합니다. | bool |
| rollingUpgradeMonitoringPolicy | 애플리케이션 업그레이드를 모니터링하는 데 사용되는 정책 | ArmRollingUpgradeMonitoringPolicy |
| upgradeMode | 롤링 업그레이드 동안 상태를 모니터링하는 데 사용되는 모드입니다. 값은 UnmonitoredAuto, UnmonitoredManual 및 Monitored입니다. | 'Invalid' '모니터링됨' 'UnmonitoredAuto' 'UnmonitoredManual' |
| upgradeReplicaSetCheckTimeout | 예기치 않은 문제가 있을 때 업그레이드 도메인의 처리를 차단하고 가용성의 손실을 방지하는 최대 시간입니다. 이 시간 제한이 만료되면 가용성 손실 문제와 상관없이 업그레이드 도메인 처리가 진행됩니다. 시간 제한은 각 업그레이드 도메인의 시작 시 다시 설정됩니다. 유효한 값은 0과 42949672925(포함) 사이입니다. (부호 없는 32비트 정수). | string |
ArmApplicationHealthPolicy
| Name | Description | 값 |
|---|---|---|
| considerWarningAsError | 경고가 오류와 동일한 심각도로 처리되는지 여부를 나타냅니다. | bool |
| defaultServiceTypeHealthPolicy | 기본적으로 서비스 유형의 상태를 평가하는 데 사용되는 상태 정책입니다. | ArmServiceTypeHealthPolicy |
| maxPercentUnhealthyDeployedApplications | 비정상적인 배포 애플리케이션의 최대 허용치입니다. 허용되는 값은 0에서 100까지의 바이트 값입니다. 백분율은 애플리케이션이 오류로 간주되기 전에 비정상일 수 있는 배포된 애플리케이션의 최대 허용 비율을 나타냅니다. 이는 비정상 배포된 애플리케이션 수를 클러스터에서 애플리케이션이 현재 배포된 노드 수에 따라 나누어 계산됩니다. 계산값은 적은 수의 노드에서 오류 하나를 허용할 수 있도록 반올림됩니다. 기본 비율은 0입니다. |
int |
| serviceTypeHealthPolicyMap | 서비스 유형 이름당 서비스 유형 상태 정책이 있는 맵입니다. 맵은 기본적으로 비어 있습니다. | ArmServiceTypeHealthPolicyMap |
ArmServiceTypeHealthPolicy
| Name | Description | 값 |
|---|---|---|
| maxPercentUnhealthyPartitionsPerService | 애플리케이션이 오류로 간주되기 전에 비정상으로 허용되는 서비스당 파티션의 최대 백분율입니다. | int 제약 조건: 최소값 = 0 최대값 = 100 |
| maxPercentUnhealthyReplicasPerPartition | 애플리케이션이 오류로 간주되기 전에 비정상으로 허용되는 파티션당 복제본의 최대 백분율입니다. | int 제약 조건: 최소값 = 0 최대값 = 100 |
| maxPercentUnhealthyServices | 애플리케이션이 오류로 간주되기 전에 비정상 상태가 될 수 있는 서비스의 최대 백분율입니다. | int 제약 조건: 최소값 = 0 최대값 = 100 |
ArmServiceTypeHealthPolicyMap
| Name | Description | 값 |
|---|---|---|
| {customized property} | ArmServiceTypeHealthPolicy |
ArmRollingUpgradeMonitoringPolicy
| Name | Description | 값 |
|---|---|---|
| failureAction | 서비스 패키지의 활성화 모드 | '수동' '롤백' |
| healthCheckRetryTimeout | 애플리케이션이나 클러스터가 정상 상태가 아닌 경우 FailureAction이 실행되기 전에 상태 평가를 다시 시도하는 기간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | 문자열 |
| healthCheckStableDuration | 업그레이드가 다음 업그레이드 도메인으로 진행되기 전에 애플리케이션 또는 클러스터가 정상 상태로 유지되어야 하는 시간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | 문자열 |
| healthCheckWaitDuration | 업그레이드 도메인을 완료한 후 상태 정책을 적용하기 전에 대기하는 시간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | 문자열 |
| upgradeDomainTimeout | FailureAction이 실행되기 전에 각 업그레이드 도메인이 완료해야 하는 시간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | 문자열 |
| upgradeTimeout | FailureAction이 실행되기 전에 전체 업그레이드를 완료해야 하는 시간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | 문자열 |
Terraform(AzAPI 공급자) 리소스 정의
클러스터/애플리케이션 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.ServiceFabric/clusters/applications 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceFabric/clusters/applications@2021-06-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
managedIdentities = [
{
name = "string"
principalId = "string"
}
]
maximumNodes = int
metrics = [
{
maximumCapacity = int
name = "string"
reservationCapacity = int
totalApplicationCapacity = int
}
]
minimumNodes = int
parameters = {
{customized property} = "string"
}
removeApplicationCapacity = bool
typeName = "string"
typeVersion = "string"
upgradePolicy = {
applicationHealthPolicy = {
considerWarningAsError = bool
defaultServiceTypeHealthPolicy = {
maxPercentUnhealthyPartitionsPerService = int
maxPercentUnhealthyReplicasPerPartition = int
maxPercentUnhealthyServices = int
}
maxPercentUnhealthyDeployedApplications = int
serviceTypeHealthPolicyMap = {
{customized property} = {
maxPercentUnhealthyPartitionsPerService = int
maxPercentUnhealthyReplicasPerPartition = int
maxPercentUnhealthyServices = int
}
}
}
forceRestart = bool
recreateApplication = bool
rollingUpgradeMonitoringPolicy = {
failureAction = "string"
healthCheckRetryTimeout = "string"
healthCheckStableDuration = "string"
healthCheckWaitDuration = "string"
upgradeDomainTimeout = "string"
upgradeTimeout = "string"
}
upgradeMode = "string"
upgradeReplicaSetCheckTimeout = "string"
}
}
})
}
속성 값
clusters/applications
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스 종류 | "Microsoft.ServiceFabric/clusters/applications@2021-06-01" |
| name | 리소스 이름 | string(필수) |
| 위치 | 새 API에서는 더 이상 사용되지 않으며 리소스 위치는 부모 리소스에 따라 달라집니다. | string |
| parent_id | 이 리소스의 부모인 리소스의 ID입니다. | 유형의 리소스에 대한 ID: 클러스터 |
| tags | Azure 리소스 태그. | 태그 이름 및 값의 사전입니다. |
| identity | Azure 리소스의 관리 ID에 대해 설명합니다. | ManagedIdentity |
| properties | 애플리케이션 리소스 속성입니다. | ApplicationResourceProperties |
ManagedIdentity
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스의 관리 ID 유형입니다. | "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
| identity_ids | 리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 양식의 ARM 리소스 ID입니다. '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
사용자 ID ID의 배열입니다. |
UserAssignedIdentityMap
| Name | Description | 값 |
|---|---|---|
| {사용자 지정 속성} | UserAssignedIdentity |
UserAssignedIdentity
이 개체에는 배포 중에 설정할 속성이 포함되어 있지 않습니다. 모든 속성은 ReadOnly입니다.
ApplicationResourceProperties
| Name | Description | 값 |
|---|---|---|
| managedIdentities | 애플리케이션에 대한 사용자 할당 ID 목록이며, 각 ID는 친숙한 이름으로 매핑됩니다. | ApplicationUserAssignedIdentity[] |
| maximumNodes | Service Fabric이 이 애플리케이션에 대해 용량을 예약하는 노드의 최대 수입니다. 이 애플리케이션의 서비스가 모든 해당 노드에 배치되지는 않습니다. 기본적으로 이 속성의 값은 0이며 서비스가 모든 노드에 배치될 수 있음을 의미합니다. | int 제약 조건: 최소값 = 0 |
| 메트릭 | 애플리케이션 용량 메트릭 설명 목록입니다. | ApplicationMetricDescription[] |
| minimumNodes | Service Fabric이 이 애플리케이션에 대해 용량을 예약하는 노드의 최소 수입니다. 이 애플리케이션의 서비스가 모든 해당 노드에 배치되지는 않습니다. 이 속성을 0으로 설정하면 용량이 예약되지 않습니다. 이 속성의 값은 MaximumNodes 속성 값보다 많을 수 없습니다. | int 제약 조건: 최소값 = 0 |
| 매개 변수 | 애플리케이션 매니페스트에 지정된 기본값에서 재정의된 값이 있는 애플리케이션 매개 변수 목록입니다. | ApplicationParameterList |
| removeApplicationCapacity | 현재 애플리케이션 용량 설정을 제거합니다. | bool |
| typeName | 애플리케이션 매니페스트에 정의된 애플리케이션 유형 이름입니다. | string |
| typeVersion | 애플리케이션 매니페스트에서 정의된 애플리케이션 유형의 버전입니다. | 문자열 |
| upgradePolicy | 모니터링되는 애플리케이션 업그레이드에 대한 정책을 설명합니다. | ApplicationUpgradePolicy |
ApplicationUserAssignedIdentity
| Name | Description | 값 |
|---|---|---|
| name | 사용자 할당 ID의 식별 이름입니다. | string(필수) |
| principalId | 사용자 할당 ID의 보안 주체 ID입니다. | string(필수) |
ApplicationMetricDescription
| Name | Description | 값 |
|---|---|---|
| maximumCapacity | Service Fabric 애플리케이션의 최대 노드 용량입니다. 단일 노드에서 이 애플리케이션의 instance 최대 로드입니다. 노드 용량이 이 값보다 크더라도 Service Fabric은 각 노드의 애플리케이션 내에서 서비스의 총 부하를 이 값으로 제한합니다. 0으로 설정하면 이 메트릭의 용량은 각 노드에서 무제한입니다. 애플리케이션 용량이 정의된 새 애플리케이션을 만들 때 MaximumNodes 및 이 값의 제품은 항상 TotalApplicationCapacity보다 작거나 같아야 합니다. 애플리케이션 용량으로 기존 애플리케이션을 업데이트할 때 MaximumNodes 및 이 값의 제품은 항상 TotalApplicationCapacity보다 작거나 같아야 합니다. |
int |
| name | 메트릭의 이름입니다. | string |
| reservationCapacity | Service Fabric 애플리케이션의 노드 예약 용량입니다. 이 애플리케이션의 인스턴스가 있는 노드에서 예약된 로드 양입니다. MinimumNodes가 지정된 경우 이러한 값의 곱은 애플리케이션에 대한 클러스터에 예약된 용량이 됩니다. 0으로 설정하면 이 메트릭에 대해 예약된 용량이 없습니다. 애플리케이션 용량을 설정하거나 애플리케이션 용량을 업데이트할 때 이 값은 각 메트릭의 MaximumCapacity보다 작거나 같아야 합니다. |
int |
| totalApplicationCapacity | Service Fabric 애플리케이션의 총 메트릭 용량입니다. 클러스터에서 이 애플리케이션의 총 메트릭 용량입니다. Service Fabric은 애플리케이션 내에서 서비스 로드의 합계를 이 값으로 제한하려고 합니다. 애플리케이션 용량이 정의된 새 애플리케이션을 만들 때 MaximumNodes 및 MaximumCapacity의 제품은 항상 이 값보다 작거나 같아야 합니다. |
int |
ApplicationParameterList
| Name | Description | 값 |
|---|---|---|
| {사용자 지정 속성} | 문자열 |
ApplicationUpgradePolicy
| Name | Description | 값 |
|---|---|---|
| applicationHealthPolicy | 애플리케이션 또는 해당 자식 엔터티 중 하나의 상태를 평가하는 데 사용되는 상태 정책을 정의합니다. | ArmApplicationHealthPolicy |
| forceRestart | true이면 코드 버전이 변경되지 않은 경우에도 업그레이드 중에 프로세스가 강제로 다시 시작됩니다(업그레이드는 구성 또는 데이터만 변경됨). | bool |
| recreateApplication | 업데이트할 때 애플리케이션을 다시 만들어야 하는지 여부를 결정합니다. value=true이면 나머지 업그레이드 정책 매개 변수는 허용되지 않으며 가용성 손실이 발생합니다. | bool |
| rollingUpgradeMonitoringPolicy | 애플리케이션 업그레이드를 모니터링하는 데 사용되는 정책 | ArmRollingUpgradeMonitoringPolicy |
| upgradeMode | 롤링 업그레이드 동안 상태를 모니터링하는 데 사용되는 모드입니다. 값은 UnmonitoredAuto, UnmonitoredManual 및 Monitored입니다. | "잘못됨" "모니터링됨" "UnmonitoredAuto" "UnmonitoredManual" |
| upgradeReplicaSetCheckTimeout | 예기치 않은 문제가 있을 때 업그레이드 도메인의 처리를 차단하고 가용성의 손실을 방지하는 최대 시간입니다. 이 시간 제한이 만료되면 가용성 손실 문제와 상관없이 업그레이드 도메인 처리가 진행됩니다. 시간 제한은 각 업그레이드 도메인의 시작 시 다시 설정됩니다. 유효한 값은 0과 42949672925(포함) 사이입니다. (부호 없는 32비트 정수). | string |
ArmApplicationHealthPolicy
| Name | Description | 값 |
|---|---|---|
| considerWarningAsError | 경고가 오류와 동일한 심각도로 처리되는지 여부를 나타냅니다. | bool |
| defaultServiceTypeHealthPolicy | 기본적으로 서비스 유형의 상태를 평가하는 데 사용되는 상태 정책입니다. | ArmServiceTypeHealthPolicy |
| maxPercentUnhealthyDeployedApplications | 비정상적인 배포 애플리케이션의 최대 허용치입니다. 허용되는 값은 0에서 100까지의 바이트 값입니다. 백분율은 애플리케이션이 오류로 간주되기 전에 비정상일 수 있는 배포된 애플리케이션의 허용되는 최대 백분율을 나타냅니다. 이는 비정상 배포된 애플리케이션 수를 현재 클러스터에 배포된 노드 수와 나누어 계산합니다. 계산값은 적은 수의 노드에서 오류 하나를 허용할 수 있도록 반올림됩니다. 기본 비율은 0입니다. |
int |
| serviceTypeHealthPolicyMap | 서비스 유형 이름당 서비스 유형 상태 정책이 있는 맵입니다. 맵은 기본적으로 비어 있습니다. | ArmServiceTypeHealthPolicyMap |
ArmServiceTypeHealthPolicy
| Name | Description | 값 |
|---|---|---|
| maxPercentUnhealthyPartitionsPerService | 애플리케이션이 오류로 간주되기 전에 비정상으로 허용되는 서비스당 파티션의 최대 비율입니다. | int 제약 조건: 최소값 = 0 최대값 = 100 |
| maxPercentUnhealthyReplicasPerPartition | 애플리케이션이 오류로 간주되기 전에 비정상으로 허용되는 파티션당 복제본의 최대 백분율입니다. | int 제약 조건: 최소값 = 0 최대값 = 100 |
| maxPercentUnhealthyServices | 애플리케이션이 오류로 간주되기 전에 비정상으로 허용되는 서비스의 최대 비율입니다. | int 제약 조건: 최소값 = 0 최대값 = 100 |
ArmServiceTypeHealthPolicyMap
| Name | Description | 값 |
|---|---|---|
| {사용자 지정 속성} | ArmServiceTypeHealthPolicy |
ArmRollingUpgradeMonitoringPolicy
| Name | Description | 값 |
|---|---|---|
| failureAction | 서비스 패키지의 활성화 모드 | "수동" "롤백" |
| healthCheckRetryTimeout | 애플리케이션이나 클러스터가 정상 상태가 아닌 경우 FailureAction이 실행되기 전에 상태 평가를 다시 시도하는 기간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | 문자열 |
| healthCheckStableDuration | 업그레이드가 다음 업그레이드 도메인으로 진행되기 전에 애플리케이션 또는 클러스터가 정상 상태로 유지되어야 하는 시간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | string |
| healthCheckWaitDuration | 업그레이드 도메인을 완료한 후 상태 정책을 적용하기 전에 대기하는 시간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | string |
| upgradeDomainTimeout | FailureAction이 실행되기 전에 각 업그레이드 도메인이 완료해야 하는 시간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | 문자열 |
| upgradeTimeout | FailureAction이 실행되기 전에 전체 업그레이드를 완료해야 하는 시간입니다. 먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다. | string |