添加非生产管道 configuring-non-production-pipelines
了解如何使用 Cloud Manager 创建和配置非生产管道以部署代码。 如果您首先想了解有关管道在 Cloud Manager 中的工作方式的更具有概念化的概述，请参阅 CI/CD 管道。
概述 overview
通过使用 Cloud Manager 中的 管道 图块，部署管理员可以创建两种不同类型的管道。
- 生产管道 — 生产管道是一个专用管道，它包含一系列精心设计的步骤，可执行这些步骤以将源代码用于生产环境。
- 非生产管道 – 非生产管道主要用于运行代码质量扫描或将源代码部署到开发环境中。
本文档侧重于非生产管道。 有关如何配置生产管道的详细信息，请参阅配置生产管道文档。
有两种类型的非生产管道：
- 代码质量管道 – 这些代码质量管道会扫描 Git 分支中的代码并执行构建和代码质量步骤。
- 部署管道 – 除了执行代码质量管道等构建和代码质量步骤之外，这些管道还将代码部署到非生产环境。
添加新的非生产管道 add-non-production-pipeline
在Cloud Manager UI中设置项目和至少一个环境后，您可以添加非生产管道。 在部署到生产环境之前，使用这些管道测试代码质量。
-
在 my.cloudmanager.adobe.com 中登录 Cloud Manager 并选择适当的组织和项目。
-
从Cloud Manager主屏幕中，打开管道信息卡，单击添加，然后选择添加非生产管道。
-
在 添加非生产管道 对话框的 配置 选项卡上，通过下列任一方式选择要创建的管道类型：
- 代码质量管道 — 创建管道，在不部署到环境的情况下，生成代码、运行单元测试和评估代码质量。
- 部署管道 — 创建用于生成代码、运行单元测试、评估代码质量并部署到环境的管道。
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| 区域 | 选项 | 描述 |
| 管道配置 | 非生产管道名称 | 在 非生产管道名称 字段中输入管道描述。 |
| 正在测试 |
仅在编辑非生产管道时可见。
|
|
| 部署选项 | 部署触发器 |
|
| 重要量度失败行为 |
|
|
| 阶段部署后审批复选框 | 仅在编辑非生产管道时可见。 选择此选项要求在部署到暂存环境后审批，管道才能继续。 如果未选中此选项，则管道将根据配置的行为继续运行。 |
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 | ||
|---|---|---|
| 区域 | 选项 | 描述 |
| 管道配置 | 非生产管道名称 | 在 非生产管道名称 字段中输入管道描述。 |
| 符合条件的部署环境 | 如果您的管道是部署管道，则必须选择Cloud Manager部署代码的环境。 | |
| 正在测试 |
仅在编辑非生产管道时可见。
|
|
| 部署选项 | 部署触发器 |
|
| 重要量度失败行为 |
|
|
| 阶段部署后审批复选框 | 仅在编辑非生产管道时可见。 选择此选项要求在部署到暂存环境后审批，管道才能继续。 如果未选中此选项，则管道将根据配置的行为继续运行。 |
|
| 跳过负载平衡器更改复选框 | 选择此选项可防止管道在部署期间进行负载平衡器更改。 | |
| Dispatcher配置 |
部署管理员角色可以配置一组内容路径，这些路径将在管道运行时失效或从AEM Dispatcher缓存中刷新。 在部署任何内容包之后，Cloud Manager会在部署管道步骤中运行这些缓存操作。 这些设置使用标准的 AEM Dispatcher 行为。 要配置
|
|
| 管道 | 体验审核复选框 | 选择此选项可在管道中包含体验审核步骤。 启用后，该管道会在“Source代码”选项卡之后包含“体验审核”步骤。 |
- 在 添加非生产管道 对话框的右下角，单击继续。
- 选择管道配置为生成和部署的代码类型。
部署完整的AEM应用程序，包括应用程序代码和默认的Web层配置。
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| 区域 | 选项 | 描述 |
| Source代码 | 存储库 | 从下拉列表中，选择管道用作其源的Git存储库。 Cloud Manager从您在此处选择的存储库中生成代码。 |
| Git分支 | 从下拉列表中，选择管道应从中构建的所选存储库的分支。 默认为 main。 管道使用所选分支作为构建和部署的源。 如有必要，请单击 刷新 以更新所选存储库的可用分支列表。 如果最近创建的分支未出现在列表中，请使用此选项。 |
|
| 生成策略 |
|
|
| 忽略Web层配置复选框 | 选择此选项可跳过全栈代码管道中Web层配置的部署。 保持未选中选项以部署Web层配置以及管道代码。 | |
| 管道 | 体验审核复选框 | 选择此选项可在管道中包含体验审核步骤。 启用后，该管道会在“Source代码”选项卡之后包含“体验审核”步骤。 |
仅部署Web层配置，例如用于存储、处理网页并将网页交付给客户端的Dispatcher资产。 当您选择 Web层配置 时，Cloud Manager将创建一个专用于Web层配置部署的管道。
如果全栈管道已存在，Cloud Manager会显示一条通知，指出创建Web层配置管道会导致现有全栈管道忽略Web层配置。 在创建Web层配置管道后，Cloud Manager会通过该管道（而不是全栈管道）管理Web层配置部署。
| table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
|---|---|---|
| 区域 | 选项 | 描述 |
| Source代码 | 存储库 | 从下拉列表中，选择包含Web层配置的Git存储库。 |
| Git分支 | 选择Cloud Manager用于部署的所选存储库中的分支。 如有必要，请单击 刷新 以更新所选存储库的可用分支列表。 如果最近创建的分支未出现在列表中，请使用此选项。 | |
| 代码位置 | 在包含要部署的Web层配置的所选存储库中输入路径。 默认位置是存储库根(/)。 |
- 单击保存。
关于在非生产管道中使用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
该视频概述了本文档中详述的管道创建过程。