程式碼部署 code-deployment

了解如何部署您的程式碼以及部署時 Cloud Manager 中會發生什麼情況。

使用 Cloud Manager 部署程式碼 deploying-code-with-cloud-manager

設定好生產管道 (包括必要的存放庫和環境) 後，您就可以準備部署程式碼了。

建置流程會啟動程式碼部署流程，包括以下步驟：

您可以透過檢視紀錄或檢閱測試標準的結果來查看各種部署流程的步驟。

部署步驟 deployment-steps

在部署的每個步驟中都會發生許多操作，本節將對此進行說明。如需有關如何在幕後部署程式碼本身的技術細節，請參閱部署流程詳細資訊一節。

中繼部署步驟 stage-deployment

此​ 中繼部署 ​步驟包括下列操作：

中繼測試步驟 stage-testing

此​ 中繼測試 ​步驟包括下列操作：

生產部署步驟 production-deployment

此​ 生產部署 ​步驟包括下列操作：

部署完成後，您的程式碼將在其目標環境中，而且您可以檢視紀錄。

逾時 timeouts

如果等候使用者回饋意見，以下步驟將逾時：

部署流程詳細資訊 deployment-process

Cloud Manager 會將建置流程產生的所有 target/*.zip 檔案上傳到儲存位置。這些成品是在管道的部署階段從該位置擷取的。

當 Cloud Manager 部署到非生產拓撲時，目標是盡快完成部署，因此會將成品同時部署到所有節點，如下所示：

部署至生產階段 deployment-production-phase

為了對 AEM 網站訪客的影響降至最低，部署到生產拓撲的流程會略有不同。

生產部署通常會遵循和上述相同的步驟，但採用滾動方式：

本流程會一直持續到部署已經觸及拓撲中的所有發佈者和 Dispatcher 為止。

緊急管道執行模式 emergency-pipeline

在危急情況下，Adobe Managed Services 客戶可能需要將程式碼變更部署到他們的中繼和生產環境，而無需等候完整的 Cloud Manager 測試週期再執行。

為了解決這些情況，可在緊急模式下執行 Cloud Manager 生產管道。使用此模式時，不執行安全性和效能測試步驟。所有其他步驟 (包括任何已設定的核准步驟) 都會按照正常管道執行模式執行。

使用緊急管道執行模式 using-emergency-pipeline

啟動生產管道執行時，如果已經為該方案啟動緊急管道執行模式功能，您可以從對話框中以正常模式或緊急模式啟動執行。

以緊急模式檢視管道執行詳細資訊頁面以進行執行時，畫面最上方的階層連結會顯示指示器，表示管道正以緊急模式執行。

以緊急模式執行管道也能透過 Cloud Manager API 或 CLI 完成。若要以緊急模式開始執行，請使用查詢參數 ?pipelineExecutionMode=EMERGENCY 向管道的執行端點提交 PUT 請求，或者在使用 CLI 時：

$ 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

重新執行的執行可以透過 trigger 欄位中的值 RE_EXECUTE 來識別。