sfctl sa-clustersfctl sa-cluster

管理独立 Service Fabric 群集。Manage stand-alone Service Fabric clusters.

命令Commands

命令Command 说明Description
configconfig 获取 Service Fabric 独立群集配置。Get the Service Fabric standalone cluster configuration.
config-upgradeconfig-upgrade 开始升级 Service Fabric 独立群集的配置。Start upgrading the configuration of a Service Fabric standalone cluster.
upgrade-statusupgrade-status 获取 Service Fabric 独立群集的群集配置升级状态。Get the cluster configuration upgrade status of a Service Fabric standalone cluster.

sfctl sa-cluster configsfctl sa-cluster config

获取 Service Fabric 独立群集配置。Get the Service Fabric standalone cluster configuration.

群集配置包含群集的属性,包括群集上的不同节点类型、安全配置、错误和升级域拓扑,等等。The cluster configuration contains properties of the cluster that include different node types on the cluster, security configurations, fault, and upgrade domain topologies, etc.

参数Arguments

参数Argument 说明Description
--configuration-api-version [必需]--configuration-api-version [Required] 独立群集 json 配置的 API 版本。The API version of the Standalone cluster json configuration.
--timeout -t--timeout -t 执行操作的服务器超时,以秒为单位。The server timeout for performing the operation in seconds. 此超时指定客户端可以等待请求的操作完成的持续时间。This timeout specifies the time duration that the client is willing to wait for the requested operation to complete. 此参数的默认值为 60 秒。The default value for this parameter is 60 seconds. 默认值: 60。Default: 60.

全局参数Global Arguments

参数Argument 说明Description
--debug--debug 提高日志记录详细程度以显示所有调试日志。Increase logging verbosity to show all debug logs.
--help -h--help -h 显示此帮助消息并退出。Show this help message and exit.
--output -o--output -o 输出格式。Output format. 允许的值: json、jsonc、table、tsv。Allowed values: json, jsonc, table, tsv. 默认值: json。Default: json.
--query--query JMESPath 查询字符串。JMESPath query string. 有关详细信息和示例,请参阅 http://jmespath.org/。See http://jmespath.org/ for more information and examples.
--verbose--verbose 提高日志记录详细程度。Increase logging verbosity. 使用 --debug 获取完整的调试日志。Use --debug for full debug logs.

sfctl sa-cluster config-upgradesfctl sa-cluster config-upgrade

开始升级 Service Fabric 独立群集的配置。Start upgrading the configuration of a Service Fabric standalone cluster.

如果参数有效,则验证提供的配置升级参数并开始升级群集配置。Validate the supplied configuration upgrade parameters and start upgrading the cluster configuration if the parameters are valid.

参数Arguments

参数Argument 说明Description
--cluster-config [必需]--cluster-config [Required] 群集配置。The cluster configuration.
--application-health-policies--application-health-policies 应用程序类型名称对的 JSON 编码字典以及引发错误之前的最大不正常百分比。JSON encoded dictionary of pairs of application type name and maximum percentage unhealthy before raising error.
--delta-unhealthy-nodes--delta-unhealthy-nodes 升级过程中允许的增量运行状况降级最大百分比。The maximum allowed percentage of delta health degradation during the upgrade. 允许的值为 0 到 100 的整数值。Allowed values are integer values from zero to 100.
--health-check-retry--health-check-retry 应用程序或群集不正常时尝试执行运行状况检查所间隔的时间长度。The length of time between attempts to perform health checks if the application or cluster is not healthy. 默认值: PT0H0M0S。Default: PT0H0M0S.
--health-check-stable--health-check-stable 升级继续到下一升级域之前,应用程序或群集必须保持正常的时长。The amount of time that the application or cluster must remain healthy before the upgrade proceeds to the next upgrade domain. 默认值: PT0H0M0S。Default: PT0H0M0S.

