设置 Service Fabric 网格 CLI

重要

Azure Service Fabric 网格的预览版已停用。 不允许再通过 Service Fabric 网格 API 进行新的部署。 对现有部署的支持将会持续到 2021 年 4 月 28 日。

有关详细信息,请参阅 Azure Service Fabric 网格预览版停用

Service Fabric 网格命令行界面 (CLI) 是在本地以及 Azure Service Fabric 网格中部署和管理资源所必需的。 设置方式如下。

有三种可以使用的 CLI,下表对它们进行了汇总。

CLI 模块 目标环境 说明
az mesh Azure Service Fabric 网格 主要 CLI,允许针对 Azure Service Fabric 网格环境部署应用程序并管理资源。
sfctl 本地群集 Service Fabric CLI 允许针对本地群集部署和测试 Service Fabric 资源。
Maven CLI 本地群集与 Azure Service Fabric 网格 包围 az meshsfctl 的一个包装器,允许 Java 开发人员使用熟悉的命令行体验进行本地和 Azure 开发。

对于预览版,Azure Service Fabric 网格 CLI 编写为 Azure CLI 的一个扩展。 可以在 Azure Cloud Shell 中安装它,也可以在 Azure CLI 的本地安装中进行安装。

先决条件

  • Azure Cloud Shell 中使用 Bash 环境。

    在新窗口中启动 Cloud Shell

  • 如果需要,请安装 Azure CLI 来运行 CLI 参考命令。

    • 如果使用的是本地安装,请使用 az login 命令登录到 Azure CLI。 若要完成身份验证过程,请遵循终端中显示的步骤。 有关其他登录选项,请参阅登录 Azure CLI

    • 出现提示时,请在首次使用时安装 Azure CLI 扩展。 有关扩展详细信息,请参阅使用 Azure CLI 的扩展

    • 运行 az version 以查找安装的版本和依赖库。 若要升级到最新版本,请运行 az upgrade

  • 本文需要 Azure CLI 版本 2.0.67 或更高版本。 如果使用 Azure Cloud Shell,则最新版本已安装。

安装 Azure Service Fabric 网格 CLI

如果尚未安装,请使用以下命令安装 Azure Service Fabric 网格 CLI 扩展模块:

az extension add --name mesh

如果已安装,请使用以下命令更新现有的 Azure Service Fabric 网格 CLI 模块:

az extension update --name mesh

安装 Service Fabric CLI (sfctl)

根据设置 Service Fabric CLI 的说明进行操作。 sfctl 模块可用于针对本地计算机上的 Service Fabric 群集根据资源模型部署应用程序。

安装 Maven CLI

要想使用 Maven CLI,需要在计算机上安装以下项:

  • Java
  • Maven
  • Git
  • Azure Mesh CLI (az mesh) - 以 Azure Service Fabric 网格作为目标
  • SFCTL (sfctl) - 以本地群集作为目标

适用于 Service Fabric 的 Maven CLI 目前仍为预览版。

若要在 Maven Java 应用中使用 Maven 插件,请将以下代码片段添加到 pom.xml 文件:

<project>
  ...
  <build>
    ...
    <plugins>
      ...
      <plugin>
        <groupId>com.microsoft.azure</groupId>
          <artifactId>azure-sfmesh-maven-plugin</artifactId>
          <version>0.1.0</version>
          <configuration>
            ...
          </configuration>
      </plugin>
    </plugins>
  </build>
</project>

请阅读 Maven CLI 参考部分来了解详细用法。

后续步骤

还可以设置你的 Windows 开发环境

找到常见问题的答案。