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 | 資源名稱 | 字串 (必要) 字元限制:4-23 合法字元: 小寫字母、數字和連字號。 以小寫字母開頭。 以小寫字母或數字結尾。 |
location | 資源位置。 | 字串 (必要) |
tags | 資源標籤。 | 標記名稱和值的字典。 請參閱 範本中的標記 |
properties | 叢集資源屬性 | ClusterProperties |
ClusterProperties
名稱 | 描述 | 值 |
---|---|---|
azureActiveDirectory | 在叢集上啟用 AAD 驗證的設定 | AzureActiveDirectory |
憑證 (certificate) | 此主要憑證將作為節點安全性的叢集節點、叢集管理端點的 SSL 憑證和預設管理員用戶端 | CertificateDescription |
clientCertificateCommonNames | 根據一般名稱信任的客戶端憑證清單 | ClientCertificateCommonName[] |
clientCertificateThumbprints | 用戶端指紋詳細數據,用於叢集作業的用戶端存取 | ClientCertificateThumbprint[] |
clusterCodeVersion | 在您的叢集中執行的 ServiceFabric 程式代碼版本 | 字串 |
diagnosticsStorageAccountConfig | 記憶體診斷帳戶組態詳細數據 | DiagnosticsStorageAccountConfig |
fabricSettings | 要設定叢集的自定義網狀架構設定清單。 | SettingsSectionDescription[] |
managementEndpoint | 叢集的 HTTP 管理端點 | 字串 (必要) |
nodeTypes | 構成叢集的節點類型清單 | NodeTypeDescription[] (必要) |
reliabilityLevel | 叢集可靠性層級表示系統服務的復本集大小 | 'Bronze' 'Gold' 'Platinum' 'Silver' |
reverseProxyCertificate | 反向 Proxy 所使用的伺服器證書 | CertificateDescription |
upgradeDescription | 升級叢集時要使用的原則。 | ClusterUpgradePolicy |
upgradeMode | 叢集升級模式指出是否由系統自動起始網狀架構升級 | 'Automatic' 'Manual' |
vmImage | VM 映像 VMSS 的名稱已設定為 。 您可以使用 Windows 或 Linux 等泛型名稱。 | 字串 |
AzureActiveDirectory
名稱 | 描述 | 值 |
---|---|---|
clientApplication | Azure Active Directory 用戶端應用程式識別碼 | 字串 |
clusterApplication | Azure Active Directory 叢集應用程式標識符 | 字串 |
tenantId | Azure Active Directory 租用戶標識符 | 字串 |
CertificateDescription
名稱 | 描述 | 值 |
---|---|---|
thumbprint | 主要憑證的指紋 | 字串 (必要) |
thumbprintSecondary | 次要憑證的指紋 | 字串 |
x509StoreName | 本機證書存儲位置 | 'AddressBook' 'AuthRoot' 'CertificateAuthority' '不允許' 'My' 'Root' 'TrustedPeople' 'TrustedPublisher' |
ClientCertificateCommonName
名稱 | 描述 | 值 |
---|---|---|
certificateCommonName | 要授與存取權的憑證通用名稱;請小心使用通配符一般名稱 | 字串 (必要) |
certificateIssuerThumbprint | 憑證簽發者指紋 | 字串 (必要) |
isAdmin | 此憑證是否用於從客戶端進行系統管理員存取,如果為 false ,則會使用或僅查詢存取權 | bool (必要) |
ClientCertificateThumbprint
名稱 | 描述 | 值 |
---|---|---|
certificateThumbprint | 憑證指紋 | 字串 (必要) |
isAdmin | 此憑證是否用於從客戶端進行系統管理員存取,如果為 false,則會使用憑證或僅查詢存取權 | bool (必要) |
DiagnosticsStorageAccountConfig
名稱 | 描述 | 值 |
---|---|---|
blobEndpoint | 診斷記憶體帳戶 Blob 端點 | 字串 (必要) |
protectedAccountKeyName | 受保護的診斷記憶體金鑰名稱 | 字串 (必要) |
queueEndpoint | 診斷記憶體帳戶佇列端點 | 字串 (必要) |
storageAccountName | 診斷記憶體帳戶名稱 | 字串 (必要) |
tableEndpoint | 診斷記憶體帳戶數據表端點 | 字串 (必要) |
SettingsSectionDescription
名稱 | 描述 | 值 |
---|---|---|
NAME | 設定區段的名稱 | 字串 (必要) |
參數 | 區段中的設定集合,每個設定都是由設定名稱和值組成的 Tuple | SettingsParameterDescription[] (必要) |
SettingsParameterDescription
名稱 | 描述 | 值 |
---|---|---|
NAME | settings 屬性的名稱 | 字串 (必要) |
值 | 屬性的值 | 字串 (必要) |
NodeTypeDescription
名稱 | 描述 | 值 |
---|---|---|
applicationPorts | 應用程式所使用的埠 | EndpointRangeDescription |
capacities | 套用至節點類型中節點的容量卷標,叢集資源管理員會使用這些標籤來了解節點擁有的資源數量 | NodeTypeDescriptionCapacities |
clientConnectionEndpointPort | TCP 叢集管理埠 | int (必要) |
durabilityLevel | 節點類型持久性層級 | 'Bronze' 'Gold' 'Silver' |
ephemeralPorts | 系統指派的應用程式埠 | EndpointRangeDescription |
httpGatewayEndpointPort | HTTP 叢集管理埠 | int (必要) |
isPrimary | 將此標示為主要節點類型 | bool (必要) |
NAME | 節點類型的名稱 | 字串 (必要) |
placementProperties | 套用至節點類型中節點的位置標記,可用來指出特定服務 (工作負載) 應執行的位置 | NodeTypeDescriptionPlacementProperties |
reverseProxyEndpointPort | 反向 Proxy 所使用的端點 | int |
vmInstanceCount | 節點類型中的節點實例數目 | int (必要) 約束: 最小值 = 1 最大值 = 2147483647 |
EndpointRangeDescription
名稱 | 描述 | 值 |
---|---|---|
endPort | 埠範圍的結束埠 | int (必要) |
startPort | 開始埠範圍 | int (必要) |
NodeTypeDescriptionCapacities
名稱 | 描述 | 值 |
---|---|---|
{自定義屬性} | 字串 |
NodeTypeDescriptionPlacementProperties
名稱 | 描述 | 值 |
---|---|---|
{自定義屬性} | 字串 |
ClusterUpgradePolicy
名稱 | 描述 | 值 |
---|---|---|
deltaHealthPolicy | 差異健康情況原則 | ClusterUpgradeDeltaHealthPolicy |
forceRestart | 強制節點重新啟動或不重新啟動 | bool |
healthCheckRetryTimeout | 健康情況檢查可以持續失敗的時間長度,它代表 .Net TimeSpan | 字串 (必要) |
healthCheckStableDuration | 健康情況檢查必須持續傳遞的時間長度,它代表 .Net TimeSpan | 字串 (必要) |
healthCheckWaitDuration | 在執行健康情況檢查之前完成升級網域之後要等待的時間長度,它代表 .Net TimeSpan | 字串 (必要) |
healthPolicy | 叢集健康情況原則 | ClusterHealthPolicy (必要) |
overrideUserUpgradePolicy | 使用使用者定義的升級原則 | bool |
upgradeDomainTimeout | 任何升級網域的逾時,它代表 .Net TimeSpan | 字串 (必要) |
upgradeReplicaSetCheckTimeout | 復本集升級完成的逾時,代表 .Net TimeSpan | 字串 (必要) |
upgradeTimeout | 升級逾時,它代表 .Net TimeSpan | 字串 (必要) |
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 |
快速入門範本
下列快速入門範本會部署此資源類型。
範本 | 描述 |
---|---|
部署 5 節點 Ubuntu Service Fabric 叢集 |
此範本可讓您在 Standard_D2_V2 Size VMSS 上部署執行 Ubuntu 的安全 5 節點 Service Fabric 叢集。 |
部署5節點安全叢集 |
此範本可讓您在Standard_D2_v2大小 VMSS 上部署執行 Windows Server 2019 Datacenter 的安全 5 節點 Service Fabric 叢集。 |
部署已啟用 NSG 的 3 個 Nodetype 安全叢集 |
此範本可讓您在Standard_D2大小 VM 上部署執行 Windows Server 2016 資料中心的安全 3 節點類型 Service Fabric 叢集。 使用此範本可讓您使用網路安全組來控制輸入和輸出網路流量。 |
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
名稱 | 描述 | 值 |
---|---|---|
類型 | 資源類型 | 'Microsoft.ServiceFabric/clusters' |
apiVersion | 資源 API 版本 | '2016-09-01' |
NAME | 資源名稱 | 字串 (必要) 字元限制:4-23 合法字元: 小寫字母、數字和連字號。 以小寫字母開頭。 以小寫字母或數字結尾。 |
location | 資源位置。 | 字串 (必要) |
tags | 資源標籤。 | 標記名稱和值的字典。 請參閱 範本中的標記 |
properties | 叢集資源屬性 | ClusterProperties |
ClusterProperties
名稱 | 描述 | 值 |
---|---|---|
azureActiveDirectory | 在叢集上啟用 AAD 驗證的設定 | AzureActiveDirectory |
憑證 (certificate) | 此主要憑證將作為節點安全性的叢集節點、叢集管理端點的 SSL 憑證和預設管理員用戶端 | CertificateDescription |
clientCertificateCommonNames | 根據一般名稱信任的客戶端憑證清單 | ClientCertificateCommonName[] |
clientCertificateThumbprints | 用戶端指紋詳細數據,用於叢集作業的用戶端存取 | ClientCertificateThumbprint[] |
clusterCodeVersion | 在您的叢集中執行的 ServiceFabric 程式代碼版本 | 字串 |
diagnosticsStorageAccountConfig | 記憶體診斷帳戶組態詳細數據 | DiagnosticsStorageAccountConfig |
fabricSettings | 要設定叢集的自定義網狀架構設定清單。 | SettingsSectionDescription[] |
managementEndpoint | 叢集的 HTTP 管理端點 | 需要字串 () |
nodeTypes | 組成叢集的節點類型清單 | NodeTypeDescription[] (必要) |
reliabilityLevel | 叢集可靠性層級表示系統服務的復本集大小 | 'Bronze' 'Gold' 'Platinum' 'Silver' |
reverseProxyCertificate | 反向 Proxy 所使用的伺服器證書 | CertificateDescription |
upgradeDescription | 升級叢集時要使用的原則。 | ClusterUpgradePolicy |
upgradeMode | 叢集升級模式指出是否由系統自動起始網狀架構升級 | 'Automatic' 'Manual' |
vmImage | 已設定 VM 映像 VMSS 的名稱。 您可以使用一般名稱,例如 Windows 或 Linux。 | 字串 |
AzureActiveDirectory
名稱 | 描述 | 值 |
---|---|---|
clientApplication | Azure Active Directory 用戶端應用程式識別碼 | 字串 |
clusterApplication | Azure Active Directory 叢集應用程式標識符 | 字串 |
tenantId | Azure Active Directory 租用戶標識符 | 字串 |
CertificateDescription
名稱 | 描述 | 值 |
---|---|---|
thumbprint | 主要憑證的指紋 | 需要字串 () |
thumbprintSecondary | 次要憑證的指紋 | 字串 |
x509StoreName | 本機證書存儲位置 | 'AddressBook' 'AuthRoot' 'CertificateAuthority' '不允許' 'My' 'Root' 'TrustedPeople' 'TrustedPublisher' |
ClientCertificateCommonName
名稱 | 描述 | 值 |
---|---|---|
certificateCommonName | 要授與存取權的憑證一般名稱;請小心使用通配符一般名稱 | 需要字串 () |
certificateIssuerThumbprint | 憑證簽發者指紋 | 需要字串 () |
isAdmin | 此憑證是否用於來自客戶端的系統管理員存取,如果為 false ,則會使用憑證或只查詢存取權 | bool (必要) |
ClientCertificateThumbprint
名稱 | 描述 | 值 |
---|---|---|
certificateThumbprint | 憑證指紋 | 需要字串 () |
isAdmin | 此憑證是否用於來自客戶端的系統管理員存取,如果為 false,則會使用憑證或只查詢存取權 | bool (必要) |
DiagnosticsStorageAccountConfig
名稱 | 描述 | 值 |
---|---|---|
blobEndpoint | 診斷記憶體帳戶 Blob 端點 | 需要字串 () |
protectedAccountKeyName | 受保護的診斷記憶體金鑰名稱 | 需要字串 () |
queueEndpoint | 診斷記憶體帳戶佇列端點 | 需要字串 () |
storageAccountName | 診斷記憶體帳戶名稱 | 字串 (必要) |
tableEndpoint | 診斷記憶體帳戶數據表端點 | 字串 (必要) |
SettingsSectionDescription
名稱 | 描述 | 值 |
---|---|---|
NAME | 設定區段的名稱 | 字串 (必要) |
參數 | 區段中的設定集合,每個設定都是由設定名稱和值組成的 Tuple | SettingsParameterDescription[] (必要) |
SettingsParameterDescription
名稱 | 描述 | 值 |
---|---|---|
NAME | settings 屬性的名稱 | 字串 (必要) |
值 | 屬性的值 | 字串 (必要) |
NodeTypeDescription
名稱 | 描述 | 值 |
---|---|---|
applicationPorts | 應用程式所使用的埠 | EndpointRangeDescription |
capacities | 套用至節點類型中節點的容量卷標,叢集資源管理員會使用這些標籤來了解節點擁有的資源數量 | NodeTypeDescriptionCapacities |
clientConnectionEndpointPort | TCP 叢集管理埠 | int (必要) |
durabilityLevel | 節點類型持久性層級 | 'Bronze' 'Gold' 'Silver' |
ephemeralPorts | 系統指派的應用程式埠 | EndpointRangeDescription |
httpGatewayEndpointPort | HTTP 叢集管理埠 | int (必要) |
isPrimary | 將此標示為主要節點類型 | bool (必要) |
NAME | 節點類型的名稱 | 字串 (必要) |
placementProperties | 套用至節點類型中節點的位置標記,可用來指出特定服務 (工作負載) 應執行的位置 | NodeTypeDescriptionPlacementProperties |
reverseProxyEndpointPort | 反向 Proxy 所使用的端點 | int |
vmInstanceCount | 節點類型中的節點實例數目 | int (必要) 約束: 最小值 = 1 最大值 = 2147483647 |
EndpointRangeDescription
名稱 | 描述 | 值 |
---|---|---|
endPort | 埠範圍的結束埠 | int (必要) |
startPort | 開始埠範圍 | int (必要) |
NodeTypeDescriptionCapacities
名稱 | 描述 | 值 |
---|---|---|
{自定義屬性} | 字串 |
NodeTypeDescriptionPlacementProperties
名稱 | 描述 | 值 |
---|---|---|
{自定義屬性} | 字串 |
ClusterUpgradePolicy
名稱 | 描述 | 值 |
---|---|---|
deltaHealthPolicy | 差異健康情況原則 | ClusterUpgradeDeltaHealthPolicy |
forceRestart | 強制節點重新啟動或不重新啟動 | bool |
healthCheckRetryTimeout | 健康情況檢查可以持續失敗的時間長度,它代表 .Net TimeSpan | 需要字串 () |
healthCheckStableDuration | 健康情況檢查必須持續通過的時間長度,它代表 .Net TimeSpan | 需要字串 () |
healthCheckWaitDuration | 在執行健康情況檢查之前完成升級網域之後要等待的時間長度,代表 .Net TimeSpan | 需要字串 () |
healthPolicy | 叢集健康情況原則 | ClusterHealthPolicy (必要) |
overrideUserUpgradePolicy | 使用使用者定義升級原則,或不使用 | bool |
upgradeDomainTimeout | 任何升級網域的逾時,它代表 .Net TimeSpan | 需要字串 () |
upgradeReplicaSetCheckTimeout | 復本集升級完成的逾時,它代表 .Net TimeSpan | 需要字串 () |
upgradeTimeout | 升級逾時,它代表 .Net TimeSpan | 需要字串 () |
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 |
快速入門範本
下列快速入門範本會部署此資源類型。
範本 | 描述 |
---|---|
部署 5 個節點 Ubuntu Service Fabric 叢集 |
此範本可讓您在Standard_D2_V2大小 VMSS 上部署執行 Ubuntu 的安全 5 節點 Service Fabric 叢集。 |
部署5個節點安全叢集 |
此範本可讓您在Standard_D2_v2大小 VMSS 上部署執行 Windows Server 2019 Datacenter 的安全 5 節點 Service Fabric 叢集。 |
部署已啟用 NSG 的 3 個 Nodetype 安全叢集 |
此範本可讓您在Standard_D2大小 VM 上部署執行 Windows Server 2016 資料中心的安全 3 節點類型 Service Fabric 叢集。 使用此範本可讓您使用網路安全組來控制輸入和輸出網路流量。 |
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
名稱 | 描述 | 值 |
---|---|---|
類型 | 資源類型 | “Microsoft.ServiceFabric/clusters@2016-09-01” |
NAME | 資源名稱 | 需要字串 () 字元限制:4-23 合法字元: 小寫字母、數字和連字號。 以小寫字母開頭。 以小寫字母或數字結尾。 |
location | 資源位置。 | 字串 (必要) |
parent_id | 若要部署至資源群組,請使用該資源群組的標識碼。 | 字串 (必要) |
tags | 資源標籤。 | 標記名稱和值的字典。 |
properties | 叢集資源屬性 | ClusterProperties |
ClusterProperties
名稱 | 描述 | 值 |
---|---|---|
azureActiveDirectory | 在叢集上啟用 AAD 驗證的設定 | AzureActiveDirectory |
憑證 (certificate) | 此主要憑證將作為節點安全性的叢集節點、叢集管理端點的 SSL 憑證和預設管理員用戶端 | CertificateDescription |
clientCertificateCommonNames | 根據一般名稱信任的客戶端憑證清單 | ClientCertificateCommonName[] |
clientCertificateThumbprints | 用戶端指紋詳細數據,用於叢集作業的用戶端存取 | ClientCertificateThumbprint[] |
clusterCodeVersion | 在您的叢集中執行的 ServiceFabric 程式代碼版本 | 字串 |
diagnosticsStorageAccountConfig | 記憶體診斷帳戶組態詳細數據 | DiagnosticsStorageAccountConfig |
fabricSettings | 要設定叢集的自定義網狀架構設定清單。 | SettingsSectionDescription[] |
managementEndpoint | 叢集的 HTTP 管理端點 | 字串 (必要) |
nodeTypes | 構成叢集的節點類型清單 | NodeTypeDescription[] (必要) |
reliabilityLevel | 叢集可靠性層級表示系統服務的復本集大小 | “Bronze” “Gold” “前文” “Silver” |
reverseProxyCertificate | 反向 Proxy 所使用的伺服器證書 | CertificateDescription |
upgradeDescription | 升級叢集時要使用的原則。 | ClusterUpgradePolicy |
upgradeMode | 叢集升級模式指出是否由系統自動起始網狀架構升級 | “Automatic” “Manual” |
vmImage | VM 映像 VMSS 的名稱已設定為 。 您可以使用 Windows 或 Linux 等泛型名稱。 | 字串 |
AzureActiveDirectory
名稱 | 描述 | 值 |
---|---|---|
clientApplication | Azure Active Directory 用戶端應用程式識別碼 | 字串 |
clusterApplication | Azure Active Directory 叢集應用程式標識符 | 字串 |
tenantId | Azure Active Directory 租用戶標識符 | 字串 |
CertificateDescription
名稱 | 描述 | 值 |
---|---|---|
thumbprint | 主要憑證的指紋 | 字串 (必要) |
thumbprintSecondary | 次要憑證的指紋 | 字串 |
x509StoreName | 本機證書存儲位置 | “AddressBook” “AuthRoot” “CertificateAuthority” “不允許” “My” “Root” “TrustedPeople” “TrustedPublisher” |
ClientCertificateCommonName
名稱 | 描述 | 值 |
---|---|---|
certificateCommonName | 要授與存取權的憑證通用名稱;請小心使用通配符一般名稱 | 字串 (必要) |
certificateIssuerThumbprint | 憑證簽發者指紋 | 字串 (必要) |
isAdmin | 此憑證是否用於從客戶端進行系統管理員存取,如果為 false ,則會使用或僅查詢存取權 | bool (必要) |
ClientCertificateThumbprint
名稱 | 描述 | 值 |
---|---|---|
certificateThumbprint | 憑證指紋 | 字串 (必要) |
isAdmin | 此憑證是否用於從客戶端進行系統管理員存取,如果為 false,則會使用憑證或僅查詢存取權 | bool (必要) |
DiagnosticsStorageAccountConfig
名稱 | 描述 | 值 |
---|---|---|
blobEndpoint | 診斷記憶體帳戶 Blob 端點 | 字串 (必要) |
protectedAccountKeyName | 受保護的診斷記憶體金鑰名稱 | 字串 (必要) |
queueEndpoint | 診斷記憶體帳戶佇列端點 | 字串 (必要) |
storageAccountName | 診斷記憶體帳戶名稱 | 字串 (必要) |
tableEndpoint | 診斷記憶體帳戶數據表端點 | 字串 (必要) |
SettingsSectionDescription
名稱 | 描述 | 值 |
---|---|---|
NAME | 設定區段的名稱 | 字串 (必要) |
參數 | 區段中的設定集合,每個設定都是由設定名稱和值組成的 Tuple | SettingsParameterDescription[] (必要) |
SettingsParameterDescription
名稱 | 描述 | 值 |
---|---|---|
NAME | settings 屬性的名稱 | 字串 (必要) |
值 | 屬性的值 | 字串 (必要) |
NodeTypeDescription
名稱 | 描述 | 值 |
---|---|---|
applicationPorts | 應用程式所使用的埠 | EndpointRangeDescription |
capacities | 套用至節點類型中節點的容量卷標,叢集資源管理員會使用這些標籤來了解節點擁有的資源數量 | NodeTypeDescriptionCapacities |
clientConnectionEndpointPort | TCP 叢集管理埠 | int (必要) |
durabilityLevel | 節點類型持久性層級 | “Bronze” “Gold” “Silver” |
ephemeralPorts | 系統指派的應用程式埠 | EndpointRangeDescription |
httpGatewayEndpointPort | HTTP 叢集管理埠 | int (必要) |
isPrimary | 將此標示為主要節點類型 | bool (必要) |
NAME | 節點類型的名稱 | 字串 (必要) |
placementProperties | 套用至節點類型中節點的位置標記,可用來指出特定服務 (工作負載) 應執行的位置 | NodeTypeDescriptionPlacementProperties |
reverseProxyEndpointPort | 反向 Proxy 所使用的端點 | int |
vmInstanceCount | 節點類型中的節點實例數目 | int (必要) 約束: 最小值 = 1 最大值 = 2147483647 |
EndpointRangeDescription
名稱 | 描述 | 值 |
---|---|---|
endPort | 埠範圍的結束埠 | int (必要) |
startPort | 開始埠範圍 | int (必要) |
NodeTypeDescriptionCapacities
名稱 | 描述 | 值 |
---|---|---|
{自定義屬性} | 字串 |
NodeTypeDescriptionPlacementProperties
名稱 | 描述 | 值 |
---|---|---|
{自定義屬性} | 字串 |
ClusterUpgradePolicy
名稱 | 描述 | 值 |
---|---|---|
deltaHealthPolicy | 差異健康情況原則 | ClusterUpgradeDeltaHealthPolicy |
forceRestart | 強制節點重新啟動或不重新啟動 | bool |
healthCheckRetryTimeout | 健康情況檢查可以持續失敗的時間長度,它代表 .Net TimeSpan | 字串 (必要) |
healthCheckStableDuration | 健康情況檢查必須持續傳遞的時間長度,它代表 .Net TimeSpan | 字串 (必要) |
healthCheckWaitDuration | 在執行健康情況檢查之前完成升級網域之後要等待的時間長度,它代表 .Net TimeSpan | 字串 (必要) |
healthPolicy | 叢集健康情況原則 | ClusterHealthPolicy (必要) |
overrideUserUpgradePolicy | 使用使用者定義的升級原則 | bool |
upgradeDomainTimeout | 任何升級網域的逾時,它代表 .Net TimeSpan | 字串 (必要) |
upgradeReplicaSetCheckTimeout | 復本集升級完成的逾時,代表 .Net TimeSpan | 字串 (必要) |
upgradeTimeout | 升級逾時,它代表 .Net TimeSpan | 字串 (必要) |
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 |