Microsoft.ServiceFabric クラスター
Bicep リソース定義
クラスター リソースの種類は、次をターゲットとする操作でデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.ServiceFabric/clusters リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.ServiceFabric/clusters@2023-11-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
properties: {
addOnFeatures: [
'string'
]
applicationTypeVersionsCleanupPolicy: {
maxUnusedVersionsToKeep: int
maxUnusedVersionsToKeep: int
}
azureActiveDirectory: {
clientApplication: 'string'
clusterApplication: 'string'
tenantId: 'string'
clientApplication: 'string'
clusterApplication: 'string'
tenantId: 'string'
}
certificate: {
thumbprint: 'string'
thumbprintSecondary: 'string'
x509StoreName: 'string'
}
certificateCommonNames: {
commonNames: [
{
certificateCommonName: 'string'
certificateIssuerThumbprint: 'string'
}
]
x509StoreName: 'string'
}
clientCertificateCommonNames: [
{
certificateCommonName: 'string'
certificateIssuerThumbprint: 'string'
isAdmin: bool
}
]
clientCertificateThumbprints: [
{
certificateThumbprint: 'string'
isAdmin: bool
}
]
clusterCodeVersion: 'string'
diagnosticsStorageAccountConfig: {
blobEndpoint: 'string'
protectedAccountKeyName: 'string'
protectedAccountKeyName2: 'string'
queueEndpoint: 'string'
storageAccountName: 'string'
tableEndpoint: 'string'
}
enableHttpGatewayExclusiveAuthMode: bool
eventStoreServiceEnabled: bool
fabricSettings: [
{
name: 'string'
parameters: [
{
name: 'string'
value: 'string'
name: 'string'
value: 'string'
}
]
name: 'string'
parameters: [
{
name: 'string'
value: 'string'
name: 'string'
value: 'string'
}
]
}
]
infrastructureServiceManager: bool
managementEndpoint: 'string'
nodeTypes: [
{
applicationPorts: {
endPort: int
startPort: int
endPort: int
startPort: int
}
capacities: {
{customized property}: 'string'
}
clientConnectionEndpointPort: int
durabilityLevel: 'string'
ephemeralPorts: {
endPort: int
startPort: int
endPort: int
startPort: int
}
httpGatewayEndpointPort: int
httpGatewayTokenAuthEndpointPort: int
isPrimary: bool
isStateless: bool
multipleAvailabilityZones: bool
name: 'string'
placementProperties: {
{customized property}: 'string'
}
reverseProxyEndpointPort: int
vmInstanceCount: int
}
]
notifications: [
{
isEnabled: bool
notificationCategory: 'WaveProgress'
notificationLevel: 'string'
notificationTargets: [
{
notificationChannel: 'string'
receivers: [
'string'
]
}
]
}
]
reliabilityLevel: 'string'
reverseProxyCertificate: {
thumbprint: 'string'
thumbprintSecondary: 'string'
x509StoreName: 'string'
}
reverseProxyCertificateCommonNames: {
commonNames: [
{
certificateCommonName: 'string'
certificateIssuerThumbprint: 'string'
}
]
x509StoreName: 'string'
}
sfZonalUpgradeMode: 'string'
upgradeDescription: {
deltaHealthPolicy: {
applicationDeltaHealthPolicies: {
{customized property}: {
defaultServiceTypeDeltaHealthPolicy: {
maxPercentDeltaUnhealthyServices: int
}
serviceTypeDeltaHealthPolicies: {
{customized property}: {
maxPercentDeltaUnhealthyServices: int
}
}
}
}
maxPercentDeltaUnhealthyApplications: int
maxPercentDeltaUnhealthyNodes: int
maxPercentUpgradeDomainDeltaUnhealthyNodes: int
maxPercentDeltaUnhealthyApplications: int
maxPercentDeltaUnhealthyNodes: int
maxPercentUpgradeDomainDeltaUnhealthyNodes: int
}
forceRestart: bool
healthCheckRetryTimeout: 'string'
healthCheckStableDuration: 'string'
healthCheckWaitDuration: 'string'
healthPolicy: {
applicationHealthPolicies: {
{customized property}: {
defaultServiceTypeHealthPolicy: {
maxPercentUnhealthyServices: int
maxPercentUnhealthyPartitionsPerService: int
maxPercentUnhealthyReplicasPerPartition: int
maxPercentUnhealthyServices: int
}
serviceTypeHealthPolicies: {
{customized property}: {
maxPercentUnhealthyServices: int
maxPercentUnhealthyPartitionsPerService: int
maxPercentUnhealthyReplicasPerPartition: int
maxPercentUnhealthyServices: int
}
}
considerWarningAsError: bool
defaultServiceTypeHealthPolicy: {
maxPercentUnhealthyServices: int
maxPercentUnhealthyPartitionsPerService: int
maxPercentUnhealthyReplicasPerPartition: int
maxPercentUnhealthyServices: int
}
maxPercentUnhealthyDeployedApplications: int
serviceTypeHealthPolicyMap: {
{customized property}: {
maxPercentUnhealthyServices: int
maxPercentUnhealthyPartitionsPerService: int
maxPercentUnhealthyReplicasPerPartition: int
maxPercentUnhealthyServices: int
}
}
}
}
maxPercentUnhealthyApplications: int
maxPercentUnhealthyNodes: int
maxPercentUnhealthyApplications: int
maxPercentUnhealthyNodes: int
}
upgradeDomainTimeout: 'string'
upgradeReplicaSetCheckTimeout: 'string'
upgradeTimeout: 'string'
deltaHealthPolicy: {
applicationDeltaHealthPolicies: {
{customized property}: {
defaultServiceTypeDeltaHealthPolicy: {
maxPercentDeltaUnhealthyServices: int
}
serviceTypeDeltaHealthPolicies: {
{customized property}: {
maxPercentDeltaUnhealthyServices: int
}
}
}
}
maxPercentDeltaUnhealthyApplications: int
maxPercentDeltaUnhealthyNodes: int
maxPercentUpgradeDomainDeltaUnhealthyNodes: int
maxPercentDeltaUnhealthyApplications: int
maxPercentDeltaUnhealthyNodes: int
maxPercentUpgradeDomainDeltaUnhealthyNodes: int
}
forceRestart: bool
healthPolicy: {
applicationHealthPolicies: {
{customized property}: {
defaultServiceTypeHealthPolicy: {
maxPercentUnhealthyServices: int
maxPercentUnhealthyPartitionsPerService: int
maxPercentUnhealthyReplicasPerPartition: int
maxPercentUnhealthyServices: int
}
serviceTypeHealthPolicies: {
{customized property}: {
maxPercentUnhealthyServices: int
maxPercentUnhealthyPartitionsPerService: int
maxPercentUnhealthyReplicasPerPartition: int
maxPercentUnhealthyServices: int
}
}
considerWarningAsError: bool
defaultServiceTypeHealthPolicy: {
maxPercentUnhealthyServices: int
maxPercentUnhealthyPartitionsPerService: int
maxPercentUnhealthyReplicasPerPartition: int
maxPercentUnhealthyServices: int
}
maxPercentUnhealthyDeployedApplications: int
serviceTypeHealthPolicyMap: {
{customized property}: {
maxPercentUnhealthyServices: int
maxPercentUnhealthyPartitionsPerService: int
maxPercentUnhealthyReplicasPerPartition: int
maxPercentUnhealthyServices: int
}
}
}
}
maxPercentUnhealthyApplications: int
maxPercentUnhealthyNodes: int
maxPercentUnhealthyApplications: int
maxPercentUnhealthyNodes: int
}
monitoringPolicy: {
healthCheckRetryTimeout: 'string'
healthCheckStableDuration: 'string'
healthCheckWaitDuration: 'string'
upgradeDomainTimeout: 'string'
upgradeTimeout: 'string'
}
upgradeReplicaSetCheckTimeout: 'string'
}
upgradeMode: 'string'
upgradePauseEndTimestampUtc: 'string'
upgradePauseStartTimestampUtc: 'string'
upgradeWave: 'string'
vmImage: 'string'
vmssZonalUpgradeMode: 'string'
waveUpgradePaused: bool
}
}
プロパティ値
clusters
名前 | 説明 | 値 |
---|---|---|
name | リソース名 | string (必須) 文字制限: 4 から 23 有効な文字: 小文字、数字、およびハイフン。 小文字で開始します。 末尾には小文字または数字を使用します。 |
location | Azure リソースの場所。 | string (必須) |
tags | Azure リソース タグ。 | タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください |
properties | クラスター リソースのプロパティ | ClusterProperties |
ClusterProperties
名前 | 説明 | 値 |
---|---|---|
addOnFeatures | クラスターで有効にするアドオン機能の一覧。 | 次のいずれかを含む文字列配列: 'BackupRestoreService' 'DnsService' 'RepairManager' 'ResourceMonitorService' |
applicationTypeVersionsCleanupPolicy | 未使用のバージョンをクリーンするために使用されるポリシー。 | ApplicationTypeVersionsCleanupPolicy |
azureActiveDirectory | クラスターの AAD 認証設定。 | AzureActiveDirectory |
証明書 (certificate) | クラスターのセキュリティ保護に使用する証明書。 指定された証明書は、クラスター内のノード間のセキュリティ、クラスター管理エンドポイント用の SSL 証明書、および既定の管理クライアントに使用されます。 | CertificateDescription |
certificateCommonNames | クラスターのセキュリティ保護に使用される共通名によって参照されるサーバー証明書の一覧について説明します。 | ServerCertificateCommonNames |
clientCertificateCommonNames | クラスターの管理が許可されている共通名によって参照されるクライアント証明書の一覧。 | ClientCertificateCommonName[] |
clientCertificateThumbprints | クラスターの管理が許可されている拇印によって参照されるクライアント証明書の一覧。 | ClientCertificateThumbprint[] |
clusterCodeVersion | クラスターの Service Fabric ランタイム バージョン。 このプロパティは、 upgradeMode が 'Manual' に設定されている場合にのみユーザーを設定します。 新しいクラスターで使用可能な Service Fabric バージョンの一覧を取得するには、 ClusterVersion API を使用します。 既存のクラスターで使用可能なバージョンの一覧を取得するには、 availableClusterVersions を使用します。 | string |
diagnosticsStorageAccountConfig | Service Fabric 診断ログを格納するためのストレージ アカウント情報。 | DiagnosticsStorageAccountConfig |
enableHttpGatewayExclusiveAuthMode | true の場合、HttpGatewayEndpoint ではトークンベースの認証は許可されません。 これは、TLS バージョン 1.3 以降をサポートするために必要です。 トークンベースの認証を使用する場合は、HttpGatewayTokenAuthEndpointPort を定義する必要があります。 | [bool] |
eventStoreServiceEnabled | イベント ストア サービスが有効かどうかを示します。 | [bool] |
fabricSettings | クラスターを構成するためのカスタム ファブリック設定の一覧。 | SettingsSectionDescription[] |
infrastructureServiceManager | インフラストラクチャ サービス マネージャーが有効かどうかを示します。 | [bool] |
managementEndpoint | クラスターの http 管理エンドポイント。 | string (必須) |
nodeTypes | クラスター内のノードの種類の一覧。 | NodeTypeDescription[] (必須) |
notifications | クラスター イベントの通知チャネルの一覧を示します。 | Notification[] |
reliabilityLevel | 信頼性レベルは、システム サービスのレプリカ セット サイズを設定します。
ReliabilityLevel について説明します。 - None - ターゲット レプリカ セット数が 1 のシステム サービスを実行します。 これは、テスト クラスターにのみ使用する必要があります。 - Bronze - ターゲット レプリカ セット数が 3 のシステム サービスを実行します。 これは、テスト クラスターにのみ使用する必要があります。 - Silver - ターゲット レプリカ セット数が 5 のシステム サービスを実行します。 - Gold - ターゲット レプリカ セット数が 7 のシステム サービスを実行します。 - Platinum - ターゲット レプリカ セット数が 9 のシステム サービスを実行します。 |
'ブロンズ' 'Gold' 'None' 'Platinum' 'Silver' |
reverseProxyCertificate | リバース プロキシで使用されるサーバー証明書。 | CertificateDescription |
reverseProxyCertificateCommonNames | クラスターのセキュリティ保護に使用される共通名によって参照されるサーバー証明書の一覧について説明します。 | ServerCertificateCommonNames |
sfZonalUpgradeMode | このプロパティは、アップグレード ドメイン (UD) 内の VM の論理グループ化を制御します。 可用性ゾーンが複数あるノード タイプがクラスター内に既に存在する場合、このプロパティを変更することはできません。 | '階層' 'Parallel' |
upgradeDescription | クラスターのアップグレード時に使用するポリシー。 | ClusterUpgradePolicy |
upgradeMode | 新しい Service Fabric ランタイム バージョンが使用可能な場合のクラスターのアップグレード モード。 | 'Automatic' 'Manual' |
upgradePauseEndTimestampUtc | クラスターでのランタイム バージョンの自動アップグレードを、クラスター上の特定の期間 (UTC) に一時停止する終了日時を示します。 | string |
upgradePauseStartTimestampUtc | クラスター上の特定の期間 (UTC) に対して、クラスターのランタイム バージョンの自動アップグレードを一時停止する開始日時を示します。 | string |
upgradeWave | 新しいクラスター ランタイム バージョンのアップグレードがリリース後に適用されるタイミングを示します。 既定では Wave0 です。 upgradeMode が "自動" に設定されている場合にのみ適用されます。 | 'Wave0' 'Wave1' 'Wave2' |
vmImage | VM イメージ VMSS は で構成されています。 Windows や Linux などの汎用名を使用できます。 | string |
vmssZonalUpgradeMode | このプロパティは、仮想マシン スケール セットのアップグレード モードを定義します。複数のAvailability Zonesを持つノード タイプが追加される場合は必須です。 | '階層' 'Parallel' |
waveUpgradePaused | クラスターへのランタイム バージョンの自動アップグレードを一時停止するブール値。 | [bool] |
ApplicationTypeVersionsCleanupPolicy
名前 | 説明 | 値 |
---|---|---|
maxUnusedVersionsToKeep | 保持するアプリケーションの種類ごとの未使用バージョンの数。 | int (必須) 制約: 最小値 = 0 |
maxUnusedVersionsToKeep | 保持するアプリケーションの種類ごとの未使用バージョンの数。 | int (必須) 制約: 最小値 = 0 |
AzureActiveDirectory
名前 | 説明 | 値 |
---|---|---|
clientApplication | Azure Active Directory クライアント アプリケーション ID。 | string |
clusterApplication | Azure Active Directory クラスター アプリケーション ID。 | string |
tenantId | Azure Active Directory テナント ID。 | string |
clientApplication | Azure Active Directory クライアント アプリケーション ID。 | string |
clusterApplication | Azure Active Directory クラスター アプリケーション ID。 | string |
tenantId | Azure Active Directory テナント ID。 | string |
CertificateDescription
名前 | 説明 | 値 |
---|---|---|
thumbprint | プライマリ証明書の拇印。 | string (必須) |
thumbprintSecondary | セカンダリ証明書の拇印。 | string |
x509StoreName | ローカル証明書ストアの場所。 | 'AddressBook' 'AuthRoot' 'CertificateAuthority' 'Disallowed' 'My' 'Root' 'TrustedPeople' 'TrustedPublisher' |
ServerCertificateCommonNames
名前 | 説明 | 値 |
---|---|---|
commonNames | クラスターのセキュリティ保護に使用される共通名によって参照されるサーバー証明書の一覧。 | ServerCertificateCommonName[] |
x509StoreName | ローカル証明書ストアの場所。 | 'AddressBook' 'AuthRoot' 'CertificateAuthority' 'Disallowed' 'My' 'Root' 'TrustedPeople' 'TrustedPublisher' |
ServerCertificateCommonName
名前 | 説明 | 値 |
---|---|---|
certificateCommonName | サーバー証明書の共通名。 | string (必須) |
certificateIssuerThumbprint | サーバー証明書の発行者の拇印。 | string (必須) |
ClientCertificateCommonName
名前 | 説明 | 値 |
---|---|---|
certificateCommonName | クライアント証明書の共通名。 | string (必須) |
certificateIssuerThumbprint | クライアント証明書の発行者の拇印。 | string (必須) |
isAdmin | クライアント証明書にクラスターへの管理者アクセス権があるかどうかを示します。 管理者以外のクライアントは、クラスターに対してのみ読み取り専用操作を実行できます。 | bool (必須) |
ClientCertificateThumbprint
名前 | 説明 | 値 |
---|---|---|
certificateThumbprint | クライアント証明書の拇印。 | string (必須) |
isAdmin | クライアント証明書にクラスターへの管理者アクセス権があるかどうかを示します。 管理者以外のクライアントは、クラスターに対してのみ読み取り専用操作を実行できます。 | bool (必須) |
DiagnosticsStorageAccountConfig
名前 | 説明 | 値 |
---|---|---|
blobEndpoint | Azure ストレージ アカウントの BLOB エンドポイント。 | string (必須) |
protectedAccountKeyName | 保護された診断ストレージ キー名。 | string (必須) |
protectedAccountKeyName2 | セカンダリで保護された診断ストレージ キー名。 ストレージ アカウント キーの 1 つがローテーションされた場合、クラスターはもう一方のキーを使用するようにフォールバックします。 | string |
queueEndpoint | Azure ストレージ アカウントのキュー エンドポイント。 | string (必須) |
storageAccountName | Azure ストレージ アカウント名。 | string (必須) |
tableEndpoint | Azure ストレージ アカウントのテーブル エンドポイント。 | string (必須) |
SettingsSectionDescription
名前 | 説明 | 値 |
---|---|---|
name | ファブリック設定のセクション名。 | string (必須) |
parameters | セクション内のパラメーターのコレクション。 | SettingsParameterDescription[] (必須) |
name | ファブリック設定のセクション名。 | string (必須) |
parameters | セクション内のパラメーターのコレクション。 | SettingsParameterDescription[] (必須) |
SettingsParameterDescription
名前 | 説明 | 値 |
---|---|---|
name | ファブリック設定のパラメーター名。 | string (必須) |
value | ファブリック設定のパラメーター値。 | string (必須) |
name | ファブリック設定のパラメーター名。 | string (必須) |
value | ファブリック設定のパラメーター値。 | string (必須) |
NodeTypeDescription
名前 | 説明 | 値 |
---|---|---|
applicationPorts | クラスターが Service Fabric アプリケーションにポートを割り当てたポートの範囲。 | EndpointRangeDescription |
capacities | ノードの種類のノードに適用される容量タグ。クラスター リソース マネージャーはこれらのタグを使用して、ノードに含まれるリソースの量を把握します。 | NodeTypeDescriptionCapacities |
clientConnectionEndpointPort | TCP クラスター管理エンドポイント ポート。 | int (必須) |
durabilityLevel | ノード タイプの持続性レベル。
DurabilityLevel について説明します。 - ブロンズ - 特権なし。 既定値です。 - Silver - インフラストラクチャ ジョブは、UD あたり 10 分間一時停止できます。 - Gold - インフラストラクチャ ジョブは、UD あたり 2 時間の間一時停止できます。 Gold の持続性は、D15_V2 や G5 などのフル ノードの VM SKU でのみ有効にできます。 |
'Bronze' 'Gold' 'Silver' |
ephemeralPorts | このノード タイプのノードを構成する必要があるエフェメラル ポートの範囲。 | EndpointRangeDescription |
httpGatewayEndpointPort | HTTP クラスター管理エンドポイント ポート。 | int (必須) |
httpGatewayTokenAuthEndpointPort | クラスターへのトークン認証ベースの HTTPS 接続に使用されるポート。 HttpGatewayEndpoint と同じポートに設定することはできません。 | INT |
isPrimary | システム サービスを実行するノードの種類。 プライマリとしてマークする必要があるノードの種類は 1 つだけです。 既存のクラスターのプライマリ ノードの種類を削除または変更することはできません。 | bool (必須) |
isStateless | ノードの種類がステートレス ワークロードのみをホストできるかどうかを示します。 | [bool] |
multipleAvailabilityZones | ノードの種類が複数のゾーンをサポートするために有効になっているかどうかを示します。 | [bool] |
name | ノードの種類の名前。 | string (必須) |
placementProperties | ノード の種類のノードに適用される配置タグ。これは、特定のサービス (ワークロード) を実行する場所を示すために使用できます。 | NodeTypeDescriptionPlacementProperties |
reverseProxyEndpointPort | リバース プロキシで使用されるエンドポイント。 | INT |
vmInstanceCount | VMInstanceCount は 1 ~ n にする必要があります。n は、この nodeType に対応する VM インスタンスの数を示します。 VMInstanceCount = 0 は、次のシナリオでのみ実行できます。NodeType はセカンダリ nodeType です。 Durability = Bronze または Durability >= Bronze and InfrastructureServiceManager = true。 VMInstanceCount = 0 の場合、この nodeType の VM は初期クラスター サイズの計算に使用されないことを意味します。 | int (必須) 制約: 最小値 = 0 最大値 = 2147483647 |
EndpointRangeDescription
名前 | 説明 | 値 |
---|---|---|
endPort | ポートの範囲の終了ポート | int (必須) |
startPort | 一連のポートの開始ポート | int (必須) |
endPort | ポートの範囲の終了ポート | int (必須) |
startPort | 一連のポートの開始ポート | int (必須) |
NodeTypeDescriptionCapacities
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | string |
NodeTypeDescriptionPlacementProperties
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | string |
Notification
名前 | 説明 | 値 |
---|---|---|
isEnabled | 通知が有効になっているかどうかを示します。 | bool (必須) |
notificationCategory | 通知のカテゴリ。 | 'WaveProgress' (必須) |
notificationLevel | 通知のレベル。 | 'All' 'Critical' (必須) |
notificationTargets | 通知をサブスクライブするターゲットの一覧。 | NotificationTarget[] (必須) |
NotificationTarget
名前 | 説明 | 値 |
---|---|---|
notificationChannel | 通知チャネルは、通知をサブスクライブしている受信者の種類 (ユーザーまたはサブスクリプション) を示します。 | 'EmailSubscription' 'EmailUser' (必須) |
受信 機 | 通知をサブスクライブするターゲットの一覧。 | string[] (必須) |
ClusterUpgradePolicy
名前 | 説明 | 値 |
---|---|---|
deltaHealthPolicy | クラスターのアップグレード時に使用されるクラスター差分正常性ポリシー。 | ClusterUpgradeDeltaHealthPolicy |
forceRestart | true の場合、コード バージョンが変更されていない場合でも、アップグレード中にプロセスが強制的に再起動されます (アップグレードによって構成またはデータのみが変更されます)。 | [bool] |
healthCheckRetryTimeout | アップグレードがロールバックされるまでにアプリケーションまたはクラスターが異常な場合に正常性評価を再試行する時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
healthCheckStableDuration | アプリケーションまたはクラスターが正常な状態である必要がある時間。この時間を超えると、アップグレードが次のアップグレード ドメインに進みます。 期間は、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
healthCheckWaitDuration | アップグレード ドメインを完了してから正常性チェックを実行するまでの待機時間。 期間は、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
healthPolicy | クラスターのアップグレード時に使用されるクラスター正常性ポリシー。 | ClusterHealthPolicy (必須) |
upgradeDomainTimeout | アップグレード がロールバックされるまでに各アップグレード ドメインが完了する必要がある時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
upgradeReplicaSetCheckTimeout | アップグレード ドメインの処理をブロックし、予期しない問題が発生したときに可用性の損失を防ぐための最長時間。 このタイムアウトが期限切れになると、可用性の損失問題に関係なく、アップグレード ドメインの処理が続行されます。 タイムアウトは、各アップグレード ドメインの開始時にリセットされます。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
upgradeTimeout | アップグレードがロールバックされるまでに全体的なアップグレードが完了する必要がある時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
deltaHealthPolicy | クラスターデルタ正常性ポリシーは、クラスターのアップグレード中にクラスターの正常性を評価するために使用される正常性ポリシーを定義します。 | ClusterUpgradeDeltaHealthPolicy |
forceRestart | true の場合、コード バージョンが変更されていない場合でも、アップグレード中にプロセスが強制的に再起動されます (アップグレードによって構成またはデータのみが変更されます)。 | [bool] |
healthPolicy | クラスターの正常性ポリシーは、クラスターのアップグレード中にクラスターの正常性を評価するために使用される正常性ポリシーを定義します。 | ClusterHealthPolicy |
monitoringPolicy | クラスター監視ポリシーでは、監視モードでアップグレードを監視するためのパラメーターについて説明します。 | ClusterMonitoringPolicy |
upgradeReplicaSetCheckTimeout | アップグレード ドメインの処理をブロックし、予期しない問題が発生したときに可用性の損失を防ぐための最長時間。 このタイムアウトが期限切れになると、可用性の損失問題に関係なく、アップグレード ドメインの処理が続行されます。 タイムアウトは、各アップグレード ドメインの開始時にリセットされます。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかになります。 この値は、00:00:00 ~ 49710.06:28:15 (秒の場合は符号なし 32 ビット整数) である必要があります。 |
string |
ClusterUpgradeDeltaHealthPolicy
名前 | 説明 | 値 |
---|---|---|
applicationDeltaHealthPolicies | クラスターのアップグレード時にアプリケーションまたはその子エンティティの正常性を評価するために使用されるアプリケーション 差分正常性ポリシー マップを定義します。 | ApplicationDeltaHealthPolicyMap |
maxPercentDeltaUnhealthyApplications | クラスターのアップグレード中に許容されるアプリケーションの正常性低下の最大許容割合。 差分は、アップグレードの開始時のアプリケーションの状態と、正常性評価時のアプリケーションの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 システム サービスはこれに含まれません。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentDeltaUnhealthyNodes | クラスターのアップグレード時に許容できるノードの正常性低下の最大許容パーセンテージ。 差分は、アップグレードの開始時のノードの状態と、正常性評価の時のノードの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUpgradeDomainDeltaUnhealthyNodes | クラスターのアップグレード時に許容できるアップグレード ドメイン ノードの正常性低下の最大許容パーセンテージ。 差分は、アップグレードの開始時のアップグレード ドメイン ノードの状態と、正常性評価の時のアップグレード ドメイン ノードの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後にすべての完了したアップグレード ドメインに対して実行され、アップグレード ドメインの状態が許容範囲内であることを確認します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentDeltaUnhealthyApplications | クラスターのアップグレード中に許容されるアプリケーションの正常性低下の最大許容割合。 差分は、アップグレードの開始時のアプリケーションの状態と、正常性評価時のアプリケーションの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 システム サービスはこれに含まれません。 注: この値は、プロパティで指定された値を上書きします。UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications |
INT 制約: 最小値 = 0 最大値 = 100 |
maxPercentDeltaUnhealthyNodes | クラスターのアップグレード時に許容できるノードの正常性低下の最大許容パーセンテージ。 差分は、アップグレードの開始時のノードの状態と、正常性評価の時のノードの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUpgradeDomainDeltaUnhealthyNodes | クラスターのアップグレード時に許容できるアップグレード ドメイン ノードの正常性低下の最大許容パーセンテージ。 差分は、アップグレードの開始時のアップグレード ドメイン ノードの状態と、正常性評価の時のアップグレード ドメイン ノードの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後にすべての完了したアップグレード ドメインに対して実行され、アップグレード ドメインの状態が許容範囲内であることを確認します。 |
INT 制約: 最小値 = 0 最大値 = 100 |
ApplicationDeltaHealthPolicyMap
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | ApplicationDeltaHealthPolicy |
ApplicationDeltaHealthPolicy
名前 | 説明 | 値 |
---|---|---|
defaultServiceTypeDeltaHealthPolicy | クラスターのアップグレード時にサービスの種類の正常性を評価するために既定で使用されるデルタ正常性ポリシー。 | ServiceTypeDeltaHealthPolicy |
serviceTypeDeltaHealthPolicies | サービスの種類ごとにサービスの種類のデルタ正常性ポリシーを持つマップ。 このマップは、既定では空です。 | ServiceTypeDeltaHealthPolicyMap |
ServiceTypeDeltaHealthPolicy
名前 | 説明 | 値 |
---|---|---|
maxPercentDeltaUnhealthyServices | クラスターのアップグレード中に許容されるサービスの正常性低下の最大許容割合。 差分は、アップグレードの開始時のサービスの状態と正常性評価時のサービスの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 |
INT 制約: 最小値 = 0 最大値 = 100 |
ServiceTypeDeltaHealthPolicyMap
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | ServiceTypeDeltaHealthPolicy |
ClusterHealthPolicy
名前 | 説明 | 値 |
---|---|---|
applicationHealthPolicies | アプリケーションまたはその子エンティティの正常性を評価するために使用されるアプリケーション正常性ポリシー マップを定義します。 | ApplicationHealthPolicyMap |
maxPercentUnhealthyApplications | エラーを報告する前の異常なアプリケーションの最大許容パーセンテージ。 たとえば、アプリケーションの 10% の異常を許容するには、この値を 10 にします。 パーセンテージは、異常な可能性のあるアプリケーションの最大許容パーセンテージを表します。この値を超えるとクラスターはエラーの状態と見なされます。 許容パーセンテージ内であっても、1 つ以上の異常なアプリケーションがある場合は、正常性は Warning として評価されます。 これは、異常なアプリケーションの数をクラスター内のアプリケーション インスタンスの総数で割ることによって計算されます。ApplicationTypeHealthPolicyMap に含まれているアプリケーションの種類のアプリケーションは除外されます。 切り上げ計算が実行され、少数のアプリケーションに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 |
INT 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyNodes | エラーを報告する前の異常なノードの最大許容パーセンテージ。 たとえば、ノードの 10% の異常を許容するには、この値を 10 にします。 パーセンテージは、異常な可能性のあるノードの最大許容パーセンテージを表します。この値を超えるとクラスターはエラーの状態と見なされます。 許容パーセンテージ内であっても、1 つ以上の異常なノードがある場合は、正常性は Warning として評価されます。 パーセンテージは、異常なノードの数をクラスター内のノードの総数で割ることによって計算されます。 切り上げ計算が実行され、少数のノードに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 大規模なクラスターでは、ダウンしているか修復を必要とするノードがいくつか必ず存在するため、それが許容されるようにこのパーセンテージを構成する必要があります。 |
INT 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyApplications | エラーを報告する前の異常なアプリケーションの最大許容パーセンテージ。 たとえば、アプリケーションの 10% の異常を許容するには、この値を 10 にします。 パーセンテージは、異常な可能性のあるアプリケーションの最大許容パーセンテージを表します。この値を超えるとクラスターはエラーの状態と見なされます。 許容パーセンテージ内であっても、1 つ以上の異常なアプリケーションがある場合は、正常性は Warning として評価されます。 これは、異常なアプリケーションの数をクラスター内のアプリケーション インスタンスの総数で割ることによって計算されます。ApplicationTypeHealthPolicyMap に含まれているアプリケーションの種類のアプリケーションは除外されます。 切り上げ計算が実行され、少数のアプリケーションに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyNodes | エラーを報告する前の異常なノードの最大許容パーセンテージ。 たとえば、ノードの 10% の異常を許容するには、この値を 10 にします。 パーセンテージは、異常な可能性のあるノードの最大許容パーセンテージを表します。この値を超えるとクラスターはエラーの状態と見なされます。 許容パーセンテージ内であっても、1 つ以上の異常なノードがある場合は、正常性は Warning として評価されます。 パーセンテージは、異常なノードの数をクラスター内のノードの総数で割ることによって計算されます。 切り上げ計算が実行され、少数のノードに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 大規模なクラスターでは、ダウンしているか修復を必要とするノードがいくつか必ず存在するため、それが許容されるようにこのパーセンテージを構成する必要があります。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
ApplicationHealthPolicyMap
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | ApplicationHealthPolicy |
ApplicationHealthPolicy
名前 | 説明 | 値 |
---|---|---|
defaultServiceTypeHealthPolicy | サービスの種類の正常性を評価するために既定で使用される正常性ポリシー。 | ServiceTypeHealthPolicy |
serviceTypeHealthPolicies | サービスの種類ごとの正常性ポリシーを持つマップ。 このマップは、既定では空です。 | ServiceTypeHealthPolicyMap |
considerWarningAsError | 警告がエラーと同じ重大度で処理されることを示します。 | bool (必須) |
defaultServiceTypeHealthPolicy | サービスの種類の正常性を評価するために既定で使用される正常性ポリシー。 | ServiceTypeHealthPolicy |
maxPercentUnhealthyDeployedApplications | 異常なデプロイ済みアプリケーションの割合の最大許容パーセンテージ。 使用できる値は、0 から 100 までのバイト値です。 パーセンテージは、アプリケーションがエラーと見なされる前に異常になる可能性がある、デプロイされたアプリケーションの許容される最大割合を表します。 これは、異常にデプロイされたアプリケーションの数を、アプリケーションが現在クラスターにデプロイされているノードの数で割ることによって計算されます。 切り上げ計算が実行され、少数のノードに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 |
int (必須) |
serviceTypeHealthPolicyMap | サービスの種類ごとの正常性ポリシーを持つマップ。 このマップは、既定では空です。 | ServiceTypeHealthPolicyMap |
ServiceTypeHealthPolicy
名前 | 説明 | 値 |
---|---|---|
maxPercentUnhealthyServices | アプリケーションがエラーと見なされる前に、異常が許容されるサービスの最大割合。 | INT 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyPartitionsPerService | サービスあたりの異常なパーティションの最大許容割合。 割合は、サービスがエラーと見なされる前に異常になる可能性があるパーティションの最大許容割合を表します。 パーセンテージが考慮されているが、少なくとも 1 つの異常なパーティションがある場合、正常性は警告として評価されます。 割合は、異常なパーティションの数をサービス内のパーティションの合計数で割ることによって計算されます。 計算は切り上げて、少数のパーティションで 1 つの障害を許容します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyReplicasPerPartition | パーティションあたりの異常なレプリカの最大許容割合。 割合は、パーティションがエラーと見なされる前に異常になる可能性があるレプリカの最大許容割合を表します。 パーセンテージが考慮されているが、少なくとも 1 つの異常なレプリカがある場合、正常性は警告として評価されます。 割合は、異常なレプリカの数をパーティション内のレプリカの合計数で割ることによって計算されます。 計算は切り上げて、少数のレプリカで 1 つの障害を許容します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyServices | 異常なサービスの最大許容割合。 パーセンテージは、アプリケーションがエラーと見なされる前に異常になる可能性があるサービスの最大許容割合を表します。 割合が考慮されているが、異常なサービスが少なくとも 1 つ存在する場合、正常性は警告として評価されます。 これは、特定のサービスの種類の異常なサービスの数を、特定のサービスの種類のサービスの合計数で割ることによって計算されます。 計算は、少数のサービスで 1 つの障害を許容するように切り上げられます。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
ServiceTypeHealthPolicyMap
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | ServiceTypeHealthPolicy |
ClusterMonitoringPolicy
名前 | 説明 | 値 |
---|---|---|
healthCheckRetryTimeout | アップグレードがロールバックされるまでにアプリケーションまたはクラスターが異常な場合に正常性評価を再試行する時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
healthCheckStableDuration | アプリケーションまたはクラスターが正常な状態である必要がある時間。この時間を超えると、アップグレードが次のアップグレード ドメインに進みます。 期間は、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
healthCheckWaitDuration | アップグレード ドメインを完了してから正常性チェックを実行するまでの待機時間。 期間は、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
upgradeDomainTimeout | アップグレード がロールバックされるまでに各アップグレード ドメインが完了する必要がある時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
upgradeTimeout | アップグレードがロールバックされるまでに全体的なアップグレードが完了する必要がある時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
クイック スタート テンプレート
次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。
Template | 説明 |
---|---|
5 ノードの Ubuntu Service Fabric クラスターをデプロイする |
このテンプレートを使用すると、Ubuntu を実行するセキュリティで保護された 5 ノードの Service Fabric クラスターを、Standard_D2_V2 サイズ VMSS にデプロイできます。 |
5 ノードセキュリティで保護されたクラスターをデプロイする |
このテンプレートを使用すると、Windows Server 2019 Datacenter を実行するセキュリティで保護された 5 ノードの Service Fabric クラスターを、Standard_D2_v2 サイズの VMSS にデプロイできます。 |
NSG が有効になっている 3 Nodetype Secure Cluster をデプロイする |
このテンプレートを使用すると、Windows Server 2016 データ センターを実行するセキュリティで保護された 3 ノードタイプの Service fabric クラスターを、Standard_D2 サイズの VM にデプロイできます。 このテンプレートを使用すると、ネットワーク セキュリティ グループを使用して、受信および送信のネットワーク トラフィックを制御できます。 |
ARM テンプレート リソース定義
クラスターのリソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドに関するページを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.ServiceFabric/clusters リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.ServiceFabric/clusters",
"apiVersion": "2023-11-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"addOnFeatures": [ "string" ],
"applicationTypeVersionsCleanupPolicy": {
"maxUnusedVersionsToKeep": "int",
"maxUnusedVersionsToKeep": "int"
},
"azureActiveDirectory": {
"clientApplication": "string",
"clusterApplication": "string",
"tenantId": "string",
"clientApplication": "string",
"clusterApplication": "string",
"tenantId": "string"
},
"certificate": {
"thumbprint": "string",
"thumbprintSecondary": "string",
"x509StoreName": "string"
},
"certificateCommonNames": {
"commonNames": [
{
"certificateCommonName": "string",
"certificateIssuerThumbprint": "string"
}
],
"x509StoreName": "string"
},
"clientCertificateCommonNames": [
{
"certificateCommonName": "string",
"certificateIssuerThumbprint": "string",
"isAdmin": "bool"
}
],
"clientCertificateThumbprints": [
{
"certificateThumbprint": "string",
"isAdmin": "bool"
}
],
"clusterCodeVersion": "string",
"diagnosticsStorageAccountConfig": {
"blobEndpoint": "string",
"protectedAccountKeyName": "string",
"protectedAccountKeyName2": "string",
"queueEndpoint": "string",
"storageAccountName": "string",
"tableEndpoint": "string"
},
"enableHttpGatewayExclusiveAuthMode": "bool",
"eventStoreServiceEnabled": "bool",
"fabricSettings": [
{
"name": "string",
"parameters": [
{
"name": "string",
"value": "string",
"name": "string",
"value": "string"
}
],
"name": "string",
"parameters": [
{
"name": "string",
"value": "string",
"name": "string",
"value": "string"
}
]
}
],
"infrastructureServiceManager": "bool",
"managementEndpoint": "string",
"nodeTypes": [
{
"applicationPorts": {
"endPort": "int",
"startPort": "int",
"endPort": "int",
"startPort": "int"
},
"capacities": {
"{customized property}": "string"
},
"clientConnectionEndpointPort": "int",
"durabilityLevel": "string",
"ephemeralPorts": {
"endPort": "int",
"startPort": "int",
"endPort": "int",
"startPort": "int"
},
"httpGatewayEndpointPort": "int",
"httpGatewayTokenAuthEndpointPort": "int",
"isPrimary": "bool",
"isStateless": "bool",
"multipleAvailabilityZones": "bool",
"name": "string",
"placementProperties": {
"{customized property}": "string"
},
"reverseProxyEndpointPort": "int",
"vmInstanceCount": "int"
}
],
"notifications": [
{
"isEnabled": "bool",
"notificationCategory": "WaveProgress",
"notificationLevel": "string",
"notificationTargets": [
{
"notificationChannel": "string",
"receivers": [ "string" ]
}
]
}
],
"reliabilityLevel": "string",
"reverseProxyCertificate": {
"thumbprint": "string",
"thumbprintSecondary": "string",
"x509StoreName": "string"
},
"reverseProxyCertificateCommonNames": {
"commonNames": [
{
"certificateCommonName": "string",
"certificateIssuerThumbprint": "string"
}
],
"x509StoreName": "string"
},
"sfZonalUpgradeMode": "string",
"upgradeDescription": {
"deltaHealthPolicy": {
"applicationDeltaHealthPolicies": {
"{customized property}": {
"defaultServiceTypeDeltaHealthPolicy": {
"maxPercentDeltaUnhealthyServices": "int"
},
"serviceTypeDeltaHealthPolicies": {
"{customized property}": {
"maxPercentDeltaUnhealthyServices": "int"
}
}
}
},
"maxPercentDeltaUnhealthyApplications": "int",
"maxPercentDeltaUnhealthyNodes": "int",
"maxPercentUpgradeDomainDeltaUnhealthyNodes": "int",
"maxPercentDeltaUnhealthyApplications": "int",
"maxPercentDeltaUnhealthyNodes": "int",
"maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
},
"forceRestart": "bool",
"healthCheckRetryTimeout": "string",
"healthCheckStableDuration": "string",
"healthCheckWaitDuration": "string",
"healthPolicy": {
"applicationHealthPolicies": {
"{customized property}": {
"defaultServiceTypeHealthPolicy": {
"maxPercentUnhealthyServices": "int",
"maxPercentUnhealthyPartitionsPerService": "int",
"maxPercentUnhealthyReplicasPerPartition": "int",
"maxPercentUnhealthyServices": "int"
},
"serviceTypeHealthPolicies": {
"{customized property}": {
"maxPercentUnhealthyServices": "int",
"maxPercentUnhealthyPartitionsPerService": "int",
"maxPercentUnhealthyReplicasPerPartition": "int",
"maxPercentUnhealthyServices": "int"
}
},
"considerWarningAsError": "bool",
"defaultServiceTypeHealthPolicy": {
"maxPercentUnhealthyServices": "int",
"maxPercentUnhealthyPartitionsPerService": "int",
"maxPercentUnhealthyReplicasPerPartition": "int",
"maxPercentUnhealthyServices": "int"
},
"maxPercentUnhealthyDeployedApplications": "int",
"serviceTypeHealthPolicyMap": {
"{customized property}": {
"maxPercentUnhealthyServices": "int",
"maxPercentUnhealthyPartitionsPerService": "int",
"maxPercentUnhealthyReplicasPerPartition": "int",
"maxPercentUnhealthyServices": "int"
}
}
}
},
"maxPercentUnhealthyApplications": "int",
"maxPercentUnhealthyNodes": "int",
"maxPercentUnhealthyApplications": "int",
"maxPercentUnhealthyNodes": "int"
},
"upgradeDomainTimeout": "string",
"upgradeReplicaSetCheckTimeout": "string",
"upgradeTimeout": "string",
"deltaHealthPolicy": {
"applicationDeltaHealthPolicies": {
"{customized property}": {
"defaultServiceTypeDeltaHealthPolicy": {
"maxPercentDeltaUnhealthyServices": "int"
},
"serviceTypeDeltaHealthPolicies": {
"{customized property}": {
"maxPercentDeltaUnhealthyServices": "int"
}
}
}
},
"maxPercentDeltaUnhealthyApplications": "int",
"maxPercentDeltaUnhealthyNodes": "int",
"maxPercentUpgradeDomainDeltaUnhealthyNodes": "int",
"maxPercentDeltaUnhealthyApplications": "int",
"maxPercentDeltaUnhealthyNodes": "int",
"maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
},
"forceRestart": "bool",
"healthPolicy": {
"applicationHealthPolicies": {
"{customized property}": {
"defaultServiceTypeHealthPolicy": {
"maxPercentUnhealthyServices": "int",
"maxPercentUnhealthyPartitionsPerService": "int",
"maxPercentUnhealthyReplicasPerPartition": "int",
"maxPercentUnhealthyServices": "int"
},
"serviceTypeHealthPolicies": {
"{customized property}": {
"maxPercentUnhealthyServices": "int",
"maxPercentUnhealthyPartitionsPerService": "int",
"maxPercentUnhealthyReplicasPerPartition": "int",
"maxPercentUnhealthyServices": "int"
}
},
"considerWarningAsError": "bool",
"defaultServiceTypeHealthPolicy": {
"maxPercentUnhealthyServices": "int",
"maxPercentUnhealthyPartitionsPerService": "int",
"maxPercentUnhealthyReplicasPerPartition": "int",
"maxPercentUnhealthyServices": "int"
},
"maxPercentUnhealthyDeployedApplications": "int",
"serviceTypeHealthPolicyMap": {
"{customized property}": {
"maxPercentUnhealthyServices": "int",
"maxPercentUnhealthyPartitionsPerService": "int",
"maxPercentUnhealthyReplicasPerPartition": "int",
"maxPercentUnhealthyServices": "int"
}
}
}
},
"maxPercentUnhealthyApplications": "int",
"maxPercentUnhealthyNodes": "int",
"maxPercentUnhealthyApplications": "int",
"maxPercentUnhealthyNodes": "int"
},
"monitoringPolicy": {
"healthCheckRetryTimeout": "string",
"healthCheckStableDuration": "string",
"healthCheckWaitDuration": "string",
"upgradeDomainTimeout": "string",
"upgradeTimeout": "string"
},
"upgradeReplicaSetCheckTimeout": "string"
},
"upgradeMode": "string",
"upgradePauseEndTimestampUtc": "string",
"upgradePauseStartTimestampUtc": "string",
"upgradeWave": "string",
"vmImage": "string",
"vmssZonalUpgradeMode": "string",
"waveUpgradePaused": "bool"
}
}
プロパティ値
clusters
名前 | 説明 | 値 |
---|---|---|
type | リソースの種類 | 'Microsoft.ServiceFabric/clusters' |
apiVersion | リソース API のバージョン | '2023-11-01-preview' |
name | リソース名 | string (必須) 文字数制限: 4 から 23 有効な文字: 小文字、数字、およびハイフン。 小文字で開始します。 末尾には小文字または数字を使用します。 |
location | Azure リソースの場所。 | string (必須) |
tags | Azure リソース タグ。 | タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください |
properties | クラスター リソースのプロパティ | ClusterProperties |
ClusterProperties
名前 | 説明 | 値 |
---|---|---|
addOnFeatures | クラスターで有効にするアドオン機能の一覧。 | 次のいずれかを含む文字列配列: 'BackupRestoreService' 'DnsService' 'RepairManager' 'ResourceMonitorService' |
applicationTypeVersionsCleanupPolicy | 未使用のバージョンをクリーンするために使用されるポリシー。 | ApplicationTypeVersionsCleanupPolicy |
azureActiveDirectory | クラスターの AAD 認証設定。 | AzureActiveDirectory |
証明書 (certificate) | クラスターのセキュリティ保護に使用する証明書。 指定された証明書は、クラスター内のノード間のセキュリティ、クラスター管理エンドポイント用の SSL 証明書、および既定の管理クライアントに使用されます。 | CertificateDescription |
certificateCommonNames | クラスターのセキュリティ保護に使用される共通名によって参照されるサーバー証明書の一覧について説明します。 | ServerCertificateCommonNames |
clientCertificateCommonNames | クラスターの管理が許可されている共通名によって参照されるクライアント証明書の一覧。 | ClientCertificateCommonName[] |
clientCertificateThumbprints | クラスターの管理が許可されている拇印によって参照されるクライアント証明書の一覧。 | ClientCertificateThumbprint[] |
clusterCodeVersion | クラスターの Service Fabric ランタイム バージョン。 このプロパティは、 upgradeMode が 'Manual' に設定されている場合にのみユーザーを設定します。 新しいクラスターで使用可能な Service Fabric バージョンの一覧を取得するには、 ClusterVersion API を使用します。 既存のクラスターで使用可能なバージョンの一覧を取得するには、 availableClusterVersions を使用します。 | string |
diagnosticsStorageAccountConfig | Service Fabric 診断ログを格納するためのストレージ アカウント情報。 | DiagnosticsStorageAccountConfig |
enableHttpGatewayExclusiveAuthMode | true の場合、HttpGatewayEndpoint ではトークンベースの認証は許可されません。 これは、TLS バージョン 1.3 以降をサポートするために必要です。 トークンベースの認証を使用する場合は、HttpGatewayTokenAuthEndpointPort を定義する必要があります。 | [bool] |
eventStoreServiceEnabled | イベント ストア サービスが有効かどうかを示します。 | [bool] |
fabricSettings | クラスターを構成するためのカスタム ファブリック設定の一覧。 | SettingsSectionDescription[] |
infrastructureServiceManager | インフラストラクチャ サービス マネージャーが有効かどうかを示します。 | [bool] |
managementEndpoint | クラスターの http 管理エンドポイント。 | string (必須) |
nodeTypes | クラスター内のノードの種類の一覧。 | NodeTypeDescription[] (必須) |
notifications | クラスター イベントの通知チャネルの一覧を示します。 | Notification[] |
reliabilityLevel | 信頼性レベルは、システム サービスのレプリカ セット サイズを設定します。
ReliabilityLevel について説明します。 - None - ターゲット レプリカ セット数が 1 のシステム サービスを実行します。 これは、テスト クラスターにのみ使用する必要があります。 - Bronze - ターゲット レプリカ セット数が 3 のシステム サービスを実行します。 これは、テスト クラスターにのみ使用する必要があります。 - Silver - ターゲット レプリカ セット数が 5 のシステム サービスを実行します。 - Gold - ターゲット レプリカ セット数が 7 のシステム サービスを実行します。 - Platinum - ターゲット レプリカ セット数が 9 のシステム サービスを実行します。 |
'ブロンズ' 'Gold' 'None' 'Platinum' 'Silver' |
reverseProxyCertificate | リバース プロキシで使用されるサーバー証明書。 | CertificateDescription |
reverseProxyCertificateCommonNames | クラスターのセキュリティ保護に使用される共通名によって参照されるサーバー証明書の一覧について説明します。 | ServerCertificateCommonNames |
sfZonalUpgradeMode | このプロパティは、アップグレード ドメイン (UD) 内の VM の論理グループ化を制御します。 可用性ゾーンが複数あるノード タイプがクラスター内に既に存在する場合、このプロパティを変更することはできません。 | '階層' 'Parallel' |
upgradeDescription | クラスターのアップグレード時に使用するポリシー。 | ClusterUpgradePolicy |
upgradeMode | 新しい Service Fabric ランタイム バージョンが使用可能な場合のクラスターのアップグレード モード。 | 'Automatic' 'Manual' |
upgradePauseEndTimestampUtc | クラスターでのランタイム バージョンの自動アップグレードを、クラスター上の特定の期間 (UTC) に一時停止する終了日時を示します。 | string |
upgradePauseStartTimestampUtc | クラスター上の特定の期間 (UTC) に対して、クラスターのランタイム バージョンの自動アップグレードを一時停止する開始日時を示します。 | string |
upgradeWave | 新しいクラスター ランタイム バージョンのアップグレードがリリース後に適用されるタイミングを示します。 既定では Wave0 です。 upgradeMode が "自動" に設定されている場合にのみ適用されます。 | 'Wave0' 'Wave1' 'Wave2' |
vmImage | VM イメージ VMSS は で構成されています。 Windows や Linux などの汎用名を使用できます。 | string |
vmssZonalUpgradeMode | このプロパティは、仮想マシン スケール セットのアップグレード モードを定義します。複数のAvailability Zonesを持つノード タイプが追加される場合は必須です。 | '階層' 'Parallel' |
waveUpgradePaused | クラスターへのランタイム バージョンの自動アップグレードを一時停止するブール値。 | [bool] |
ApplicationTypeVersionsCleanupPolicy
名前 | 説明 | 値 |
---|---|---|
maxUnusedVersionsToKeep | 保持するアプリケーションの種類ごとの未使用バージョンの数。 | int (必須) 制約: 最小値 = 0 |
maxUnusedVersionsToKeep | 保持するアプリケーションの種類ごとの未使用バージョンの数。 | int (必須) 制約: 最小値 = 0 |
AzureActiveDirectory
名前 | 説明 | 値 |
---|---|---|
clientApplication | Azure Active Directory クライアント アプリケーション ID。 | string |
clusterApplication | Azure Active Directory クラスター アプリケーション ID。 | string |
tenantId | Azure Active Directory テナント ID。 | string |
clientApplication | Azure Active Directory クライアント アプリケーション ID。 | string |
clusterApplication | Azure Active Directory クラスター アプリケーション ID。 | string |
tenantId | Azure Active Directory テナント ID。 | string |
CertificateDescription
名前 | 説明 | 値 |
---|---|---|
thumbprint | プライマリ証明書の拇印。 | string (必須) |
thumbprintSecondary | セカンダリ証明書の拇印。 | string |
x509StoreName | ローカル証明書ストアの場所。 | 'AddressBook' 'AuthRoot' 'CertificateAuthority' 'Disallowed' 'My' 'Root' 'TrustedPeople' 'TrustedPublisher' |
ServerCertificateCommonNames
名前 | 説明 | 値 |
---|---|---|
commonNames | クラスターのセキュリティ保護に使用される共通名によって参照されるサーバー証明書の一覧。 | ServerCertificateCommonName[] |
x509StoreName | ローカル証明書ストアの場所。 | 'AddressBook' 'AuthRoot' 'CertificateAuthority' 'Disallowed' 'My' 'Root' 'TrustedPeople' 'TrustedPublisher' |
ServerCertificateCommonName
名前 | 説明 | 値 |
---|---|---|
certificateCommonName | サーバー証明書の共通名。 | string (必須) |
certificateIssuerThumbprint | サーバー証明書の発行者の拇印。 | string (必須) |
ClientCertificateCommonName
名前 | 説明 | 値 |
---|---|---|
certificateCommonName | クライアント証明書の共通名。 | string (必須) |
certificateIssuerThumbprint | クライアント証明書の発行者の拇印。 | string (必須) |
isAdmin | クライアント証明書にクラスターへの管理者アクセス権があるかどうかを示します。 管理者以外のクライアントは、クラスターに対してのみ読み取り専用操作を実行できます。 | bool (必須) |
ClientCertificateThumbprint
名前 | 説明 | 値 |
---|---|---|
certificateThumbprint | クライアント証明書の拇印。 | string (必須) |
isAdmin | クライアント証明書にクラスターへの管理者アクセス権があるかどうかを示します。 管理者以外のクライアントは、クラスターに対してのみ読み取り専用操作を実行できます。 | bool (必須) |
DiagnosticsStorageAccountConfig
名前 | 説明 | 値 |
---|---|---|
blobEndpoint | Azure ストレージ アカウントの BLOB エンドポイント。 | string (必須) |
protectedAccountKeyName | 保護された診断ストレージ キー名。 | string (必須) |
protectedAccountKeyName2 | セカンダリで保護された診断ストレージ キー名。 ストレージ アカウント キーの 1 つがローテーションされた場合、クラスターはもう一方のキーを使用するようにフォールバックします。 | string |
queueEndpoint | Azure ストレージ アカウントのキュー エンドポイント。 | string (必須) |
storageAccountName | Azure ストレージ アカウント名。 | string (必須) |
tableEndpoint | Azure ストレージ アカウントのテーブル エンドポイント。 | string (必須) |
SettingsSectionDescription
名前 | 説明 | 値 |
---|---|---|
name | ファブリック設定のセクション名。 | string (必須) |
parameters | セクション内のパラメーターのコレクション。 | SettingsParameterDescription[] (必須) |
name | ファブリック設定のセクション名。 | string (必須) |
parameters | セクション内のパラメーターのコレクション。 | SettingsParameterDescription[] (必須) |
SettingsParameterDescription
名前 | 説明 | 値 |
---|---|---|
name | ファブリック設定のパラメーター名。 | string (必須) |
value | ファブリック設定のパラメーター値。 | string (必須) |
name | ファブリック設定のパラメーター名。 | string (必須) |
value | ファブリック設定のパラメーター値。 | string (必須) |
NodeTypeDescription
名前 | 説明 | 値 |
---|---|---|
applicationPorts | クラスターが Service Fabric アプリケーションにポートを割り当てたポートの範囲。 | EndpointRangeDescription |
capacities | ノードの種類のノードに適用される容量タグでは、クラスター リソース マネージャーはこれらのタグを使用して、ノードのリソースの量を把握します。 | NodeTypeDescriptionCapacities |
clientConnectionEndpointPort | TCP クラスター管理エンドポイント ポート。 | int (必須) |
durabilityLevel | ノード タイプの持続性レベル。
DurabilityLevel について説明します。 - ブロンズ - 特権なし。 既定値です。 - Silver - インフラストラクチャ ジョブは、UD あたり 10 分間一時停止できます。 - Gold - インフラストラクチャ ジョブは、UD あたり 2 時間の間一時停止できます。 Gold の持続性は、D15_V2 や G5 などのフル ノードの VM SKU でのみ有効にできます。 |
'ブロンズ' 'Gold' 'Silver' |
ephemeralPorts | このノード タイプのノードを構成する必要があるエフェメラル ポートの範囲。 | EndpointRangeDescription |
httpGatewayEndpointPort | HTTP クラスター管理エンドポイント ポート。 | int (必須) |
httpGatewayTokenAuthEndpointPort | クラスターへのトークン認証ベースの HTTPS 接続に使用されるポート。 HttpGatewayEndpoint と同じポートに設定することはできません。 | INT |
isPrimary | システム サービスを実行するノードの種類。 プライマリとしてマークするノード タイプは 1 つだけです。 既存のクラスターでは、プライマリ ノードの種類を削除または変更できません。 | bool (必須) |
isStateless | ノードの種類がステートレス ワークロードのみをホストできるかどうかを示します。 | [bool] |
multipleAvailabilityZones | 複数のゾーンをサポートするためにノードの種類が有効になっているかどうかを示します。 | [bool] |
name | ノードの種類の名前。 | string (必須) |
placementProperties | ノード の種類のノードに適用される配置タグ。これは、特定のサービス (ワークロード) を実行する場所を示すために使用できます。 | NodeTypeDescriptionPlacementProperties |
reverseProxyEndpointPort | リバース プロキシによって使用されるエンドポイント。 | INT |
vmInstanceCount | VMInstanceCount は 1 から n にする必要があります。ここで n は、この nodeType に対応する VM インスタンスの数を示します。 VMInstanceCount = 0 は、次のシナリオでのみ実行できます。NodeType はセカンダリ nodeType です。 Durability = Bronze または Durability >= Bronze and InfrastructureServiceManager = true。 VMInstanceCount = 0 の場合、この nodeType の VM は初期クラスター サイズの計算に使用されないことを意味します。 | int (必須) 制約: 最小値 = 0 最大値 = 2147483647 |
EndpointRangeDescription
名前 | 説明 | 値 |
---|---|---|
endPort | ポートの範囲の終了ポート | int (必須) |
startPort | ポート範囲の開始ポート | int (必須) |
endPort | ポートの範囲の終了ポート | int (必須) |
startPort | ポート範囲の開始ポート | int (必須) |
NodeTypeDescriptionCapacities
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | string |
NodeTypeDescriptionPlacementProperties
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | string |
Notification
名前 | 説明 | 値 |
---|---|---|
isEnabled | 通知が有効になっているかどうかを示します。 | bool (必須) |
notificationCategory | 通知のカテゴリ。 | 'WaveProgress' (必須) |
notificationLevel | 通知のレベル。 | 'All' 'Critical' (必須) |
notificationTargets | 通知をサブスクライブするターゲットの一覧。 | NotificationTarget[] (必須) |
NotificationTarget
名前 | 説明 | 値 |
---|---|---|
notificationChannel | 通知チャネルは、通知にサブスクライブされている受信者の種類 (ユーザーまたはサブスクリプション) を示します。 | 'EmailSubscription' 'EmailUser' (必須) |
受信 機 | 通知をサブスクライブするターゲットの一覧。 | string[] (必須) |
ClusterUpgradePolicy
名前 | 説明 | 値 |
---|---|---|
deltaHealthPolicy | クラスターのアップグレード時に使用されるクラスターデルタ正常性ポリシー。 | ClusterUpgradeDeltaHealthPolicy |
forceRestart | true の場合、コード バージョンが変更されていない場合 (アップグレードによって構成またはデータのみが変更される) 場合でも、アップグレード中にプロセスが強制的に再起動されます。 | [bool] |
healthCheckRetryTimeout | アップグレードがロールバックされるまでにアプリケーションまたはクラスターが異常な場合に正常性評価を再試行する時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかになります。 | string (必須) |
healthCheckStableDuration | アプリケーションまたはクラスターが正常な状態である必要がある時間。この時間を超えると、アップグレードが次のアップグレード ドメインに進みます。 期間は、hh:mm:ss または d.hh:mm:ss.ms 形式で指定できます。 | string (必須) |
healthCheckWaitDuration | アップグレード ドメインを完了してから正常性チェックを実行するまでの待機時間。 期間は、hh:mm:ss または d.hh:mm:ss.ms 形式で指定できます。 | string (必須) |
healthPolicy | クラスターのアップグレード時に使用されるクラスター正常性ポリシー。 | ClusterHealthPolicy (必須) |
upgradeDomainTimeout | アップグレードがロールバックされるまでに、各アップグレード ドメインが完了する必要がある時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかになります。 | string (必須) |
upgradeReplicaSetCheckTimeout | アップグレード ドメインの処理をブロックし、予期しない問題が発生したときに可用性の損失を防ぐための最長時間。 このタイムアウトが期限切れになると、可用性の損失問題に関係なく、アップグレード ドメインの処理が続行されます。 タイムアウトは、各アップグレード ドメインの開始時にリセットされます。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかになります。 | string (必須) |
upgradeTimeout | アップグレードがロールバックされるまでに、アップグレード全体が完了する必要がある時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかになります。 | string (必須) |
deltaHealthPolicy | クラスターデルタ正常性ポリシーは、クラスターのアップグレード中にクラスターの正常性を評価するために使用される正常性ポリシーを定義します。 | ClusterUpgradeDeltaHealthPolicy |
forceRestart | true の場合、コード バージョンが変更されていない場合 (アップグレードによって構成またはデータのみが変更される) 場合でも、アップグレード中にプロセスが強制的に再起動されます。 | [bool] |
healthPolicy | クラスター正常性ポリシーは、クラスターのアップグレード中にクラスターの正常性を評価するために使用される正常性ポリシーを定義します。 | ClusterHealthPolicy |
monitoringPolicy | クラスター監視ポリシーは、監視モードでアップグレードを監視するためのパラメーターを記述します。 | ClusterMonitoringPolicy |
upgradeReplicaSetCheckTimeout | アップグレード ドメインの処理をブロックし、予期しない問題が発生したときに可用性の損失を防ぐための最長時間。 このタイムアウトが期限切れになると、可用性の損失問題に関係なく、アップグレード ドメインの処理が続行されます。 タイムアウトは、各アップグレード ドメインの開始時にリセットされます。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかになります。 この値は、00:00:00 ~ 49710.06:28:15 (秒の場合は符号なし 32 ビット整数) である必要があります。 |
string |
ClusterUpgradeDeltaHealthPolicy
名前 | 説明 | 値 |
---|---|---|
applicationDeltaHealthPolicies | クラスターのアップグレード時にアプリケーションまたはその子エンティティの正常性を評価するために使用されるアプリケーション 差分正常性ポリシー マップを定義します。 | ApplicationDeltaHealthPolicyMap |
maxPercentDeltaUnhealthyApplications | クラスターのアップグレード中に許容されるアプリケーションの正常性低下の最大許容割合。 差分は、アップグレードの開始時のアプリケーションの状態と、正常性評価時のアプリケーションの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 システム サービスはこれに含まれません。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentDeltaUnhealthyNodes | クラスターのアップグレード時に許容できるノードの正常性低下の最大許容パーセンテージ。 差分は、アップグレードの開始時のノードの状態と、正常性評価の時のノードの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUpgradeDomainDeltaUnhealthyNodes | クラスターのアップグレード時に許容できるアップグレード ドメイン ノードの正常性低下の最大許容パーセンテージ。 差分は、アップグレードの開始時のアップグレード ドメイン ノードの状態と、正常性評価の時のアップグレード ドメイン ノードの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後にすべての完了したアップグレード ドメインに対して実行され、アップグレード ドメインの状態が許容範囲内であることを確認します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentDeltaUnhealthyApplications | クラスターのアップグレード中に許容されるアプリケーションの正常性低下の最大許容割合。 差分は、アップグレードの開始時のアプリケーションの状態と、正常性評価時のアプリケーションの状態との間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 システム サービスはこれに含まれません。 注: この値は、プロパティで指定された値を上書きします。UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications |
INT 制約: 最小値 = 0 最大値 = 100 |
maxPercentDeltaUnhealthyNodes | クラスターのアップグレード時に許容できるノードの正常性低下の最大許容パーセンテージ。 差分は、アップグレードの開始時のノードの状態と、正常性評価の時のノードの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUpgradeDomainDeltaUnhealthyNodes | クラスターのアップグレード時に許容できるアップグレード ドメイン ノードの正常性低下の最大許容パーセンテージ。 差分は、アップグレードの開始時のアップグレード ドメイン ノードの状態と、正常性評価の時のアップグレード ドメイン ノードの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後にすべての完了したアップグレード ドメインに対して実行され、アップグレード ドメインの状態が許容範囲内であることを確認します。 |
INT 制約: 最小値 = 0 最大値 = 100 |
ApplicationDeltaHealthPolicyMap
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | ApplicationDeltaHealthPolicy |
ApplicationDeltaHealthPolicy
名前 | 説明 | 値 |
---|---|---|
defaultServiceTypeDeltaHealthPolicy | クラスターのアップグレード時にサービスの種類の正常性を評価するために既定で使用されるデルタ正常性ポリシー。 | ServiceTypeDeltaHealthPolicy |
serviceTypeDeltaHealthPolicies | サービスの種類の名前ごとのサービスの種類のデルタ正常性ポリシーを含むマップ。 このマップは、既定では空です。 | ServiceTypeDeltaHealthPolicyMap |
ServiceTypeDeltaHealthPolicy
名前 | 説明 | 値 |
---|---|---|
maxPercentDeltaUnhealthyServices | クラスターのアップグレード中に許容されるサービスの正常性低下の最大許容割合。 差分は、アップグレードの開始時のサービスの状態と正常性評価時のサービスの状態との間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 |
INT 制約: 最小値 = 0 最大値 = 100 |
ServiceTypeDeltaHealthPolicyMap
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | ServiceTypeDeltaHealthPolicy |
ClusterHealthPolicy
名前 | 説明 | 値 |
---|---|---|
applicationHealthPolicies | アプリケーションまたはその子エンティティの正常性を評価するために使用されるアプリケーション正常性ポリシー マップを定義します。 | ApplicationHealthPolicyMap |
maxPercentUnhealthyApplications | エラーを報告する前の異常なアプリケーションの最大許容パーセンテージ。 たとえば、アプリケーションの 10% の異常を許容するには、この値を 10 にします。 パーセンテージは、異常な可能性のあるアプリケーションの最大許容パーセンテージを表します。この値を超えるとクラスターはエラーの状態と見なされます。 許容パーセンテージ内であっても、1 つ以上の異常なアプリケーションがある場合は、正常性は Warning として評価されます。 これは、異常なアプリケーションの数をクラスター内のアプリケーション インスタンスの総数で割ることによって計算されます。ApplicationTypeHealthPolicyMap に含まれているアプリケーションの種類のアプリケーションは除外されます。 切り上げ計算が実行され、少数のアプリケーションに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 |
INT 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyNodes | エラーを報告する前の異常なノードの最大許容パーセンテージ。 たとえば、ノードの 10% の異常を許容するには、この値を 10 にします。 パーセンテージは、異常な可能性のあるノードの最大許容パーセンテージを表します。この値を超えるとクラスターはエラーの状態と見なされます。 許容パーセンテージ内であっても、1 つ以上の異常なノードがある場合は、正常性は Warning として評価されます。 パーセンテージは、異常なノードの数をクラスター内のノードの総数で割ることによって計算されます。 切り上げ計算が実行され、少数のノードに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 大規模なクラスターでは、ダウンしているか修復を必要とするノードがいくつか必ず存在するため、それが許容されるようにこのパーセンテージを構成する必要があります。 |
INT 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyApplications | エラーを報告する前の異常なアプリケーションの最大許容パーセンテージ。 たとえば、アプリケーションの 10% の異常を許容するには、この値を 10 にします。 パーセンテージは、異常な可能性のあるアプリケーションの最大許容パーセンテージを表します。この値を超えるとクラスターはエラーの状態と見なされます。 許容パーセンテージ内であっても、1 つ以上の異常なアプリケーションがある場合は、正常性は Warning として評価されます。 これは、異常なアプリケーションの数をクラスター内のアプリケーション インスタンスの総数で割ることによって計算されます。ApplicationTypeHealthPolicyMap に含まれているアプリケーションの種類のアプリケーションは除外されます。 切り上げ計算が実行され、少数のアプリケーションに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyNodes | エラーを報告する前の異常なノードの最大許容パーセンテージ。 たとえば、ノードの 10% の異常を許容するには、この値を 10 にします。 パーセンテージは、異常な可能性のあるノードの最大許容パーセンテージを表します。この値を超えるとクラスターはエラーの状態と見なされます。 許容パーセンテージ内であっても、1 つ以上の異常なノードがある場合は、正常性は Warning として評価されます。 パーセンテージは、異常なノードの数をクラスター内のノードの総数で割ることによって計算されます。 切り上げ計算が実行され、少数のノードに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 大規模なクラスターでは、ダウンしているか修復を必要とするノードがいくつか必ず存在するため、それが許容されるようにこのパーセンテージを構成する必要があります。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
ApplicationHealthPolicyMap
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | ApplicationHealthPolicy |
ApplicationHealthPolicy
名前 | 説明 | 値 |
---|---|---|
defaultServiceTypeHealthPolicy | サービスの種類の正常性を評価するために既定で使用される正常性ポリシー。 | ServiceTypeHealthPolicy |
serviceTypeHealthPolicies | サービスの種類の名前ごとのサービスの種類の正常性ポリシーを含むマップ。 このマップは、既定では空です。 | ServiceTypeHealthPolicyMap |
considerWarningAsError | 警告がエラーと同じ重大度で処理されることを示します。 | bool (必須) |
defaultServiceTypeHealthPolicy | サービスの種類の正常性を評価するために既定で使用される正常性ポリシー。 | ServiceTypeHealthPolicy |
maxPercentUnhealthyDeployedApplications | 異常なデプロイ済みアプリケーションの割合の最大許容パーセンテージ。 使用できる値は、0 から 100 までのバイト値です。 パーセンテージは、アプリケーションがエラーと見なされる前に異常になる可能性がある、デプロイされたアプリケーションの最大許容パーセンテージを表します。 これは、異常なデプロイされたアプリケーションの数を、クラスター内でアプリケーションが現在デプロイされているノードの数で割ることによって計算されます。 切り上げ計算が実行され、少数のノードに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 |
int (必須) |
serviceTypeHealthPolicyMap | サービスの種類の名前ごとのサービスの種類の正常性ポリシーを含むマップ。 このマップは、既定では空です。 | ServiceTypeHealthPolicyMap |
ServiceTypeHealthPolicy
名前 | 説明 | 値 |
---|---|---|
maxPercentUnhealthyServices | アプリケーションがエラーと見なされる前に、異常が許容されるサービスの最大割合。 | INT 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyPartitionsPerService | サービスあたりの異常なパーティションの最大許容割合。 割合は、サービスがエラーと見なされる前に異常になる可能性があるパーティションの最大許容割合を表します。 パーセンテージが考慮されているが、少なくとも 1 つの異常なパーティションがある場合、正常性は警告として評価されます。 割合は、異常なパーティションの数をサービス内のパーティションの合計数で割ることによって計算されます。 計算は切り上げて、少数のパーティションで 1 つの障害を許容します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyReplicasPerPartition | パーティションあたりの異常なレプリカの最大許容割合。 割合は、パーティションがエラーと見なされる前に異常になる可能性があるレプリカの最大許容割合を表します。 パーセンテージが考慮されているが、少なくとも 1 つの異常なレプリカがある場合、正常性は警告として評価されます。 割合は、異常なレプリカの数をパーティション内のレプリカの合計数で割ることによって計算されます。 計算は切り上げて、少数のレプリカで 1 つの障害を許容します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyServices | 異常なサービスの最大許容割合。 パーセンテージは、アプリケーションがエラーと見なされる前に異常になる可能性があるサービスの最大許容割合を表します。 割合が考慮されているが、異常なサービスが少なくとも 1 つ存在する場合、正常性は警告として評価されます。 これは、特定のサービスの種類の異常なサービスの数を、特定のサービスの種類のサービスの合計数で割ることによって計算されます。 計算は、少数のサービスで 1 つの障害を許容するように切り上げられます。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
ServiceTypeHealthPolicyMap
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | ServiceTypeHealthPolicy |
ClusterMonitoringPolicy
名前 | 説明 | 値 |
---|---|---|
healthCheckRetryTimeout | アップグレードがロールバックされるまでにアプリケーションまたはクラスターが異常な場合に正常性評価を再試行する時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
healthCheckStableDuration | アプリケーションまたはクラスターが正常な状態である必要がある時間。この時間を超えると、アップグレードが次のアップグレード ドメインに進みます。 期間は、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
healthCheckWaitDuration | アップグレード ドメインを完了してから正常性チェックを実行するまでの待機時間。 期間は、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
upgradeDomainTimeout | アップグレード がロールバックされるまでに各アップグレード ドメインが完了する必要がある時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
upgradeTimeout | アップグレードがロールバックされるまでに全体的なアップグレードが完了する必要がある時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
クイック スタート テンプレート
次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。
Template | 説明 |
---|---|
5 ノードの Ubuntu Service Fabric クラスターをデプロイする |
このテンプレートを使用すると、Ubuntu を実行するセキュリティで保護された 5 ノードの Service Fabric クラスターを、Standard_D2_V2 サイズ VMSS にデプロイできます。 |
5 ノードセキュリティで保護されたクラスターをデプロイする |
このテンプレートを使用すると、Windows Server 2019 Datacenter を実行するセキュリティで保護された 5 ノードの Service Fabric クラスターを、Standard_D2_v2 サイズの VMSS にデプロイできます。 |
NSG が有効になっている 3 Nodetype Secure Cluster をデプロイする |
このテンプレートを使用すると、Windows Server 2016 データ センターを実行するセキュリティで保護された 3 ノードタイプの Service fabric クラスターを、Standard_D2 サイズの VM にデプロイできます。 このテンプレートを使用すると、ネットワーク セキュリティ グループを使用して、受信および送信のネットワーク トラフィックを制御できます。 |
Terraform (AzAPI プロバイダー) リソース定義
クラスターのリソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループ
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.ServiceFabric/clusters リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceFabric/clusters@2023-11-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
addOnFeatures = [
"string"
]
applicationTypeVersionsCleanupPolicy = {
maxUnusedVersionsToKeep = int
maxUnusedVersionsToKeep = int
}
azureActiveDirectory = {
clientApplication = "string"
clusterApplication = "string"
tenantId = "string"
clientApplication = "string"
clusterApplication = "string"
tenantId = "string"
}
certificate = {
thumbprint = "string"
thumbprintSecondary = "string"
x509StoreName = "string"
}
certificateCommonNames = {
commonNames = [
{
certificateCommonName = "string"
certificateIssuerThumbprint = "string"
}
]
x509StoreName = "string"
}
clientCertificateCommonNames = [
{
certificateCommonName = "string"
certificateIssuerThumbprint = "string"
isAdmin = bool
}
]
clientCertificateThumbprints = [
{
certificateThumbprint = "string"
isAdmin = bool
}
]
clusterCodeVersion = "string"
diagnosticsStorageAccountConfig = {
blobEndpoint = "string"
protectedAccountKeyName = "string"
protectedAccountKeyName2 = "string"
queueEndpoint = "string"
storageAccountName = "string"
tableEndpoint = "string"
}
enableHttpGatewayExclusiveAuthMode = bool
eventStoreServiceEnabled = bool
fabricSettings = [
{
name = "string"
parameters = [
{
name = "string"
value = "string"
name = "string"
value = "string"
}
]
name = "string"
parameters = [
{
name = "string"
value = "string"
name = "string"
value = "string"
}
]
}
]
infrastructureServiceManager = bool
managementEndpoint = "string"
nodeTypes = [
{
applicationPorts = {
endPort = int
startPort = int
endPort = int
startPort = int
}
capacities = {
{customized property} = "string"
}
clientConnectionEndpointPort = int
durabilityLevel = "string"
ephemeralPorts = {
endPort = int
startPort = int
endPort = int
startPort = int
}
httpGatewayEndpointPort = int
httpGatewayTokenAuthEndpointPort = int
isPrimary = bool
isStateless = bool
multipleAvailabilityZones = bool
name = "string"
placementProperties = {
{customized property} = "string"
}
reverseProxyEndpointPort = int
vmInstanceCount = int
}
]
notifications = [
{
isEnabled = bool
notificationCategory = "WaveProgress"
notificationLevel = "string"
notificationTargets = [
{
notificationChannel = "string"
receivers = [
"string"
]
}
]
}
]
reliabilityLevel = "string"
reverseProxyCertificate = {
thumbprint = "string"
thumbprintSecondary = "string"
x509StoreName = "string"
}
reverseProxyCertificateCommonNames = {
commonNames = [
{
certificateCommonName = "string"
certificateIssuerThumbprint = "string"
}
]
x509StoreName = "string"
}
sfZonalUpgradeMode = "string"
upgradeDescription = {
deltaHealthPolicy = {
applicationDeltaHealthPolicies = {
{customized property} = {
defaultServiceTypeDeltaHealthPolicy = {
maxPercentDeltaUnhealthyServices = int
}
serviceTypeDeltaHealthPolicies = {
{customized property} = {
maxPercentDeltaUnhealthyServices = int
}
}
}
}
maxPercentDeltaUnhealthyApplications = int
maxPercentDeltaUnhealthyNodes = int
maxPercentUpgradeDomainDeltaUnhealthyNodes = int
maxPercentDeltaUnhealthyApplications = int
maxPercentDeltaUnhealthyNodes = int
maxPercentUpgradeDomainDeltaUnhealthyNodes = int
}
forceRestart = bool
healthCheckRetryTimeout = "string"
healthCheckStableDuration = "string"
healthCheckWaitDuration = "string"
healthPolicy = {
applicationHealthPolicies = {
{customized property} = {
defaultServiceTypeHealthPolicy = {
maxPercentUnhealthyServices = int
maxPercentUnhealthyPartitionsPerService = int
maxPercentUnhealthyReplicasPerPartition = int
maxPercentUnhealthyServices = int
}
serviceTypeHealthPolicies = {
{customized property} = {
maxPercentUnhealthyServices = int
maxPercentUnhealthyPartitionsPerService = int
maxPercentUnhealthyReplicasPerPartition = int
maxPercentUnhealthyServices = int
}
}
considerWarningAsError = bool
defaultServiceTypeHealthPolicy = {
maxPercentUnhealthyServices = int
maxPercentUnhealthyPartitionsPerService = int
maxPercentUnhealthyReplicasPerPartition = int
maxPercentUnhealthyServices = int
}
maxPercentUnhealthyDeployedApplications = int
serviceTypeHealthPolicyMap = {
{customized property} = {
maxPercentUnhealthyServices = int
maxPercentUnhealthyPartitionsPerService = int
maxPercentUnhealthyReplicasPerPartition = int
maxPercentUnhealthyServices = int
}
}
}
}
maxPercentUnhealthyApplications = int
maxPercentUnhealthyNodes = int
maxPercentUnhealthyApplications = int
maxPercentUnhealthyNodes = int
}
upgradeDomainTimeout = "string"
upgradeReplicaSetCheckTimeout = "string"
upgradeTimeout = "string"
deltaHealthPolicy = {
applicationDeltaHealthPolicies = {
{customized property} = {
defaultServiceTypeDeltaHealthPolicy = {
maxPercentDeltaUnhealthyServices = int
}
serviceTypeDeltaHealthPolicies = {
{customized property} = {
maxPercentDeltaUnhealthyServices = int
}
}
}
}
maxPercentDeltaUnhealthyApplications = int
maxPercentDeltaUnhealthyNodes = int
maxPercentUpgradeDomainDeltaUnhealthyNodes = int
maxPercentDeltaUnhealthyApplications = int
maxPercentDeltaUnhealthyNodes = int
maxPercentUpgradeDomainDeltaUnhealthyNodes = int
}
forceRestart = bool
healthPolicy = {
applicationHealthPolicies = {
{customized property} = {
defaultServiceTypeHealthPolicy = {
maxPercentUnhealthyServices = int
maxPercentUnhealthyPartitionsPerService = int
maxPercentUnhealthyReplicasPerPartition = int
maxPercentUnhealthyServices = int
}
serviceTypeHealthPolicies = {
{customized property} = {
maxPercentUnhealthyServices = int
maxPercentUnhealthyPartitionsPerService = int
maxPercentUnhealthyReplicasPerPartition = int
maxPercentUnhealthyServices = int
}
}
considerWarningAsError = bool
defaultServiceTypeHealthPolicy = {
maxPercentUnhealthyServices = int
maxPercentUnhealthyPartitionsPerService = int
maxPercentUnhealthyReplicasPerPartition = int
maxPercentUnhealthyServices = int
}
maxPercentUnhealthyDeployedApplications = int
serviceTypeHealthPolicyMap = {
{customized property} = {
maxPercentUnhealthyServices = int
maxPercentUnhealthyPartitionsPerService = int
maxPercentUnhealthyReplicasPerPartition = int
maxPercentUnhealthyServices = int
}
}
}
}
maxPercentUnhealthyApplications = int
maxPercentUnhealthyNodes = int
maxPercentUnhealthyApplications = int
maxPercentUnhealthyNodes = int
}
monitoringPolicy = {
healthCheckRetryTimeout = "string"
healthCheckStableDuration = "string"
healthCheckWaitDuration = "string"
upgradeDomainTimeout = "string"
upgradeTimeout = "string"
}
upgradeReplicaSetCheckTimeout = "string"
}
upgradeMode = "string"
upgradePauseEndTimestampUtc = "string"
upgradePauseStartTimestampUtc = "string"
upgradeWave = "string"
vmImage = "string"
vmssZonalUpgradeMode = "string"
waveUpgradePaused = bool
}
})
}
プロパティ値
clusters
名前 | 説明 | 値 |
---|---|---|
type | リソースの種類 | "Microsoft.ServiceFabric/clusters@2023-11-01-preview" |
name | リソース名 | string (必須) 文字数制限: 4 から 23 有効な文字: 小文字、数字、およびハイフン。 小文字で開始します。 末尾には小文字または数字を使用します。 |
location | Azure リソースの場所。 | string (必須) |
parent_id | リソース グループにデプロイするには、そのリソース グループの ID を使用します。 | string (必須) |
tags | Azure リソース タグ。 | タグ名と値のディクショナリ。 |
properties | クラスター リソースのプロパティ | ClusterProperties |
ClusterProperties
名前 | 説明 | 値 |
---|---|---|
addOnFeatures | クラスターで有効にするアドオン機能の一覧。 | 次のいずれかを含む文字列配列: "BackupRestoreService" "DnsService" "RepairManager" "ResourceMonitorService" |
applicationTypeVersionsCleanupPolicy | 未使用のバージョンをクリーンするために使用されるポリシー。 | ApplicationTypeVersionsCleanupPolicy |
azureActiveDirectory | クラスターの AAD 認証設定。 | AzureActiveDirectory |
証明書 (certificate) | クラスターのセキュリティ保護に使用する証明書。 指定された証明書は、クラスター内のノード間セキュリティ、クラスター管理エンドポイント用の SSL 証明書、および既定の管理クライアントに使用されます。 | CertificateDescription |
certificateCommonNames | クラスターのセキュリティ保護に使用される共通名によって参照されるサーバー証明書の一覧について説明します。 | ServerCertificateCommonNames |
clientCertificateCommonNames | クラスターの管理が許可されている共通名によって参照されるクライアント証明書の一覧。 | ClientCertificateCommonName[] |
clientCertificateThumbprints | クラスターの管理が許可されている拇印によって参照されるクライアント証明書の一覧。 | ClientCertificateThumbprint[] |
clusterCodeVersion | クラスターの Service Fabric ランタイム バージョン。 このプロパティは、 upgradeMode が 'Manual' に設定されている場合にのみユーザーを設定します。 新しいクラスターで使用可能な Service Fabric バージョンの一覧を取得するには、 ClusterVersion API を使用します。 既存のクラスターで使用可能なバージョンの一覧を取得するには、 availableClusterVersions を使用します。 | string |
diagnosticsStorageAccountConfig | Service Fabric 診断ログを格納するためのストレージ アカウント情報。 | DiagnosticsStorageAccountConfig |
enableHttpGatewayExclusiveAuthMode | true の場合、HttpGatewayEndpoint ではトークンベースの認証は許可されません。 これは、TLS バージョン 1.3 以降をサポートするために必要です。 トークンベースの認証を使用する場合は、HttpGatewayTokenAuthEndpointPort を定義する必要があります。 | [bool] |
eventStoreServiceEnabled | イベント ストア サービスが有効かどうかを示します。 | [bool] |
fabricSettings | クラスターを構成するためのカスタム ファブリック設定の一覧。 | SettingsSectionDescription[] |
infrastructureServiceManager | インフラストラクチャ サービス マネージャーが有効かどうかを示します。 | [bool] |
managementEndpoint | クラスターの http 管理エンドポイント。 | string (必須) |
nodeTypes | クラスター内のノードの種類の一覧。 | NodeTypeDescription[] (必須) |
notifications | クラスター イベントの通知チャネルの一覧を示します。 | Notification[] |
reliabilityLevel | 信頼性レベルは、システム サービスのレプリカ セット サイズを設定します。
ReliabilityLevel について説明します。 - None - ターゲット レプリカ セット数が 1 のシステム サービスを実行します。 これは、テスト クラスターにのみ使用する必要があります。 - Bronze - ターゲット レプリカ セット数が 3 のシステム サービスを実行します。 これは、テスト クラスターにのみ使用する必要があります。 - Silver - ターゲット レプリカ セット数が 5 のシステム サービスを実行します。 - Gold - ターゲット レプリカ セット数が 7 のシステム サービスを実行します。 - Platinum - ターゲット レプリカ セット数が 9 のシステム サービスを実行します。 |
"ブロンズ" "Gold" "None" "Platinum" "シルバー" |
reverseProxyCertificate | リバース プロキシで使用されるサーバー証明書。 | CertificateDescription |
reverseProxyCertificateCommonNames | クラスターのセキュリティ保護に使用される共通名によって参照されるサーバー証明書の一覧について説明します。 | ServerCertificateCommonNames |
sfZonalUpgradeMode | このプロパティは、アップグレード ドメイン (UD) 内の VM の論理グループ化を制御します。 可用性ゾーンが複数あるノード タイプがクラスター内に既に存在する場合、このプロパティを変更することはできません。 | "階層" "Parallel" |
upgradeDescription | クラスターのアップグレード時に使用するポリシー。 | ClusterUpgradePolicy |
upgradeMode | 新しい Service Fabric ランタイム バージョンが使用可能な場合のクラスターのアップグレード モード。 | "自動" "Manual" |
upgradePauseEndTimestampUtc | クラスターでのランタイム バージョンの自動アップグレードを、クラスター上の特定の期間 (UTC) に一時停止する終了日時を示します。 | string |
upgradePauseStartTimestampUtc | クラスター上の特定の期間 (UTC) に対して、クラスターのランタイム バージョンの自動アップグレードを一時停止する開始日時を示します。 | string |
upgradeWave | 新しいクラスター ランタイム バージョンのアップグレードがリリース後に適用されるタイミングを示します。 既定では Wave0 です。 upgradeMode が "自動" に設定されている場合にのみ適用されます。 | "Wave0" "Wave1" "Wave2" |
vmImage | VM イメージ VMSS は で構成されています。 Windows や Linux などの汎用名を使用できます。 | string |
vmssZonalUpgradeMode | このプロパティは、仮想マシン スケール セットのアップグレード モードを定義します。複数のAvailability Zonesを持つノード タイプが追加される場合は必須です。 | "階層" "Parallel" |
waveUpgradePaused | クラスターへのランタイム バージョンの自動アップグレードを一時停止するブール値。 | [bool] |
ApplicationTypeVersionsCleanupPolicy
名前 | 説明 | 値 |
---|---|---|
maxUnusedVersionsToKeep | 保持するアプリケーションの種類ごとの未使用バージョンの数。 | int (必須) 制約: 最小値 = 0 |
maxUnusedVersionsToKeep | 保持するアプリケーションの種類ごとの未使用バージョンの数。 | int (必須) 制約: 最小値 = 0 |
AzureActiveDirectory
名前 | 説明 | 値 |
---|---|---|
clientApplication | Azure Active Directory クライアント アプリケーション ID。 | string |
clusterApplication | Azure Active Directory クラスター アプリケーション ID。 | string |
tenantId | Azure Active Directory テナント ID。 | string |
clientApplication | Azure Active Directory クライアント アプリケーション ID。 | string |
clusterApplication | Azure Active Directory クラスター アプリケーション ID。 | string |
tenantId | Azure Active Directory テナント ID。 | string |
CertificateDescription
名前 | 説明 | 値 |
---|---|---|
thumbprint | プライマリ証明書の拇印。 | string (必須) |
thumbprintSecondary | セカンダリ証明書の拇印。 | string |
x509StoreName | ローカル証明書ストアの場所。 | "AddressBook" "AuthRoot" "CertificateAuthority" "許可されていません" "My" "Root" "TrustedPeople" "TrustedPublisher" |
ServerCertificateCommonNames
名前 | 説明 | 値 |
---|---|---|
commonNames | クラスターのセキュリティ保護に使用される共通名によって参照されるサーバー証明書の一覧。 | ServerCertificateCommonName[] |
x509StoreName | ローカル証明書ストアの場所。 | "AddressBook" "AuthRoot" "CertificateAuthority" "許可されていません" "My" "Root" "TrustedPeople" "TrustedPublisher" |
ServerCertificateCommonName
名前 | 説明 | 値 |
---|---|---|
certificateCommonName | サーバー証明書の共通名。 | string (必須) |
certificateIssuerThumbprint | サーバー証明書の発行者の拇印。 | string (必須) |
ClientCertificateCommonName
名前 | 説明 | 値 |
---|---|---|
certificateCommonName | クライアント証明書の共通名。 | string (必須) |
certificateIssuerThumbprint | クライアント証明書の発行者の拇印。 | string (必須) |
isAdmin | クライアント証明書がクラスターへの管理者アクセス権を持っているかどうかを示します。 管理者以外のクライアントは、クラスターに対して読み取り専用操作のみを実行できます。 | bool (必須) |
ClientCertificateThumbprint
名前 | 説明 | 値 |
---|---|---|
certificateThumbprint | クライアント証明書の拇印。 | string (必須) |
isAdmin | クライアント証明書がクラスターへの管理者アクセス権を持っているかどうかを示します。 管理者以外のクライアントは、クラスターに対して読み取り専用操作のみを実行できます。 | bool (必須) |
DiagnosticsStorageAccountConfig
名前 | 説明 | 値 |
---|---|---|
blobEndpoint | Azure ストレージ アカウントの BLOB エンドポイント。 | string (必須) |
protectedAccountKeyName | 保護された診断ストレージ キー名。 | string (必須) |
protectedAccountKeyName2 | セカンダリで保護された診断ストレージ キー名。 ストレージ アカウント キーの 1 つがローテーションされた場合、クラスターはもう一方のキーを使用するようにフォールバックします。 | string |
queueEndpoint | Azure ストレージ アカウントのキュー エンドポイント。 | string (必須) |
storageAccountName | Azure ストレージ アカウント名。 | string (必須) |
tableEndpoint | Azure ストレージ アカウントのテーブル エンドポイント。 | string (必須) |
SettingsSectionDescription
名前 | 説明 | 値 |
---|---|---|
name | ファブリック設定のセクション名。 | string (必須) |
parameters | セクション内のパラメーターのコレクション。 | SettingsParameterDescription[] (必須) |
name | ファブリック設定のセクション名。 | string (必須) |
parameters | セクション内のパラメーターのコレクション。 | SettingsParameterDescription[] (必須) |
SettingsParameterDescription
名前 | 説明 | 値 |
---|---|---|
name | ファブリック設定のパラメーター名。 | string (必須) |
value | ファブリック設定のパラメーター値。 | string (必須) |
name | ファブリック設定のパラメーター名。 | string (必須) |
value | ファブリック設定のパラメーター値。 | string (必須) |
NodeTypeDescription
名前 | 説明 | 値 |
---|---|---|
applicationPorts | クラスターが Service Fabric アプリケーションにポートを割り当てたポートの範囲。 | EndpointRangeDescription |
capacities | ノードの種類のノードに適用される容量タグでは、クラスター リソース マネージャーはこれらのタグを使用して、ノードのリソースの量を把握します。 | NodeTypeDescriptionCapacities |
clientConnectionEndpointPort | TCP クラスター管理エンドポイント ポート。 | int (必須) |
durabilityLevel | ノード タイプの持続性レベル。
DurabilityLevel について説明します。 - ブロンズ - 特権なし。 既定値です。 - Silver - インフラストラクチャ ジョブは、UD あたり 10 分間一時停止できます。 - Gold - インフラストラクチャ ジョブは、UD あたり 2 時間の間一時停止できます。 Gold の持続性は、D15_V2 や G5 などのフル ノードの VM SKU でのみ有効にできます。 |
"ブロンズ" "Gold" "シルバー" |
ephemeralPorts | このノード タイプのノードを構成する必要があるエフェメラル ポートの範囲。 | EndpointRangeDescription |
httpGatewayEndpointPort | HTTP クラスター管理エンドポイント ポート。 | int (必須) |
httpGatewayTokenAuthEndpointPort | クラスターへのトークン認証ベースの HTTPS 接続に使用されるポート。 HttpGatewayEndpoint と同じポートに設定することはできません。 | INT |
isPrimary | システム サービスを実行するノードの種類。 プライマリとしてマークするノード タイプは 1 つだけです。 既存のクラスターでは、プライマリ ノードの種類を削除または変更できません。 | bool (必須) |
isStateless | ノードの種類がステートレス ワークロードのみをホストできるかどうかを示します。 | [bool] |
multipleAvailabilityZones | 複数のゾーンをサポートするためにノードの種類が有効になっているかどうかを示します。 | [bool] |
name | ノードの種類の名前。 | string (必須) |
placementProperties | ノード の種類のノードに適用される配置タグ。これは、特定のサービス (ワークロード) を実行する場所を示すために使用できます。 | NodeTypeDescriptionPlacementProperties |
reverseProxyEndpointPort | リバース プロキシで使用されるエンドポイント。 | INT |
vmInstanceCount | VMInstanceCount は 1 ~ n にする必要があります。n は、この nodeType に対応する VM インスタンスの数を示します。 VMInstanceCount = 0 は、次のシナリオでのみ実行できます。NodeType はセカンダリ nodeType です。 Durability = Bronze または Durability >= Bronze and InfrastructureServiceManager = true。 VMInstanceCount = 0 の場合、この nodeType の VM は初期クラスター サイズの計算に使用されないことを意味します。 | int (必須) 制約: 最小値 = 0 最大値 = 2147483647 |
EndpointRangeDescription
名前 | 説明 | 値 |
---|---|---|
endPort | ポートの範囲の終了ポート | int (必須) |
startPort | 一連のポートの開始ポート | int (必須) |
endPort | ポートの範囲の終了ポート | int (必須) |
startPort | 一連のポートの開始ポート | int (必須) |
NodeTypeDescriptionCapacities
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | string |
NodeTypeDescriptionPlacementProperties
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | string |
Notification
名前 | 説明 | 値 |
---|---|---|
isEnabled | 通知が有効になっているかどうかを示します。 | bool (必須) |
notificationCategory | 通知のカテゴリ。 | "WaveProgress" (必須) |
notificationLevel | 通知のレベル。 | "All" "Critical" (必須) |
notificationTargets | 通知をサブスクライブするターゲットの一覧。 | NotificationTarget[] (必須) |
NotificationTarget
名前 | 説明 | 値 |
---|---|---|
notificationChannel | 通知チャネルは、通知をサブスクライブしている受信者の種類 (ユーザーまたはサブスクリプション) を示します。 | "EmailSubscription" "EmailUser" (必須) |
受信 機 | 通知をサブスクライブするターゲットの一覧。 | string[] (必須) |
ClusterUpgradePolicy
名前 | 説明 | 値 |
---|---|---|
deltaHealthPolicy | クラスターのアップグレード時に使用されるクラスター差分正常性ポリシー。 | ClusterUpgradeDeltaHealthPolicy |
forceRestart | true の場合、コード バージョンが変更されていない場合でも、アップグレード中にプロセスが強制的に再起動されます (アップグレードによって構成またはデータのみが変更されます)。 | [bool] |
healthCheckRetryTimeout | アップグレードがロールバックされるまでにアプリケーションまたはクラスターが異常な場合に正常性評価を再試行する時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
healthCheckStableDuration | アプリケーションまたはクラスターが正常な状態である必要がある時間。この時間を超えると、アップグレードが次のアップグレード ドメインに進みます。 期間は、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
healthCheckWaitDuration | アップグレード ドメインを完了してから正常性チェックを実行するまでの待機時間。 期間は、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
healthPolicy | クラスターのアップグレード時に使用されるクラスター正常性ポリシー。 | ClusterHealthPolicy (必須) |
upgradeDomainTimeout | アップグレード がロールバックされるまでに各アップグレード ドメインが完了する必要がある時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
upgradeReplicaSetCheckTimeout | アップグレード ドメインの処理をブロックし、予期しない問題が発生したときに可用性の損失を防ぐための最長時間。 このタイムアウトが期限切れになると、可用性の損失問題に関係なく、アップグレード ドメインの処理が続行されます。 タイムアウトは、各アップグレード ドメインの開始時にリセットされます。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
upgradeTimeout | アップグレードがロールバックされるまでに全体的なアップグレードが完了する必要がある時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
deltaHealthPolicy | クラスターデルタ正常性ポリシーは、クラスターのアップグレード中にクラスターの正常性を評価するために使用される正常性ポリシーを定義します。 | ClusterUpgradeDeltaHealthPolicy |
forceRestart | true の場合、コード バージョンが変更されていない場合でも、アップグレード中にプロセスが強制的に再起動されます (アップグレードによって構成またはデータのみが変更されます)。 | [bool] |
healthPolicy | クラスターの正常性ポリシーは、クラスターのアップグレード中にクラスターの正常性を評価するために使用される正常性ポリシーを定義します。 | ClusterHealthPolicy |
monitoringPolicy | クラスター監視ポリシーでは、監視モードでアップグレードを監視するためのパラメーターについて説明します。 | ClusterMonitoringPolicy |
upgradeReplicaSetCheckTimeout | アップグレード ドメインの処理をブロックし、予期しない問題が発生したときに可用性の損失を防ぐための最長時間。 このタイムアウトが期限切れになると、可用性の損失問題に関係なく、アップグレード ドメインの処理が続行されます。 タイムアウトは、各アップグレード ドメインの開始時にリセットされます。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 この値は、00:00:00 から 49710.06:28:15 (秒の場合は符号なし 32 ビット整数) である必要があります。 |
string |
ClusterUpgradeDeltaHealthPolicy
名前 | 説明 | 値 |
---|---|---|
applicationDeltaHealthPolicies | クラスターのアップグレード時にアプリケーションまたはその子エンティティの正常性を評価するために使用されるアプリケーション デルタ正常性ポリシー マップを定義します。 | ApplicationDeltaHealthPolicyMap |
maxPercentDeltaUnhealthyApplications | クラスターのアップグレード中に許容されるアプリケーションの正常性低下の最大許容割合。 差分は、アップグレードの開始時のアプリケーションの状態と、正常性評価時のアプリケーションの状態との間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 システム サービスはこれに含まれません。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentDeltaUnhealthyNodes | クラスターのアップグレード時に許容できるノードの正常性低下の最大許容パーセンテージ。 差分は、アップグレードの開始時のノードの状態と、正常性評価の時のノードの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUpgradeDomainDeltaUnhealthyNodes | クラスターのアップグレード時に許容できるアップグレード ドメイン ノードの正常性低下の最大許容パーセンテージ。 差分は、アップグレードの開始時のアップグレード ドメイン ノードの状態と、正常性評価の時のアップグレード ドメイン ノードの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後にすべての完了したアップグレード ドメインに対して実行され、アップグレード ドメインの状態が許容範囲内であることを確認します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentDeltaUnhealthyApplications | クラスターのアップグレード中に許容されるアプリケーションの正常性低下の最大許容割合。 差分は、アップグレードの開始時のアプリケーションの状態と、正常性評価時のアプリケーションの状態との間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 システム サービスはこれに含まれません。 注: この値は、プロパティで指定された値を上書きします。UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications |
INT 制約: 最小値 = 0 最大値 = 100 |
maxPercentDeltaUnhealthyNodes | クラスターのアップグレード時に許容できるノードの正常性低下の最大許容パーセンテージ。 差分は、アップグレードの開始時のノードの状態と、正常性評価の時のノードの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUpgradeDomainDeltaUnhealthyNodes | クラスターのアップグレード時に許容できるアップグレード ドメイン ノードの正常性低下の最大許容パーセンテージ。 差分は、アップグレードの開始時のアップグレード ドメイン ノードの状態と、正常性評価の時のアップグレード ドメイン ノードの状態の間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後にすべての完了したアップグレード ドメインに対して実行され、アップグレード ドメインの状態が許容範囲内であることを確認します。 |
INT 制約: 最小値 = 0 最大値 = 100 |
ApplicationDeltaHealthPolicyMap
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | ApplicationDeltaHealthPolicy |
ApplicationDeltaHealthPolicy
名前 | 説明 | 値 |
---|---|---|
defaultServiceTypeDeltaHealthPolicy | クラスターのアップグレード時にサービスの種類の正常性を評価するために既定で使用されるデルタ正常性ポリシー。 | ServiceTypeDeltaHealthPolicy |
serviceTypeDeltaHealthPolicies | サービスの種類の名前ごとのサービスの種類のデルタ正常性ポリシーを含むマップ。 このマップは、既定では空です。 | ServiceTypeDeltaHealthPolicyMap |
ServiceTypeDeltaHealthPolicy
名前 | 説明 | 値 |
---|---|---|
maxPercentDeltaUnhealthyServices | クラスターのアップグレード中に許容されるサービスの正常性低下の最大許容割合。 差分は、アップグレードの開始時のサービスの状態と正常性評価時のサービスの状態との間で測定されます。 チェックは、すべてのアップグレード ドメインのアップグレード完了後に実行され、クラスターのグローバル状態が許容範囲内であることを確認します。 |
INT 制約: 最小値 = 0 最大値 = 100 |
ServiceTypeDeltaHealthPolicyMap
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | ServiceTypeDeltaHealthPolicy |
ClusterHealthPolicy
名前 | 説明 | 値 |
---|---|---|
applicationHealthPolicies | アプリケーションまたはその子エンティティの正常性を評価するために使用されるアプリケーション正常性ポリシー マップを定義します。 | ApplicationHealthPolicyMap |
maxPercentUnhealthyApplications | エラーを報告する前の異常なアプリケーションの最大許容パーセンテージ。 たとえば、アプリケーションの 10% の異常を許容するには、この値を 10 にします。 パーセンテージは、異常な可能性のあるアプリケーションの最大許容パーセンテージを表します。この値を超えるとクラスターはエラーの状態と見なされます。 許容パーセンテージ内であっても、1 つ以上の異常なアプリケーションがある場合は、正常性は Warning として評価されます。 これは、異常なアプリケーションの数をクラスター内のアプリケーション インスタンスの総数で割ることによって計算されます。ApplicationTypeHealthPolicyMap に含まれているアプリケーションの種類のアプリケーションは除外されます。 切り上げ計算が実行され、少数のアプリケーションに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 |
INT 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyNodes | エラーを報告する前の異常なノードの最大許容パーセンテージ。 たとえば、ノードの 10% の異常を許容するには、この値を 10 にします。 パーセンテージは、異常な可能性のあるノードの最大許容パーセンテージを表します。この値を超えるとクラスターはエラーの状態と見なされます。 許容パーセンテージ内であっても、1 つ以上の異常なノードがある場合は、正常性は Warning として評価されます。 パーセンテージは、異常なノードの数をクラスター内のノードの総数で割ることによって計算されます。 切り上げ計算が実行され、少数のノードに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 大規模なクラスターでは、ダウンしているか修復を必要とするノードがいくつか必ず存在するため、それが許容されるようにこのパーセンテージを構成する必要があります。 |
INT 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyApplications | エラーを報告する前の異常なアプリケーションの最大許容パーセンテージ。 たとえば、アプリケーションの 10% の異常を許容するには、この値を 10 にします。 パーセンテージは、異常な可能性のあるアプリケーションの最大許容パーセンテージを表します。この値を超えるとクラスターはエラーの状態と見なされます。 許容パーセンテージ内であっても、1 つ以上の異常なアプリケーションがある場合は、正常性は Warning として評価されます。 これは、異常なアプリケーションの数をクラスター内のアプリケーション インスタンスの総数で割ることによって計算されます。ApplicationTypeHealthPolicyMap に含まれているアプリケーションの種類のアプリケーションは除外されます。 切り上げ計算が実行され、少数のアプリケーションに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyNodes | エラーを報告する前の異常なノードの最大許容パーセンテージ。 たとえば、ノードの 10% の異常を許容するには、この値を 10 にします。 パーセンテージは、異常な可能性のあるノードの最大許容パーセンテージを表します。この値を超えるとクラスターはエラーの状態と見なされます。 許容パーセンテージ内であっても、1 つ以上の異常なノードがある場合は、正常性は Warning として評価されます。 パーセンテージは、異常なノードの数をクラスター内のノードの総数で割ることによって計算されます。 切り上げ計算が実行され、少数のノードに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 大規模なクラスターでは、ダウンしているか修復を必要とするノードがいくつか必ず存在するため、それが許容されるようにこのパーセンテージを構成する必要があります。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
ApplicationHealthPolicyMap
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | ApplicationHealthPolicy |
ApplicationHealthPolicy
名前 | 説明 | 値 |
---|---|---|
defaultServiceTypeHealthPolicy | サービスの種類の正常性を評価するために既定で使用される正常性ポリシー。 | ServiceTypeHealthPolicy |
serviceTypeHealthPolicies | サービスの種類の名前ごとのサービスの種類の正常性ポリシーを含むマップ。 このマップは、既定では空です。 | ServiceTypeHealthPolicyMap |
considerWarningAsError | 警告がエラーと同じ重大度で処理されることを示します。 | bool (必須) |
defaultServiceTypeHealthPolicy | サービスの種類の正常性を評価するために既定で使用される正常性ポリシー。 | ServiceTypeHealthPolicy |
maxPercentUnhealthyDeployedApplications | 異常なデプロイ済みアプリケーションの割合の最大許容パーセンテージ。 使用できる値は、0 から 100 までのバイト値です。 パーセンテージは、アプリケーションがエラーと見なされる前に異常になる可能性がある、デプロイされたアプリケーションの最大許容パーセンテージを表します。 これは、異常なデプロイされたアプリケーションの数を、クラスター内でアプリケーションが現在デプロイされているノードの数で割ることによって計算されます。 切り上げ計算が実行され、少数のノードに対する 1 つのエラーは許容されます。 既定のパーセンテージは 0 です。 |
int (必須) |
serviceTypeHealthPolicyMap | サービスの種類の名前ごとのサービスの種類の正常性ポリシーを含むマップ。 このマップは、既定では空です。 | ServiceTypeHealthPolicyMap |
ServiceTypeHealthPolicy
名前 | 説明 | 値 |
---|---|---|
maxPercentUnhealthyServices | アプリケーションがエラーと見なされる前に、異常が許容されるサービスの最大割合。 | INT 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyPartitionsPerService | サービスあたりの異常なパーティションの最大許容割合。 割合は、サービスがエラーと見なされる前に異常になる可能性があるパーティションの最大許容割合を表します。 パーセンテージが考慮されているが、少なくとも 1 つの異常なパーティションがある場合、正常性は警告として評価されます。 割合は、異常なパーティションの数をサービス内のパーティションの合計数で割ることによって計算されます。 計算は切り上げて、少数のパーティションで 1 つの障害を許容します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyReplicasPerPartition | パーティションあたりの異常なレプリカの最大許容割合。 割合は、パーティションがエラーと見なされる前に異常になる可能性があるレプリカの最大許容割合を表します。 パーセンテージが考慮されているが、少なくとも 1 つの異常なレプリカがある場合、正常性は警告として評価されます。 割合は、異常なレプリカの数をパーティション内のレプリカの合計数で割ることによって計算されます。 計算は切り上げて、少数のレプリカで 1 つの障害を許容します。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
maxPercentUnhealthyServices | 異常なサービスの最大許容割合。 パーセンテージは、アプリケーションがエラーと見なされる前に異常になる可能性があるサービスの最大許容割合を表します。 割合が考慮されているが、異常なサービスが少なくとも 1 つ存在する場合、正常性は警告として評価されます。 これは、特定のサービスの種類の異常なサービスの数を、特定のサービスの種類のサービスの合計数で割ることによって計算されます。 計算は、少数のサービスで 1 つの障害を許容するように切り上げられます。 |
int (必須) 制約: 最小値 = 0 最大値 = 100 |
ServiceTypeHealthPolicyMap
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | ServiceTypeHealthPolicy |
ClusterMonitoringPolicy
名前 | 説明 | 値 |
---|---|---|
healthCheckRetryTimeout | アップグレードがロールバックされるまでにアプリケーションまたはクラスターが異常な場合に正常性評価を再試行する時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
healthCheckStableDuration | アプリケーションまたはクラスターが正常な状態である必要がある時間。この時間を超えると、アップグレードが次のアップグレード ドメインに進みます。 期間は、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
healthCheckWaitDuration | アップグレード ドメインを完了してから正常性チェックを実行するまでの待機時間。 期間は、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
upgradeDomainTimeout | アップグレード がロールバックされるまでに各アップグレード ドメインが完了する必要がある時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |
upgradeTimeout | アップグレードがロールバックされるまでに全体的なアップグレードが完了する必要がある時間。 タイムアウトは、hh:mm:ss または d.hh:mm:ss.ms 形式のいずれかです。 | string (必須) |