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

将 VMware Tanzu 应用程序加速器与 Azure Spring Apps 企业计划配合使用

注意

Azure Spring Apps 是 Azure Spring Cloud 服务的新名称。 虽然该服务有新名称，但一些地方仍会使用旧名称，我们仍在更新屏幕截图、视频和图形等资产。

本文适用于：❌ 基本版/标准版 ✔️ 企业版

本文介绍如何将 VMware Tanzu 应用程序加速器（应用加速器）与 Azure Spring Apps 企业计划配合使用，以可发现且可重复的方式启动应用程序开发。

应用加速器可帮助你启动应用程序开发并以可发现且可重复的方式部署应用程序。 你可以使用应用加速器基于已发布的加速器项目创建新项目。 有关详细信息，请参阅 VMware 文档中的 VMware Tanzu 应用程序加速器。

先决条件

• Azure 订阅。 如果没有 Azure 订阅，请在开始之前创建一个免费帐户。

• 了解并满足 Azure 市场中的企业计划的要求部分列出的要求。

• 带有 Azure Spring Apps 扩展的 Azure CLI。 使用以下命令删除以前的版本，并安装最新的扩展。 如果以前安装了 spring-cloud 扩展，请卸载它以避免配置和版本不匹配。

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

• 若要在 VS Code 中使用应用加速器，还需要满足以下先决条件：

  • Visual Studio Code
  • Visual Studio Code 的 Azure Spring Apps 扩展

启用应用加速器

预配 Azure Spring Apps 企业计划实例时，可以启用应用加速器。 如果你已有 Azure Spring Apps 企业计划资源，请参阅管理现有企业计划实例中的应用加速器部分，以了解如何启用它。

可以使用 Azure 门户或 Azure CLI 启用应用加速器。

Azure 门户

请按照以下步骤使用 Azure 门户启用应用加速器：

1. 打开 Azure 门户。

2. 在“基本信息”选项卡上的“定价”部分，选择“企业层”并指定所需信息。 然后选择“下一步: VMware Tanzu 设置”。

3. 在“VMware Tanzu 设置”选项卡上，选择“启用应用加速器”。

   

4. 指定其他设置，然后选择“查看并创建”。

5. 在“查看并创建”选项卡上，确保“启用应用加速器”和“启用开发工具门户”设置为“是”。 选择“创建”以创建企业计划实例。

Azure CLI

按照以下步骤使用 Azure CLI 预配启用了应用加速器的 Azure Spring Apps 服务实例。

1. 使用以下命令登录到 Azure CLI 并选择活动订阅：

   az login
   az account list --output table
   az account set --subscription <subscription-ID>
   

2. 使用以下命令接受 Azure Spring Apps 企业计划的法律条款和隐私声明。 仅当订阅从未用于创建企业计划实例时，才需要执行此步骤。

   az provider register --namespace Microsoft.SaaS
   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

3. 选择一个位置。 此位置必须支持 Azure Spring Apps 企业计划。 有关详细信息，请参阅 Azure Spring Apps 常见问题解答。

4. 使用以下命令来创建资源组：

   az group create \
       --name <resource-group-name> \
       --location <location>
   

   有关资源组的详细信息，请参阅什么是 Azure 资源管理器？

5. 准备 Azure Spring Apps 服务实例的名称。 该名称必须为 4 到 32 个字符，只能包含小写字母、数字及连字符。 服务名称的第一个字符必须是字母，最后一个字符必须是字母或数字。

6. 使用以下命令创建已启用应用加速器的 Azure Spring Apps 服务实例：

   az spring create \
       --resource-group <resource-group-name> \
       --name <Azure-Spring-Apps-service-instance-name> \
       --sku enterprise \
       --enable-application-accelerator
   

监视应用加速器

使用应用程序加速器，你可以从 Git 存储库中的文件生成新项目。 下表介绍了应用程序加速器的组件：

