設定生產管道 configure-production-pipeline

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

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

NOTE
直到計畫建立完成,Git存放庫至少有一個分支,並建立生產和測試環境集後,才能設定生產管道。

在開始部署程式碼之前,您必須從 Cloud Manager 設定管道設定。

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

新增生產管道 adding-production-pipeline

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

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

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

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

    計畫管理員概觀中的管道卡

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

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

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

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

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

    生產管道設定

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

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

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

完整堆疊程式碼 full-stack-code

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

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

若要完成完整堆疊程式碼生產管道的設定,請按照以下步驟操作。

  1. 在​ 原始程式碼 ​索引標籤上,您必須定義以下選項。

    • 存放庫 - 此選項會定義管道應該從哪個 Git 存放庫擷取程式碼。
    note tip
    TIP
    如要了解如何在 Cloud Manager 中新增和管理存放庫,請參閱文件:新增和管理存放庫
    • Git 分支 - 此選項會定義管道應該選取哪個分支來擷取程式碼。
      • 輸入分支名稱的前幾個字元,該欄位的自動完成功能將會尋找相符的分支以幫助您進行選擇。
    • 忽略 Web 層設定- 選取後,管道不會部署您的 Web 層設定。
    • 在部署到生產之前暫停 - 此選項會在部署到生產之前暫停管道。
    • 已排程 - 此選項可讓使用者啟用已排程的產生部署。

    完整堆疊程式碼

  2. 點選或按一下「繼續」以前往「體驗稽核」標籤,您可以在其中定義應一律包含在體驗稽核中的路徑。

    新增體驗稽核

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

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

為體驗稽核設定的路徑會提交給服務,並在管道執行時根據效能、協助工具、SEO (搜尋引擎最佳化)、最佳實務和 PWA (漸進式 Web 應用程式) 測試進行評估。如需更多詳細資訊,請參閱了解體驗稽核結果

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

目標部署 targeted-deployment

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

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

    • 請參閱使用設定管道文章以取得支援的設定清單,其中包括記錄轉送、清除相關的維護工作以及各種CDN設定,並在您的存放庫中管理這些設定,以便正確部署它們。
    • 執行目標部署管道時,將會部署設定,前提是這些設定會儲存至您在管道中定義的環境、存放庫和分支。
    • 在任何時候,每個環境只能有一個設定管道。
  • 前端程式碼 — 設定AEM應用程式前端的JavaScript和CSS。

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

    • 如需詳細資訊,請參閱檔案CI/CD管道
    • 如果所選環境存在 Web 層程式碼管道,則此選項會停用。
    • 如果您將現有的完整堆疊管道部署到環境,則為同一環境建立 Web 層設定管道將忽略完整堆疊管道中的現有 Web 層設定。
NOTE
私人存放庫不支援 Web 層和設定管道。請參閱文件「在 Cloud Manager 中新增私人存放庫」,了解詳細資訊和完整的限制清單。

選擇部署型別後,完成建立生產、目標部署管道的步驟相同。

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

目標部署選項

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

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

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

    設定管道

  3. 按一下「儲存」。

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

跳過發送器套件 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>!true</value>
    </property>
  </activation>
  <modules>
    <module>dispatcher</module>
  </modules>
</profile>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab