新增生產管道 configure-production-pipeline

瞭解如何設定生產管道以建置計畫碼並將其部署到生產環境。 生產管道會先將計畫碼部署到中繼環境。 在核准後,會將相同的程式碼部署到生產環境。

使用者必須擁有​ 部署管理員 ​角色才能設定生產管道。

NOTE
在發生以下情況之前,無法設定生產管道:
  • 程式隨即建立。
  • Git存放庫至少有一個分支。
  • 生產和中繼環境隨即建立。

開始部署程式碼之前,請從Cloud Manager設定您的管道設定。

NOTE
你可以在初始設定後編輯管道設定

新增生產管道 adding-production-pipeline

設定好方案並擁有至少一個使用Cloud Manager UI的環境後,您就可以依照以下步驟著手新增生產管道了。

TIP
在設定前端管道之前,請參閱AEM Quick Site建立歷程,以透過易於使用的AEM Quick Site建立工具取得端到端指南。 此歷程可幫助您簡化AEM網站的前端開發,讓您無需AEM後端知識即可快速自訂網站。
  1. experience.adobe.com登入Cloud Manager。

  2. 在「快速存取」區段中,按一下「Experience Manager」。

  3. 在左側面板中,按一下「Cloud Manager」。

  4. 選取您想要的組織。

  5. 在「我的程式」控制台中,按一下某個程式。

  6. 在「我的程式」控制台中,選取程式。

  7. 從​ 方案總覽 ​頁面瀏覽至​ 管道 ​卡片,然後按一下​ 新增 ​以選取​新增生產管道

    專案管理員概觀中的管道卡

  8. 新增生產管道​對話框隨即顯示。提供​ 管道名稱 ​以識別您的管道以及以下選項。按一下​「繼續」

    部署觸發計畫 - 在定義部署觸發計畫以啟動管道時,有以下選項。

    • 手動 — 手動啟動管道。
    • 在Git變更上 — 只要將認可新增到已設定的Git分支,就會啟動CI/CD管道。 使用此選項,您仍然可以在需要時手動啟動管道。

    重要量度失敗行為 - 在管道設定或編輯期間,部署管理員​可選擇對任何品質閘道中遭遇重要失敗時的管道行為進行定義。可使用的選項包括:

    • 每次都詢問 — 預設設定。 任何重要失敗都需要手動介入。
    • 立即失敗 - 如果選取,則每當重要失敗發生時,會取消管道。此程式基本上是模擬使用者手動拒絕每次失敗。
    • 立即繼續 — 如果選取,則每當重要失敗發生時,管道會自動繼續。 此程式基本上是模擬使用者手動核准每次失敗。

    生產管道設定

  9. 在​ Source程式碼 ​索引標籤上,選取管道應處理的程式碼型別。

如需有關管道型別的詳細資訊,請參閱CI/CD管道

完成建立生產流水線的步驟因所選原始計畫碼型別而異。 按照上面的連結跳到本文件的下一部分以便完成管道的設定。

我使用完整棧疊計畫碼 full-stack-code

完整棧疊計畫碼管道同時部署包含一個或多個AEM伺服器應用程式以及HTTPD/Dispatcher配置的後端和前端計畫碼構建。

NOTE
如果所選環境已存在完整堆疊程式碼管道,則此選項會停用。

若要設定完整棧疊計畫碼管道:

  1. 在​ Source程式碼 ​索引標籤上,定義下列選項。

    • 存放庫 — 定義管道應該從哪個Git存放庫擷取程式碼。
    note tip
    TIP
    請參閱新增和管理存放庫,瞭解如何在Cloud Manager中新增和管理存放庫。
    • Git分支 — 從下拉式清單中,選擇管道建置應在所選存放庫中的哪個分支。 預設為 main。 管道使用所選分支作為構建和部署的來源。 如有必要,請按一下[重新整理]​ ​來更新所選存放庫的可用分支清單。 如果最近建立的分支未出現在清單中,請使用此選項。

    • 建置策略

      • 完整組建 — 每次都會建置存放庫中的所有模組

      • Beta 智慧型組建 — 僅建置自上次認可後已變更的模組。
        進一步瞭解在非生產管道中使用Smart Build

        note important
        IMPORTANT
        智慧型組建僅適用於計畫碼品質管道和開發完整棧疊計畫碼部署管道。

        * **忽略 Web 層設定**- 選取後,管道不會部署您的 Web 層設定。

    • 在部署到生產之前暫停 — 在部署到生產之前暫停管道。

    • 已排程 — 讓使用者啟用已排程的生產部署。

    完整堆疊程式碼

  2. 按一下​ 繼續 ​進入​ 體驗稽核 ​索引標籤,您可以在其中定義應一律包含在體驗稽核中的路徑。

    新增體驗稽核

  3. 提供要包含在體驗稽核中的路徑。

  4. 按一下​儲存,即可儲存您的管道。

當管道執行時,會根據效能、協助工具、SEO、最佳實務和PWA測試,提交和評估為體驗稽核設定的路徑。 如需更多詳細資料,請參閱瞭解體驗稽核結果

管道已儲存,您現在可以在​ 計劃概觀 ​頁面的​ 管道 ​卡上管理您的管道

我正在使用目標部署 targeted-deployment