构成名称	实例计数	每个实例的 vCPU 数	每个实例的内存	说明
accelerator-server	2	0.4 core	0.5Gi	提供开发工具门户使用的 API 来列出可用的加速器和选项。
accelerator-engine	1	1 个内核	3Gi	处理输入值和文件（从 Git 存储库的快照中拉取）并应用动态转换来生成项目。
accelerator-controller	1	0.2 core	0.25Gi	协调应用程序加速器资源。
source-controller	1	0.2 core	0.25Gi	注册控制器以协调应用程序加速器使用的 ImageRepositories 和 MavenArtifacts 资源。
flux-source-controller	1	0.2 core	0.25Gi	注册控制器以协调应用程序加速器使用的 GithubRepository 资源。 支持管理应用程序加速器的 Git 存储库源。

你可以使用 Azure 门户和 Azure CLI 查看所有组件的运行实例和资源使用情况。

Azure 门户

你可以在 Azure 门户的“开发人员工具”页上查看应用程序加速器的状态，如以下屏幕截图所示：

Azure CLI

在 Azure CLI 中使用以下命令查看应用程序加速器。

az spring application-accelerator show \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

配置开发人员工具以访问应用程序加速器

若要访问应用程序加速器，必须配置 Tanzu 开发人员工具。 有关详细信息，请参阅在 Azure Spring Apps 企业计划中配置 Tanzu 开发人员工具。

使用应用程序加速器启动新项目

若要使用应用程序加速器启动新项目，必须获取管理加速器的权限。 然后，你可以管理预定义的加速器或自己的加速器。

获取管理加速器的权限

管理加速器需要以下权限：

• 读取：获取 Azure Spring Apps 预定义加速器
• 其他：禁用 Azure Spring Apps 预定义加速器
• 其他：启用 Azure Spring Apps 预定义加速器
• 写入：创建或更新 Microsoft Azure Spring Apps 自定义加速器
• 读取：获取 Azure Spring Apps 自定义加速器

有关详细信息，请参阅如何在 Azure Spring Apps 中使用权限。

管理预定义加速器

若要启动新项目，可以从多个预定义加速器开始。 可以根据自己的偏好禁用或启用内置加速器。

可以使用 Azure 门户或 Azure CLI 管理预定义加速器。

Azure 门户

可以在 Azure 门户的“加速器”选项卡上查看内置加速器，如以下屏幕截图所示：

Azure CLI

在 Azure CLI 中使用以下命令查看内置加速器列表：

az spring application-accelerator predefined-accelerator list \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

使用以下命令禁用内置预定义加速器：

az spring application-accelerator predefined-accelerator disable \
    --name <predefined-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

使用以下命令启用内置预定义加速器：

az spring application-accelerator predefined-accelerator enable \
    --name <predefined-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

管理自己的加速器

除了使用预定义加速器之外，你还可以创建自己的加速器。 可以使用 Azure Devops、GitHub、GitLab 或 BitBucket 中的任何 Git 存储库。

使用以下步骤创建和维护你自己的加速器：

首先，在 Git 存储库的根目录中创建一个名为 accelerator.yaml 的文件。

你可以使用 accelerator.yaml 文件来声明用户使用 UI 中的窗体填写的输入选项。 这些选项值控制模板引擎在返回压缩的输出文件之前的处理。 如果你不包含 accelerator.yaml 文件，存储库仍可用作加速器，但文件会未经修改地传递给用户。 有关详细信息，请参阅创建 accelerator.yaml 文件。

接下来，发布新加速器。

创建 accelerator.yaml 文件后，可以创建加速器。 然后，你可以在 Azure 门户中查看它，也可以在开发人员工具门户的“应用程序加速器”页中查看它。 可以使用 Azure 门户或 Azure CLI 发布新加速器。

Azure 门户

若要创建自己的加速器，请打开“加速器”部分，然后选择“自定义加速器”部分下的“添加加速器”。

Azure CLI

使用以下命令在 Azure CLI 中创建自己的加速器：

az spring application-accelerator customized-accelerator create \
    --name <customized-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name> \
    --display-name <display-name> \
    --git-url <git-repo-url> \
   [--description <description>] \
   [--icon-url <icon-url>] \
   [--accelerator-tags <tags-on-accelerator>] \
   [--git-interval <git-repository-refresh-interval-in-seconds>] \
   [--git-branch <git-branch-name>] \
   [--git-commit <git-commit-ID>] \
   [--git-tag <git-tag>] \
   [--ca-cert-name <ca-cert-name>] \
   [--username] \
   [--password] \
   [--private-key] \
   [--host-key] \
   [--host-key-algorithm]

下表介绍了可自定义加速器字段。

Portal	CLI	说明	必需/可选
Name	name	加速器的独一无二的名称。 名称在创建后无法更改。	必须
描述	display-name	加速器的较长说明。	可选
图标 URL	icon-url	表示 UI 中加速器的图像的 URL。	可选
标记	accelerator-tags	一个字符串数组，定义可在 UI 搜索中使用的加速器属性。	可选
Git URL	git-url	加速器源 Git 存储库的存储库 URL。 此 URL 可以是 HTTP/S 或 SSH 地址。 SSH 地址不支持类似 scp 的语法（例如 user@example.com:repository.git）， 而只支持有效的 URL 格式 ssh://user@example.com:22/repository.git。	必须
Git 间隔	git-interval-in-seconds	检查存储库更新的间隔。 如果未指定，则间隔默认为 10 分钟。 在加速器出现在 UI 中之前，还有一个刷新间隔（当前为 10 秒）。 更改反映在 UI 中之前可能会有 10 秒的延迟。	可选
Git 分支	git-branch	用于签出和监视更改的 Git 分支。 你应该仅指定 Git 分支、Git 提交或 Git 标记。	可选
Git 提交	git-commit	要签出的 Git 提交 SHA。你应该仅指定 Git 分支、Git 提交或 Git 标记。	可选
Git 标记	git-tag	要签出的 Git 提交标记。你应该仅指定 Git 分支、Git 提交或 Git 标记。	可选
Git 子路径	git-sub-path	Git 存储库内的文件夹路径，会被视为加速器或片段的根。	可选
身份验证类型	N/A	加速器源存储库的身份验证类型。 类型可以是 Public、Basic auth 或 SSH。	必须
用户名	username	用于访问身份验证类型为 Basic auth 的加速器源存储库的用户名。	当身份验证类型为 Basic auth 时是必需的。
密码/个人访问令牌	password	用于访问身份验证类型为 Basic auth 的加速器源存储库的密码。	当身份验证类型为 Basic auth 时是必需的。
私钥	private-key	用于访问身份验证类型为 SSH 的加速器源存储库的私钥。 仅支持 OpenSSH 私钥。	当身份验证类型为 SSH 时是必需的。
主机密钥	host-key	用于访问身份验证类型为 SSH 的加速器源存储库的主机密钥。	当身份验证类型为 SSH 时是必需的。
主机密钥算法	host-key-algorithm	用于访问身份验证类型为 SSH 的加速器源存储库的主机密钥算法。 可以是 ecdsa-sha2-nistp256 或 ssh-rsa。	当身份验证类型为 SSH 时是必需的。
CA 证书名称	ca-cert-name	用于通过身份验证类型为 Public 或 Basic auth 的自签名证书访问加速器源存储库的 CA 证书名称。	当自签名证书用于 Git 存储库 URL 时是必需的。
类型	type	自定义加速器的类型。 类型可以是 Accelerator 或 Fragment。 默认值为 Accelerator。	可选

若要查看所有已发布的加速器，请参阅“开发人员工具”页的“应用加速器”部分。 选择应用加速器 URL 以查看开发人员工具门户中的已发布加速器：

若要查看新发布的加速器，请刷新开发人员工具门户。

注意

开发人员工具门户可能需要几秒钟的时间来刷新目录并为新加速器添加条目。 创建加速器时，刷新间隔配置为 git-interval。 更改加速器后，所做的更改还需要一段时间才能反映在开发人员工具门户中。 最佳做法是在将更改应用到 Git 存储库后更改 git-interval 以加快验证速度。

引用你自己的加速器中的片段

随着新加速器的添加，编写和维护加速器的工作可能会变得重复且冗长。 有些人通过复制现有项目并对其进行修改来创建新项目，但此过程可能很乏味且容易出错。 为了让用户更轻松地创建和维护加速器，应用程序加速器支持一项名为“组合”的功能，该功能允许重复使用加速器的部件（称为“片段”）。

