Cloud Manager CI/CD 管道 intro-cicd

了解 Cloud Manager 的 CI/CD 管道,以及如何使用它们高效地部署代码。

简介 introduction

Cloud Manager 中的 CI/CD 管道是一种从源存储库构建代码并将其部署到环境中的机制。管道可以由事件触发,例如源代码存储库的拉取请求(即代码更改),也可以按常规计划触发,匹配发布节奏。

要配置管道,必须:

  • 定义将启动管道的触发器。
  • 定义用于控制生产部署的参数。
  • 配置性能测试参数。

Cloud Manager 提供两种类型的管道:

管道类型

生产管道 prod-pipeline

生产管道是一种专门构建的管道,包括一系列协调的步骤,可部署用于生产的源代码。这些步骤包括初次构建、打包、测试、验证和部署到所有暂存环境中。因此,只有在创建了一组生产和暂存环境后,才能添加生产管道。

TIP
有关详细信息,请参阅配置生产管道。

非生产管道 non-prod-pipeline

非生产管道主要用于运行代码质量扫描或将源代码部署到开发环境中。

TIP
有关详细信息,请参阅配置非生产管道。

代码源 code-sources

除了生产和非生产,管道还可以根据其部署的代码类型进行区分。

  • 全栈管道 – 同时部署后端和前端代码构建,其中包含一个或多个 AEM 服务器应用程序以及 HTTPD/Dispatcher 配置。
  • 配置管道 — 快速部署功能配置,如日志转发、清除相关的维护任务,以及各种CDN配置,如流量过滤器规则(包括WAF规则)、请求和响应转换、源选择器、客户端重定向、错误页面、客户管理的CDN密钥、清除API密钥和基本身份验证。
  • 前端管道 – 部署包含一个或多个客户端 UI 应用程序的前端代码版本。
  • Web 层配置管道 – 部署 HTTPD/Dispatcher 配置

这些将在本文档后面详细描述。

了解 Cloud Manager 中的 CI-CD 管道 understand-pipelines

下表总结了Cloud Manager中可用的管道及其用法。

管道类型
部署或代码质量
源代码
用途
注释
生产或非生产
部署
全栈
同时部署后端和前端代码构建以及 HTTPD/Dispatcher 配置
前端代码必须与 AEM 服务器代码同时部署时。
尚未采用前端管道或 Web 层配置管道时。
生产或非生产
部署
前端
部署包含一个或多个客户端 UI 应用程序的前端代码版本
支持多个并存前端管道
比全栈部署快得多
生产或非生产
部署
Web 层配置
部署 HTTPD/Dispatcher 配置
几分钟即可部署
生产或非生产
部署
配置
为与CDN、日志转发和清除维护任务相关的许多功能🔗部署配置
几分钟即可部署
非生产
代码质量
全栈
在不部署的情况下对全栈代码运行代码质量扫描
支持多条管道
非生产
代码质量
前端
在不部署的情况下对前端代码运行代码质量扫描
支持多条管道
非生产
代码质量
Web 层配置
在不部署的情况下对 Dispatcher 配置运行代码质量扫描
支持多条管道

下图说明了 Cloud Manager 的管道配置,包括传统的、单个前端存储库或独立的前端存储库设置。

Cloud Manager 管道配置

全栈管道 full-stack-pipeline

全栈管道将后端代码、前端代码和 Web 层配置同时部署到 AEM 运行时。

  • 后端代码 – 不可变内容,如 Java 代码、OSGi 配置、Repoinit 以及可变内容
  • 前端代码 – 应用程序 UI 资源,如 JavaScript、CSS、字体
  • Web 层配置管道 – HTTPD/Dispatcher 配置

全栈管道表示一个“uber”管道,可以同时完成所有操作,同时使用户可以选择分别通过前端管道和 Web 层配置管道专门部署其前端代码或 Dispatcher 配置。

全栈管道将前端代码 (JavaScript/CSS) 打包为 AEM 客户端库。

如果未配置 Web 层配置管道,则全栈管道可能会部署 Web 层配置。

