添加生产管道 configuring-production-pipelines
了解如何使用 Cloud Manager 创建和配置生产管道以部署代码。 如果您首先想了解有关管道在 Cloud Manager 中的工作方式的更具有概念化的概述，请参阅 CI/CD 管道。
概述 overview
通过使用 Cloud Manager 中的管道设置图块，您可以创建两种不同类型的管道。
- 生产管道 - 生产管道是一个专用管道，它包含一系列精心设计的步骤，可执行这些步骤以将 Git 存储库中的源代码用于生产环境。
- 非生产管道 - 非生产管道主要用于运行代码质量扫描或将源代码部署到开发环境中。
本文档侧重于生产管道。 有关如何配置非生产管道的详细信息，请参阅配置非生产管道文档。
部署管理员角色负责设置管道。 管道配置包含：
- 定义会启动管道的触发器。
- 定义用于控制生产部署的参数。
- 配置性能测试参数。
添加生产管道 adding-production-pipeline
在使用 Cloud Manager UI 设置项目并具有至少一个环境后，便可以添加生产管道。
-
在 my.cloudmanager.adobe.com 上登录到 Cloud Manager 并选择适当的组织和项目。
-
从 项目概述 页面导航到 管道 信息卡。
-
单击 + 添加，然后选择添加生产管道。
-
这将打开 添加生产管道 对话框，您必须在其中的 配置 选项卡上为管道定义大量选项。 这些选项将分组到多个可折叠的部分中，并且会在以下步骤中进行描述。
-
在 管道名称 字段中提供管道的描述性名称。
-
在 环境 部分下，您可以定义触发部署的内容以及应如何在每个环境中推出部署。
-
在 暂存 部分中，您可以定义管道部署到暂存环境的方式。
-
部署触发器 - 您可以使用以下选项来定义部署触发器以启动管道。
- 手动 - 使用 Cloud Manager UI 手动启动管道。
- 在 Git 发生更改时 – 只要将承诺添加到配置的 Git 分支时就会启动 CI/CD 管道。 利用此选项，您仍能根据需要手动启动管道。
-
重要量度失败行为 - 在管道设置或编辑期间，部署管理员可以选择定义在任何质量审核出现重要失败时的管道行为。 可用的选项为：
- 每次询问 – 默认设置，需要对任何重要失败进行手动干预。
- 立即失败 – 每当发生重要失败时，管道都会被取消。 它是在模拟用户手动拒绝每个失败。
- 立即继续 – 每当发生重要失败时，管道都会自动运行。 它是在模拟用户手动批准每个失败。
-
部署选项 - 您可以加快执行某些部署任务。
-
暂存部署后审批 - 此审批在部署到暂存环境后且执行任何测试前进行。 否则，在生产部署之前进行审批，这将在所有测试完成后执行。
-
跳过负载平衡器更改 - 不进行负载平衡器更改。
-
-
Dispatcher 配置 - 部署管理员角色可以配置一组内容路径，这些路径会在管道运行时失效或从 AEM Dispatcher 缓存中刷新。 在部署任何内容包之后，便会作为部署管道步骤的一部分执行这些缓存操作。 这些设置使用标准的 AEM Dispatcher 行为。 若要进行配置，请进行以下操作：
-
在 路径 下，提供内容路径。
-
在 类型 下，选择要对路径执行的操作。
- 刷新 - 执行缓存删除。
- 使无效 - 执行缓存无效，与将内容从创作实例激活到发布实例时类似。
-
单击 添加路径 以添加指定路径。 可以为每个环境添加最多 100 个路径。
-
note tip TIP 通常，最好是使用失效操作，但在某些情况下可能需要进行刷新，特别是在使用 AEM HTML 客户端库时。 -
-
在 生产 部分中，您可以定义管道部署到生产环境的方式。
-
部署选项 - 您可以定义用于控制生产部署的参数。
-
使用上线审批 – 部署必须由具有业务负责人、项目管理员或 部署管理员 角色的用户通过 Cloud Manager UI 来手动审批。
-
已计划 - 在生产部署前暂停管道以允许对其进行安排。 如果选择此选项，管道会在部署到暂存环境后停止，并提示用户要执行的操作。
Now- 立即部署到生产环境，从而有效地完成管道。- 日期 - 允许用户计划应完成部署的时间。
- 停止执行 - 中止部署到生产环境。
note tip TIP 请参阅代码部署，了解如何设置部署计划或立即执行管道。 -
使用 CSE 监督 - 如果选择此选项，则通过 CSE（客户成功工程师）启动实际部署。 在启用此选项的情况下创建或编辑管道时，部署管理员角色具有以下选项。
- 任何 CSE - 允许任何可用的 CSE 启动部署。
- 我的 CSE - 仅允许分配给客户的特定 CSE 启动部署。 如果分配的 CSE 不可用，该选项也将适用于指定的 CSE 后备人员。
-
-
Dispatcher 配置 - 为您的生产环境定义 Dispatcher 配置。 这些选项与暂存环境的选项相同。
-
-
-
-
单击 继续 进入 Source代码 选项卡，在该选项卡中选择要部署和配置源存储库的代码类型。
-
单击 继续 以进入 暂存测试 选项卡，可以在其中根据已许可的产品来配置 AEM Sites 和 AEM Assets 性能测试。
note tip TIP 请参阅代码质量测试了解有关 阶段测试 选项卡上可用的选项的更多详细信息。 -
在 站点内容传递/分布式负载权重部分中，您可以根据三个页面集之间的页面请求权重来配置网站性能测试。 您可以根据需要启用或禁用页面集。
- 受欢迎实时页面
- 其他实时页面
- 新页面
-
在 Assets 性能测试分发部分中，您可以定义图像和 PDF 的测试分发，并定义您自己的测试资产。
-
图像 - 调整滑块可调整图像和 PDF 之间的测试拆分。
-
PDF - 调整滑块可调整图像和 PDF 之间的测试拆分。
-
通过上传您自己的自定义资产来定义它们。
- 格式 - 选择您的自定义资产是否为 PDF 格式的图像。
- 文件名 - 使用文件浏览器按钮从本地计算机中选择图像。
- 添加测试文件 - 单击以上传您选择的资产。
-
-
-
单击 保存 以完成生产管道添加操作。
全栈代码 full-stack-code
全栈代码管道部署后端和前端代码构建以及HTTPD/Dispatcher配置。
要配置全栈栈代码生产管道：
-
在 Source代码 选项卡上，定义以下选项。
- 存储库 - 定义管道应从中检索代码的 Git 存储库。
note tip TIP 请参阅项目设置文档，了解如何在 Cloud Manager 中添加和管理存储库。 - Git分支 — 定义管道应从中检索代码的分支。
- 忽略 Web 层配置 – 勾选后，该管道不会部署您的 Web 层配置。 如果同一环境已存在某个Web层配置管道，则该复选框将自动选中并禁用，因为Web层配置由该管道管理。 当不存在Web层配置管道时，您可以选择或清除此选项以控制全栈管道是否部署Dispatcher配置。
-
单击 继续 进入 阶段测试 选项卡。 有关详细信息，请参阅暂存测试。
Web 层配置 web-tier-config
Web层配置管道仅部署HTTPD/Dispatcher配置。 有关此管道类型的更多详细信息，请参阅CI/CD管道。
如果您为具有现有全栈管道的环境创建Web层配置管道，则忽略全栈管道中的Web层配置。 此更改仅影响该环境中的Web层配置。
要配置Web层配置生产管道：
-
在 Source代码 选项卡上，定义以下选项。
- 存储库 — 从下拉列表中选择包含Web层配置的Git存储库。
- Git分支 — 选择Cloud Manager用于部署的所选存储库中的分支。
- 代码位置 — 在包含要部署的Web层配置的选定存储库中输入路径。 默认位置是存储库根(
/)。
note NOTE 如果代码位置未指向Dispatcher代码位置，则可能会将其他应用程序代码拉入工件包并部署到Dispatcher，从而导致Apache在重新启动时失败以及管道失败。 确保为存储库中的Dispatcher文件设置正确的路径。 -
单击 继续 进入 阶段测试 选项卡。 有关详细信息，请参阅暂存测试。
关于在生产管道中使用Smart Build about-smart-build
Cloud Manager中的 智能生成 是生产管道的优化生成策略。 Smart Build通过缓存模块并仅重新生成自上次成功运行以来发生更改的模块来缩短构建时间。 未更改的模块从缓存中重用，而只重新构建已修改的模块及其依赖关系，从而提高迭代开发工作流的效率。
Smart Build当前可用于以下内容：
- 代码质量管道。
- 开发、暂存和生产全栈部署管道。
在出现以下情况时，建议使用Smart Build：
- 您正在积极开发和提交频繁的增量更改。
- 您的项目包含多个Maven模块。
- 完整内部版本需要大量时间。
当出现以下情况时，Smart Build并不总是理想的：
- 您的内部版本严重依赖在Maven的依赖关系图之外执行操作的插件。
- 每次执行都需要完全重新生成验证。
了解构建性能 smart-build-performance
使用Smart Build的性能提升取决于以下几个因素：
- 项目中的模块数。
- 代码更改的频率和范围。
- 依赖项在各个模块之间的分布。
通常，具有多个独立模块的项目可以看到最大的改进。
每模块缓存选择退出 smart-build-cache-optout
Smart Build提供细粒度控制，允许您禁用特定模块的缓存。 此功能在以下情况下很有用：
- 使用插件，如
exec-maven-plugin或maven-antrun-plugin。 - 执行Maven依赖项未跟踪的文件操作。
- 缓存时生成不一致的结果。
禁用模块的缓存 smart-build-disable-caching
您可以将以下属性添加到受影响模块的pom.xml：
<properties>
<maven.build.cache.enabled>false</maven.build.cache.enabled>
</properties>
此语法强制模块在每次管道执行时重新生成，而其他模块继续受益于缓存。
使用智能构建时的限制和注意事项 smart-build-limitations
使用Smart Build时，请牢记以下几点：
- Smart Build依赖于Maven依赖关系分析。
- 在依赖关系图之外进行的更改可能不会触发重新生成。
- 某些插件可能与缓存不完全兼容。
- 您可以通过编辑非生产管道随时切换回完整内部版本。
如果遇到意外的生成行为，请考虑禁用特定模块的缓存或暂时将生成策略切换到完整生成。
智能生成问题疑难解答 smart-build-troubleshoot
·验证插件行为（尤其是
exec/antrun插件）。·检查大多数模块是否频繁更改。
·使用 Full Build 进行验证。
请参阅添加生产管道以启用智能生成。
后续步骤 the-next-steps
配置管道后，部署代码。 请参阅 代码部署以了解更多详细信息。
视频教程 video-tutorial-one
该视频概述了本文档中详述的管道创建过程。