通过以下步骤引用加速器中的片段：

1. 使用 Azure 门户或 Azure CLI 发布类型为“Fragment”的新加速器。

   Azure 门户

   若要创建片段加速器，请打开“加速器”部分，选择“自定义加速器”部分下的“添加加速器”，然后下选择“片段”。

   

   Azure CLI

   使用以下命令创建类型为“Fragment”的自定义加速器：

   az spring application-accelerator customized-accelerator create \
       --resource-group <resource-group-name> \
       --service <service-instance-name> \
       --name <fragment-accelerator-name> \
       --display-name <display-name> \
       --type Fragment \
       [--git-sub-path <sub project path>] \
       --git-url <git-repo-URL>
   

2. 更改加速器项目中的 accelerator.yaml 文件。 使用 accelerator 部分中的 imports 指令和 engine 部分中的 InvokeFragment 指令来引用加速器中的片段，如以下示例所示：

   accelerator:
       ...
     # options for the UI
     options:
       ...
     imports:
     - name: <fragment-accelerator-name>
     ...
   
   engine:
     chain:
       ...
     - merge:
       - include: [ "**" ]
       - type: InvokeFragment
         reference: <fragment-accelerator-name>
   

3. 将更改与开发人员工具门户同步。

   为了更快地在开发人员工具门户上反映所做的更改，你可以为自定义加速器的“Git 间隔”字段提供一个值。 “Git 间隔”值表示系统检查 Git 存储库中的更新的频率。

4. 使用 Azure 门户或 Azure CLI 将更改与 Azure 门户上的自定义加速器同步。

   Azure 门户

   以下列表显示了同步更改的两种方法：

   • 创建或更新自定义加速器。
   • 打开“加速器”部分，然后选择“同步证书”。

   Azure CLI

   使用以下命令同步加速器的更改：

   az spring application-accelerator customized-accelerator sync-cert \
       --name <customized-accelerator-name> \
       --service <service-instance-name> \
       --resource-group <resource-group-name>
   

有关详细信息，请参阅 VMware 文档中的使用应用程序加速器中的片段。

使用加速器启动新项目

通过以下步骤使用加速器启动新项目：

1. 在“开发人员工具”页上，选择应用加速器 URL 以打开开发人员工具门户。

   

2. 在“开发人员工具门户”上，选择一个加速器。

3. 在“生成加速器”页的“配置加速器”部分指定输入选项。

   

4. 选择“浏览文件”以查看项目结构和源代码。

   

5. 选择“查看并生成”以查看指定的参数，然后选择“生成加速器”。

   

6. 然后，你可以以 zip 文件的形式查看或下载项目。

   

使用自签名证书配置加速器

设置专用 Git 存储库并使用自签名证书启用 HTTPS 时，应该为加速器配置 CA 证书名称，以实现从加速器到 Git 存储库的客户端证书验证。

通过以下步骤使用自签名证书配置加速器：

1. 将证书导入 Azure Spring Apps。 有关详细信息，请参阅在 Azure Spring Apps 的应用程序中使用 TLS/SSL 证书的导入证书部分。
2. 使用 Azure 门户或 Azure CLI 为加速器配置证书。

Azure 门户

若要为加速器配置证书，请打开“加速器”部分，然后选择“自定义加速器”部分下的“添加加速器”。 然后从下拉列表中选择证书。

Azure CLI

使用以下命令为加速器配置证书：

az spring application-accelerator customized-accelerator create \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <customized-accelerator-name> \
    --git-url <git-repo-URL> \
    --ca-cert-name <ca-cert-name>

轮换证书

证书过期后，需要使用以下步骤轮换 Spring Cloud Apps 中的证书：

1. 从受信任的 CA 生成新证书。
2. 将证书导入 Azure Spring Apps。 有关详细信息，请参阅在 Azure Spring Apps 的应用程序中使用 TLS/SSL 证书的导入证书部分。
3. 使用 Azure 门户或 Azure CLI 同步证书。

