添加生产管道 configure-production-pipeline

了解如何配置生产管道以生成代码并将其部署到生产环境。 生产管道首先将代码部署到暂存环境。 在获得批准后,它会将相同的代码部署到生产环境。

用户必须具有​ 部署管理员 ​角色才能配置生产管道。

NOTE
在发生以下情况之前,无法设置生产管道:
  • 项目随即会创建。
  • Git存储库至少有一个分支。
  • 将创建生产和暂存环境。

在开始部署代码之前,请从Cloud Manager配置管道设置。

NOTE
在初始设置后,您可以编辑管道设置

添加新的生产管道 adding-production-pipeline

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

TIP
在配置前端管道之前,请参阅AEM快速站点创建历程,获取易于使用的AEM快速站点创建工具的端到端指南。 此历程可帮助您简化AEM站点的前端开发,让您无需AEM后端知识即可快速自定义站点。
  1. my.cloudmanager.adobe.com 登录 Cloud Manager 并选择适当的组织。

  2. 在​ 我的程序 ​控制台上,选择该程序。

  3. 从​ 项目概述 ​页面导航到​ 管道 ​卡并单击​ 添加 ​以选择​ 添加生产管道

    在“程序管理员”概述中的“管道”信息卡

  4. 此时会显示​ 添加生产管道 ​对话框。提供​ 管道名称,识别您的管道以及以下选项。单击​ “继续”

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

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

    重要量度失败行为r – 在管道设置或编辑期间,部署管理员 ​可以选择定义在任何质量审核出现重要失败时的管道行为。可用的选项为:

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

    生产管道配置

  5. 在​ Source代码 ​选项卡上,选择管道应处理的代码类型。

有关管道类型的更多信息,请参阅CI/CD管道

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

配置全栈栈代码管道 full-stack-code

全栈代码管道同时部署后端和前端代码构建,其中包含一个或多个AEM服务器应用程序以及HTTPD/Dispatcher配置。

NOTE
如果所选环境已存在全栈代码管道,则会禁用此选择。

要配置全栈栈代码管道:

  1. 在​ Source代码 ​选项卡上,定义以下选项。

    • 存储库 — 定义管道应从中检索代码的Git存储库。
    note tip
    TIP
    请参阅添加和管理存储库,了解如何在Cloud Manager中添加和管理存储库。
    • Git分支 — 定义所选管道应从中检索代码的分支。
      输入分支名称的前几个字符,此字段的自动完成功能将查找匹配的分支以帮助您进行选择。
    • 忽略 Web 层配置 – 勾选后,该管道不会部署您的 Web 层配置。
    • 在部署到生产之前暂停 — 在部署到生产之前暂停管道。
    • 已计划 — 允许用户启用计划的生产部署。

    全栈代码

  2. 单击​ 继续 ​前进到​ 体验审核 ​选项卡,您可以在其中定义应始终包含在体验审核中的路径。

    添加体验审核

  3. 提供要包含在体验审核中的路径。

  4. 单击​ 保存 ​以保存管道。

在管道运行时,会提交为体验审核配置的路径,并根据性能、可访问性、SEO、最佳实践和PWA测试进行评估。 有关详细信息,请参阅了解体验审核结果

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

配置目标部署管道 targeted-deployment

目标部署仅会为AEM应用程序的选定部分部署代码。 在此类部署中,您可以选择​ 包含 ​以下代码类型之一:

  • 配置 — 为AEM环境中的各种功能配置设置。

    • 请参阅使用配置管道以获取支持的配置列表,包括日志转发、清除相关的维护任务和各种CDN配置,并在存储库中管理这些配置以便正确部署它们。
    • 运行目标部署管道时,将部署配置,前提是这些配置已保存到管道中定义的环境、存储库和分支。
    • 在任何时候,每个环境只能有一个配置管道。
  • 前端代码 — 为AEM应用程序的前端配置JavaScript和CSS。

    • 有了前端管道,前端开发人员可以获得更多的独立性,可加快开发过程。
    • 请参阅文档使用前端管道开发站点,了解此流程的工作方式以及一些需要注意的事项,以便充分发挥此流程的潜力。
  • Web层配置 — 配置Dispatcher属性,以存储、处理网页并将网页交付给客户端。

    • 有关更多详细信息,请参阅文档CI/CD管道
    • 如果所选环境存在 Web 层代码管道,则会禁用此选择。
    • 如果您为具有现有全栈管道的环境创建Web层配置管道,则忽略全栈管道中的Web层配置。 此更改仅影响该环境中的Web层配置。
NOTE
专用存储库不支持 Web 层和配置管道。有关详细信息和完整的限制列表,请参阅在Cloud Manager中添加专用存储库

要配置目标部署管道:

  1. 选择所需的部署类型。

目标部署选项

  1. 定义​ 符合条件的部署环境

    • 如果您的管道是部署管道,则必须选择它应该部署到哪些环境。
  2. 在​ Source代码 ​下,定义以下选项:

    • 存储库 – 此选项定义管道应从中检索代码的 Git 存储库。
    note tip
    TIP
    请参阅添加和管理存储库,了解如何在 Cloud Manager 中添加和管理存储库。
    • Git 分支 – 此选项定义管道应从中检索代码的所选存储库的分支。
      • 输入分支名称的前几个字符,以及此字段的自动完成功能。它会找到您可以选择的匹配分支。
    • 代码位置 – 此选项定义管道应从中检索代码的所选存储库分支中的路径。
    • 部署到生产之前暂停 – 此选项在部署到生产之前暂停管道。
    • 已计划 — 允许用户启用计划的生产部署。 仅适用于Web层目标部署。

    配置管道

  3. 单击“保存”。

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

跳过Dispatcher包 skip-dispatcher-packages

要在管道中构建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>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab