新增非生產管道 configuring-non-production-pipelines
了解如何使用 Cloud Manager 建立和設定非生產管道以部署程式碼。 如果您想先了解有關在 Cloud Manager 中管道如何運作的更多概念性概觀，請參閱CI/CD 管道。
概觀 overview
使用 管道 圖磚 (在 Cloud Manager 中)，部署管理員可建立兩個不同類型的管道。
- 生產管道 — 生產管道是一個專門建置的管道，由一系列精心安排的步驟組成，以將原始程式碼一路帶入生產環境。
- 非生產管道 - 非生產管道主要用於執行程式碼品質掃描或將原始程式碼部署到開發環境中。
本文件會專注於非生產管道。 如需有關如何設定生產管道的詳細資訊，請參閱文件設定生產管道。
有兩種類型的非生產管道：
- 程式碼品質管道 - 這些管道會對 Git 分支中的程式碼執行程式碼品質掃描，並執行建置和程式碼品質步驟。
- 部署管道 - 除了執行程式碼品質管道之類的建置和程式碼品質步驟，這些管道還會將程式碼部署到非生產環境。
新增一個全新非生產管道 add-non-production-pipeline
在Cloud Manager UI中設定方案和至少一個環境後，您可以新增非生產管道。 在部署到生產環境之前，使用這些管道來測試計畫碼品質。
-
在 my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織和方案。
-
從Cloud Manager主畫面中，開啟管道卡並按一下新增，然後選取新增非生產管道。
-
在 新增非生產管道 對話方塊的 組態 索引標籤上，選取您要建立的管道型別（下列其中一項）：
- 程式碼品質管道 — 建立管道，在不部署至環境的情況下，建置程式碼、執行單元測試和評估程式碼品質。
- 部署管道 — 建立管道，用於建置程式碼、執行單元測試、評估程式碼品質，以及部署到環境。
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| 章節 | 選項 | 說明 |
| 管道設定 | 非生產管道名稱 | 在 非生產管道名稱 欄位中輸入管道的說明。 |
| 正在測試 |
只有在編輯非生產管道時才可見。
|
|
| 部署選項 | 部署觸發程式 |
|
| 重要量度失敗行為 |
|
|
| 中繼部署後核准核取方塊 | 只有在編輯非生產管道時才可見。 選取此選項要求在部署到中繼環境後，管道才能繼續。 如果未選取此選項，則管道會根據設定的行為繼續。 |
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 | ||
|---|---|---|
| 章節 | 選項 | 說明 |
| 管道設定 | 非生產管道名稱 | 在 非生產管道名稱 欄位中輸入管道的說明。 |
| 符合資格的部署環境 | 如果您的管道是部署管道，您必須選擇Cloud Manager部署計畫碼的環境。 | |
| 正在測試 |
只有在編輯非生產管道時才可見。
|
|
| 部署選項 | 部署觸發程式 |
|
| 重要量度失敗行為 |
|
|
| 中繼部署後核准核取方塊 | 只有在編輯非生產管道時才可見。 選取此選項要求在部署到中繼環境後，管道才能繼續。 如果未選取此選項，則管道會根據設定的行為繼續。 |
|
| 略過負載平衡器變更核取方塊 | 選取此選項可防止管道在部署期間進行負載平衡器變更。 | |
| Dispatcher設定 |
部署管理員角色可設定在執行管道時失效或從AEM Dispatcher快取中排清的一組內容路徑。 在部署任何內容套件後，Cloud Manager會在部署管道步驟中執行這些快取動作。 這些設定使用標準的 AEM Dispatcher 行為。 若要設定
|
|
| 管道 | 體驗稽核核取方塊 | 選取此選項可在管道中包含體驗稽核步驟。 啟用後，管道會在Source程式碼索引標籤之後包含體驗稽核步驟。 |
- 在 新增非生產管道 對話方塊的右下角，按一下繼續。
- 選取管道設定為建置和部署的程式碼型別。
部署完整的AEM應用程式，包括應用程式程式碼，以及依預設的Web層設定。
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| 章節 | 選項 | 說明 |
| Source代碼 | 存放庫 | 從下拉式清單中，選擇管道用作其來源的Git存放庫。 Cloud Manager會從您在此選擇的存放庫建置程式碼。 |
| Git分支 | 從下拉式清單中，選擇管道應建置的來源（所選存放庫）分支。 預設為 main。 管道使用所選分支作為構建和部署的來源。 如有必要，請按一下[重新整理] 來更新所選存放庫的可用分支清單。 如果最近建立的分支未出現在清單中，請使用此選項。 |
|
| 建置策略 |
|
|
| 忽略Web層組態核取方塊 | 選取此選項可跳過在完整棧疊計畫碼管道中部署Web層設定。 取消選取此選項以部署網頁層級設定以及管道的程式碼。 | |
| 管道 | 體驗稽核核取方塊 | 選取此選項可在管道中包含體驗稽核步驟。 啟用後，管道會在Source程式碼索引標籤之後包含體驗稽核步驟。 |
僅部署Web層設定，例如用來儲存、處理網頁以及將網頁傳送給使用者端的Dispatcher屬性。 當您選取 網頁層設定 時，Cloud Manager會建立專用於網頁層設定部署的管道。
如果完整棧疊管道已存在，Cloud Manager會顯示通知，指出建立Web層設定管道會導致現有完整棧疊管道忽略Web層設定。 在您建立網頁層級設定管道後，Cloud Manager會透過該管道（而非完整棧疊管道）管理網頁層級設定部署。
| table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
|---|---|---|
| 章節 | 選項 | 說明 |
| Source代碼 | 存放庫 | 從下拉式清單中，選取包含網頁層設定的Git存放庫。 |
| Git分支 | 在選擇的存放庫中選取Cloud Manager用於部署的分支。 如有必要，請按一下[重新整理] 來更新所選存放庫的可用分支清單。 如果最近建立的分支未出現在清單中，請使用此選項。 | |
| 代碼位置 | 在選取的存放庫中輸入包含要部署的Web層設定的路徑。 預設位置是存放庫根目錄(/)。 |
- 按一下「儲存」。
關於在非生產管道中使用Smart Build about-smart-build
Cloud Manager中的 智慧型組建 是非生產管道的最佳組建策略。 Smart Build會快取模組，並只重新建置自上次成功執行後已變更的模組，藉此縮短建置時間。 未變更的模組會從快取中重複使用，而只會重建已修改的模組及其相依性，進而提高反複開發工作流程的效率。
Smart Build目前僅適用於下列專案：
- 計畫碼品質管道。
- 開發完整棧疊部署管道。
發生下列情況時，建議使用Smart Build：
- 您正在積極開發和提交頻繁的增量變更。
- 您的專案包含多個Maven模組。
- 完整組建需要相當長的時間。
有以下情況時，Smart Build並不總是理想的選擇：
- 您的組建嚴重依賴外掛程式，這些外掛程式會在Maven的相依性圖表之外執行操作。
- 每次執行都需要完整重建驗證。
瞭解組建效能 smart-build-performance
使用Smart Build的效能提升取決於幾個因素，包括：
- 專案中的模組數。
- 程式碼變更的頻率和範圍。
- 跨模組的相依性分佈。
一般而言，具有許多獨立模組的專案可以有最大的改善。
每個模組快取選擇退出 smart-build-cache-optout
Smart Build提供可讓您停用特定模組快取的精細控制項。 此功能在某些模組中相當實用：
- 使用外掛程式，例如
exec-maven-plugin或maven-antrun-plugin。 - 執行Maven相依性未追蹤的檔案操作。
- 快取時產生不一致的結果。
停用模組的快取 smart-build-disable-caching
您可以將下列屬性新增至受影響模組的pom.xml：
<properties>
<maven.build.cache.enabled>false</maven.build.cache.enabled>
</properties>
此語法會強制模組在每次管道執行時重建，而其他模組會繼續受益於快取。
使用Smart Build時的限制和考量 smart-build-limitations
使用Smart Build時，請記得下列事項：
- Smart Build仰賴Maven相依性分析。
- 相依性圖表以外的變更可能不會觸發重新建置。
- 有些外掛程式可能與快取不完全相容。
- 您可以透過編輯非生產管道隨時切換回完整組建。
如果您遇到非預期的建置行為，請考慮停用特定模組的快取，或暫時將建置策略切換為完整建置。
疑難排解智慧型組建問題 smart-build-troubleshoot
·驗證外掛程式行為（尤其是
exec/antrun外掛程式）。·檢查大多數模組是否頻繁變更。
·使用 完整組建 進行驗證。
請參閱啟用Smart Build時新增非生產管道🔗。
後續步驟 the-next-steps
管道設定後，可以部署您的程式碼。 請參閱「程式碼部署」，了解更多詳細資訊。
教學課程影片 video-tutorial
本影片將概觀管道建立流程，而本文件中有詳細說明。