配置非生产管道

了解如何配置非生产管道，以便在部署到生产环境之前测试代码的质量。

非生产管道

除了部署到阶段和生产环境的生产管道外，您还可以设置非生产管道来验证代码。

有两种类型的非生产管道：

• 代码质量管道 – 这些代码质量管道将扫描 Git 分支中的代码并执行构建和代码质量步骤。
• 部署管道 – 除了执行代码质量管道等构建和代码质量步骤之外，这些管道还将代码部署到非生产环境。

添加新的非生产管道

在设置项目并具有至少一个使用 Cloud Manager UI 的环境后，便可以执行以下步骤来添加非生产管道。

1. 在 my.cloudmanager.adobe.com 登录 Cloud Manager 并选择适当的组织和程序。

2. 从 Cloud Manager 主屏幕访问​管道​信息卡。 单击​+添加​并选择​添加非生产管道。

   

3. 在​添加非生产管道​对话框的​配置​选项卡上，选择要添加的非生产管道的类型。

   • 代码质量管道 – 创建一个管道来构建您的代码、运行单元测试和评估代码质量但不部署。
   • 部署管道 – 创建一个管道来构建您的代码、运行单元测试、评估代码质量和部署到环境。

   

4. 提供​非生产管道名称，识别您的管道以及以下附加信息。

   • 部署触发器 – 在定义启动管道的部署触发器时，您可以使用以下选项。

     • 手动 – 使用此选项可手动启动管道。
     • 在 Git 发生更改时 – 只要将承诺添加到配置的 Git 分支，此选项就会启动 CI/CD 管道。 利用此选项，您仍能根据需要手动启动管道。

5. 如果您选择创建​部署管道，您还必须定义​重要量度失败行为。

   • 每次询问 – 此行为是默认设置，需要对任何重要失败进行手动干预。
   • 立即失败 – 如果选定此选项，则只要发生重要失败，就会取消管道。它实际上是在模拟用户手动拒绝每个失败。
   • 立即继续 – 如果选定此选项，则每当发生重要失败时，管道就会自动继续。它实际上是在模拟用户手动批准每个失败。

6. 单击​“继续”。

7. 在​添加非生产管道​对话框的​源代码​选项卡上，您必须选择管道应处理的代码类型。

   • 前端代码
   • 全栈代码
   • Web 层配置

根据您选择的​源代码​选项，完成非生产管道创建的步骤有所不同。 按照上面的链接跳到本文档的下一节，完成管道的配置。

前端代码

前端代码管道部署包含一个或多个客户端 UI 应用程序的前端代码版本。 有关此类型管道的详细信息，请参阅 CI/CD 管道文档。

要完成前端代码非生产管道的配置，请执行以下步骤。

1. 在​源代码​选项卡上，必须定义以下选项。

   • 符合条件的部署环境 – 如果您的管道是部署管道，则必须选择应该部署到哪些环境。
   • 存储库 – 此选项定义管道应从中检索代码的 Git 存储库。
   小贴士

   请参阅添加和管理存储库，了解如何在 Cloud Manager 中添加和管理存储库。

   • Git 分支 – 此选项定义管道应从中检索代码的所选存储库的分支。
     • 输入分支名称的前几个字符，以及此字段的自动完成功能。它会找到您可以选择的匹配分支。
   • 代码位置 – 此选项定义管道应从中检索代码的所选存储库分支中的路径。

   

2. 单击“保存”。

管道已保存，您现在可以在程序概述页面的​管道​信息卡上​管理您的管道。

全栈代码

全栈代码管道同时部署后端和前端代码构建，其中包含一个或多个 AEM 服务器应用程序以及 HTTPD/Dispatcher 配置。 有关此类型管道的详细信息，请参阅 CI/CD 管道文档。

要完成全栈代码非生产管道的配置，请执行以下步骤。

1. 在​源代码​选项卡上，必须定义以下选项。

   • 符合条件的部署环境 – 如果您的管道是部署管道，则必须选择应该部署到哪些环境。
   • 存储库 – 此选项定义管道应从中检索代码的 Git 存储库。
   小贴士

   请参阅添加和管理存储库，了解如何在 Cloud Manager 中添加和管理存储库。

   • Git 分支 – 此选项定义管道应从中检索代码的所选存储库的分支。

     • 输入分支名称的前几个字符，以及此字段的自动完成功能。它有助于您找到您可以选择的匹配分支。

   • 忽略 Web 层配置 – 勾选后，该管道不会部署您的 Web 层配置。

   • 管道 – 如果您的管道是部署管道，则可以选择运行测试阶段。检查要在此阶段启用的选项。如果没有选择任何选项，则管道运行期间将不会显示测试阶段。

     • 产品功能测试 – 针对开发环境执行产品功能测试。
     • 自定义功能测试 - 针对开发环境执行自定义功能测试。
     • 自定义 UI 测试 – 为自定义应用程序执行自定义 UI 测试。

   

2. 单击“保存”。

管道已保存，您现在可以在程序概述页面的​管道​信息卡上​管理您的管道。

Web 层配置

Web 层配置管道部署 HTTPD/Dispatcher 配置。 有关此类型管道的详细信息，请参阅 CI/CD 管道。

要完成 Web 层代码非生产管道的配置，请执行以下步骤。

1. 在​源代码​选项卡上，必须定义以下选项。

   • 符合条件的部署环境 – 如果您的管道是部署管道，则必须选择应该部署到哪些环境。
   • 存储库 – 此选项定义管道应从中检索代码的 Git 存储库。
   小贴士

   请参阅添加和管理存储库，了解如何在 Cloud Manager 中添加和管理存储库。

   • Git 分支 – 此选项定义管道应从中检索代码的所选存储库的分支。
   • 代码位置 – 此选项定义管道应从中检索代码的所选存储库分支中的路径。
     • 对于 Web 层配置管道，该路径通常包含 conf.d、conf.dispatcher.d 和 opt-in 目录。
     • 例如，如果项目结构是从 AEM 项目原型生成的，路径将是 /dispatcher/src。

   

2. 单击“保存”。

管道已保存，您现在可以在程序概述页面的​管道​信息卡上​管理您的管道。

使用前端管道开发站点

有了前端管道，前端开发人员可以获得更多的独立性，可加快开发过程。

请参阅文档使用前端管道开发站点，了解此流程的工作方式以及一些需要注意的事项，以便充分发挥此流程的潜力。

跳过 Dispatcher 程序包

如果希望将 Dispatcher 程序包作为管道的一部分构建，但不希望将其发布来构建存储，则可以禁用发布它们，这可能会缩短管道运行持续时间。

必须通过项目 pom.xml 文件，添加以下禁用发布 Dispatcher 程序包的配置。 该配置基于一个环境变量，作为一个标志，您可以在 Cloud Manager 构建容器中设置，定义何时应忽略 Dispatcher 程序包。

<profile>
  <id>only-include-dispatcher-when-it-isnt-ignored</id>
  <activation>
    <property>
      <name>env.IGNORE_DISPATCHER_PACKAGES</name>
      <value>!true</value>
    </property>
  </activation>
  <modules>
    <module>dispatcher</module>
  </modules>
</profile>

Business.Adobe.com 资源