默认行为（不强制重新部署）

当未设置或设置 false 为 force-redeploy 时，管道仅在目标环境的库存存储库中检测到新变更时才会部署。

1. CD管道启动，并用管道运行ID标记当前提交。

2. 管道从该标签读取对应环境分支的内容。

3. 该管道计算当前提交与关联于该 <target-environment>_latest 标签的提交之间的部署差异。

4. 管道评估增量：

   • 如果增量为空，则管道停止运行且不会进行部署。
   • 如果增量包含更改，则管道继续执行。

5. 该管道部署了增量中标识的变更。

6. 部署成功后，管道会将 <target-environment>_latest 标签附加到新提交上。

强制行为（伴随强制重新部署）

当 force-redeploy 设置为 true 时，管道将跳过增量验证，并重新部署完整的库存，无论是否检测到变更。 此方法可确保将完整的应用程序状态重新应用到部署目标。

1. CD管道启动，并用管道运行ID标记当前提交。
2. 管道从该标签读取对应环境分支的内容。
3. 管道计算部署增量，在此场景下通常为空。
4. 该 force-redeploy=true 设置会导致管道跳过增量检查并继续执行。
5. 该管道将整个应用程序状态从分支重新部署。
6. 成功重新部署后，管道会将 标签 <target-environment>_latest 附加到刚刚部署的提交上。

回滚管道概述

此管道允许您通过指定特定 ServiceNow 变更请求ID（例如）回滚至先前已知的 CHG-12345 良好配置。

此变更请求ID作为成功部署的唯一标记，是回滚管道的必填输入项。

您可以通过两种方式查找先前部署的变更请求ID：

• ServiceNow：定位您要恢复的部署的变更请求。
• 库存仓库：由于库存状态由源代码控制管理，每次部署都通过提交进行唯一标识。 您可以找到想要回退的提交，并识别与该提交关联的 CHG-*** 标签。

回滚管道包含以下阶段：

• prod-rollback-start
• prod-setup
• prod-rollback-change-request
• prod-deployment
• prod-acceptance-tests
• prod-rollback-finish

管道运行使用 rollback-change-request-id 环境属性中的信息来创建新的变更请求。

为保持合规性，管道重新开启与先前部署相关的问题。 这些问题已附加到新的变更请求中，其原始截止日期保持不变。 成功的回滚操作将库存中的 标签 _latest 移至上一个提交。

创建回滚管道

使用 触发 cd-rollback-listener 回滚至最后已知良好版本。

1. 前往您的CD管道。
2. 添加手动触发器或复制手动CD触发器。
3. 编辑触发器并将监听器设置为 cd-rollback-listener。
4. 选择保存。
5. 为每个所需区域和目标环境组合创建独立的触发器。

触发回滚管道

回滚管道运行使用以下环境属性：

除非满足以下条件，否则管道终止：

• rollback-change-request-id 必须是同一区域和目标环境下已完成部署的ID。
• 与之 rollback-change-request-id 相关的部署版本号不得早于由回滚限制指定的部署次数。

Tekton PIPELINE_NAME 环境属性决定运行是部署还是回滚。

• cd-rollback-pipeline 回滚的默认值。
• cd-pipeline 部署的默认值。

您可以使用此属性自定义分支逻辑。

使用回滚功能的概述 GitOps

使用持续部署管道，通过执行将更改回滚到 Git 特定版本的操作 commit-id，将库存的先前版本部署到目标环境。

由于您直接在库存库中回滚提交，而非通过变更 ServiceNow 请求ID触发回滚管道，此操作不会自动重新开启之前的合规问题或管理其截止日期。

当触发时，CD管道将执行以下步骤完成重新部署：

• 管道启动并为当前提交（即回退提交）添加管道运行ID标签。
• 管道从该标签读取对应环境分支的内容。
• 该管道计算当前提交与关联于该 <target-environment>_latest 标签的提交之间的部署差异。
• 成功部署后，该 <target-environment>_latest 标签被移至新的（回退）提交。