以下限制适用。

  • 用户必须以​ 部署管理员 ​角色登录,才能配置或运行管道。
  • 在任何时候,每个环境只能有一个全栈管道。

此外,如果您选择引入 Web 层配置管道,请注意全栈管道的行为。

  • 如果存在相应的 Web 层配置管道,则环境的完整堆栈管道将忽略 Dispatcher 配置。
  • 如果环境的相应 Web 层配置管道不存在,则用户可以配置全栈管道,包括或忽略 Dispatcher 配置。

全栈管道可以是代码质量管道或部署。

配置全栈管道 configure-full-stack

要了解如何配置全栈管道,请参阅以下文档:

配置管道 config-deployment-pipeline

通过配置管道,您可以快速部署用于日志转发、清除相关的维护任务和各种CDN配置的配置,例如流量过滤器规则(包括WAF规则)、请求和响应转换、源选择器、客户端重定向、错误页面、客户管理的CDN密钥、清除API密钥和基本身份验证。

请参阅文档使用配置管道,获取受支持功能的完整列表,并了解如何管理存储库中的配置以便正确部署它们。

配置管道 configure-config-deployment

要了解如何配置管道,请参阅以下文档:

前端管道 front-end

前端代码是用作静态文件的任何代码。它独立于 AEM 提供的 UI 代码,可能包括站点主题、客户定义的 SPA、SPA 和其他解决方案。

前端管道通过加速后端开发的前端代码异步部署,帮助您的团队简化设计和开发过程。这个专用管道将 JavaScript 和 CSS 作为主题部署到 AEM 分发层,从而产生一个新的主题版本,可以从 AEM 交付的页面中引用。

NOTE
具有​ 部署管理员 ​角色的用户可以同时创建和运行多个前端管道。
但是,每个程序(所有类型)的最大管道数限制为 300 条。

前端管道可以是代码质量管道或部署管道。

配置前端管道之前 before-start

在配置前端管道之前,请查看AEM 快速网站创建历程,全面了解易于使用的“AEM 快速站点创建”工具的端到端指南。此过程将帮助您简化前端开发,并允许您在不了解后端 AEM 的情况下快速定制站点。

配置前端管道 configure-front-end

要了解如何配置前端管道,请参阅以下内容:

使用前端管道开发站点 developing-with-front-end-pipeline

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

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

Web 层配置管道 web-tier-config-pipelines

Web 层配置管道通过将 HTTPD/Dispatcher 配置与其他代码更改分离,实现了对 AEM 运行时的独占部署。它是一个简化的管道,为只希望部署Dispatcher配置更改的用户提供了加速方法,只需几分钟即可完成部署。

TIP
使用 Web 层配置管道,您可以选择将 Web 配置存储在与全栈管道相同的源位置,或者存储在不同的位置,具体取决于哪个结构更适合您的项目。

以下限制适用。

  • 您必须使用 AEM 版本 2021.12.6151.20211217T120950Z 或更新版本才能使用 Web 层配置管道。
  • 您必须选择启用 Dispatcher 工具的灵活模式才能使用 Web 层配置管道。
  • 用户必须以​ 部署管理员 ​角色登录,才能配置或运行管道。
  • 在任何时候,每个环境只能有一个 Web 层配置管道。
  • 当相应的全栈管道正在运行时,用户无法配置Web层配置管道。
  • Web 层结构必须遵循灵活的模式结构,如文档云中 Dispatcher中所定义。

此外,请注意全栈管道在引入 Web 层管道时的行为。

  • 如果尚未为环境配置 Web 层配置管道,则用户可以在配置其相应的全栈管道时进行选择,以便在执行和部署期间包括或忽略 Dispatcher 配置。
  • 一旦为环境配置了 Web 层配置管道,其相应的全栈管道(如果存在)将在执行和部署期间忽略 Dispatcher 配置。
  • 删除 Web 层配置管道后,其相应的全栈管道会重置为在执行期间部署 Dispatcher 配置。

Web 层配置管道可以是代码质量类型或部署类型。

配置Web层管道 configure-web-tier

要了解如何配置Web层管道,请参阅以下文档:

有关管道类型的视频概述 video

要快速概述管道类型,请观看此短视频。

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab