Share via

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az sf managed-application

  • 参考

管理在 Azure Service Fabric 托管群集上运行的应用程序。 仅支持 ARM 部署的应用程序。

命令

名称 说明 类型 状态
az sf managed-application create

在 Azure Service Fabric 托管群集上创建新的托管应用程序。

 核心 GA
az sf managed-application delete

删除托管应用程序。

 核心 GA
az sf managed-application list

列出给定托管群集的托管应用程序。

 核心 GA
az sf managed-application show

显示 Azure Service Fabric 托管群集上托管应用程序的属性。

 核心 GA
az sf managed-application update

更新 Azure Service Fabric 托管应用程序。

 核心 GA

az sf managed-application create

在 Azure Service Fabric 托管群集上创建新的托管应用程序。

az sf managed-application create --application-name
                                 --application-type-name
                                 --application-type-version
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters]
                                 [--package-url]
                                 [--tags]

示例

使用参数创建托管应用程序“testApp”。 应用程序类型“TestAppType”版本“v1”应已存在于群集中，应在应用程序清单中定义应用程序参数。

az sf managed-application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --application-parameters key0=value0 --tags key1=value1

使用提供的包 URL 创建应用程序“testApp”和应用类型版本。

az sf managed-application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --package-url "https://sftestapp.blob.core.windows.net/sftestapp/testApp_1.0.sfpkg" \
    --application-parameters key0=value0

必需参数

--application-name --name

指定应用程序名称。

--application-type-name --type-name

指定应用程序类型名称。

--application-type-version --version

指定应用程序类型版本。

--cluster-name -c

指定群集的名称（如果未指定），则与资源组名称相同。

--resource-group -g

指定资源组名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--application-parameters --parameters

将应用程序参数指定为键/值对。 这些参数必须存在于应用程序清单中。 例如：--application-parameters param1=value1 param2=value2。

--package-url

指定应用程序包 sfpkg 文件的 URL。

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az sf managed-application delete

删除托管应用程序。

az sf managed-application delete --application-name
                                 --cluster-name
                                 --resource-group

示例

删除托管应用程序。

az sf managed-application delete -g testRG -c testCluster --application-name testApp

必需参数

--application-name --name

指定应用程序名称。

--cluster-name -c

指定群集的名称（如果未指定），则与资源组名称相同。

--resource-group -g

指定资源组名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az sf managed-application list

列出给定托管群集的托管应用程序。

az sf managed-application list --cluster-name
                               --resource-group

示例

列出给定托管群集的托管应用程序。

az sf managed-application list -g testRG -c testCluster

必需参数

--cluster-name -c

指定群集的名称（如果未指定），则与资源组名称相同。

--resource-group -g

指定资源组名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az sf managed-application show

显示 Azure Service Fabric 托管群集上托管应用程序的属性。

az sf managed-application show --application-name
                               --cluster-name
                               --resource-group

示例

获取托管应用程序。

az sf managed-application show -g testRG -c testCluster --application-name testApp

必需参数

--application-name --name

指定应用程序名称。

--cluster-name -c

指定群集的名称（如果未指定），则与资源组名称相同。

--resource-group -g

指定资源组名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az sf managed-application update

更新 Azure Service Fabric 托管应用程序。

这允许更新标记、应用程序参数、值是应用程序 UpgradePolicy 和/或升级将触发应用程序升级的应用程序类型版本。

az sf managed-application update --application-name
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters]
                                 [--application-type-version]
                                 [--close-duration]
                                 [--consider-warning-as-error {false, true}]
                                 [--failure-action {Manual, Rollback}]
                                 [--force-restart {false, true}]
                                 [--hc-retry-timeout]
                                 [--hc-stable-duration]
                                 [--hc-wait-duration]
                                 [--max-percent-unhealthy-apps]
                                 [--max-percent-unhealthy-partitions]
                                 [--max-percent-unhealthy-replicas]
                                 [--max-percent-unhealthy-services]
                                 [--recreate-application {false, true}]
                                 [--rep-check-timeout]
                                 [--service-type-health-policy-map]
                                 [--tags]
                                 [--ud-timeout]
                                 [--upgrade-mode {Monitored, UnmonitoredAuto}]
                                 [--upgrade-timeout]

示例

将应用程序参数和更新策略值和应用类型版本更新为 v2。