首先,会将其解释为表示 ISO 8601 持续时间的一个字符串。It is first interpreted as a string representing an ISO 8601 duration. 如果那失败,则会将其解释为表示总毫秒数的一个数字。If that fails, then it is interpreted as a number representing the total number of milliseconds.
--health-check-wait--health-check-wait 启动运行状况检查进程之前,完成升级域后等待的时间长度。The length of time to wait after completing an upgrade domain before starting the health checks process. 默认值: PT0H0M0S。Default: PT0H0M0S.
--timeout -t--timeout -t 默认值: 60。Default: 60.
--unhealthy-applications--unhealthy-applications 升级过程中允许的不正常应用程序最大百分比。The maximum allowed percentage of unhealthy applications during the upgrade. 允许的值为 0 到 100 的整数值。Allowed values are integer values from zero to 100.
--unhealthy-nodes--unhealthy-nodes 升级过程中允许的不正常节点最大百分比。The maximum allowed percentage of unhealthy nodes during the upgrade. 允许的值为 0 到 100 的整数值。Allowed values are integer values from zero to 100.
--upgrade-domain-delta-unhealthy-nodes--upgrade-domain-delta-unhealthy-nodes 升级过程中允许的升级域增量运行状况降级最大百分比。The maximum allowed percentage of upgrade domain delta health degradation during the upgrade. 允许的值为 0 到 100 的整数值。Allowed values are integer values from zero to 100.
--upgrade-domain-timeout--upgrade-domain-timeout 执行 FailureAction 前,每个升级域需等待的时长。The amount of time each upgrade domain has to complete before FailureAction is executed. 默认值: PT0H0M0S。Default: PT0H0M0S.

首先,会将其解释为表示 ISO 8601 持续时间的一个字符串。It is first interpreted as a string representing an ISO 8601 duration. 如果那失败,则会将其解释为表示总毫秒数的一个数字。If that fails, then it is interpreted as a number representing the total number of milliseconds.
--upgrade-timeout--upgrade-timeout 执行 FailureAction 前,完成整个升级需等待的时长。The amount of time the overall upgrade has to complete before FailureAction is executed. 默认值: PT0H0M0S。Default: PT0H0M0S.

首先,会将其解释为表示 ISO 8601 持续时间的一个字符串。It is first interpreted as a string representing an ISO 8601 duration. 如果那失败,则会将其解释为表示总毫秒数的一个数字。If that fails, then it is interpreted as a number representing the total number of milliseconds.

全局参数Global Arguments

参数Argument 说明Description
--debug--debug 提高日志记录详细程度以显示所有调试日志。Increase logging verbosity to show all debug logs.
--help -h--help -h 显示此帮助消息并退出。Show this help message and exit.
--output -o--output -o 输出格式。Output format. 允许的值: json、jsonc、table、tsv。Allowed values: json, jsonc, table, tsv. 默认值: json。Default: json.
--query--query JMESPath 查询字符串。JMESPath query string. 有关详细信息和示例,请参阅 http://jmespath.org/。See http://jmespath.org/ for more information and examples.
--verbose--verbose 提高日志记录详细程度。Increase logging verbosity. 使用 --debug 获取完整的调试日志。Use --debug for full debug logs.

示例Examples

启动群集配置更新Start a cluster configuration update

sfctl sa-cluster config-upgrade --cluster-config <YOUR CLUSTER CONFIG> --application-health-
policies "{"fabric:/System":{"ConsiderWarningAsError":true}}"

sfctl sa-cluster upgrade-statussfctl sa-cluster upgrade-status

获取 Service Fabric 独立群集的群集配置升级状态。Get the cluster configuration upgrade status of a Service Fabric standalone cluster.

获取 Service Fabric 独立群集的群集配置升级状态详细信息。Get the cluster configuration upgrade status details of a Service Fabric standalone cluster.

参数Arguments

参数Argument 说明Description
--timeout -t--timeout -t 执行操作的服务器超时,以秒为单位。The server timeout for performing the operation in seconds. 此超时指定客户端可以等待请求的操作完成的持续时间。This timeout specifies the time duration that the client is willing to wait for the requested operation to complete. 此参数的默认值为 60 秒。The default value for this parameter is 60 seconds. 默认值: 60。Default: 60.

全局参数Global Arguments

参数Argument 说明Description
--debug--debug 提高日志记录详细程度以显示所有调试日志。Increase logging verbosity to show all debug logs.
--help -h--help -h 显示此帮助消息并退出。Show this help message and exit.
--output -o--output -o 输出格式。Output format. 允许的值: json、jsonc、table、tsv。Allowed values: json, jsonc, table, tsv. 默认值: json。Default: json.
--query--query JMESPath 查询字符串。JMESPath query string. 有关详细信息和示例,请参阅 http://jmespath.org/。See http://jmespath.org/ for more information and examples.
--verbose--verbose 提高日志记录详细程度。Increase logging verbosity. 使用 --debug 获取完整的调试日志。Use --debug for full debug logs.

后续步骤Next steps