sfctl cluster
選取、管理及操作 Service Fabric 叢集。
命令
| 命令 | 描述 |
|---|---|
| code-versions | 取得 Service Fabric 叢集中布建的網狀架構程式代碼版本清單。 |
| config-versions | 取得 Service Fabric 叢集中布建的網狀架構組態版本清單。 |
| health | 取得 Service Fabric 叢集的健康情況。 |
| 資訊清單 | 取得 Service Fabric 叢集指令清單。 |
| operation-cancel | 取消使用者引發的錯誤作業。 |
| operation-list | 取得依提供的輸入篩選的使用者引發錯誤作業清單。 |
| 佈建 | 布建 Service Fabric 叢集的程式代碼或組態套件。 |
| recover-system | 表示 Service Fabric 叢集應該嘗試復原目前卡在仲裁遺失中的系統服務。 |
| report-health | 在 Service Fabric 叢集上傳送健康情況報告。 |
| select | 聯機到 Service Fabric 叢集端點。 |
| show-connection | 顯示此 sfctl 實例所連接的 Service Fabric 叢集。 |
| 取消布建 | 取消布建 Service Fabric 叢集的程式代碼或組態套件。 |
| 升級 | 開始升級 Service Fabric 叢集的程式代碼或組態版本。 |
| upgrade-resume | 讓叢集升級移至下一個升級網域。 |
| upgrade-rollback | 復原 Service Fabric 叢集的升級。 |
| upgrade-status | 取得目前叢集升級的進度。 |
| upgrade-update | 更新 Service Fabric 叢集升級的升級參數。 |
sfctl cluster code-versions
取得 Service Fabric 叢集中布建的網狀架構程式代碼版本清單。
取得叢集中布建之網狀架構程式代碼版本的相關信息清單。 參數 CodeVersion 可用來選擇性地將輸出篩選為只有該特定版本。
引數
| Argument | 描述 |
|---|---|
| --code-version | Service Fabric 的產品版本。 |
| --timeout -t | 伺服器逾時，以秒為單位執行作業。 此逾時會指定客戶端願意等候要求作業完成的時間持續時間。 此參數的預設值為 60 秒。 預設值：60。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster config-versions
取得 Service Fabric 叢集中布建的網狀架構組態版本清單。
取得叢集中布建網狀架構組態版本的相關信息清單。 參數 ConfigVersion 可用來選擇性地將輸出篩選為只有該特定版本。
引數
| Argument | 描述 |
|---|---|
| --config-version | Service Fabric 的組態版本。 |
| --timeout -t | 伺服器逾時，以秒為單位執行作業。 此逾時會指定客戶端願意等候要求作業完成的時間持續時間。 此參數的預設值為 60 秒。 預設值：60。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster health
取得 Service Fabric 叢集的健康情況。
使用 EventsHealthStateFilter，根據健康情況狀態篩選叢集上報告的健康情況事件集合。 同樣地，使用 NodesHealthStateFilter 和 ApplicationsHealthStateFilter，根據節點的匯總健全狀態篩選傳回的節點和應用程式集合。
引數
| Argument | 描述 |
|---|---|
| --applications-health-state-filter | 允許根據叢集健康狀態查詢結果傳回的應用程式健康情況狀態對象進行篩選。 此參數的可能值包括從 HealthStateFilter 列舉成員的成員或位運算取得的整數值。 只會傳回符合篩選條件的應用程式。 所有應用程式都會用來評估匯總的健康情況狀態。 如果未指定，則會傳回所有專案。 狀態值是以旗標為基礎的列舉，因此值可以是使用位 『OR』 運算子取得的這些值組合。 例如，如果提供的值為 6，則會傳回 HealthState 值為 OK （2） 和 Warning （4） 的應用程式健康情況狀態。 - 預設值 - 預設值。 符合任何 HealthState。 值為零。 - 無 - 不符合任何 HealthState 值的篩選。 用來傳回指定狀態集合上沒有結果。 值為 1。 - 確定 - 符合輸入的篩選與 HealthState 值 Ok。 值為 2。 - 警告 - 符合輸入與 HealthState 值 Warning 的篩選條件。 值為 4。 - 錯誤 - 符合輸入與 HealthState 值 Error 的篩選條件。 值為 8。 - 全部 - 符合任何 HealthState 值的輸入的篩選條件。 值為 65535。 |
| --events-health-state-filter | 允許根據健康情況狀態篩選傳回的HealthEvent物件集合。 此參數的可能值包括下列其中一個健康情況狀態的整數值。 只會傳回符合篩選的事件。 所有事件都會用來評估匯總的健康情況狀態。 如果未指定，則會傳回所有專案。 狀態值是以旗標為基礎的列舉，因此值可以是這些值的組合，使用位 『OR』 運算子取得。 例如，如果提供的值為 6，則會傳回 HealthState 值為 OK （2） 和 Warning （4） 的所有事件。 - 預設值 - 預設值。 符合任何 HealthState。 值為零。 - 無 - 不符合任何 HealthState 值的篩選。 用來傳回指定狀態集合上沒有結果。 值為 1。 - 確定 - 符合輸入的篩選與 HealthState 值 Ok。 值為 2。 - 警告 - 符合輸入與 HealthState 值 Warning 的篩選條件。 值為 4。 - 錯誤 - 符合輸入與 HealthState 值 Error 的篩選條件。 值為 8。 - 全部 - 符合任何 HealthState 值的輸入的篩選條件。 值為 65535。 |
| --exclude-health-statistics | 指出健康情況統計數據是否應該當做查詢結果的一部分傳回。 False 預設為 False。 統計數據顯示健全狀況狀態為Ok、Warning和Error的子實體數目。 |
| --include-system-application-health-statistics | 指出健康情況統計數據是否應該包含 fabric：/System 應用程式健康情況統計數據。 False 預設為 False。 如果 IncludeSystemApplicationHealthStatistics 設定為 true，健康情況統計數據會包含屬於 fabric：/System 應用程式的實體。 否則，查詢結果只會包含使用者應用程式的健全狀況統計數據。 健康情況統計數據必須包含在查詢結果中，才能套用此參數。 |
| --nodes-health-state-filter | 允許根據叢集健康情況查詢結果傳回的節點健康情況狀態對象進行篩選。 此參數的可能值包括下列其中一個健康情況狀態的整數值。 只會傳回符合篩選條件的節點。 所有節點都會用來評估匯總的健康情況狀態。 如果未指定，則會傳回所有專案。 狀態值是以旗標為基礎的列舉，因此值可以是使用位 『OR』 運算子取得的這些值組合。 例如，如果提供的值為 6，則會傳回 HealthState 值為 OK （2） 和 Warning （4） 的節點健康情況狀態。 - 預設值 - 預設值。 符合任何 HealthState。 值為零。 - 無 - 不符合任何 HealthState 值的篩選。 用來傳回指定狀態集合上沒有結果。 值為 1。 - 確定 - 符合輸入的篩選與 HealthState 值 Ok。 值為 2。 - 警告 - 符合輸入與 HealthState 值 Warning 的篩選條件。 值為 4。 - 錯誤 - 符合輸入與 HealthState 值 Error 的篩選條件。 值為 8。 - 全部 - 符合任何 HealthState 值的輸入的篩選條件。 值為 65535。 |
| --timeout -t | 伺服器逾時，以秒為單位執行作業。 此逾時會指定客戶端願意等候要求作業完成的時間持續時間。 此參數的預設值為 60 秒。 預設值：60。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster manifest
取得 Service Fabric 叢集指令清單。
取得 Service Fabric 叢集指令清單。 叢集指令清單包含叢集的屬性，這些屬性包含叢集上的不同節點類型、安全性設定、容錯和升級網域拓撲等。部署獨立叢集時，這些屬性會指定為ClusterConfig.JSON檔案的一部分。 不過，叢集指令清單中大部分的資訊都是由 Service Fabric 在其他部署案例中於叢集部署期間於內部產生（例如使用 Azure 入口網站 時）。 叢集指令清單的內容僅供參考之用，使用者不預期會相依於檔案內容的格式或其解譯。
引數
| Argument | 描述 |
|---|---|
| --timeout -t | 伺服器逾時，以秒為單位執行作業。 此逾時會指定客戶端願意等候要求作業完成的時間持續時間。 此參數的預設值為 60 秒。 預設值：60。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster operation-cancel
取消使用者引發的錯誤作業。
下列 API 會啟動可使用 CancelOperation 取消的錯誤作業：StartDataLoss、StartQuorumLoss、StartPartitionRestart、StartNodeTransition。 如果 force 為 false，則會正常停止並清除指定的使用者引發作業。 如果 force 為 true，命令將會中止，而且可能會留下一些內部狀態。 將 force 指定為 true 應該小心使用。 除非已在相同的測試命令上呼叫此 API，且強制設定為 false，否則除非測試命令已經有 OperationState.RollingBack 的 OperationState，否則不允許呼叫此 API。 釐清：OperationState.RollingBack 表示系統將會/正在清除執行 命令所造成的內部系統狀態。 如果測試命令造成數據遺失，則不會還原數據。 例如，如果您呼叫 StartDataLoss，然後呼叫此 API，系統只會清除執行命令的內部狀態。 如果命令進展到足以造成數據遺失，則不會還原目標分割區的數據。 重要注意事項：如果使用 force==true 叫用此 API，內部狀態可能會落後。
引數
| Argument | 描述 |
|---|---|
| --operation-id [必要] | 識別此 API 呼叫的 GUID。 這會傳遞至對應的 GetProgress API。 |
| --force | 指出是否要藉由執行使用者引發的作業，正常回復及清除修改的內部系統狀態。 |
| --timeout -t | 伺服器逾時，以秒為單位執行作業。 此逾時會指定客戶端願意等候要求作業完成的時間持續時間。 此參數的預設值為 60 秒。 預設值：60。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster operation-list
取得依提供的輸入篩選的使用者引發錯誤作業清單。
取得依提供的輸入篩選的使用者引發錯誤作業清單。
引數
| Argument | 描述 |
|---|---|
| --state-filter | 用來篩選 OperationState 的用戶引發作業。 - 65535 - 選取 [全部- 1 - 選取執行 - 2 - 選取滾動 - 8 - 選取已完成 - 16 - 選取錯誤 - 32 - 選取已取消 - 64 - 選取 ForceCancelled。 默認值：65535。 |
| --timeout -t | 伺服器逾時，以秒為單位執行作業。 此逾時會指定客戶端願意等候要求作業完成的時間持續時間。 此參數的預設值為 60 秒。 預設值：60。 |
| --type-filter | 用來篩選 OperationType 以用於用戶引發的作業。 - 65535 - 全部選取 - 1 - 選取 PartitionDataLoss。 - 2 - 選取 [PartitionQuorumLoss]。 - 4 - 選取 [PartitionRestart]。 - 8 - 選取 [NodeTransition]。 默認值：65535。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster provision
布建 Service Fabric 叢集的程式代碼或組態套件。
驗證並布建 Service Fabric 叢集的程式代碼或組態套件。
引數
| Argument | 描述 |
|---|---|
| --cluster-manifest-file-path | 叢集指令清單檔案路徑。 |
| --code-file-path | 叢集程式代碼套件檔案路徑。 |
| --timeout -t | 伺服器逾時，以秒為單位執行作業。 此逾時會指定客戶端願意等候要求作業完成的時間持續時間。 此參數的預設值為 60 秒。 預設值：60。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster recover-system
表示 Service Fabric 叢集應該嘗試復原目前卡在仲裁遺失中的系統服務。
表示 Service Fabric 叢集應該嘗試復原目前卡在仲裁遺失中的系統服務。 只有在已知無法復原關閉的複本時，才應該執行這項作業。 不正確使用此 API 可能會導致潛在的數據遺失。
引數
| Argument | 描述 |
|---|---|
| --timeout -t | 伺服器逾時，以秒為單位執行作業。 此逾時會指定客戶端願意等候要求作業完成的時間持續時間。 此參數的預設值為 60 秒。 預設值：60。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster report-health
在 Service Fabric 叢集上傳送健康情況報告。
在 Service Fabric 叢集上傳送健康情況報告。 報表必須包含其報告之健康情況報告來源和屬性的相關信息。 報告會傳送至 Service Fabric 網關節點，該節點會轉送至健康狀態存放區。 網關可以接受報告，但在額外的驗證之後，健康狀態存放區會拒絕。 例如，健康狀態存放區可能會因為無效的參數而拒絕報告，例如過時的序號。 若要查看報告是否已套用在健康狀態存放區中，請執行 GetClusterHealth 並檢查報告是否出現在 HealthEvents 區段中。
引數
| Argument | 描述 |
|---|---|
| --health-property [必要] | 健康情況信息的屬性。 實體可以有不同屬性的健康情況報告。 屬性是字串，而不是固定列舉，可讓記者彈性地分類觸發報表的狀態條件。 例如，具有SourceId「LocalWatchdog」 的記者可以監視節點上可用磁碟的狀態，以便報告該節點上的 「AvailableDisk」 屬性。 相同的記者可以監視節點連線能力，因此它可以報告相同節點上的屬性「連線能力」。 在健康狀態存放區中，這些報告會被視為指定節點的個別健康情況事件。 屬性與SourceId一起，可唯一識別健康情況資訊。 |
| --health-state [必要] | 可能的值包括：『Invalid』、『Ok』、『Warning』、『Error』、『Unknown』。 |
| --source-id [必要] | 識別產生健康情況資訊之用戶端/監視程式/系統元件的來源名稱。 |
| --描述 | 健康情況資訊的描述。 它代表用來新增人類可讀報表資訊的自由文字。 描述的最大字串長度為4096個字元。 如果提供的字串較長，則會自動截斷。 截斷時，描述的最後一個字元包含標記 “[Truncated]”，而字串大小總計為 4096 個字元。 標記的存在表示發生截斷的使用者。 請注意，截斷時，描述的原始字串少於 4096 個字元。 |
| --立即的 | 指出是否應立即傳送報表的旗標。 健康情況報告會傳送至 Service Fabric 閘道應用程式，此應用程式會轉送至健康狀態存放區。 如果 Immediate 設定為 true，則不論 HTTP 閘道應用程式所使用的網狀架構客戶端設定為何，報表都會立即從 HTTP 閘道傳送至健康狀態存放區。 這對於應儘快傳送的重要報告很有用。 根據計時和其他條件，傳送報告可能仍然失敗，例如，如果 HTTP 閘道已關閉或訊息未連線到閘道。 如果 [即時運算] 設定為 false，則會根據 HTTP 閘道的健康情況客戶端設定來傳送報告。 因此，它會根據 HealthReportSendInterval 組態進行批處理。 這是建議的設定，因為它可讓健康情況用戶端將健康情況報告訊息優化到健康狀態存放區，以及健康情況報告處理。 根據預設，報表不會立即傳送。 |
| --remove-when-expired | 值，指出報表在到期時是否從健康狀態存放區中移除。 如果設定為 true，報表會在到期後從健康狀態存放區中移除。 如果設定為 false，報表會在過期時被視為錯誤。 此屬性的值預設為 false。 當用戶端定期報告時，應該設定 RemoveWhenExpired false （預設值）。 如此一來，記者有問題（例如死結）且無法報告，實體會在健康情況報告到期時評估為錯誤。 這會將實體標示為處於錯誤健康狀態。 |
| --sequence-number | 此健康情況報告的序號為數值字串。 健康狀態存放區會使用報表序號來偵測過時的報告。 如果未指定，當加入報表時，健康情況用戶端會自動產生序號。 |
| --timeout -t | 預設值：60。 |
| --ttl | 此健康情況報告有效的持續時間。 此欄位會使用ISO8601格式來指定持續時間。 當用戶端定期報告時，他們應該傳送頻率高於存留時間的報告。 如果客戶端回報轉換，他們可以將存留時間設定為無限。 存留時間到期時，如果 RemoveWhenExpired 為 true，則會從健康狀態存放區移除包含健康情況資訊的健全狀況事件，如果 RemoveWhenExpired false，則會在錯誤時進行評估。 如果未指定，存留時間預設為無限值。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster select
聯機到 Service Fabric 叢集端點。
如果連線到安全叢集，請指定憑證 （.crt） 和密鑰檔案的絕對路徑 （.key） 或具有兩者 （.pem） 的單一檔案。 請勿同時指定兩者。 或者，如果連線到安全的叢集，也指定 CA 配套檔案或受信任 CA 憑證目錄的絕對路徑。 沒有先執行此命令的叢集連線，包括與localhost的連線。 不過，連線到本機叢集不需要明確的端點。 如果使用自我簽署憑證或其他未由已知 CA 簽署的憑證，請傳入 --ca 參數以確保驗證通過。 如果不在生產叢集上，若要略過客戶端驗證（適用於自我簽署或尚未簽署的已知 CA），請使用 --no-verify 選項。 雖然可行，但不建議用於生產叢集。 憑證驗證錯誤可能會造成其他結果。
引數
| Argument | 描述 |
|---|---|
| --aad | 使用 Microsoft Entra ID 進行驗證。 |
| --ca | 要視為有效或 CA 配套檔案的 CA 憑證目錄絕對路徑。 如果使用 CA 憑證的目錄， c_rehash <directory> 必須先執行 OpenSSL 所提供的目錄，才能計算憑證哈希，並建立適當的符號連結。 這是用來驗證叢集傳回的憑證是否有效。 |
| --證書 | 用戶端憑證檔案的絕對路徑。 |
| --端點 | 叢集端點 URL，包括埠和 HTTP 或 HTTPS 前置詞。 一般而言，端點看起來會像 https\://<your-url>\:19080。 如果未指定任何端點，則會預設為 http\://localhost\:19080。 |
| --鑰匙 | 用戶端憑證金鑰檔案的絕對路徑。 |
| --no-verify | 使用 HTTPS 時停用憑證的驗證，請注意：這是不安全的選項，不應該用於生產環境。 |
| --pem | 用戶端憑證的絕對路徑，做為 .pem 檔案。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster show-connection
顯示此 sfctl 實例所連接的 Service Fabric 叢集。
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster unprovision
取消布建 Service Fabric 叢集的程式代碼或組態套件。
支援個別取消布建程式代碼和設定。
引數
| Argument | 描述 |
|---|---|
| --code-version | 叢集程式代碼套件版本。 |
| --config-version | 叢集指令清單版本。 |
| --timeout -t | 伺服器逾時，以秒為單位執行作業。 此逾時會指定客戶端願意等候要求作業完成的時間持續時間。 此參數的預設值為 60 秒。 預設值：60。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster upgrade
開始升級 Service Fabric 叢集的程式代碼或組態版本。
驗證提供的升級參數，並在參數有效時開始升級 Service Fabric 叢集的程式代碼或組態版本。
引數
| Argument | 描述 |
|---|---|
| --app-health-map | 在引發錯誤之前，應用程式名稱配對和最大百分比狀況不良的 JSON 編碼字典。 |
| --app-type-health-map | 在引發錯誤之前，應用程式類型名稱配對和最大百分比狀況不良的 JSON 編碼字典。 |
| --code-version | 叢集程式代碼版本。 |
| --config-version | 叢集組態版本。 |
| --delta-health-evaluation | 啟用差異健康情況評估，而不是完成每個升級網域之後的絕對健康情況評估。 |
| --delta-unhealthy-nodes | 叢集升級期間允許的最大節點健康情況降低百分比。 預設值：10 差異會在升級開始時的節點狀態和健康情況評估時節點的狀態之間測量。 檢查會在每個升級網域升級完成之後執行，以確保叢集的全域狀態在容許的限制內。 |
| --failure-action | 可能的值包括：『Invalid』、『Rollback』、『Manual』。 |
| --force-restart | 即使程式代碼版本未變更，在升級期間仍會強制重新啟動進程。 升級只會變更組態或數據。 |
| --health-check-retry | 嘗試執行健康情況檢查應用程式或叢集是否狀況不良之間的時間長度。 |
| --health-check-stable | 在升級繼續進入下一個升級網域之前，應用程式或叢集必須維持狀況良好的時間長度。 它會先解譯為代表 ISO 8601 持續時間的字串。 如果失敗，則會解譯為代表總毫秒數的數字。 |
| --health-check-wait | 開始健康狀態檢查程式之前，完成升級網域之後要等待的時間長度。 |
| --replica-set-check-timeout | 封鎖升級網域處理的時間上限，並避免在發生非預期的問題時遺失可用性。 當此逾時到期時，不論可用性遺失問題為何，升級網域的處理都會繼續。 逾時會在每個升級網域開始時重設。 有效值介於 0 與42949672925之間。 |
| --rolling-upgrade-mode | 可能的值包括：'Invalid'、'UnmonitoredAuto'、'UnmonitoredManual'、'Monitored'。 默認值：UnmonitoredAuto。 |
| --timeout -t | 預設值：60。 |
| --unhealthy-applications | 報告錯誤之前，允許的應用程式狀況不良百分比上限。 例如，若要允許 10% 的應用程式狀況不良，此值會是 10。 百分比代表在叢集視為錯誤之前，可能狀況不良的應用程式最大容許百分比。 如果遵守百分比，但至少有一個狀況不良的應用程式，則健康情況會評估為Warning。 這是藉由將狀況不良的應用程式數目除以叢集中應用程式實例總數，不包括 ApplicationTypeHealthPolicyMap 中包含的應用程式類型應用程式。 計算會四捨五入，以容許少量應用程序發生一個失敗。 |
| --unhealthy-nodes | 報告錯誤之前，允許狀況不良節點的百分比上限。 例如，若要允許 10% 的節點狀況不良，這個值會是 10。 百分比代表在叢集視為錯誤之前，可狀況不良之節點的最大容許百分比。 如果遵守百分比，但至少有一個狀況不良的節點，則健康情況會評估為Warning。 百分比的計算方式是將狀況不良的節點數目除以叢集中的節點總數。 針對較少的節點數目，計算會四捨五入以容許一個失敗。 在大型叢集中，某些節點一律會關閉或關閉以進行修復，因此應該將此百分比設定為容許該百分比。 |
| --upgrade-domain-delta-unhealthy-nodes | 叢集升級期間允許升級網域節點健康情況降低的最大允許百分比。 默認值：15。 差異會測量升級網域節點在升級開始時的狀態，以及健康情況評估時升級網域節點的狀態。 檢查會在所有已完成升級網域的每個升級網域完成之後執行，以確保升級網域的狀態在容許的限制內。 |
| --upgrade-domain-timeout | 執行 FailureAction 之前，每個升級網域必須完成的時間長度。 它會先解譯為代表 ISO 8601 持續時間的字串。 如果失敗，則會解譯為代表總毫秒數的數字。 |
| --upgrade-timeout | 執行 FailureAction 之前，整體升級必須完成的時間量。 它會先解譯為代表 ISO 8601 持續時間的字串。 如果失敗，則會解譯為代表總毫秒數的數字。 |
| --warning-as-error | 指出是否以與錯誤相同的嚴重性來處理警告。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster upgrade-resume
讓叢集升級移至下一個升級網域。
如果適當，請讓叢集程式代碼或組態升級移至下一個升級網域。
引數
| Argument | 描述 |
|---|---|
| --upgrade-domain [必要] | 此叢集升級的下一個升級網域。 |
| --timeout -t | 伺服器逾時，以秒為單位執行作業。 此逾時會指定客戶端願意等候要求作業完成的時間持續時間。 此參數的預設值為 60 秒。 預設值：60。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster upgrade-rollback
復原 Service Fabric 叢集的升級。
復原 Service Fabric 叢集的程式代碼或組態升級。
引數
| Argument | 描述 |
|---|---|
| --timeout -t | 伺服器逾時，以秒為單位執行作業。 此逾時會指定客戶端願意等候要求作業完成的時間持續時間。 此參數的預設值為 60 秒。 預設值：60。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster upgrade-status
取得目前叢集升級的進度。
取得進行中叢集升級的目前進度。 如果目前沒有任何升級正在進行中，請取得先前叢集升級的最後一個狀態。
引數
| Argument | 描述 |
|---|---|
| --timeout -t | 伺服器逾時，以秒為單位執行作業。 此逾時會指定客戶端願意等候要求作業完成的時間持續時間。 此參數的預設值為 60 秒。 預設值：60。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |
sfctl cluster upgrade-update
更新 Service Fabric 叢集升級的升級參數。
引數
| Argument | 描述 |
|---|---|
| --app-health-map | 在引發錯誤之前，應用程式名稱配對和最大百分比狀況不良的 JSON 編碼字典。 |
| --app-type-health-map | 在引發錯誤之前，應用程式類型名稱配對和最大百分比狀況不良的 JSON 編碼字典。 |
| --delta-health-evaluation | 啟用差異健康情況評估，而不是完成每個升級網域之後的絕對健康情況評估。 |
| --delta-unhealthy-nodes | 叢集升級期間允許的最大節點健康情況降低百分比。 預設值：10 差異會在升級開始時的節點狀態和健康情況評估時節點的狀態之間測量。 檢查會在每個升級網域升級完成之後執行，以確保叢集的全域狀態在容許的限制內。 |
| --failure-action | 可能的值包括：『Invalid』、『Rollback』、『Manual』。 |
| --force-restart | 即使程式代碼版本未變更，在升級期間仍會強制重新啟動進程。 升級只會變更組態或數據。 |
| --health-check-retry | 嘗試執行健康情況檢查應用程式或叢集是否狀況不良之間的時間長度。 |
| --health-check-stable | 在升級繼續進入下一個升級網域之前，應用程式或叢集必須維持狀況良好的時間長度。 它會先解譯為代表 ISO 8601 持續時間的字串。 如果失敗，則會解譯為代表總毫秒數的數字。 |
| --health-check-wait | 開始健康狀態檢查程式之前，完成升級網域之後要等待的時間長度。 |
| --replica-set-check-timeout | 封鎖升級網域處理的時間上限，並避免在發生非預期的問題時遺失可用性。 當此逾時到期時，不論可用性遺失問題為何，升級網域的處理都會繼續。 逾時會在每個升級網域開始時重設。 有效值介於 0 與42949672925之間。 |
| --rolling-upgrade-mode | 可能的值包括：'Invalid'、'UnmonitoredAuto'、'UnmonitoredManual'、'Monitored'。 默認值：UnmonitoredAuto。 |
| --timeout -t | 預設值：60。 |
| --unhealthy-applications | 報告錯誤之前，允許的應用程式狀況不良百分比上限。 例如，若要允許 10% 的應用程式狀況不良，此值會是 10。 百分比代表在叢集視為錯誤之前，可能狀況不良的應用程式最大容許百分比。 如果遵守百分比，但至少有一個狀況不良的應用程式，則健康情況會評估為Warning。 這是藉由將狀況不良的應用程式數目除以叢集中應用程式實例總數，不包括 ApplicationTypeHealthPolicyMap 中包含的應用程式類型應用程式。 計算會四捨五入，以容許少量應用程序發生一個失敗。 |
| --unhealthy-nodes | 報告錯誤之前，允許狀況不良節點的百分比上限。 例如，若要允許 10% 的節點狀況不良，這個值會是 10。 百分比代表在叢集視為錯誤之前，可狀況不良之節點的最大容許百分比。 如果遵守百分比，但至少有一個狀況不良的節點，則健康情況會評估為Warning。 百分比的計算方式是將狀況不良的節點數目除以叢集中的節點總數。 針對較少的節點數目，計算會四捨五入以容許一個失敗。 在大型叢集中，某些節點一律會關閉或關閉以進行修復，因此應該將此百分比設定為容許該百分比。 |
| --upgrade-domain-delta-unhealthy-nodes | 叢集升級期間允許升級網域節點健康情況降低的最大允許百分比。 默認值：15。 差異會測量升級網域節點在升級開始時的狀態，以及健康情況評估時升級網域節點的狀態。 檢查會在所有已完成升級網域的每個升級網域完成之後執行，以確保升級網域的狀態在容許的限制內。 |
| --upgrade-domain-timeout | 執行 FailureAction 之前，每個升級網域必須完成的時間長度。 它會先解譯為代表 ISO 8601 持續時間的字串。 如果失敗，則會解譯為代表總毫秒數的數字。 |
| --upgrade-kind | 可能的值包括：『Invalid』、『Rolling』、『Rolling_ForceRestart』。 默認值：滾動。 |
| --upgrade-timeout | 執行 FailureAction 之前，整體升級必須完成的時間量。 它會先解譯為代表 ISO 8601 持續時間的字串。 如果失敗，則會解譯為代表總毫秒數的數字。 |
| --warning-as-error | 指出是否以與錯誤相同的嚴重性來處理警告。 |
全域引數
| Argument | 描述 |
|---|---|
| --debug | 增加記錄詳細資訊，以顯示所有偵錯記錄。 |
| --help -h | 顯示此說明訊息並結束。 |
| --output -o | 輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。 |
| --查詢 | JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。 |
| --verbose | 增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。 |