預設行為（不強制重新部署）

當 force-redeploy 未設定或設定為 false 時，管道僅在目標環境的清單儲存庫中偵測到新變更時才會部署。

1. CD 管道啟動，並將當前提交標記為管道執行 ID。

2. 該管道會從該標籤讀取對應環境分支的內容。

3. 此管道會計算當前提交與標 <target-environment>_latest 籤相關聯的提交之間的部署差異。

4. 該管道評估增量：

   • 若 delta 為空，則管道停止運作且不會進行部署。
   • 若增量包含變更，則管道繼續執行。

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 必須是同一區域與目標環境下已完成部署的識別碼。
• 與 相關的 rollback-change-request-id 部署，其時間不得早於由 rollback-limit 指定的部署次數。

Tekton PIPELINE_NAME 環境屬性決定執行是否為部署或回滾。

• cd-rollback-pipeline：回滾的預設值。
• cd-pipeline 部署的預設值。

您可以使用此屬性自訂分支邏輯。

使用回滾功能的概述 GitOps

使用持續部署管道，透過將變更還原至特定版本的操作 Gitcommit-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. 在您的持續交付工具鏈中觸發手動持續交付管道執行。

內聯回滾概述

此模式會在同一管道執行期間內，將當前部署回滾至先前狀態。 當部署或驗收測試階段發生錯誤或失敗時，導致部署嘗試被標記為失敗，此時即需執行此操作。

若環境 rollback-enabled 屬性設定為 1，且在部署或驗收測試階段發生失敗時，內嵌回滾將自動執行。

若觸發回滾，CD 管道將執行您在 rollback .pipeline-config.yaml 檔案中定義的區段。 若檔案中未定義某 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]