Microsoft.ServiceFabric クラスター 2016-09-01
Bicep リソース定義
クラスター リソースの種類は、次をターゲットとする操作でデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.ServiceFabric/clusters リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.ServiceFabric/clusters@2016-09-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
properties: {
azureActiveDirectory: {
clientApplication: 'string'
clusterApplication: 'string'
tenantId: 'string'
}
certificate: {
thumbprint: 'string'
thumbprintSecondary: 'string'
x509StoreName: 'string'
}
clientCertificateCommonNames: [
{
certificateCommonName: 'string'
certificateIssuerThumbprint: 'string'
isAdmin: bool
}
]
clientCertificateThumbprints: [
{
certificateThumbprint: 'string'
isAdmin: bool
}
]
clusterCodeVersion: 'string'
diagnosticsStorageAccountConfig: {
blobEndpoint: 'string'
protectedAccountKeyName: 'string'
queueEndpoint: 'string'
storageAccountName: 'string'
tableEndpoint: 'string'
}
fabricSettings: [
{
name: 'string'
parameters: [
{
name: 'string'
value: 'string'
}
]
}
]
managementEndpoint: 'string'
nodeTypes: [
{
applicationPorts: {
endPort: int
startPort: int
}
capacities: {
{customized property}: 'string'
}
clientConnectionEndpointPort: int
durabilityLevel: 'string'
ephemeralPorts: {
endPort: int
startPort: int
}
httpGatewayEndpointPort: int
isPrimary: bool
name: 'string'
placementProperties: {
{customized property}: 'string'
}
reverseProxyEndpointPort: int
vmInstanceCount: int
}
]
reliabilityLevel: 'string'
reverseProxyCertificate: {
thumbprint: 'string'
thumbprintSecondary: 'string'
x509StoreName: 'string'
}
upgradeDescription: {
deltaHealthPolicy: {
maxPercentDeltaUnhealthyApplications: int
maxPercentDeltaUnhealthyNodes: int
maxPercentUpgradeDomainDeltaUnhealthyNodes: int
}
forceRestart: bool
healthCheckRetryTimeout: 'string'
healthCheckStableDuration: 'string'
healthCheckWaitDuration: 'string'
healthPolicy: {
maxPercentUnhealthyApplications: int
maxPercentUnhealthyNodes: int
}
overrideUserUpgradePolicy: bool
upgradeDomainTimeout: 'string'
upgradeReplicaSetCheckTimeout: 'string'
upgradeTimeout: 'string'
}
upgradeMode: 'string'
vmImage: 'string'
}
}
プロパティ値
clusters
| 名前 | 説明 | 値 |
|---|---|---|
| name | リソース名 | string (必須) 文字制限: 4 から 23 有効な文字: 小文字、数字、およびハイフン。 小文字で開始します。 末尾には小文字または数字を使用します。 |
| location | リソースの場所。 | string (必須) |
| tags | リソース タグ。 | タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください |
| properties | クラスター リソースのプロパティ | ClusterProperties |
ClusterProperties
| 名前 | 説明 | 値 |
|---|---|---|
| azureActiveDirectory | クラスターで AAD 認証を有効にする設定 | AzureActiveDirectory |
| 証明書 (certificate) | このプライマリ証明書は、クラスター ノードからノードのセキュリティ、クラスター管理エンドポイントの SSL 証明書、および既定の管理クライアントとして使用されます | CertificateDescription |
| clientCertificateCommonNames | 共通名に基づいて信頼するクライアント証明書の一覧 | ClientCertificateCommonName[] |
| clientCertificateThumbprints | クライアント拇印の詳細は、クラスター操作のクライアント アクセスに使用されます | ClientCertificateThumbprint[] |
| clusterCodeVersion | クラスターで実行されている ServiceFabric コード バージョン | string |
| diagnosticsStorageAccountConfig | ストレージ 診断 アカウントの構成の詳細 | DiagnosticsStorageAccountConfig |
| fabricSettings | クラスターを構成するためのカスタム ファブリック設定の一覧。 | SettingsSectionDescription[] |
| managementEndpoint | クラスターの http 管理エンドポイント | string (必須) |
| nodeTypes | クラスターを構成するノードの種類の一覧 | NodeTypeDescription[] (必須) |
| reliabilityLevel | クラスターの信頼性レベルは、システム サービスのレプリカ セット サイズを示します | 'ブロンズ' 'Gold' 'Platinum' 'Silver' |
| reverseProxyCertificate | リバース プロキシで使用されるサーバー証明書 | CertificateDescription |
| upgradeDescription | クラスターのアップグレード時に使用するポリシー。 | ClusterUpgradePolicy |
| upgradeMode | クラスター アップグレード モードは、ファブリック のアップグレードがシステムによって自動的に開始されるかどうかを示します | 'Automatic' 'Manual' |
| vmImage | VM イメージ VMSS の名前は で構成されています。 Windows や Linux などの汎用名を使用できます。 | string |
AzureActiveDirectory
| 名前 | 説明 | 値 |
|---|---|---|
| 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' |
ClientCertificateCommonName
| 名前 | 説明 | 値 |
|---|---|---|
| certificateCommonName | アクセス権を付与する証明書の共通名。ワイルドカード共通名を使用する場合は注意してください | string (必須) |
| certificateIssuerThumbprint | 証明書発行者の拇印 | string (必須) |
| isAdmin | この証明書は、クライアントからの管理者アクセスに使用されるか、false の場合は 使用されるか、アクセスのみを照会します | bool (必須) |
ClientCertificateThumbprint
| 名前 | 説明 | 値 |
|---|---|---|
| certificateThumbprint | 証明書のサムプリント | string (必須) |
| isAdmin | この証明書は、クライアントからの管理者アクセスに使用されるか、false の場合は使用されるか、アクセスのみを照会します | bool (必須) |
DiagnosticsStorageAccountConfig
| 名前 | 説明 | 値 |
|---|---|---|
| blobEndpoint | 診断ストレージ アカウント BLOB エンドポイント | string (必須) |
| protectedAccountKeyName | 保護された診断ストレージ キー名 | string (必須) |
| queueEndpoint | 診断ストレージ アカウント キュー エンドポイント | string (必須) |
| storageAccountName | 診断ストレージ アカウント名 | string (必須) |
| tableEndpoint | 診断ストレージ アカウント テーブル エンドポイント | string (必須) |
SettingsSectionDescription
| 名前 | 説明 | 値 |
|---|---|---|
| name | 設定セクションの名前 | string (必須) |
| parameters | セクションの設定のコレクション。各設定は、設定名と値で構成されるタプルです | SettingsParameterDescription[] (必須) |
SettingsParameterDescription
| 名前 | 説明 | 値 |
|---|---|---|
| name | settings プロパティの名前 | string (必須) |
| value | プロパティの値。 | string (必須) |
NodeTypeDescription
| 名前 | 説明 | 値 |
|---|---|---|
| applicationPorts | アプリケーションで使用されるポート | EndpointRangeDescription |
| capacities | ノードの種類のノードに適用される容量タグ。クラスター リソース マネージャーはこれらのタグを使用して、ノードに含まれるリソースの量を把握します | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | TCP クラスター管理エンドポイント ポート | int (必須) |
| durabilityLevel | ノードの種類の持続性レベル | 'Bronze' 'Gold' 'Silver' |
| ephemeralPorts | システム割り当てアプリケーション ポート | EndpointRangeDescription |
| httpGatewayEndpointPort | HTTP クラスター管理エンドポイント ポート | int (必須) |
| isPrimary | これをプライマリ ノードの種類としてマークする | bool (必須) |
| name | ノードの種類の名前 | string (必須) |
| placementProperties | ノード の種類のノードに適用される配置タグ。これは、特定のサービス (ワークロード) を実行する場所を示すために使用できます | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | リバース プロキシで使用されるエンドポイント | INT |
| vmInstanceCount | ノード の種類のノード インスタンスの数 | int (必須) 制約: 最小値 = 1 最大値 = 2147483647 |
EndpointRangeDescription
| 名前 | 説明 | 値 |
|---|---|---|
| endPort | ポートの範囲の終了ポート | int (必須) |
| startPort | 一連のポートの開始ポート | int (必須) |
NodeTypeDescriptionCapacities
| 名前 | 説明 | 値 |
|---|---|---|
| {カスタマイズされたプロパティ} | string |
NodeTypeDescriptionPlacementProperties
| 名前 | 説明 | 値 |
|---|---|---|
| {カスタマイズされたプロパティ} | string |
ClusterUpgradePolicy
| 名前 | 説明 | 値 |
|---|---|---|
| deltaHealthPolicy | デルタ正常性ポリシー | ClusterUpgradeDeltaHealthPolicy |
| forceRestart | 強制的にノードを再起動するか、再起動しないか | [bool] |
| healthCheckRetryTimeout | 正常性チェックが継続的に失敗する可能性がある時間の長さ。.Net TimeSpan を表します | string (必須) |
| healthCheckStableDuration | 正常性チェックが継続的に通過する必要がある時間の長さ。.Net TimeSpan を表します | string (必須) |
| healthCheckWaitDuration | 正常性チェックを実行する前にアップグレード ドメインを完了してから待機する時間の長さは、.Net TimeSpan を表します | string (必須) |
| healthPolicy | クラスターの正常性ポリシー | ClusterHealthPolicy (必須) |
| overrideUserUpgradePolicy | ユーザー定義のアップグレード ポリシーを使用するかどうか | [bool] |
| upgradeDomainTimeout | アップグレード ドメインのタイムアウトは、.Net TimeSpan を表します | string (必須) |
| upgradeReplicaSetCheckTimeout | レプリカ セットのアップグレードが完了するまでのタイムアウト。.Net TimeSpan を表します | string (必須) |
| upgradeTimeout | アップグレード タイムアウトは、.Net TimeSpan を表します | string (必須) |
ClusterUpgradeDeltaHealthPolicy
| 名前 | 説明 | 値 |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | その他の異常なアプリケーションの割合 | int (必須) 制約: 最小値 = 0 最大値 = 100 |
| maxPercentDeltaUnhealthyNodes | 追加の異常なノードの割合 | int (必須) 制約: 最小値 = 0 最大値 = 100 |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | アップグレード ドメインあたりの追加の異常なノードの割合 | int (必須) 制約: 最小値 = 0 最大値 = 100 |
ClusterHealthPolicy
| 名前 | 説明 | 値 |
|---|---|---|
| maxPercentUnhealthyApplications | エラーを報告する前の異常なアプリケーションの最大許容パーセンテージ。 たとえば、アプリケーションの 10% の異常を許容するには、この値を 10 にします。 | INT 制約: 最小値 = 0 最大値 = 100 |
| maxPercentUnhealthyNodes | エラーを報告する前の異常なノードの最大許容パーセンテージ。 たとえば、ノードの 10% の異常を許容するには、この値を 10 にします。 | INT 制約: 最小値 = 0 最大値 = 100 |
クイック スタート テンプレート
次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。
| 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": "2016-09-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"azureActiveDirectory": {
"clientApplication": "string",
"clusterApplication": "string",
"tenantId": "string"
},
"certificate": {
"thumbprint": "string",
"thumbprintSecondary": "string",
"x509StoreName": "string"
},
"clientCertificateCommonNames": [
{
"certificateCommonName": "string",
"certificateIssuerThumbprint": "string",
"isAdmin": "bool"
}
],
"clientCertificateThumbprints": [
{
"certificateThumbprint": "string",
"isAdmin": "bool"
}
],
"clusterCodeVersion": "string",
"diagnosticsStorageAccountConfig": {
"blobEndpoint": "string",
"protectedAccountKeyName": "string",
"queueEndpoint": "string",
"storageAccountName": "string",
"tableEndpoint": "string"
},
"fabricSettings": [
{
"name": "string",
"parameters": [
{
"name": "string",
"value": "string"
}
]
}
],
"managementEndpoint": "string",
"nodeTypes": [
{
"applicationPorts": {
"endPort": "int",
"startPort": "int"
},
"capacities": {
"{customized property}": "string"
},
"clientConnectionEndpointPort": "int",
"durabilityLevel": "string",
"ephemeralPorts": {
"endPort": "int",
"startPort": "int"
},
"httpGatewayEndpointPort": "int",
"isPrimary": "bool",
"name": "string",
"placementProperties": {
"{customized property}": "string"
},
"reverseProxyEndpointPort": "int",
"vmInstanceCount": "int"
}
],
"reliabilityLevel": "string",
"reverseProxyCertificate": {
"thumbprint": "string",
"thumbprintSecondary": "string",
"x509StoreName": "string"
},
"upgradeDescription": {
"deltaHealthPolicy": {
"maxPercentDeltaUnhealthyApplications": "int",
"maxPercentDeltaUnhealthyNodes": "int",
"maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
},
"forceRestart": "bool",
"healthCheckRetryTimeout": "string",
"healthCheckStableDuration": "string",
"healthCheckWaitDuration": "string",
"healthPolicy": {
"maxPercentUnhealthyApplications": "int",
"maxPercentUnhealthyNodes": "int"
},
"overrideUserUpgradePolicy": "bool",
"upgradeDomainTimeout": "string",
"upgradeReplicaSetCheckTimeout": "string",
"upgradeTimeout": "string"
},
"upgradeMode": "string",
"vmImage": "string"
}
}
プロパティ値
clusters
| 名前 | 説明 | 値 |
|---|---|---|
| type | リソースの種類 | 'Microsoft.ServiceFabric/clusters' |
| apiVersion | リソース API のバージョン | '2016-09-01' |
| name | リソース名 | string (必須) 文字数制限: 4 から 23 有効な文字: 小文字、数字、およびハイフン。 小文字で開始します。 末尾には小文字または数字を使用します。 |
| location | リソースの場所。 | string (必須) |
| tags | リソース タグ。 | タグ名と値のディクショナリ。 「テンプレートのタグ」を参照してください |
| properties | クラスター リソースのプロパティ | ClusterProperties |
ClusterProperties
| 名前 | 説明 | 値 |
|---|---|---|
| azureActiveDirectory | クラスターで AAD 認証を有効にする設定 | AzureActiveDirectory |
| 証明書 (certificate) | このプライマリ証明書は、クラスター ノードからノードのセキュリティ、クラスター管理エンドポイントの SSL 証明書、既定の管理クライアントとして使用されます | CertificateDescription |
| clientCertificateCommonNames | 共通名に基づいて信頼するクライアント証明書の一覧 | ClientCertificateCommonName[] |
| clientCertificateThumbprints | クライアント拇印の詳細は、クラスター操作のクライアント アクセスに使用されます | ClientCertificateThumbprint[] |
| clusterCodeVersion | クラスターで実行されている ServiceFabric コード バージョン | string |
| diagnosticsStorageAccountConfig | ストレージ 診断 アカウントの構成の詳細 | DiagnosticsStorageAccountConfig |
| fabricSettings | クラスターを構成するためのカスタム ファブリック設定の一覧。 | SettingsSectionDescription[] |
| managementEndpoint | クラスターの http 管理エンドポイント | string (必須) |
| nodeTypes | クラスターを構成するノードの種類の一覧 | NodeTypeDescription[] (必須) |
| reliabilityLevel | クラスターの信頼性レベルは、システム サービスのレプリカ セット サイズを示します | 'ブロンズ' 'Gold' 'Platinum' 'Silver' |
| reverseProxyCertificate | リバース プロキシで使用されるサーバー証明書 | CertificateDescription |
| upgradeDescription | クラスターのアップグレード時に使用するポリシー。 | ClusterUpgradePolicy |
| upgradeMode | クラスター アップグレード モードは、ファブリック のアップグレードがシステムによって自動的に開始されるかどうかを示します | 'Automatic' 'Manual' |
| vmImage | VM イメージ VMSS の名前は で構成されています。 Windows や Linux などの汎用名を使用できます。 | string |
AzureActiveDirectory
| 名前 | 説明 | 値 |
|---|---|---|
| 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' |
ClientCertificateCommonName
| 名前 | 説明 | 値 |
|---|---|---|
| certificateCommonName | アクセス権が付与される証明書の共通名。野生のカード共通名を使用する場合は注意してください | string (必須) |
| certificateIssuerThumbprint | 証明書発行者の拇印 | string (必須) |
| isAdmin | この証明書は、クライアントからの管理者アクセスに使用されます。false の場合は、使用されるか、アクセスのみを照会します | bool (必須) |
ClientCertificateThumbprint
| 名前 | 説明 | 値 |
|---|---|---|
| certificateThumbprint | 証明書のサムプリント | string (必須) |
| isAdmin | この証明書は、クライアントからの管理者アクセスに使用されます。false の場合は、使用されるか、アクセスのみを照会します | bool (必須) |
DiagnosticsStorageAccountConfig
| 名前 | 説明 | 値 |
|---|---|---|
| blobEndpoint | 診断ストレージ アカウント BLOB エンドポイント | string (必須) |
| protectedAccountKeyName | 保護された診断ストレージ キー名 | string (必須) |
| queueEndpoint | 診断ストレージ アカウント キュー エンドポイント | string (必須) |
| storageAccountName | 診断ストレージ アカウント名 | string (必須) |
| tableEndpoint | 診断ストレージ アカウント テーブル のエンドポイント | string (必須) |
SettingsSectionDescription
| 名前 | 説明 | 値 |
|---|---|---|
| name | 設定セクションの名前 | string (必須) |
| parameters | セクション内の設定のコレクション。各設定は、設定名と値で構成されるタプルです | SettingsParameterDescription[] (必須) |
SettingsParameterDescription
| 名前 | 説明 | 値 |
|---|---|---|
| name | settings プロパティの名前 | string (必須) |
| value | プロパティの値。 | string (必須) |
NodeTypeDescription
| 名前 | 説明 | 値 |
|---|---|---|
| applicationPorts | アプリケーションで使用されるポート | EndpointRangeDescription |
| capacities | ノードの種類のノードに適用される容量タグは、クラスター リソース マネージャーはこれらのタグを使用して、ノードが持つリソースの量を把握します | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | TCP クラスター管理エンドポイント ポート | int (必須) |
| durabilityLevel | ノードの種類の持続性レベル | 'ブロンズ' 'Gold' 'Silver' |
| ephemeralPorts | システム割り当てアプリケーション ポート | EndpointRangeDescription |
| httpGatewayEndpointPort | HTTP クラスター管理エンドポイント ポート | int (必須) |
| isPrimary | これをプライマリ ノードの種類としてマークする | bool (必須) |
| name | ノード タイプの名前 | string (必須) |
| placementProperties | ノード の種類のノードに適用される配置タグ。これを使用して、特定のサービス (ワークロード) を実行する場所を示すことができます | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | リバース プロキシによって使用されるエンドポイント | INT |
| vmInstanceCount | ノード タイプ内のノード インスタンスの数 | int (必須) 制約: 最小値 = 1 最大値 = 2147483647 |
EndpointRangeDescription
| 名前 | 説明 | 値 |
|---|---|---|
| endPort | ポートの範囲の終了ポート | int (必須) |
| startPort | ポート範囲の開始ポート | int (必須) |
NodeTypeDescriptionCapacities
| 名前 | 説明 | 値 |
|---|---|---|
| {カスタマイズされたプロパティ} | string |
NodeTypeDescriptionPlacementProperties
| 名前 | 説明 | 値 |
|---|---|---|
| {カスタマイズされたプロパティ} | string |
ClusterUpgradePolicy
| 名前 | 説明 | 値 |
|---|---|---|
| deltaHealthPolicy | デルタ正常性ポリシー | ClusterUpgradeDeltaHealthPolicy |
| forceRestart | 強制的にノードを再起動するか、再起動しないか | [bool] |
| healthCheckRetryTimeout | 正常性チェックが継続的に失敗する時間の長さ。.Net TimeSpan を表します | string (必須) |
| healthCheckStableDuration | 正常性チェックが継続的に通過する必要がある時間の長さ。.Net TimeSpan を表します | string (必須) |
| healthCheckWaitDuration | 正常性チェックを実行する前にアップグレード ドメインを完了してから待機する時間の長さは、.Net TimeSpan を表します | string (必須) |
| healthPolicy | クラスターの正常性ポリシー | ClusterHealthPolicy (必須) |
| overrideUserUpgradePolicy | ユーザー定義のアップグレード ポリシーを使用するかどうか | [bool] |
| upgradeDomainTimeout | アップグレード ドメインのタイムアウトは、.Net TimeSpan を表します | string (必須) |
| upgradeReplicaSetCheckTimeout | レプリカ セットのアップグレードが完了するまでのタイムアウト。.Net TimeSpan を表します | string (必須) |
| upgradeTimeout | アップグレード タイムアウトは、.Net TimeSpan を表します | string (必須) |
ClusterUpgradeDeltaHealthPolicy
| 名前 | 説明 | 値 |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | その他の異常なアプリケーションの割合 | int (必須) 制約: 最小値 = 0 最大値 = 100 |
| maxPercentDeltaUnhealthyNodes | 追加の異常なノードの割合 | int (必須) 制約: 最小値 = 0 最大値 = 100 |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | アップグレード ドメインあたりの追加の異常なノードの割合 | int (必須) 制約: 最小値 = 0 最大値 = 100 |
ClusterHealthPolicy
| 名前 | 説明 | 値 |
|---|---|---|
| maxPercentUnhealthyApplications | エラーを報告する前の異常なアプリケーションの最大許容パーセンテージ。 たとえば、アプリケーションの 10% の異常を許容するには、この値を 10 にします。 | INT 制約: 最小値 = 0 最大値 = 100 |
| maxPercentUnhealthyNodes | エラーを報告する前の異常なノードの最大許容パーセンテージ。 たとえば、ノードの 10% の異常を許容するには、この値を 10 にします。 | INT 制約: 最小値 = 0 最大値 = 100 |
クイック スタート テンプレート
次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。
| 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@2016-09-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
azureActiveDirectory = {
clientApplication = "string"
clusterApplication = "string"
tenantId = "string"
}
certificate = {
thumbprint = "string"
thumbprintSecondary = "string"
x509StoreName = "string"
}
clientCertificateCommonNames = [
{
certificateCommonName = "string"
certificateIssuerThumbprint = "string"
isAdmin = bool
}
]
clientCertificateThumbprints = [
{
certificateThumbprint = "string"
isAdmin = bool
}
]
clusterCodeVersion = "string"
diagnosticsStorageAccountConfig = {
blobEndpoint = "string"
protectedAccountKeyName = "string"
queueEndpoint = "string"
storageAccountName = "string"
tableEndpoint = "string"
}
fabricSettings = [
{
name = "string"
parameters = [
{
name = "string"
value = "string"
}
]
}
]
managementEndpoint = "string"
nodeTypes = [
{
applicationPorts = {
endPort = int
startPort = int
}
capacities = {
{customized property} = "string"
}
clientConnectionEndpointPort = int
durabilityLevel = "string"
ephemeralPorts = {
endPort = int
startPort = int
}
httpGatewayEndpointPort = int
isPrimary = bool
name = "string"
placementProperties = {
{customized property} = "string"
}
reverseProxyEndpointPort = int
vmInstanceCount = int
}
]
reliabilityLevel = "string"
reverseProxyCertificate = {
thumbprint = "string"
thumbprintSecondary = "string"
x509StoreName = "string"
}
upgradeDescription = {
deltaHealthPolicy = {
maxPercentDeltaUnhealthyApplications = int
maxPercentDeltaUnhealthyNodes = int
maxPercentUpgradeDomainDeltaUnhealthyNodes = int
}
forceRestart = bool
healthCheckRetryTimeout = "string"
healthCheckStableDuration = "string"
healthCheckWaitDuration = "string"
healthPolicy = {
maxPercentUnhealthyApplications = int
maxPercentUnhealthyNodes = int
}
overrideUserUpgradePolicy = bool
upgradeDomainTimeout = "string"
upgradeReplicaSetCheckTimeout = "string"
upgradeTimeout = "string"
}
upgradeMode = "string"
vmImage = "string"
}
})
}
プロパティ値
clusters
| 名前 | 説明 | 値 |
|---|---|---|
| type | リソースの種類 | "Microsoft.ServiceFabric/clusters@2016-09-01" |
| name | リソース名 | string (必須) 文字数制限: 4 から 23 有効な文字: 小文字、数字、およびハイフン。 小文字で開始します。 末尾には小文字または数字を使用します。 |
| location | リソースの場所。 | string (必須) |
| parent_id | リソース グループにデプロイするには、そのリソース グループの ID を使用します。 | string (必須) |
| tags | リソース タグ。 | タグ名と値のディクショナリ。 |
| properties | クラスター リソースのプロパティ | ClusterProperties |
ClusterProperties
| 名前 | 説明 | 値 |
|---|---|---|
| azureActiveDirectory | クラスターで AAD 認証を有効にする設定 | AzureActiveDirectory |
| 証明書 (certificate) | このプライマリ証明書は、クラスター ノードからノードのセキュリティ、クラスター管理エンドポイントの SSL 証明書、既定の管理クライアントとして使用されます | CertificateDescription |
| clientCertificateCommonNames | 共通名に基づいて信頼するクライアント証明書の一覧 | ClientCertificateCommonName[] |
| clientCertificateThumbprints | クライアント拇印の詳細は、クラスター操作のクライアント アクセスに使用されます | ClientCertificateThumbprint[] |
| clusterCodeVersion | クラスターで実行されている ServiceFabric コード バージョン | string |
| diagnosticsStorageAccountConfig | ストレージ 診断 アカウントの構成の詳細 | DiagnosticsStorageAccountConfig |
| fabricSettings | クラスターを構成するカスタム ファブリック設定の一覧。 | SettingsSectionDescription[] |
| managementEndpoint | クラスターの http 管理エンドポイント | string (必須) |
| nodeTypes | クラスターを構成するノードの種類の一覧 | NodeTypeDescription[] (必須) |
| reliabilityLevel | クラスターの信頼性レベルは、システム サービスのレプリカ セット サイズを示します | "Bronze" "Gold" "Platinum" "シルバー" |
| reverseProxyCertificate | リバース プロキシで使用されるサーバー証明書 | CertificateDescription |
| upgradeDescription | クラスターのアップグレード時に使用するポリシー。 | ClusterUpgradePolicy |
| upgradeMode | クラスター アップグレード モードは、ファブリック アップグレードがシステムによって自動的に開始されるかどうかを示します | "自動" "Manual" |
| vmImage | VM イメージ VMSS の名前が で構成されています。 Windows や Linux などの汎用名を使用できます。 | string |
AzureActiveDirectory
| 名前 | 説明 | 値 |
|---|---|---|
| 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" |
ClientCertificateCommonName
| 名前 | 説明 | 値 |
|---|---|---|
| certificateCommonName | アクセス権を付与する証明書の共通名。ワイルドカード共通名を使用する場合は注意してください | string (必須) |
| certificateIssuerThumbprint | 証明書発行者の拇印 | string (必須) |
| isAdmin | この証明書は、クライアントからの管理者アクセスに使用されます。false の場合は、使用されるか、アクセスのみを照会します | bool (必須) |
ClientCertificateThumbprint
| 名前 | 説明 | 値 |
|---|---|---|
| certificateThumbprint | 証明書のサムプリント | string (必須) |
| isAdmin | この証明書は、クライアントからの管理者アクセスに使用されます。false の場合は、使用されるか、アクセスのみを照会します | bool (必須) |
DiagnosticsStorageAccountConfig
| 名前 | 説明 | 値 |
|---|---|---|
| blobEndpoint | 診断ストレージ アカウント BLOB エンドポイント | string (必須) |
| protectedAccountKeyName | 保護された診断ストレージ キー名 | string (必須) |
| queueEndpoint | 診断ストレージ アカウント キュー エンドポイント | string (必須) |
| storageAccountName | 診断ストレージ アカウント名 | string (必須) |
| tableEndpoint | 診断ストレージ アカウント テーブル のエンドポイント | string (必須) |
SettingsSectionDescription
| 名前 | 説明 | 値 |
|---|---|---|
| name | 設定セクションの名前 | string (必須) |
| parameters | セクション内の設定のコレクション。各設定は、設定名と値で構成されるタプルです | SettingsParameterDescription[] (必須) |
SettingsParameterDescription
| 名前 | 説明 | 値 |
|---|---|---|
| name | settings プロパティの名前 | string (必須) |
| value | プロパティの値。 | string (必須) |
NodeTypeDescription
| 名前 | 説明 | 値 |
|---|---|---|
| applicationPorts | アプリケーションで使用されるポート | EndpointRangeDescription |
| capacities | ノードの種類のノードに適用される容量タグは、クラスター リソース マネージャーはこれらのタグを使用して、ノードが持つリソースの量を把握します | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | TCP クラスター管理エンドポイント ポート | int (必須) |
| durabilityLevel | ノードの種類の持続性レベル | "ブロンズ" "Gold" "シルバー" |
| ephemeralPorts | システム割り当てアプリケーション ポート | EndpointRangeDescription |
| httpGatewayEndpointPort | HTTP クラスター管理エンドポイント ポート | int (必須) |
| isPrimary | これをプライマリ ノードの種類としてマークする | bool (必須) |
| name | ノード タイプの名前 | string (必須) |
| placementProperties | ノード の種類のノードに適用される配置タグ。これを使用して、特定のサービス (ワークロード) を実行する場所を示すことができます | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | リバース プロキシによって使用されるエンドポイント | INT |
| vmInstanceCount | ノード タイプ内のノード インスタンスの数 | int (必須) 制約: 最小値 = 1 最大値 = 2147483647 |
EndpointRangeDescription
| 名前 | 説明 | 値 |
|---|---|---|
| endPort | ポートの範囲の終了ポート | int (必須) |
| startPort | ポート範囲の開始ポート | int (必須) |
NodeTypeDescriptionCapacities
| 名前 | 説明 | 値 |
|---|---|---|
| {カスタマイズされたプロパティ} | string |
NodeTypeDescriptionPlacementProperties
| 名前 | 説明 | 値 |
|---|---|---|
| {カスタマイズされたプロパティ} | string |
ClusterUpgradePolicy
| 名前 | 説明 | 値 |
|---|---|---|
| deltaHealthPolicy | デルタ正常性ポリシー | ClusterUpgradeDeltaHealthPolicy |
| forceRestart | 強制的にノードを再起動するか、再起動しないか | [bool] |
| healthCheckRetryTimeout | 正常性チェックが継続的に失敗する時間の長さ。.Net TimeSpan を表します | string (必須) |
| healthCheckStableDuration | 正常性チェックが継続的に通過する必要がある時間の長さ。.Net TimeSpan を表します | string (必須) |
| healthCheckWaitDuration | 正常性チェックを実行する前にアップグレード ドメインを完了した後に待機する時間の長さは、.Net TimeSpan を表します | string (必須) |
| healthPolicy | クラスター正常性ポリシー | ClusterHealthPolicy (必須) |
| overrideUserUpgradePolicy | ユーザー定義のアップグレード ポリシーを使用するかどうか | [bool] |
| upgradeDomainTimeout | アップグレード ドメインのタイムアウトは、.Net TimeSpan を表します | string (必須) |
| upgradeReplicaSetCheckTimeout | レプリカ セットのアップグレードが完了するまでのタイムアウト。.Net TimeSpan を表します | string (必須) |
| upgradeTimeout | アップグレード タイムアウトは、.Net TimeSpan を表します | string (必須) |
ClusterUpgradeDeltaHealthPolicy
| 名前 | 説明 | 値 |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | その他の異常なアプリケーションの割合 | int (必須) 制約: 最小値 = 0 最大値 = 100 |
| maxPercentDeltaUnhealthyNodes | 追加の異常なノードの割合 | int (必須) 制約: 最小値 = 0 最大値 = 100 |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | アップグレード ドメインあたりの追加の異常なノードの割合 | int (必須) 制約: 最小値 = 0 最大値 = 100 |
ClusterHealthPolicy
| 名前 | 説明 | 値 |
|---|---|---|
| maxPercentUnhealthyApplications | エラーを報告する前の異常なアプリケーションの最大許容パーセンテージ。 たとえば、アプリケーションの 10% の異常を許容するには、この値を 10 にします。 | INT 制約: 最小値 = 0 最大値 = 100 |
| maxPercentUnhealthyNodes | エラーを報告する前の異常なノードの最大許容パーセンテージ。 たとえば、ノードの 10% の異常を許容するには、この値を 10 にします。 | INT 制約: 最小値 = 0 最大値 = 100 |
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示