加速器不会自动使用最新的证书。 应使用 Azure 门户或 Azure CLI 同步一个或多个证书。

Azure 门户

若要同步所有加速器的证书，请打开“加速器”部分，然后选择“同步证书”，如以下屏幕截图所示：

若要同步单个加速器的证书，请打开“加速器”部分，然后从加速器的上下文菜单中选择“同步证书”，如以下屏幕截图所示：

Azure CLI

使用以下命令同步加速器的证书：

az spring application-accelerator customized-accelerator sync-cert \
    --name <customized-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

在现有企业计划实例中管理应用加速器

可以使用 Azure 门户或 Azure CLI，在现有的 Azure Spring Apps 企业计划实例下启用应用加速器。

Azure 门户

如果开发人员工具公共终结点已公开，你可以启用应用加速器，然后按 Ctrl+F5 来停用浏览器缓存，以便在开发人员工具门户上查看它。

按照以下步骤使用 Azure 门户，在现有的 Azure Spring Apps 企业计划实例下启用应用加速器：

1. 导航到服务资源，然后选择“开发人员工具”。

2. 选择“管理工具”。

3. 选择“启用应用加速器”，然后选择“应用”。

   

可以在“开发人员工具”页上查看应用加速器是已启用还是已禁用。

Azure CLI

使用以下命令通过 Azure CLI 为 Azure Spring Apps 服务实例启用应用加速器：

az spring application-accelerator create \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

使用以下命令为 Azure Spring Apps 服务实例禁用应用加速器：

az spring application-accelerator delete \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

若要访问开发人员工具门户，请确保它已通过分配的公共终结点启用。 使用以下命令启用开发人员工具门户：

az spring dev-tool create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --assign-endpoint

在 VS Code 中使用应用加速器

可以直接从 VS Code 的 Azure Spring Apps 企业计划服务实例中的应用加速器的任何加速器来启动项目。

查看应用加速器列表

使用以下步骤查看 Azure Spring Apps 企业计划服务实例中的应用加速器列表：

1. 在 Visual Studio Code 中，打开 Azure Spring Apps 扩展，然后登录到 Azure 帐户。

2. 展开所需的服务实例，然后右键单击以选择该服务实例。

3. 从菜单中选择“打开应用程序加速器”，以打开应用加速器列表。 系统会提示你安装 Tanzu 应用程序加速器 Visual Studio Code 扩展（如果尚未安装）。

   

4. 选择用于启动项目的任何加速器。

   

注意

使用此扩展时，如果遇到任何无法解决的问题，请将你的帐户从此扩展中退出登录。

排查应用加速器问题

如果你尝试为尚未启用应用加速器或尚未公开公共终结点的服务实例打开应用加速器，则会看到以下错误消息：Application Accelerator of Spring Apps <instance-name> is not enabled or publically accessible。

若要启用应用加速器并公开公共终结点，请使用以下步骤。 有关详细信息，请参阅在现有企业计划实例中管理应用加速器部分。

1. 如果你在开发人员工具门户中启用了单一登录，则会在访问扩展时看到以下消息：The extension 'Tanzu App Accelerator' wants to sign in using VMware Tanzu.有关详细信息，请参阅在 Azure Spring Apps 企业计划中配置 Tanzu 开发人员工具中的配置开发人员工具门户部分。

2. 依次选择“允许”、“打开”、“打开”以打开 VS Code 扩展列表。

   

有时候，你可能会收到类似于以下示例的错误消息：AADSTS50011: The redirect URI 'vscode://VMware.tanzu-app-accelerator' specified in the request does not match the redirect URIs configured for the application 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'. Make sure the redirect URI sent in the request matches one added to your application in the Azure portal. Navigate to https://aka.ms/redirectUriMismatchError to learn more about how to fix this.

若要解决此问题，请将重定向 URI vscode://VMware.tanzu-app-accelerator 添加到相关的标识提供者 (IdP)。 在 Microsoft Entra ID 中，转到“身份验证”菜单，然后将重定向 URI 添加到平台配置中的移动和桌面应用程序。

后续步骤

• Azure Spring Apps