创建回滚升级拉取请求

1. 在库存中识别出您想要回滚到的部署 commit-id 版本。
2. 将仓库状态回退至该提交。
3. 创建拉取请求以恢复已撤销的状态。

以下示例通过使用命令展示了这种情况 git。

1. 列出提交和标签以查找最后已知良好状态的提交ID（例如 refs/tags/8）

   # /c/usr/devsecops/compliance-inventory (master)
   $ git show-ref --tags
   ...
   83f7a87ee59185eaeac554bd3abeebfd2c1b4ad8 refs/tags/8
   ...
   1914a125e76aa97c497f4bd2c2f455b58cf079b8 refs/tags/prod_latest
   

2. 列出当前状态 (refs/tags/prod_latest) 与目标状态 (refs/tags/8) 之间的所有提交。

   # /c/usr/devsecops/compliance-inventory (master)
   $ git rev-list --no-merges HEAD...83f7a87ee59185eaeac554bd3abeebfd2c1b4ad8
   67cc8babdff3e09c1f0e632f897798c1b5424f38
   6fab5ce3d60590cd858206424ecfd7d3a8c9ceb4
   ...
   

3. 将库存状态回滚至目标提交（refs/tags/8）。

   # /c/usr/devsecops/compliance-inventory (master)
   $ git revert -n $(git rev-list --no-merges HEAD...83f7a87ee59185eaeac554bd3abeebfd2c1b4ad8)
   

4. 提交新状态。

   # /c/usr/devsecops/compliance-inventory (master|REVERTING)
   $ git commit -m "revert master to 83f7a87ee59185eaeac554bd3abeebfd2c1b4ad8"
   [master af82538] revert master to 83f7a87ee59185eaeac554bd3abeebfd2c1b4ad8
   

5. 将更新推送到主分支。

   # /c/usr/devsecops/compliance-inventory (master)
   $ git push --set-upstream origin master
   ...
   To [https://us-south.git.cloud.ibm.com/jaunin.b/compliance-inventory.git](https://us-south.git.cloud.ibm.com/jaunin.b/compliance-inventory.git)
     67cc8ba..af82538  master -> master
   ...
   

触发持续部署管道

1. 为回滚晋升变更创建拉取请求。

2. 审查并合并拉取请求。

3. 在您的持续交付工具链中触发手动CD 管道运行。

内联回滚概述

此模式将在同一管道运行上下文中回滚当前部署。 当部署或验收测试阶段发生错误或故障时，导致部署尝试被标记为失败，则需要执行此操作。

若环境 rollback-enabled 属性设置为 1，且在部署或验收测试阶段发生失败，则内联回滚将自动运行。

如果触发回滚，CD 管道将运行在您的 . rollback``.pipeline-config.yaml yaml 文件中为 segment 定义的操作。 如果文件中未定义某个 rollback 分段，则默认实现将运行并提示您提供回滚脚本。

示例回滚脚本位于 .pipeline-config.yaml：

rollback:
  image: icr.io/continuous-delivery/pipeline/pipeline-base-image:2.74
  script: |
    #!/usr/bin/env bash
    if [[ "$PIPELINE_DEBUG" == 1 ]]; then
      trap env EXIT
      env
      set -x
    fi
    source $WORKSPACE/$PIPELINE_CONFIG_REPO_PATH/scripts/deploy_setup.sh
    source $WORKSPACE/$PIPELINE_CONFIG_REPO_PATH/scripts/rollback.sh

内联回滚期间设置的属性

• rollback-status: 指示回滚步骤的状态。 可能的值为： [notRun, success, failure]
• rollback-exit-code 回滚步骤的退出代码。 如果回滚未执行，则此值为空。
• default-rollback-executed: 若默认实现（即提示输入脚本）已运行，则设置 true 为。 该值默认为空。
• pipeline-execution-status: 指示整体管道运行状态。 可能的值为： [successful_deployment, failed_deployment_failed_rollback, failed_deployment_successful_rollback]