代码部署 code-deployment
了解如何部署代码以及在部署代码时 Cloud Manager 中会发生什么情况。
使用 Cloud Manager 部署代码 deploying-code-with-cloud-manager
配置生产管道（包括必要的存储库和环境）后，便可以部署代码。
-
单击 Cloud Manager 中的 部署 开始部署过程。
-
此时将显示 管道执行 屏幕。 单击 构建 开始此流程。
构建过程会启动代码部署过程，包括以下步骤：
- 暂存部署
- 暂存测试
- 生产部署
您可以通过查看日志或依据测试标准审查结果，来审查各种部署过程的步骤。
部署步骤 deployment-steps
在部署的每个步骤中都会进行许多操作，本节将会对此进行介绍。 查看部署过程详细信息，了解有关如何在幕后部署代码本身的技术详细信息。
暂存部署步骤 stage-deployment
暂存部署步骤包含以下操作：
暂存测试步骤 stage-testing
暂存测试步骤包含以下操作：
生产部署步骤 production-deployment
生产部署步骤包含以下操作：
-
申请审批
- 配置管道时将启用此选项。
- 利用此选项，您可以计划生产部署，也可以单击 立即 来立即执行生产部署。
-
计划生产部署
- 配置管道时将启用此选项。
- 根据用户的时区指定计划的日期和时间。
-
CSE 支持（如果已启用）
-
部署到生产
部署完成后，代码将位于其目标环境中，并且您可以查看日志。
超时 timeouts
如果继续等待用户反馈，则以下步骤将会超时：
部署过程详细信息 deployment-process
Cloud Manager 将构建过程生成的所有 target/*.zip 文件上传到存储位置。 在管道的部署阶段，将从该位置检索这些工件。
当 Cloud Manager 部署到非生产拓扑时，目标是尽快完成部署，因此，工件将同时部署到所有节点，如下所示：
-
Cloud Manager 确定每个工件是 AEM 还是 Dispatcher 包。
-
Cloud Manager 会从负载平衡器中移除所有 Dispatcher，以在部署期间隔离环境。
- 除非另有配置，否则您可以跳过开发和暂存部署中的负载均衡器更改。 也就是说，对于开发环境，在非生产管道中分离和附加步骤，对于暂存环境，在生产管道中进行分离和附加。
note NOTE 预计 1-1-1 客户将会使用此功能。 -
每个 AEM 工件均通过包管理器 API 部署到每个 AEM 实例，其中包依赖关系将确定部署顺序。
- 要了解有关如何使用包安装新功能、在实例之间传输内容以及备份存储库内容的更多信息， 请参阅包管理器。
note NOTE 所有 AEM 工件都会部署供作者和发布者使用。 在需要特定于节点的配置时，应利用运行模式。 要了解有关运行模式如何允许您针对特定目的调整 AEM 实例的更多信息，请参阅“部署到 AEM as a Cloud Service”文档的“运行模式”部分。 -
Dispatcher 工件将会部署到每个 Dispatcher，如下所示：
- 当前配置已备份并复制到临时位置。
- 已删除所有配置（不可变文件除外）。 有关更多详细信息，请参阅 Dispatcher 配置。 这种方法会清空目录，以确保不会留下孤立文件。
- 工件将提取到
httpd目录。 不会覆盖不可变文件。 在部署时，您对 Git 存储库中不可变文件所做的任何更改都会被忽略。 这些文件是 AMS Dispatcher 框架的核心，因此无法更改。 - Apache 执行配置测试。 如果未发现任何错误，则将重新加载服务。 如果发现错误，则从备份中恢复配置，重新加载服务，并将错误报告回Cloud Manager。
- 管道配置中指定的每个路径都将失效或从 Dispatcher 缓存中进行刷新。
note NOTE Cloud Manager 要求 Dispatcher 工件包含完整文件集。 所有 Dispatcher 配置文件都必须位于 Git 存储库中。 缺少文件或文件夹会导致部署失败。 -
在将所有 AEM 和 Dispatcher 包成功部署到所有节点后，会将 Dispatcher 重新添加到负载平衡器，同时完成部署。
note NOTE 您可以跳过开发和暂存部署中的负载均衡器更改。 也就是说，对于开发环境，在非生产管道中分离和附加步骤，对于暂存环境，在生产管道中进行分离和附加。
部署到生产阶段 deployment-production-phase
部署到生产拓扑的过程略有不同，以尽量减小对 AEM 网站访客产生的影响。
生产部署通常遵循与上述相同的步骤，但它采用的是滚动方式：
- 将 AEM 包部署到作者。
- 从负载平衡器分离 dispatcher1。
- 以并行方式将 AEM 包部署到 publish1，并将 Dispatcher 包部署到 dispatcher1，同时刷新 Dispatcher 缓存。
- 将 dispatcher1 放回负载平衡器中。
- 在将 dispatcher1 重新投入使用后，就会从负载平衡器中分离 dispatcher2。
- 以并行方式将 AEM 包部署到 publish2，并将 Dispatcher 包部署到 dispatcher2，同时刷新 Dispatcher 缓存。
- 将 dispatcher2 放回负载平衡器中。
此过程将持续进行，直到部署到达拓扑中的所有发布者和 Dispatcher 为止。
紧急管道执行模式 emergency-pipeline
在紧急情况下，Adobe Managed Services 客户可能需要立即将代码更改部署到其暂存和生产环境。 此功能使他们能够绕过完整的 Cloud Manager 测试周期。
为了处理这些情况，可以在紧急模式下执行 Cloud Manager 生产管道。 在使用此模式时，不执行安全性测试和性能测试步骤。 所有其他步骤（包括任何已配置的审批步骤）都会像在正常管道执行模式中那样执行。
使用紧急管道执行模式 using-emergency-pipeline
当您启动生产管道执行时，您可以从对话框中选择正常模式或紧急模式。 如果程序激活了紧急管道执行模式功能，则此选项可用。 启用该功能后，此选项可用。
在查看紧急模式下的执行运行的管道执行详细信息页面时，屏幕顶部的痕迹导航会显示一个指示器，指明管道正在紧急模式下执行。
要在紧急模式下执行管道，也可以通过 Cloud Manager API 或 CLI 实现。 要在紧急模式下启动执行，请使用查询参数 ?pipelineExecutionMode=EMERGENCY 或在使用 CLI 时将 PUT 请求提交到管道的执行端点：
$ aio cloudmanager:pipeline:create-execution PIPELINE_ID --emergency
重新执行生产部署 reexecute-deployment
在罕见的情况下，生产部署步骤可能会因短暂的原因而失败。 在这些情况下，只要生产部署步骤已完成，您就可以重新执行它，无论它是成功、遭到取消还是不成功。 使用由以下三个步骤组成的相同管道支持重新执行：
- 验证步骤 - 在正常管道执行期间进行的相同验证。
- 构建步骤 - 在重新执行的上下文中，构建步骤复制工件，但实际上并不执行新的构建过程。
- 生产部署步骤 - 使用与正常管道执行中的生产部署步骤相同的配置和选项。
在此类能够重新执行的情况下，生产管道状态页面在平常的 下载构建日志 选项旁提供 重新执行 选项。
限制 limitations
- 生产部署步骤的重新执行仅适用于上一次执行。
- 重新执行不适用于回滚执行或“推送更新”执行。
- 如果上一次执行在生产部署步骤前的任何时间点失败，则无法重新执行。
重新执行 API reexecute-api
除了在 UI 中可用之外，您还可以使用 Cloud Manager API 触发重新执行以及标识已作为重新执行触发的执行。
触发重新执行 triggering
要触发重新执行，需要对生产部署步骤状态的 HAL 链接 http://ns.adobe.com/adobecloud/rel/pipeline/reExecute 作出 PUT 请求。
- 如果存在此链接，则可以从该步骤重新开始执行。
- 如果此链接不存在，则无法从该步骤重新开始执行。
此链接仅适用于生产部署步骤。
{
"_links": {
"http://ns.adobe.com/adobecloud/rel/pipeline/logs": {
"href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/logs",
"templated": false
},
"http://ns.adobe.com/adobecloud/rel/pipeline/reExecute": {
"href": "/api/program/4/pipeline/1/execution?stepId=2983530",
"templated": false
},
"http://ns.adobe.com/adobecloud/rel/pipeline/metrics": {
"href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/metrics",
"templated": false
},
"self": {
"href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530",
"templated": false
}
},
"id": "6187842",
"stepId": "2983530",
"phaseId": "1575676",
"action": "deploy",
"environment": "weretail-global-b75-prod",
"environmentType": "prod",
"environmentId": "59254",
"startedAt": "2022-01-20T14:47:41.247+0000",
"finishedAt": "2022-01-20T15:06:19.885+0000",
"updatedAt": "2022-01-20T15:06:20.803+0000",
"details": {
},
"status": "FINISHED"
HAL 链接的 href 值的语法只是一个示例，应始终从 HAL 链接读取而不是生成实际值。
向此端点提交 PUT请求会导致出现 201 响应（如果成功）。 响应主体表示的是新的执行。 该功能类似于通过 API 开始常规执行。
识别重新执行的执行 identifying
系统通过触发器字段中的值 RE_EXECUTE 识别重新执行的执行。