使用 Azure Service Fabric CLI (sfctl) 管理 Azure Service Fabric 应用程序

项目
08/12/2024

了解如何创建和删除在 Azure Service Fabric 群集中运行的应用程序。

先决条件

安装 Service Fabric CLI。然后选择 Service Fabric 群集。有关详细信息，请参阅 Service Fabric CLI 入门。
已准备好随时可供部署的 Service Fabric 应用程序包。有关如何创建和打包应用程序的详细信息，请参阅 Service Fabric 应用程序模型。

概述

若要部署新应用程序，请完成以下步骤：

将应用程序包上传到 Service Fabric 映像存储中。
预配应用程序类型。
删除映像存储内容。
指定并创建应用程序。
指定并创建服务。

若要删除现有应用程序，请完成以下步骤：

删除应用程序。
取消预配关联的应用程序类型。

部署新应用程序

要部署新应用程序，请完成以下任务：

将新应用程序包上传到映像存储区

在创建应用程序之前，先将应用程序包上传到 Service Fabric 映像存储。

例如，如果应用程序包在 app_package_dir 目录中，请使用以下命令上传该目录：

sfctl application upload --path ~/app_package_dir

对于大型应用程序包，可以指定 --show-progress 选项来显示上传进度。

预配应用程序类型

完成上传后，预配应用程序。若要预配应用程序，请运行以下命令：

sfctl application provision --application-type-build-path app_package_dir

application-type-build-path 的值是将应用程序包上传到的目录的名称。

删除应用程序包

建议在成功注册应用程序后删除应用程序包。从映像存储区中删除应用程序包可以释放系统资源。保留未使用的应用程序包会占用磁盘存储空间，导致应用程序出现性能问题。

若要从映像存储中删除应用程序包，请使用以下命令：

sfctl store delete --content-path app_package_dir

content-path 必须是创建应用程序时上传的目录的名称。

基于应用程序类型创建应用程序

预配应用程序后，使用以下命令来命名并创建应用程序：

sfctl application create --app-name fabric:/TestApp --app-type TestAppType --app-version 1.0

app-name 是要用于应用程序实例的名称。可以从前面预配的应用程序清单获取其他参数。

应用程序名称必须以 fabric:/ 前缀开头。

为新应用程序创建服务

创建应用程序后，通过该应用程序创建服务。在以下示例中，我们通过自己的应用程序创建新的无状态服务。在前面预配的应用程序包中的服务清单内，定义可通过应用程序创建的服务。

sfctl service create --app-id TestApp --name fabric:/TestApp/TestSvc --service-type TestServiceType \
--stateless --instance-count 1 --singleton-scheme

验证应用程序部署和运行状况

要验证一切运行正常，请使用以下运行状况命令：

sfctl application list
sfctl service list --application-id TestApp

若要验证服务是否正常运行，请使用类似的命令检索服务和应用程序的运行状况：

sfctl application health --application-id TestApp
sfctl service health --service-id TestApp/TestSvc

正常的服务和应用程序的 HealthState 值为 Ok。

删除现有应用程序

要删除应用程序，请完成以下任务：

删除应用程序

若要删除应用程序，请使用以下命令：

sfctl application delete --application-id TestEdApp

取消预配应用程序类型

删除应用程序后，如果不再需要它，可以取消预配应用程序类型。若要取消预配应用程序类型，请使用以下命令：

sfctl application unprovision --application-type-name TestAppType --application-type-version 1.0

类型名称和类型版本必须与前面预配的应用程序清单中的名称和版本匹配。

升级应用程序

创建应用程序后，可重复一组相同的步骤来预配应用程序的第二个版本。然后，可通过 Service Fabric 应用程序升级转换为运行第二个版本的应用程序。有关详细信息，请参阅有关 Service Fabric 应用程序升级的文档。

要执行升级，请首先使用与之前相同的命令预配应用程序的下一个版本：

sfctl application upload --path ~/app_package_dir_2
sfctl application provision --application-type-build-path app_package_dir_2
sfctl store delete --content-path app_package_dir_2

建议随后执行受监视的自动升级，通过运行以下命令启动升级：

sfctl application upgrade --app-id TestApp --app-version 2.0.0 --parameters "{\"test\":\"value\"}" --mode Monitored

升级可通过指定的任何设置覆盖现有参数。如有必要，应用程序参数应作为参数传递到升级命令。应用程序参数应编码为 JSON 对象。

要检索以前指定的任何参数，可使用 sfctl application info 命令。

在应用程序升级过程时，可使用 sfctl application upgrade-status 命令检索状态。

最后，如果正在进行升级但需要取消此次升级，可使用 sfctl application upgrade-rollback 回滚升级。

通过