Microsoft.ServiceFabric クラスター 2017-07-01-preview
Bicep リソース定義
クラスター リソースの種類は、次をターゲットとする操作でデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.ServiceFabric/clusters リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.ServiceFabric/clusters@2017-07-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
properties: {
addOnFeatures: [
'string'
]
availableClusterVersions: [
{
codeVersion: 'string'
environment: 'string'
supportExpiryUtc: 'string'
}
]
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'
clusterState: '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
}
upgradeDomainTimeout: 'string'
upgradeReplicaSetCheckTimeout: 'string'
upgradeTimeout: 'string'
}
upgradeMode: 'string'
vmImage: 'string'
}
}
プロパティ値
clusters
| 名前 | 説明 | 値 |
|---|---|---|
| name | リソース名 | string (必須) 文字制限: 4 から 23 有効な文字: 小文字、数字、およびハイフン。 小文字で開始します。 末尾には小文字または数字を使用します。 |
| location | リソースの場所。 | string (必須) |
| tags | リソース タグ。 | タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください |
| properties | クラスター リソースのプロパティ | ClusterProperties |
ClusterProperties
| 名前 | 説明 | 値 |
|---|---|---|
| addOnFeatures | クラスターで有効にするアドオン機能の一覧。 | 次のいずれかを含む文字列配列: 'BackupRestoreService' 'DnsService' 'RepairManager' |
| availableClusterVersions | このクラスターで使用できる Service Fabric ランタイム バージョン。 | ClusterVersionDetails[] |
| azureActiveDirectory | クラスターの AAD 認証設定。 | AzureActiveDirectory |
| 証明書 (certificate) | クラスターのセキュリティ保護に使用する証明書。 指定された証明書は、クラスター内のノード間のセキュリティ、クラスター管理エンドポイント用の SSL 証明書、および既定の管理クライアントに使用されます。 | CertificateDescription |
| clientCertificateCommonNames | クラスターの管理が許可されている共通名によって参照されるクライアント証明書の一覧。 | ClientCertificateCommonName[] |
| clientCertificateThumbprints | クラスターの管理が許可されている拇印によって参照されるクライアント証明書の一覧。 | ClientCertificateThumbprint[] |
| clusterCodeVersion | クラスターの Service Fabric ランタイム バージョン。 このプロパティは、 upgradeMode が 'Manual' に設定されている場合にのみユーザーを設定します。 新しいクラスターで使用可能な Service Fabric バージョンの一覧を取得するには、ClusterVersion API を使用します。 既存のクラスターで使用可能なバージョンの一覧を取得するには、 availableClusterVersions を使用します。 | string |
| clusterState | クラスターの現在の状態。 - WaitingForNodes - クラスター リソースが作成され、リソース プロバイダーが Service Fabric VM 拡張機能の起動と報告を待機していることを示します。 - デプロイ中 - Service Fabric ランタイムが VM にインストールされていることを示します。 クラスター リソースは、クラスターが起動し、システム サービスが起動するまで、この状態になります。 - BaselineUpgrade - クラスターのバージョンを確立するためにクラスターがアップグレード中であることを示します。 このアップグレードは、クラスターが初めて起動したときに自動的に開始されます。 - UpdatingUserConfiguration - ユーザーが指定した構成でクラスターがアップグレードされていることを示します。 - UpdatingUserCertificate - ユーザー指定の証明書を使用してクラスターがアップグレードされていることを示します。 - UpdatingInfrastructure - クラスターが最新の Service Fabric ランタイム バージョンでアップグレードされていることを示します。 これは、 upgradeMode が "自動" に設定されている場合にのみ発生します。 - EnforcingClusterVersion - クラスターが想定とは異なるバージョンにあり、クラスターが予想されるバージョンにアップグレードされていることを示します。 - UpgradeServiceUnreachable - クラスター内のシステム サービスがリソース プロバイダーをポーリングしなくなったことを示します。 この状態のクラスターは、リソース プロバイダーによって管理できません。 - AutoScale - クラスターの ReliabilityLevel が調整されていることを示します。 - 準備完了 - クラスターが安定した状態であることを示します。 |
'AutoScale' 'BaselineUpgrade' 'デプロイ中' 'EnforcingClusterVersion' 'Ready' 'UpdatingInfrastructure' 'UpdatingUserCertificate' 'UpdatingUserConfiguration' 'UpgradeServiceUnreachable' 'WaitingForNodes' |
| diagnosticsStorageAccountConfig | Service Fabric 診断ログを格納するためのストレージ アカウント情報。 | DiagnosticsStorageAccountConfig |
| fabricSettings | クラスターを構成するためのカスタム ファブリック設定の一覧。 | SettingsSectionDescription[] |
| managementEndpoint | クラスターの http 管理エンドポイント。 | string (必須) |
| nodeTypes | クラスター内のノードの種類の一覧。 | NodeTypeDescription[] (必須) |
| reliabilityLevel | 信頼性レベルは、システム サービスのレプリカ セット サイズを設定します。 ReliabilityLevel について説明します。 - None - ターゲット レプリカ セット数が 1 のシステム サービスを実行します。 これは、テスト クラスターにのみ使用する必要があります。 - Bronze - ターゲット レプリカ セット数が 3 のシステム サービスを実行します。 これは、テスト クラスターにのみ使用する必要があります。 - Silver - ターゲット レプリカ セット数が 5 のシステム サービスを実行します。 - Gold - ターゲット レプリカ セット数が 7 のシステム サービスを実行します。 - Platinum - ターゲット レプリカ セット数が 9 のシステム サービスを実行します。 |
'Bronze' 'Gold' 'None' 'Platinum' 'Silver' |
| reverseProxyCertificate | リバース プロキシで使用されるサーバー証明書。 | CertificateDescription |
| upgradeDescription | クラスターのアップグレード時に使用するポリシー。 | ClusterUpgradePolicy |
| upgradeMode | 新しい Service Fabric ランタイム バージョンが使用可能な場合のクラスターのアップグレード モード。 - 自動 - クラスターは、使用可能になるとすぐに、最新の Service Fabric ランタイム バージョンに自動的にアップグレードされます。 - 手動 - クラスターは、最新の Service Fabric ランタイム バージョンに自動的にアップグレードされません。 クラスターは、クラスター リソースで clusterCodeVersion プロパティを設定することによってアップグレードされます。 |
'Automatic' 'Manual' |
| vmImage | VM イメージ VMSS は で構成されています。 Windows や Linux などの汎用名を使用できます。 | string |
ClusterVersionDetails
| 名前 | 説明 | 値 |
|---|---|---|
| codeVersion | クラスターの Service Fabric ランタイム バージョン。 | string |
| 環境 | このバージョンが Windows または Linux オペレーティング システム用かどうかを示します。 | 'Linux' 'Windows' |
| supportExpiryUtc | バージョンのサポートの有効期限の日付。 | 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 | クライアント証明書がクラスターへの管理者アクセス権を持っているかどうかを示します。 管理者以外のクライアントは、クラスターに対して読み取り専用操作のみを実行できます。 | bool (必須) |
ClientCertificateThumbprint
| 名前 | 説明 | 値 |
|---|---|---|
| certificateThumbprint | クライアント証明書の拇印。 | string (必須) |
| isAdmin | クライアント証明書がクラスターへの管理者アクセス権を持っているかどうかを示します。 管理者以外のクライアントは、クラスターに対して読み取り専用操作のみを実行できます。 | bool (必須) |
DiagnosticsStorageAccountConfig
| 名前 | 説明 | 値 |
|---|---|---|
| blobEndpoint | Azure ストレージ アカウントの BLOB エンドポイント。 | string (必須) |
| protectedAccountKeyName | 保護された診断ストレージ キー名。 | string (必須) |
| queueEndpoint | Azure ストレージ アカウントのキュー エンドポイント。 | string (必須) |
| storageAccountName | Azure ストレージ アカウント名。 | string (必須) |
| tableEndpoint | Azure ストレージ アカウントのテーブル エンドポイント。 | string (必須) |
SettingsSectionDescription
| 名前 | 説明 | 値 |
|---|---|---|
| name | ファブリック設定のセクション名。 | string (必須) |
| parameters | セクション内のパラメーターのコレクション。 | SettingsParameterDescription[] (必須) |
SettingsParameterDescription
| 名前 | 説明 | 値 |
|---|---|---|
| name | ファブリック設定のパラメーター名。 | string (必須) |
| value | ファブリック設定のパラメーター値。 | string (必須) |
NodeTypeDescription
| 名前 | 説明 | 値 |
|---|---|---|
| applicationPorts | クラスターが Service Fabric アプリケーションにポートを割り当てたポートの範囲。 | EndpointRangeDescription |
| capacities | ノードの種類のノードに適用される容量タグ。クラスター リソース マネージャーはこれらのタグを使用して、ノードに含まれるリソースの量を把握します。 | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | TCP クラスター管理エンドポイント ポート。 | int (必須) |
| durabilityLevel | ノード タイプの持続性レベル。 DurabilityLevel について説明します。 - ブロンズ - 特権なし。 既定値です。 - Silver - インフラストラクチャ ジョブは、UD あたり 30 分間一時停止できます。 - Gold - インフラストラクチャ ジョブは、UD あたり 2 時間の間一時停止できます。 Gold の持続性は、D15_V2 や G5 などのフル ノードの VM SKU でのみ有効にできます。 |
'Bronze' 'Gold' 'Silver' |
| ephemeralPorts | このノード タイプのノードを構成する必要があるエフェメラル ポートの範囲。 | EndpointRangeDescription |
| httpGatewayEndpointPort | HTTP クラスター管理エンドポイント ポート。 | int (必須) |
| isPrimary | システム サービスを実行するノードの種類。 プライマリとしてマークする必要があるノードの種類は 1 つだけです。 既存のクラスターのプライマリ ノードの種類を削除または変更することはできません。 | bool (必須) |
| name | ノードの種類の名前。 | string (必須) |
| placementProperties | ノード の種類のノードに適用される配置タグ。これは、特定のサービス (ワークロード) を実行する場所を示すために使用できます。 | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | リバース プロキシによって使用されるエンドポイント。 | INT |
| vmInstanceCount | ノード タイプ内のノードの数。 この数は、対応する VirtualMachineScaleSet リソースの capacity プロパティと一致する必要があります。 | int (必須) 制約: 最小値 = 1 最大値 = 2147483647 |
EndpointRangeDescription
| 名前 | 説明 | 値 |
|---|---|---|
| endPort | ポートの範囲の終了ポート | int (必須) |
| startPort | ポート範囲の開始ポート | int (必須) |
NodeTypeDescriptionCapacities
| 名前 | 説明 | 値 |
|---|---|---|
| {カスタマイズされたプロパティ} | string |
NodeTypeDescriptionPlacementProperties
| 名前 | 説明 | 値 |
|---|---|---|
| {カスタマイズされたプロパティ} | 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 (必須) |
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": "2017-07-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"addOnFeatures": [ "string" ],
"availableClusterVersions": [
{
"codeVersion": "string",
"environment": "string",
"supportExpiryUtc": "string"
}
],
"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",
"clusterState": "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"
},
"upgradeDomainTimeout": "string",
"upgradeReplicaSetCheckTimeout": "string",
"upgradeTimeout": "string"
},
"upgradeMode": "string",
"vmImage": "string"
}
}
プロパティ値
clusters
| 名前 | 説明 | 値 |
|---|---|---|
| type | リソースの種類 | 'Microsoft.ServiceFabric/clusters' |
| apiVersion | リソース API のバージョン | '2017-07-01-preview' |
| name | リソース名 | string (必須) 文字数制限: 4 から 23 有効な文字: 小文字、数字、およびハイフン。 小文字で開始します。 末尾には小文字または数字を使用します。 |
| location | リソースの場所。 | string (必須) |
| tags | リソース タグ。 | タグ名と値のディクショナリ。 「テンプレートのタグ」を参照してください |
| properties | クラスター リソースのプロパティ | ClusterProperties |
ClusterProperties
| 名前 | 説明 | 値 |
|---|---|---|
| addOnFeatures | クラスターで有効にするアドオン機能の一覧。 | 次のいずれかを含む文字列配列: 'BackupRestoreService' 'DnsService' 'RepairManager' |
| availableClusterVersions | このクラスターで使用できる Service Fabric ランタイム バージョン。 | ClusterVersionDetails[] |
| azureActiveDirectory | クラスターの AAD 認証設定。 | AzureActiveDirectory |
| 証明書 (certificate) | クラスターのセキュリティ保護に使用する証明書。 指定された証明書は、クラスター内のノード間セキュリティ、クラスター管理エンドポイント用の SSL 証明書、および既定の管理クライアントに使用されます。 | CertificateDescription |
| clientCertificateCommonNames | クラスターの管理が許可されている共通名によって参照されるクライアント証明書の一覧。 | ClientCertificateCommonName[] |
| clientCertificateThumbprints | クラスターの管理が許可されている拇印によって参照されるクライアント証明書の一覧。 | ClientCertificateThumbprint[] |
| clusterCodeVersion | クラスターの Service Fabric ランタイム バージョン。 このプロパティは、 upgradeMode が 'Manual' に設定されている場合にユーザーを設定することによってのみ実行できます。 新しいクラスターで使用可能な Service Fabric バージョンの一覧を取得するには、ClusterVersion API を使用します。 既存のクラスターで使用可能なバージョンの一覧を取得するには、 availableClusterVersions を使用します。 | string |
| clusterState | クラスターの現在の状態。 - WaitingForNodes - クラスター リソースが作成され、リソース プロバイダーが Service Fabric VM 拡張機能の起動と報告を待機していることを示します。 - デプロイ中 - Service Fabric ランタイムが VM にインストールされていることを示します。 クラスター リソースは、クラスターが起動し、システム サービスが起動するまで、この状態になります。 - BaselineUpgrade - クラスターのバージョンを確立するためにクラスターがアップグレード中であることを示します。 このアップグレードは、クラスターが初めて起動したときに自動的に開始されます。 - UpdatingUserConfiguration - ユーザー指定の構成でクラスターがアップグレードされていることを示します。 - UpdatingUserCertificate - ユーザー指定の証明書を使用してクラスターがアップグレードされていることを示します。 - UpdatingInfrastructure - クラスターが最新の Service Fabric ランタイム バージョンでアップグレードされていることを示します。 これは、 upgradeMode が "自動" に設定されている場合にのみ発生します。 - EnforcingClusterVersion - クラスターが想定とは異なるバージョンにあり、クラスターが予想されるバージョンにアップグレードされていることを示します。 - UpgradeServiceUnreachable - クラスター内のシステム サービスがリソース プロバイダーをポーリングしなくなったことを示します。 この状態のクラスターは、リソース プロバイダーによって管理できません。 - 自動スケーリング - クラスターの ReliabilityLevel が調整されていることを示します。 - 準備完了 - クラスターが安定した状態であることを示します。 |
'AutoScale' 'BaselineUpgrade' 'デプロイ中' 'EnforcingClusterVersion' 'Ready' 'UpdatingInfrastructure' 'UpdatingUserCertificate' 'UpdatingUserConfiguration' 'UpgradeServiceUnreachable' 'WaitingForNodes' |
| diagnosticsStorageAccountConfig | Service Fabric 診断ログを格納するためのストレージ アカウント情報。 | DiagnosticsStorageAccountConfig |
| fabricSettings | クラスターを構成するためのカスタム ファブリック設定の一覧。 | SettingsSectionDescription[] |
| managementEndpoint | クラスターの http 管理エンドポイント。 | string (必須) |
| nodeTypes | クラスター内のノードの種類の一覧。 | NodeTypeDescription[] (必須) |
| reliabilityLevel | 信頼性レベルは、システム サービスのレプリカ セット サイズを設定します。 ReliabilityLevel について説明します。 - None - ターゲット レプリカ セット数が 1 のシステム サービスを実行します。 これは、テスト クラスターにのみ使用する必要があります。 - Bronze - ターゲット レプリカ セット数が 3 のシステム サービスを実行します。 これは、テスト クラスターにのみ使用する必要があります。 - Silver - ターゲット レプリカ セット数が 5 のシステム サービスを実行します。 - Gold - ターゲット レプリカ セット数が 7 のシステム サービスを実行します。 - Platinum - ターゲット レプリカ セット数が 9 のシステム サービスを実行します。 |
'Bronze' 'Gold' 'None' 'Platinum' 'Silver' |
| reverseProxyCertificate | リバース プロキシで使用されるサーバー証明書。 | CertificateDescription |
| upgradeDescription | クラスターのアップグレード時に使用するポリシー。 | ClusterUpgradePolicy |
| upgradeMode | 新しい Service Fabric ランタイム バージョンが使用可能な場合のクラスターのアップグレード モード。 - 自動 - クラスターは、使用可能になるとすぐに、最新の Service Fabric ランタイム バージョンに自動的にアップグレードされます。 - 手動 - クラスターは、最新の Service Fabric ランタイム バージョンに自動的にアップグレードされません。 クラスターは、クラスター リソースで clusterCodeVersion プロパティを設定することによってアップグレードされます。 |
'Automatic' 'Manual' |
| vmImage | VM イメージ VMSS は で構成されています。 Windows や Linux などの汎用名を使用できます。 | string |
ClusterVersionDetails
| 名前 | 説明 | 値 |
|---|---|---|
| codeVersion | クラスターの Service Fabric ランタイム バージョン。 | string |
| 環境 | このバージョンが Windows または Linux オペレーティング システム用かどうかを示します。 | 'Linux' 'Windows' |
| supportExpiryUtc | バージョンのサポートの有効期限の日付。 | 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 | クライアント証明書がクラスターへの管理者アクセス権を持っているかどうかを示します。 管理者以外のクライアントは、クラスターに対して読み取り専用操作のみを実行できます。 | bool (必須) |
ClientCertificateThumbprint
| 名前 | 説明 | 値 |
|---|---|---|
| certificateThumbprint | クライアント証明書の拇印。 | string (必須) |
| isAdmin | クライアント証明書がクラスターへの管理者アクセス権を持っているかどうかを示します。 管理者以外のクライアントは、クラスターに対して読み取り専用操作のみを実行できます。 | bool (必須) |
DiagnosticsStorageAccountConfig
| 名前 | 説明 | 値 |
|---|---|---|
| blobEndpoint | Azure ストレージ アカウントの BLOB エンドポイント。 | string (必須) |
| protectedAccountKeyName | 保護された診断ストレージ キー名。 | string (必須) |
| queueEndpoint | Azure ストレージ アカウントのキュー エンドポイント。 | string (必須) |
| storageAccountName | Azure ストレージ アカウント名。 | string (必須) |
| tableEndpoint | Azure ストレージ アカウントのテーブル エンドポイント。 | string (必須) |
SettingsSectionDescription
| 名前 | 説明 | 値 |
|---|---|---|
| name | ファブリック設定のセクション名。 | string (必須) |
| parameters | セクション内のパラメーターのコレクション。 | SettingsParameterDescription[] (必須) |
SettingsParameterDescription
| 名前 | 説明 | 値 |
|---|---|---|
| name | ファブリック設定のパラメーター名。 | string (必須) |
| value | ファブリック設定のパラメーター値。 | string (必須) |
NodeTypeDescription
| 名前 | 説明 | 値 |
|---|---|---|
| applicationPorts | クラスターが Service Fabric アプリケーションにポートを割り当てたポートの範囲。 | EndpointRangeDescription |
| capacities | ノードの種類のノードに適用される容量タグ。クラスター リソース マネージャーはこれらのタグを使用して、ノードに含まれるリソースの量を把握します。 | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | TCP クラスター管理エンドポイント ポート。 | int (必須) |
| durabilityLevel | ノード タイプの持続性レベル。 DurabilityLevel について説明します。 - ブロンズ - 特権なし。 既定値です。 - Silver - インフラストラクチャ ジョブは、UD あたり 30 分間一時停止できます。 - Gold - インフラストラクチャ ジョブは、UD あたり 2 時間の間一時停止できます。 Gold の持続性は、D15_V2 や G5 などのフル ノードの VM SKU でのみ有効にできます。 |
'ブロンズ' 'Gold' 'Silver' |
| ephemeralPorts | このノード タイプのノードを構成する必要があるエフェメラル ポートの範囲。 | EndpointRangeDescription |
| httpGatewayEndpointPort | HTTP クラスター管理エンドポイント ポート。 | int (必須) |
| isPrimary | システム サービスを実行するノードの種類。 プライマリとしてマークするノード タイプは 1 つだけです。 既存のクラスターでは、プライマリ ノードの種類を削除または変更できません。 | bool (必須) |
| name | ノードの種類の名前。 | string (必須) |
| placementProperties | ノード の種類のノードに適用される配置タグ。これは、特定のサービス (ワークロード) を実行する場所を示すために使用できます。 | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | リバース プロキシによって使用されるエンドポイント。 | INT |
| vmInstanceCount | ノード タイプ内のノードの数。 この数は、対応する VirtualMachineScaleSet リソースの capacity プロパティと一致する必要があります。 | int (必須) 制約: 最小値 = 1 最大値 = 2147483647 |
EndpointRangeDescription
| 名前 | 説明 | 値 |
|---|---|---|
| endPort | ポートの範囲の終了ポート | int (必須) |
| startPort | ポート範囲の開始ポート | int (必須) |
NodeTypeDescriptionCapacities
| 名前 | 説明 | 値 |
|---|---|---|
| {カスタマイズされたプロパティ} | string |
NodeTypeDescriptionPlacementProperties
| 名前 | 説明 | 値 |
|---|---|---|
| {カスタマイズされたプロパティ} | 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 (必須) |
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 nodetype Service fabric クラスターを、Standard_D2 サイズの VM にデプロイできます。 このテンプレートを使用すると、ネットワーク セキュリティ グループを使用して、受信および送信のネットワーク トラフィックを制御できます。 |
Terraform (AzAPI プロバイダー) リソース定義
クラスター リソースの種類は、次をターゲットとする操作でデプロイできます。
- リソース グループ
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.ServiceFabric/clusters リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceFabric/clusters@2017-07-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
addOnFeatures = [
"string"
]
availableClusterVersions = [
{
codeVersion = "string"
environment = "string"
supportExpiryUtc = "string"
}
]
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"
clusterState = "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
}
upgradeDomainTimeout = "string"
upgradeReplicaSetCheckTimeout = "string"
upgradeTimeout = "string"
}
upgradeMode = "string"
vmImage = "string"
}
})
}
プロパティ値
clusters
| 名前 | 説明 | 値 |
|---|---|---|
| type | リソースの種類 | "Microsoft.ServiceFabric/clusters@2017-07-01-preview" |
| name | リソース名 | string (必須) 文字制限: 4 から 23 有効な文字: 小文字、数字、およびハイフン。 小文字で開始します。 末尾には小文字または数字を使用します。 |
| location | リソースの場所。 | string (必須) |
| parent_id | リソース グループにデプロイするには、そのリソース グループの ID を使用します。 | string (必須) |
| tags | リソース タグ。 | タグの名前と値のディクショナリ。 |
| properties | クラスター リソースのプロパティ | ClusterProperties |
ClusterProperties
| 名前 | 説明 | 値 |
|---|---|---|
| addOnFeatures | クラスターで有効にするアドオン機能の一覧。 | 次のいずれかを含む文字列配列: "BackupRestoreService" "DnsService" "RepairManager" |
| availableClusterVersions | このクラスターで使用できる Service Fabric ランタイム バージョン。 | ClusterVersionDetails[] |
| azureActiveDirectory | クラスターの AAD 認証設定。 | AzureActiveDirectory |
| 証明書 (certificate) | クラスターのセキュリティ保護に使用する証明書。 指定された証明書は、クラスター内のノード間セキュリティ、クラスター管理エンドポイント用の SSL 証明書、および既定の管理クライアントに使用されます。 | CertificateDescription |
| clientCertificateCommonNames | クラスターの管理が許可されている共通名によって参照されるクライアント証明書の一覧。 | ClientCertificateCommonName[] |
| clientCertificateThumbprints | クラスターの管理が許可されている拇印によって参照されるクライアント証明書の一覧。 | ClientCertificateThumbprint[] |
| clusterCodeVersion | クラスターの Service Fabric ランタイム バージョン。 このプロパティは、 upgradeMode が 'Manual' に設定されている場合にユーザーを設定することによってのみ実行できます。 新しいクラスターで使用可能な Service Fabric バージョンの一覧を取得するには、ClusterVersion API を使用します。 既存のクラスターで使用可能なバージョンの一覧を取得するには、 availableClusterVersions を使用します。 | string |
| clusterState | クラスターの現在の状態。 - WaitingForNodes - クラスター リソースが作成され、リソース プロバイダーが Service Fabric VM 拡張機能の起動と報告を待機していることを示します。 - デプロイ中 - Service Fabric ランタイムが VM にインストールされていることを示します。 クラスター リソースは、クラスターが起動し、システム サービスが起動するまで、この状態になります。 - BaselineUpgrade - クラスターのバージョンを確立するためにクラスターがアップグレード中であることを示します。 このアップグレードは、クラスターが初めて起動したときに自動的に開始されます。 - UpdatingUserConfiguration - ユーザー指定の構成でクラスターがアップグレードされていることを示します。 - UpdatingUserCertificate - ユーザー指定の証明書を使用してクラスターがアップグレードされていることを示します。 - UpdatingInfrastructure - クラスターが最新の Service Fabric ランタイム バージョンでアップグレードされていることを示します。 これは、 upgradeMode が "自動" に設定されている場合にのみ発生します。 - EnforcingClusterVersion - クラスターが想定とは異なるバージョンにあり、クラスターが予想されるバージョンにアップグレードされていることを示します。 - UpgradeServiceUnreachable - クラスター内のシステム サービスがリソース プロバイダーをポーリングしなくなったことを示します。 この状態のクラスターは、リソース プロバイダーによって管理できません。 - 自動スケーリング - クラスターの ReliabilityLevel が調整されていることを示します。 - 準備完了 - クラスターが安定した状態であることを示します。 |
"自動スケーリング" "BaselineUpgrade" "デプロイ中" "EnforcingClusterVersion" "Ready" "UpdatingInfrastructure" "UpdatingUserCertificate" "UpdatingUserConfiguration" "UpgradeServiceUnreachable" "WaitingForNodes" |
| diagnosticsStorageAccountConfig | Service Fabric 診断ログを格納するためのストレージ アカウント情報。 | DiagnosticsStorageAccountConfig |
| fabricSettings | クラスターを構成するためのカスタム ファブリック設定の一覧。 | SettingsSectionDescription[] |
| managementEndpoint | クラスターの http 管理エンドポイント。 | string (必須) |
| nodeTypes | クラスター内のノードの種類の一覧。 | NodeTypeDescription[] (必須) |
| reliabilityLevel | 信頼性レベルは、システム サービスのレプリカ セット サイズを設定します。 ReliabilityLevel について説明します。 - None - ターゲット レプリカ セット数が 1 のシステム サービスを実行します。 これは、テスト クラスターにのみ使用する必要があります。 - Bronze - ターゲット レプリカ セット数が 3 のシステム サービスを実行します。 これは、テスト クラスターにのみ使用する必要があります。 - Silver - ターゲット レプリカ セット数が 5 のシステム サービスを実行します。 - Gold - ターゲット レプリカ セット数が 7 のシステム サービスを実行します。 - Platinum - ターゲット レプリカ セット数が 9 のシステム サービスを実行します。 |
"Bronze" "Gold" "None" "Platinum" "シルバー" |
| reverseProxyCertificate | リバース プロキシで使用されるサーバー証明書。 | CertificateDescription |
| upgradeDescription | クラスターのアップグレード時に使用するポリシー。 | ClusterUpgradePolicy |
| upgradeMode | 新しい Service Fabric ランタイム バージョンが使用可能な場合のクラスターのアップグレード モード。 - 自動 - クラスターは、使用可能になるとすぐに、最新の Service Fabric ランタイム バージョンに自動的にアップグレードされます。 - 手動 - クラスターは、最新の Service Fabric ランタイム バージョンに自動的にアップグレードされません。 クラスターは、クラスター リソースで clusterCodeVersion プロパティを設定することによってアップグレードされます。 |
"自動" "Manual" |
| vmImage | VM イメージ VMSS は で構成されています。 Windows や Linux などの汎用名を使用できます。 | string |
ClusterVersionDetails
| 名前 | 説明 | 値 |
|---|---|---|
| codeVersion | クラスターの Service Fabric ランタイム バージョン。 | string |
| 環境 | このバージョンが Windows または Linux オペレーティング システム用かどうかを示します。 | "Linux" "Windows" |
| supportExpiryUtc | バージョンのサポートの有効期限の日付。 | 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 | クライアント証明書がクラスターへの管理者アクセス権を持っているかどうかを示します。 管理者以外のクライアントは、クラスターに対して読み取り専用操作のみを実行できます。 | bool (必須) |
ClientCertificateThumbprint
| 名前 | 説明 | 値 |
|---|---|---|
| certificateThumbprint | クライアント証明書の拇印。 | string (必須) |
| isAdmin | クライアント証明書がクラスターへの管理者アクセス権を持っているかどうかを示します。 管理者以外のクライアントは、クラスターに対して読み取り専用操作のみを実行できます。 | bool (必須) |
DiagnosticsStorageAccountConfig
| 名前 | 説明 | 値 |
|---|---|---|
| blobEndpoint | Azure ストレージ アカウントの BLOB エンドポイント。 | string (必須) |
| protectedAccountKeyName | 保護された診断ストレージ キー名。 | string (必須) |
| queueEndpoint | Azure ストレージ アカウントのキュー エンドポイント。 | string (必須) |
| storageAccountName | Azure ストレージ アカウント名。 | string (必須) |
| tableEndpoint | Azure ストレージ アカウントのテーブル エンドポイント。 | string (必須) |
SettingsSectionDescription
| 名前 | 説明 | 値 |
|---|---|---|
| name | ファブリック設定のセクション名。 | string (必須) |
| parameters | セクション内のパラメーターのコレクション。 | SettingsParameterDescription[] (必須) |
SettingsParameterDescription
| 名前 | 説明 | 値 |
|---|---|---|
| name | ファブリック設定のパラメーター名。 | string (必須) |
| value | ファブリック設定のパラメーター値。 | string (必須) |
NodeTypeDescription
| 名前 | 説明 | 値 |
|---|---|---|
| applicationPorts | クラスターが Service Fabric アプリケーションにポートを割り当てたポートの範囲。 | EndpointRangeDescription |
| capacities | ノードの種類のノードに適用される容量タグでは、クラスター リソース マネージャーはこれらのタグを使用して、ノードのリソースの量を把握します。 | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | TCP クラスター管理エンドポイント ポート。 | int (必須) |
| durabilityLevel | ノード タイプの持続性レベル。 DurabilityLevel について説明します。 - ブロンズ - 特権なし。 既定値です。 - Silver - インフラストラクチャ ジョブは、UD あたり 30 分間一時停止できます。 - Gold - インフラストラクチャ ジョブは、UD あたり 2 時間の間一時停止できます。 Gold の持続性は、D15_V2 や G5 などのフル ノードの VM SKU でのみ有効にできます。 |
"ブロンズ" "Gold" "シルバー" |
| ephemeralPorts | このノード タイプのノードを構成する必要があるエフェメラル ポートの範囲。 | EndpointRangeDescription |
| httpGatewayEndpointPort | HTTP クラスター管理エンドポイント ポート。 | int (必須) |
| isPrimary | システム サービスを実行するノードの種類。 プライマリとしてマークするノード タイプは 1 つだけです。 既存のクラスターでは、プライマリ ノードの種類を削除または変更できません。 | bool (必須) |
| name | ノードの種類の名前。 | string (必須) |
| placementProperties | ノード の種類のノードに適用される配置タグ。これは、特定のサービス (ワークロード) を実行する場所を示すために使用できます。 | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | リバース プロキシによって使用されるエンドポイント。 | INT |
| vmInstanceCount | ノード タイプ内のノードの数。 この数は、対応する VirtualMachineScaleSet リソースの capacity プロパティと一致する必要があります。 | int (必須) 制約: 最小値 = 1 最大値 = 2147483647 |
EndpointRangeDescription
| 名前 | 説明 | 値 |
|---|---|---|
| endPort | ポートの範囲の終了ポート | int (必須) |
| startPort | ポート範囲の開始ポート | int (必須) |
NodeTypeDescriptionCapacities
| 名前 | 説明 | 値 |
|---|---|---|
| {カスタマイズされたプロパティ} | string |
NodeTypeDescriptionPlacementProperties
| 名前 | 説明 | 値 |
|---|---|---|
| {カスタマイズされたプロパティ} | 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 (必須) |
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」を参照してください。
フィードバックの送信と表示