目標部署只會為AEM應用程式的選定部分部署程式碼。 在這種部署中,您可以選擇​ 包含 ​下列其中一個型別的程式碼:

  • 設定 — 設定AEM環境中各種功能的設定。

    • 如需支援的設定清單,請參閱使用設定管道,其中包含記錄檔轉送、清除相關的維護工作以及各種CDN設定,並在您的存放庫中管理這些設定,以便正確部署它們。
    • 執行目標部署管道時,會部署設定,前提是這些設定會儲存至管道中定義的環境、存放庫和分支。
    • 在任何時候,每個環境只能有一個設定管道。
  • 設定Edge Delivery Services設定管道 - Edge Delivery設定管道沒有獨立的開發、測試和生產環境。 在AEM as a Cloud Service中,變更會經過開發、階段和生產等層級。 相反地,Edge Delivery設定管道會直接將其設定套用至在Cloud Manager中註冊的所有Edge Delivery Sites網域。 若要深入瞭解,請參閱新增Edge Delivery管道

  • 前端計畫碼 — 為AEM應用計畫的前端設定JavaScript和CSS。

    • 有了前端管道,給前端開發者更多的獨立性,可以加快開發進程。
    • 請參閱文件使用前端管道開發網站 了解此程序的工作原理以及需要注意的一些注意事項,以充分發揮此程序的潛力。
  • 網頁層設定 — 設定Dispatcher屬性,以儲存、處理及傳送網頁給使用者端。

    • 如需詳細資訊,請參閱檔案CI/CD管道
    • 如果所選環境存在 Web 層程式碼管道,則此選項會停用。
    • 如果您為具有現有完整棧疊管道的環境建立Web層配置管道,則忽略完整棧疊管道中的Web層配置。 此變更只會影響該環境中的Web層設定。
NOTE
私人存放庫不支援 Web 層和設定管道。請參閱在Cloud Manager中新增私人存放庫,以取得詳細資訊和完整的限制清單。

若要設定目標部署管道:

  1. 選擇所需的部署型別。

目標部署選項

  1. 定義​合格的部署環境

    • 如果您的管道是部署管道,則必須選擇它應該部署到哪些環境。
  2. 在​ Source程式碼 ​下,定義下列選項:

    • 存放庫 - 此選項會定義管道應該從哪個 Git 存放庫擷取程式碼。
    note tip
    TIP
    請參閱新增和管理存放庫,以便了解如何在 Cloud Manager 中新增和管理存放庫,
    • Git 分支 - 此選項會定義管道應該選取哪個分支來擷取程式碼。
      • 輸入分支名稱的前幾個字元,該欄位的自動完成功能。會尋找相符的分支以幫助您進行選取。
    • 程式碼位置 - 此選項會定義管道應從所選存放庫的分支中擷取程式碼的路徑。
    • 在部署到生產之前暫停 - 此選項會在部署到生產之前暫停管道。
    • 已排程 — 讓使用者啟用已排程的生產部署。 僅適用於Web層目標部署。

    設定管道

  3. 按一下「儲存」。

管道已儲存,您現在可以在​ 計劃概觀 ​頁面的​ 管道 ​卡上管理您的管道

Beta:關於在生產管道中使用Smart Build about-smart-build-production-pipeline

Cloud Manager中的​ 智慧型組建 ​是生產管道的最佳組建策略。 Smart Build會快取模組,並只重新建置自上次成功執行後已變更的模組,藉此縮短建置時間。 未變更的模組會從快取中重複使用,而只會重建已修改的模組及其相依性,進而提高反複開發工作流程的效率。

NOTE
對這個測試版感興趣嗎? 請寄送電子郵件至 beta_quickbuild_cmpipelines@adobe.com,並附上您的 Adobe OrgID 和方案 ID。
IMPORTANT
啟用Smart Build後的首次執行行為類似於Full Build,因為快取是空的。

發生下列情況時,建議使用Smart Build:

  • 您正在積極開發和提交頻繁的增量變更。
  • 您的專案包含多個Maven模組。
  • 完整組建需要相當長的時間。

有以下情況時,Smart Build並不總是理想的選擇:

  • 您的組建嚴重依賴外掛程式,這些外掛程式會在Maven的相依性圖表之外執行操作。
  • 每次執行都需要完整重建驗證。

瞭解組建效能 smart-build-performance

使用Smart Build的效能提升取決於幾個因素,包括:

  • 專案中的模組數。
  • 程式碼變更的頻率和範圍。
  • 跨模組的相依性分佈。

一般而言,具有許多獨立模組的專案可以有最大的改善。

每個模組快取選擇退出 smart-build-cache-optout

Smart Build提供可讓您停用特定模組快取的精細控制項。 此功能在某些模組中相當實用:

  • 使用外掛程式,例如exec-maven-pluginmaven-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外掛程式)。
沒有效能改善
·確認已執行多次(快取熱身)。
·檢查大多數模組是否頻繁變更。
未預期的成品或遺失的變更
·檢閱變更是否在Maven相依性追蹤之外。
·使用​ 完整組建 ​進行驗證。

請參閱新增生產管道以啟用智慧建置。

跳過Dispatcher套件 skip-dispatcher-packages

若要在管道中建置Dispatcher套件,而不將套件發佈到建置儲存,您可以停用發佈選項。 這麼做有助於縮短管道的執行時間。

必須透過您的專案 pom.xml 檔案新增以下停用發佈 Dispatcher 套件的設定。環境變數可作為您在Cloud Manager建置容器中設定的標幟,以判斷何時應忽略Dispatcher套件。

<profile>
  <id>only-include-dispatcher-when-it-isnt-ignored</id>
  <activation>
    <property>
      <name>env.IGNORE_DISPATCHER_PACKAGES</name>
      <value>[!NOTE]rue</value>
    </property>
  </activation>
  <modules>
    <module>dispatcher</module>
  </modules>
</profile>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab