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 | 資源名稱 | 字串 (必要) 字元限制：4-23 合法字元： 小寫字母、數字和連字號。 以小寫字母開頭。 以小寫字母或數字結尾。 |
| location | 資源位置。 | 字串 (必要) |
| 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。 | 字串 |
| clusterState | 叢集的目前狀態。 - WaitingForNodes - 指出已建立叢集資源，且資源提供者正在等候 Service Fabric VM 擴充功能開機並回報。 - 部署 - 指出正在 VM 上安裝 Service Fabric 執行時間。 叢集資源會處於此狀態，直到叢集開機並啟動系統服務為止。 - BaselineUpgrade - 指出叢集正在升級以建立叢集版本。 第一次啟動叢集時，會自動起始此升級。 - UpdateingUserConfiguration - 指出叢集正以使用者提供的組態升級。 - UpdateingUserCertificate - 指出叢集正以使用者提供的憑證升級。 - UpdateingInfrastructure - 指出叢集正以最新的 Service Fabric 運行時間版本升級。 只有在 upgradeMode 設定為 'Automatic' 時，才會發生這種情況。 - EnforcingClusterVersion - 指出叢集與預期的版本不同，且叢集正在升級為預期的版本。 - UpgradeServiceUnreachable - 指出叢集中的系統服務不再輪詢資源提供者。 處於此狀態的叢集無法由資源提供者管理。 - AutoScale - 指出正在調整叢集的 ReliabilityLevel。 - 就緒 - 指出叢集處於穩定狀態。 |
'AutoScale' 'BaselineUpgrade' '部署' 'EnforcingClusterVersion' 'Ready' 'UpdateingInfrastructure' 'UpdateingUserCertificate' 'UpdateingUserConfiguration' 'UpgradeServiceUnreachable' 'WaitingForNodes' |
| diagnosticsStorageAccountConfig | 用來儲存 Service Fabric 診斷記錄的記憶體帳戶資訊。 | DiagnosticsStorageAccountConfig |
| fabricSettings | 要設定叢集的自定義網狀架構設定清單。 | SettingsSectionDescription[] |
| managementEndpoint | 叢集的 HTTP 管理端點。 | 字串 (必要) |
| nodeTypes | 叢集中的節點類型清單。 | NodeTypeDescription[] (必要) |
| reliabilityLevel | 可靠性層級會設定系統服務的復本集大小。 瞭解 ReliabilityLevel。 - 無 - 執行目標複本集計數為 1 的系統服務。 這隻應該用於測試叢集。 - 銅級 - 執行目標複本集計數為 3 的系統服務。 這隻應該用於測試叢集。 - Silver - 執行目標複本集計數為 5 的系統服務。 - 金級 - 執行目標複本集計數為 7 的系統服務。 - 諮詢服務 - 執行目標複本集計數為 9 的系統服務。 |
'Bronze' 'Gold' 'None' 'Platinum' 'Silver' |
| reverseProxyCertificate | 反向 Proxy 所使用的伺服器證書。 | CertificateDescription |
| upgradeDescription | 升級叢集時要使用的原則。 | ClusterUpgradePolicy |
| upgradeMode | 當有新的 Service Fabric 執行時間版本可用時，叢集的升級模式。 - 自動 - 叢集會在可用後立即自動升級至最新的 Service Fabric 運行時間版本。 - 手動 - 叢集不會自動升級至最新的 Service Fabric 運行時間版本。 叢集是藉由在叢集資源中設定 clusterCodeVersion 屬性來升級。 |
'Automatic' 'Manual' |
| vmImage | VM 映像 VMSS 已設定為 。 您可以使用 Windows 或 Linux 等泛型名稱。 | 字串 |
ClusterVersionDetails
| 名稱 | 描述 | 值 |
|---|---|---|
| codeVersion | 叢集的 Service Fabric 運行時間版本。 | 字串 |
| Environment | 指出此版本是否適用於 Windows 或 Linux 作業系統。 | 'Linux' 'Windows' |
| supportExpiryUtc | 版本支援到期的日期。 | 字串 |
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 | 指出客戶端憑證是否具有叢集的管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 | bool (必要) |
ClientCertificateThumbprint
| 名稱 | 描述 | 值 |
|---|---|---|
| certificateThumbprint | 用戶端憑證的指紋。 | 需要字串 () |
| isAdmin | 指出客戶端憑證是否具有叢集的管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 | bool (必要) |
DiagnosticsStorageAccountConfig
| 名稱 | 描述 | 值 |
|---|---|---|
| blobEndpoint | Azure 記憶體帳戶的 Blob 端點。 | 需要字串 () |
| protectedAccountKeyName | 受保護的診斷記憶體金鑰名稱。 | 需要字串 () |
| queueEndpoint | Azure 記憶體帳戶的佇列端點。 | 需要字串 () |
| storageAccountName | Azure 儲存體帳戶名稱。 | 需要字串 () |
| tableEndpoint | Azure 記憶體帳戶的數據表端點。 | 需要字串 () |
SettingsSectionDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | 網狀架構設定的區段名稱。 | 需要字串 () |
| 參數 | 區段中的參數集合。 | SettingsParameterDescription[] (必要) |
SettingsParameterDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | 網狀架構設定的參數名稱。 | 需要字串 () |
| 值 | 網狀架構設定的參數值。 | 需要字串 () |
NodeTypeDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| applicationPorts | 叢集指派埠至 Service Fabric 應用程式的埠範圍。 | EndpointRangeDescription |
| capacities | 套用至節點類型中節點的容量卷標，叢集資源管理員會使用這些標籤來了解節點具有多少資源。 | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | TCP 叢集管理埠。 | 需要 int () |
| durabilityLevel | 節點類型的持久性層級。 瞭解 DurabilityLevel。 - 銅級 - 沒有許可權。 此為預設值。 - Silver - 每個 UD 可以暫停 30 分鐘的基礎結構作業。 - 金級 - 每個 UD 可以暫停 2 小時的基礎結構作業。 Gold 持久性只能在完整節點 VM SKU (例如 D15_V2、G5 等) 上啟用。 |
'Bronze' 'Gold' 'Silver' |
| ephemeralPorts | 此節點類型中節點應設定的暫時埠範圍。 | EndpointRangeDescription |
| httpGatewayEndpointPort | HTTP 叢集管理埠。 | 需要 int () |
| isPrimary | 將執行系統服務的節點類型。 只有一個節點類型應該標示為主要節點。 無法刪除或變更現有叢集的主要節點類型。 | bool (必要) |
| NAME | 節點類型的名稱。 | 需要字串 () |
| placementProperties | 套用至節點類型中節點的放置標籤，可用來指出某些服務 (工作負載) 應執行的位置。 | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | 反向 Proxy 所使用的端點。 | int |
| vmInstanceCount | 節點類型中的節點數目。 此計數應該符合對應 VirtualMachineScaleSet 資源中的 capacity 屬性。 | 需要 int () 約束： 最小值 = 1 最大值 = 2147483647 |
EndpointRangeDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| endPort | 埠範圍的結束埠 | 需要 int () |
| startPort | 開始埠範圍 | 需要 int () |
NodeTypeDescriptionCapacities
| 名稱 | 描述 | 值 |
|---|---|---|
| {自定義屬性} | 字串 |
NodeTypeDescriptionPlacementProperties
| 名稱 | 描述 | 值 |
|---|---|---|
| {自定義屬性} | 字串 |
ClusterUpgradePolicy
| 名稱 | 描述 | 值 |
|---|---|---|
| deltaHealthPolicy | 升級叢集時所使用的差異健全狀況原則。 | ClusterUpgradeDeltaHealthPolicy |
| forceRestart | 如果為 true，則即使程式代碼版本未變更，仍會在升級期間強制重新啟動， (升級只會變更組態或數據) 。 | bool |
| healthCheckRetryTimeout | 在升級復原之前，應用程式或叢集狀況不良時重試健康情況評估的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 需要字串 () |
| healthCheckStableDuration | 在升級繼續進入下一個升級網域之前，應用程式或叢集必須維持狀況良好的時間長度。 持續時間可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 需要字串 () |
| healthCheckWaitDuration | 在執行健康狀態檢查之前，完成升級網域之後要等待的時間長度。 持續時間可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 需要字串 () |
| healthPolicy | 升級叢集時所使用的叢集健全狀況原則。 | ClusterHealthPolicy (必要) |
| upgradeDomainTimeout | 每個升級網域在升級復原之前必須完成的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 需要字串 () |
| upgradeReplicaSetCheckTimeout | 發生非預期問題時，封鎖處理升級網域並防止遺失可用性的時間長度上限。 此逾時過期時，無論是否發生可用性遺失問題，升級網域的處理都將繼續。 逾時會在每個升級網域啟動時重設。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 需要字串 () |
| upgradeTimeout | 在升級復原之前，整體升級必須完成的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 需要字串 () |
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 叢集。 使用此範本可讓您使用網路安全組來控制輸入和輸出網路流量。 |
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
| 名稱 | 描述 | 值 |
|---|---|---|
| 類型 | 資源類型 | 'Microsoft.ServiceFabric/clusters' |
| apiVersion | 資源 API 版本 | '2017-07-01-preview' |
| NAME | 資源名稱 | 需要字串 () 字元限制：4-23 合法字元： 小寫字母、數字和連字號。 以小寫字母開頭。 以小寫字母或數字結尾。 |
| location | 資源位置。 | 需要字串 () |
| 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。 | 字串 |
| clusterState | 叢集的目前狀態。 - WaitingForNodes - 指出已建立叢集資源，且資源提供者正在等候 Service Fabric VM 擴充功能開機並回報。 - 部署 - 指出正在 VM 上安裝 Service Fabric 執行時間。 叢集資源會處於此狀態，直到叢集開機並啟動系統服務為止。 - BaselineUpgrade - 指出叢集正在升級以建立叢集版本。 第一次啟動叢集時，會自動起始此升級。 - UpdateingUserConfiguration - 指出叢集正以使用者提供的組態升級。 - UpdateingUserCertificate - 指出叢集正以使用者提供的憑證升級。 - UpdateingInfrastructure - 指出叢集正以最新的 Service Fabric 運行時間版本升級。 只有在 upgradeMode 設定為 'Automatic' 時，才會發生這種情況。 - EnforcingClusterVersion - 指出叢集與預期的版本不同，且叢集正在升級為預期的版本。 - UpgradeServiceUnreachable - 指出叢集中的系統服務不再輪詢資源提供者。 處於此狀態的叢集無法由資源提供者管理。 - AutoScale - 指出正在調整叢集的 ReliabilityLevel。 - 就緒 - 指出叢集處於穩定狀態。 |
'AutoScale' 'BaselineUpgrade' '部署' 'EnforcingClusterVersion' 'Ready' 'UpdateingInfrastructure' 'UpdateingUserCertificate' 'UpdateingUserConfiguration' 'UpgradeServiceUnreachable' 'WaitingForNodes' |
| diagnosticsStorageAccountConfig | 用來儲存 Service Fabric 診斷記錄的記憶體帳戶資訊。 | DiagnosticsStorageAccountConfig |
| fabricSettings | 要設定叢集的自定義網狀架構設定清單。 | SettingsSectionDescription[] |
| managementEndpoint | 叢集的 HTTP 管理端點。 | 字串 (必要) |
| nodeTypes | 叢集中的節點類型清單。 | NodeTypeDescription[] (必要) |
| reliabilityLevel | 可靠性層級會設定系統服務的復本集大小。 瞭解 ReliabilityLevel。 - 無 - 執行目標複本集計數為 1 的系統服務。 這隻應該用於測試叢集。 - 銅級 - 執行目標複本集計數為 3 的系統服務。 這隻應該用於測試叢集。 - Silver - 執行目標複本集計數為 5 的系統服務。 - 金級 - 執行目標複本集計數為 7 的系統服務。 - 諮詢服務 - 執行目標複本集計數為 9 的系統服務。 |
'Bronze' 'Gold' 'None' 'Platinum' 'Silver' |
| reverseProxyCertificate | 反向 Proxy 所使用的伺服器證書。 | CertificateDescription |
| upgradeDescription | 升級叢集時要使用的原則。 | ClusterUpgradePolicy |
| upgradeMode | 當有新的 Service Fabric 執行時間版本可用時，叢集的升級模式。 - 自動 - 叢集會在可用後立即自動升級至最新的 Service Fabric 運行時間版本。 - 手動 - 叢集不會自動升級至最新的 Service Fabric 運行時間版本。 叢集是藉由在叢集資源中設定 clusterCodeVersion 屬性來升級。 |
'Automatic' 'Manual' |
| vmImage | VM 映像 VMSS 已設定為 。 您可以使用 Windows 或 Linux 等泛型名稱。 | 字串 |
ClusterVersionDetails
| 名稱 | 描述 | 值 |
|---|---|---|
| codeVersion | 叢集的 Service Fabric 運行時間版本。 | 字串 |
| Environment | 指出此版本是否適用於 Windows 或 Linux 作業系統。 | 'Linux' 'Windows' |
| supportExpiryUtc | 版本支援到期的日期。 | 字串 |
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 | 指出客戶端憑證是否具有叢集的系統管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 | bool (必要) |
ClientCertificateThumbprint
| 名稱 | 描述 | 值 |
|---|---|---|
| certificateThumbprint | 用戶端憑證的指紋。 | 字串 (必要) |
| isAdmin | 指出客戶端憑證是否具有叢集的系統管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 | bool (必要) |
DiagnosticsStorageAccountConfig
| 名稱 | 描述 | 值 |
|---|---|---|
| blobEndpoint | Azure 記憶體帳戶的 Blob 端點。 | 字串 (必要) |
| protectedAccountKeyName | 受保護的診斷記憶體金鑰名稱。 | 字串 (必要) |
| queueEndpoint | Azure 記憶體帳戶的佇列端點。 | 字串 (必要) |
| storageAccountName | Azure 儲存體帳戶名稱。 | 字串 (必要) |
| tableEndpoint | Azure 記憶體帳戶的數據表端點。 | 字串 (必要) |
SettingsSectionDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | 網狀架構設定的區段名稱。 | 字串 (必要) |
| 參數 | 區段中的參數集合。 | SettingsParameterDescription[] (必要) |
SettingsParameterDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | 網狀架構設定的參數名稱。 | 字串 (必要) |
| 值 | 網狀架構設定的參數值。 | 字串 (必要) |
NodeTypeDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| applicationPorts | 叢集指派埠至 Service Fabric 應用程式的埠範圍。 | EndpointRangeDescription |
| capacities | 套用至節點類型中節點的容量卷標，叢集資源管理員會使用這些標籤來了解節點擁有的資源量。 | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | TCP 叢集管理埠。 | int (必要) |
| durabilityLevel | 節點類型的持久性層級。 瞭解 DurabilityLevel。 - 銅級 - 沒有許可權。 此為預設值。 - Silver - 每個 UD 可以暫停基礎結構作業 30 分鐘。 - 金級 - 每個 UD 可以暫停基礎結構作業 2 小時。 Gold 持久性只能在完整節點 VM SKU (例如 D15_V2、G5 等) 上啟用。 |
'Bronze' 'Gold' 'Silver' |
| ephemeralPorts | 此節點類型中的節點應設定的暫時埠範圍。 | EndpointRangeDescription |
| httpGatewayEndpointPort | HTTP 叢集管理埠。 | int (必要) |
| isPrimary | 將執行系統服務的節點類型。 只有一個節點類型應該標示為主要節點。 無法刪除或變更現有叢集的主要節點類型。 | bool (必要) |
| NAME | 節點類型的名稱。 | 字串 (必要) |
| placementProperties | 套用至節點類型中節點的位置標記，可用來指出特定服務 (工作負載) 應該執行的位置。 | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | 反向 Proxy 所使用的端點。 | int |
| vmInstanceCount | 節點類型中的節點數目。 此計數應該符合對應 VirtualMachineScaleSet 資源中的 capacity 屬性。 | int (必要) 約束： 最小值 = 1 最大值 = 2147483647 |
EndpointRangeDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| endPort | 埠範圍的結束埠 | int (必要) |
| startPort | 開始埠範圍 | int (必要) |
NodeTypeDescriptionCapacities
| 名稱 | 描述 | 值 |
|---|---|---|
| {自定義屬性} | 字串 |
NodeTypeDescriptionPlacementProperties
| 名稱 | 描述 | 值 |
|---|---|---|
| {自定義屬性} | 字串 |
ClusterUpgradePolicy
| 名稱 | 描述 | 值 |
|---|---|---|
| deltaHealthPolicy | 升級叢集時所使用的差異健康情況原則。 | ClusterUpgradeDeltaHealthPolicy |
| forceRestart | 如果為 true，則即使程式代碼版本未變更，升級期間仍會強制重新啟動進程 (只會變更組態或數據) 。 | bool |
| healthCheckRetryTimeout | 在升級復原之前，應用程式或叢集狀況不良時重試健康情況評估的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 字串 (必要) |
| healthCheckStableDuration | 在升級繼續進入下一個升級網域之前，應用程式或叢集必須維持狀況良好的時間長度。 持續時間可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 字串 (必要) |
| healthCheckWaitDuration | 在執行健康情況檢查之前，完成升級網域之後等待的時間長度。 持續時間可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 字串 (必要) |
| healthPolicy | 升級叢集時使用的叢集健康情況原則。 | ClusterHealthPolicy (必要) |
| upgradeDomainTimeout | 每個升級網域在升級復原之前必須完成的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 字串 (必要) |
| upgradeReplicaSetCheckTimeout | 發生非預期問題時，封鎖處理升級網域並防止遺失可用性的時間長度上限。 此逾時過期時，無論是否發生可用性遺失問題，升級網域的處理都將繼續。 逾時會在每個升級網域啟動時重設。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 字串 (必要) |
| upgradeTimeout | 在升級復原之前，整體升級必須完成的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 字串 (必要) |
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@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
| 名稱 | 描述 | 值 |
|---|---|---|
| 類型 | 資源類型 | “Microsoft.ServiceFabric/clusters@2017-07-01-preview” |
| NAME | 資源名稱 | 需要字串 () 字元限制：4-23 合法字元： 小寫字母、數字和連字號。 以小寫字母開頭。 以小寫字母或數字結尾。 |
| location | 資源位置。 | 需要字串 () |
| parent_id | 若要部署至資源群組，請使用該資源群組的標識碼。 | 需要字串 () |
| 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。 | 字串 |
| clusterState | 叢集的目前狀態。 - WaitingForNodes - 指出已建立叢集資源，且資源提供者正在等候 Service Fabric VM 擴充功能開機並回報。 - 部署 - 指出正在 VM 上安裝 Service Fabric 執行時間。 叢集資源會處於此狀態，直到叢集開機並啟動系統服務為止。 - BaselineUpgrade - 指出叢集正在升級以建立叢集版本。 當叢集第一次開機時，會自動起始此升級。 - UpdateingUserConfiguration - 指出叢集正以使用者提供的組態進行升級。 - UpdateingUserCertificate - 指出叢集正以使用者提供的憑證進行升級。 - UpdateingInfrastructure - 指出叢集正使用最新的 Service Fabric 運行時間版本進行升級。 只有在 upgradeMode 設定為 'Automatic' 時，才會發生此情況。 - 強制執行ClusterVersion - 指出叢集位於與預期版本不同的版本，且叢集正在升級至預期的版本。 - UpgradeServiceUnreachable - 指出叢集中的系統服務不再輪詢資源提供者。 處於此狀態的叢集無法由資源提供者管理。 - 自動調整 - 指出正在調整叢集的 ReliabilityLevel。 - 就緒 - 指出叢集處於穩定狀態。 |
“AutoScale” “BaselineUpgrade” “部署” “EnforcingClusterVersion” "Ready" “UpdateingInfrastructure” “UpdateingUserCertificate” “UpdateingUserConfiguration” “UpgradeServiceUnreachable” “WaitingForNodes” |
| diagnosticsStorageAccountConfig | 用來儲存 Service Fabric 診斷記錄的記憶體帳戶資訊。 | DiagnosticsStorageAccountConfig |
| fabricSettings | 要設定叢集的自定義網狀架構設定清單。 | SettingsSectionDescription[] |
| managementEndpoint | 叢集的 HTTP 管理端點。 | 需要字串 () |
| nodeTypes | 叢集中的節點類型清單。 | NodeTypeDescription[] (必要) |
| reliabilityLevel | 可靠性層級會設定系統服務的復本集大小。 瞭解 ReliabilityLevel。 - 無 - 執行目標副本集計數為 1 的系統服務。 這應該只用於測試叢集。 - 銅級 - 執行目標副本集計數為 3 的系統服務。 這應該只用於測試叢集。 - Silver - 執行目標副本集計數為 5 的系統服務。 - 金級 - 執行目標副本集計數為 7 的系統服務。 - 點數 - 執行目標副本集計數為 9 的系統服務。 |
銅級” “Gold” "None" “點子” “Silver” |
| reverseProxyCertificate | 反向 Proxy 所使用的伺服器證書。 | CertificateDescription |
| upgradeDescription | 升級叢集時要使用的原則。 | ClusterUpgradePolicy |
| upgradeMode | 有新的 Service Fabric 執行時間版本可用時，叢集的升級模式。 - 自動 - 叢集一旦可用，就會自動升級至最新的 Service Fabric 運行時間版本。 - 手動 - 叢集不會自動升級至最新的 Service Fabric 運行時間版本。 叢集的升級方式是在叢集資源中設定 clusterCodeVersion 屬性。 |
“Automatic” “手動” |
| vmImage | 已設定 VM 映像 VMSS。 您可以使用一般名稱，例如 Windows 或 Linux。 | 字串 |
ClusterVersionDetails
| 名稱 | 描述 | 值 |
|---|---|---|
| codeVersion | 叢集的 Service Fabric 運行時間版本。 | 字串 |
| Environment | 指出此版本是否適用於 Windows 或 Linux 作業系統。 | "Linux" "Windows" |
| supportExpiryUtc | 版本的支援到期日。 | 字串 |
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 | 指出客戶端憑證是否具有叢集的管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 | bool (必要) |
ClientCertificateThumbprint
| 名稱 | 描述 | 值 |
|---|---|---|
| certificateThumbprint | 用戶端憑證的指紋。 | 需要字串 () |
| isAdmin | 指出客戶端憑證是否具有叢集的管理員存取權。 非系統管理員用戶端只能在叢集上執行唯讀作業。 | bool (必要) |
DiagnosticsStorageAccountConfig
| 名稱 | 描述 | 值 |
|---|---|---|
| blobEndpoint | Azure 記憶體帳戶的 Blob 端點。 | 需要字串 () |
| protectedAccountKeyName | 受保護的診斷記憶體金鑰名稱。 | 需要字串 () |
| queueEndpoint | Azure 記憶體帳戶的佇列端點。 | 需要字串 () |
| storageAccountName | Azure 儲存體帳戶名稱。 | 需要字串 () |
| tableEndpoint | Azure 記憶體帳戶的數據表端點。 | 需要字串 () |
SettingsSectionDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | 網狀架構設定的區段名稱。 | 需要字串 () |
| 參數 | 區段中的參數集合。 | SettingsParameterDescription[] (必要) |
SettingsParameterDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| NAME | 網狀架構設定的參數名稱。 | 需要字串 () |
| 值 | 網狀架構設定的參數值。 | 需要字串 () |
NodeTypeDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| applicationPorts | 叢集指派埠至 Service Fabric 應用程式的埠範圍。 | EndpointRangeDescription |
| capacities | 套用至節點類型中節點的容量卷標，叢集資源管理員會使用這些標籤來了解節點擁有的資源量。 | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | TCP 叢集管理埠。 | int (必要) |
| durabilityLevel | 節點類型的持久性層級。 瞭解 DurabilityLevel。 - 銅級 - 沒有許可權。 此為預設值。 - Silver - 每個 UD 可以暫停基礎結構作業 30 分鐘。 - 金級 - 每個 UD 可以暫停基礎結構作業 2 小時。 Gold 持久性只能在完整節點 VM SKU (例如 D15_V2、G5 等) 上啟用。 |
“Bronze” “Gold” “Silver” |
| ephemeralPorts | 此節點類型中的節點應設定的暫時埠範圍。 | EndpointRangeDescription |
| httpGatewayEndpointPort | HTTP 叢集管理埠。 | int (必要) |
| isPrimary | 將執行系統服務的節點類型。 只有一個節點類型應該標示為主要節點。 無法刪除或變更現有叢集的主要節點類型。 | bool (必要) |
| NAME | 節點類型的名稱。 | 字串 (必要) |
| placementProperties | 套用至節點類型中節點的位置標記，可用來指出特定服務 (工作負載) 應該執行的位置。 | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | 反向 Proxy 所使用的端點。 | int |
| vmInstanceCount | 節點類型中的節點數目。 此計數應該符合對應 VirtualMachineScaleSet 資源中的 capacity 屬性。 | int (必要) 約束： 最小值 = 1 最大值 = 2147483647 |
EndpointRangeDescription
| 名稱 | 描述 | 值 |
|---|---|---|
| endPort | 埠範圍的結束埠 | int (必要) |
| startPort | 開始埠範圍 | int (必要) |
NodeTypeDescriptionCapacities
| 名稱 | 描述 | 值 |
|---|---|---|
| {自定義屬性} | 字串 |
NodeTypeDescriptionPlacementProperties
| 名稱 | 描述 | 值 |
|---|---|---|
| {自定義屬性} | 字串 |
ClusterUpgradePolicy
| 名稱 | 描述 | 值 |
|---|---|---|
| deltaHealthPolicy | 升級叢集時所使用的差異健康情況原則。 | ClusterUpgradeDeltaHealthPolicy |
| forceRestart | 如果為 true，則即使程式代碼版本未變更，升級期間仍會強制重新啟動進程 (只會變更組態或數據) 。 | bool |
| healthCheckRetryTimeout | 在升級復原之前，應用程式或叢集狀況不良時重試健康情況評估的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 字串 (必要) |
| healthCheckStableDuration | 在升級繼續進入下一個升級網域之前，應用程式或叢集必須維持狀況良好的時間長度。 持續時間可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 字串 (必要) |
| healthCheckWaitDuration | 在執行健康情況檢查之前，完成升級網域之後等待的時間長度。 持續時間可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 字串 (必要) |
| healthPolicy | 升級叢集時使用的叢集健康情況原則。 | ClusterHealthPolicy (必要) |
| upgradeDomainTimeout | 每個升級網域在升級復原之前必須完成的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 字串 (必要) |
| upgradeReplicaSetCheckTimeout | 發生非預期問題時，封鎖處理升級網域並防止遺失可用性的時間長度上限。 此逾時過期時，無論是否發生可用性遺失問題，升級網域的處理都將繼續。 逾時會在每個升級網域啟動時重設。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 字串 (必要) |
| upgradeTimeout | 在升級復原之前，整體升級必須完成的時間量。 逾時可以是 hh：mm：ss 或 d.hh：mm：ss.ms 格式。 | 字串 (必要) |
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 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應