az sf managed-application update -g testRG -c testCluster --application-name testApp --application-type-version v2 \
  --application-parameters key0=value0 --health-check-stable-duration 0 --health-check-wait-duration 0 --health-check-retry-timeout 0 \
    --upgrade-domain-timeout 5000 --upgrade-timeout 7000 --failure-action Rollback --upgrade-replica-set-check-timeout 300 --force-restart

更新托管应用程序服务类型运行状况策略映射。

az sf managed-application update -g testRG -c testCluster --application-name testApp --service-type-health-policy-map  "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5,5"

必需参数

--application-name --name

指定应用程序名称。

--cluster-name -c

指定群集的名称（如果未指定），则与资源组名称相同。

--resource-group -g

指定资源组名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--application-parameters --parameters

将应用程序参数指定为键/值对。 这些参数必须存在于应用程序清单中。 例如：--application-parameters param1=value1 param2=value2。

--application-type-version --version

指定应用程序类型版本。

--close-duration --instance-close-delay-duration --instance-close-duration

指定持续时间（以秒为单位）以等待无状态实例关闭之前，以允许活动请求正常清空。 当实例在应用程序/群集升级期间关闭时，只有在服务说明中配置了非零延迟持续时间的实例时，这才有效。

--consider-warning-as-error --warning-as-error

指示在运行状况评估期间是否将警告运行状况事件视为错误事件。

接受的值: false, true
默认值: False
--failure-action

指定监视升级失败时要执行的操作。 此参数的可接受值为 Rollback 或 Manual。

接受的值: Manual, Rollback
--force-restart

指示即使升级是仅配置更改，服务主机也会重启。

接受的值: false, true
默认值: False
--hc-retry-timeout --health-check-retry-timeout

指定持续时间（以秒为单位），如果以前的运行状况检查失败，Service Fabric 会重试运行状况检查。

--hc-stable-duration --health-check-stable-duration

指定 Service Fabric 等待的持续时间（以秒为单位）以验证应用程序在移动到下一个升级域或完成升级之前是否稳定。 此等待持续时间可防止在执行运行状况检查后立即检测到运行状况更改。

--hc-wait-duration --health-check-wait-duration

指定 Service Fabric 在升级域完成升级后在执行初始运行状况检查之前等待的持续时间（以秒为单位）。

--max-percent-unhealthy-apps --max-percent-unhealthy-deployed-applications --max-unhealthy-apps

指定在群集中的节点上部署的应用程序实例的最大百分比，这些实例在群集的应用程序运行状况状态出错之前处于运行状况状态。 允许的值为 0 到 100。

--max-percent-unhealthy-partitions --max-unhealthy-parts

指定运行状况策略允许的默认服务类型用于监视升级的每个服务的最大未保留分区百分比。 允许的值为 0 到 100。

--max-percent-unhealthy-replicas --max-unhealthy-reps

指定默认服务类型用于监视升级的默认服务类型的运行状况策略所允许的每个服务的最大不保留副本 (replica)百分比。 允许的值为 0 到 100。

--max-percent-unhealthy-services --max-unhealthy-servs

指定运行状况策略允许用于监视升级的默认服务类型允许的最大未维护服务百分比。 允许的值为 0 到 100。

--recreate-application

确定是否应在更新时重新创建应用程序。 如果 value=true，则不允许使用升级策略参数的其余部分。

接受的值: false, true
默认值: False
--rep-check-timeout --replica-check-timeout --upgrade-replica-set-check-timeout

指定 Service Fabric 等待服务重新配置为安全状态（如果尚未处于安全状态）之前的最长时间（以秒为单位）。

--service-type-health-policy-map --service-type-policy

按以下格式指定用于不同服务类型的运行状况策略映射作为键/值对：“ServiceTypeName”=“MaxPercentUnhealthyPartitionsPerService，MaxPercentUnhealthyReplicasPerPartition，MaxPercentUnhealthyServices”。 例如：--service-type-health-policy-map “ServiceTypeName01”=“5,10,5” “ServiceTypeName02”=“5,5,5”。

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--ud-timeout --upgrade-domain-timeout

指定 Service Fabric 升级单个升级域所需的时间（以秒为单位）。 在此时间段后，升级失败。

--upgrade-mode

指定用于在滚动升级期间监视运行状况的模式。 值为 Monitored 和 UnmonitoredAuto。

接受的值: Monitored, UnmonitoredAuto
--upgrade-timeout

指定 Service Fabric 对整个升级所需的时间（以秒为单位）。 在此时间段后，升级失败。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。