設定生產管道

了解如何設定生產管道以建置計劃碼並將其部署到生產環境。生產管道會先將計劃碼部署到測試環境，並在獲得核准後將相同的計劃碼部署到生產環境。

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

注意

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

在開始部署計劃碼之前，您必須從 Cloud Manager 設定管道設定。

注意

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

新增生產管道

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

秘訣

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

  1. 在 my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織和計畫。

  2. 瀏覽至​管道​卡 (從​計畫總覽​頁面) 並按一下​新增，以選取​新增生產管道。

    專案管理員總覽中的管道卡

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

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

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

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

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

    生產管道設定

  4. 在​原始計劃碼​索引標籤上，您必須定義管道應在何處擷取其計劃碼以及它是什麼類型的計劃碼。

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

前端計劃碼

前端計劃碼管道部署包含一個或多個用戶端 UI 應用計劃的前端計劃碼建置。有關此類管道的更多資訊，請參閱文件 CI/CD 管道。

若要完成前端計劃碼生產管道的設定，請按照以下步驟操作。

  1. 在​原始計劃碼​索引標籤上，您必須定義以下選項。

    • 存放庫 - 此選項會定義管道應該從哪個 Git 存放庫擷取計劃碼。
    秘訣

    如要了解如何在 Cloud Manager 中新增和管理存放庫，請參閱文件：新增和管理存放庫。

    • Git 分支 - 此選項會定義管道應該選取哪個分支來擷取計劃碼。
      • 輸入分支名稱的前幾個字元，該欄位的自動完成功能將會尋找相符的分支以幫助您進行選擇。
    • 計劃碼位置 - 此選項會定義管道應從所選存放庫的分支中擷取計劃碼的路徑。
    • 在部署到生產之前暫停 - 此選項會在部署到生產之前暫停管道。

    前端計劃碼

  2. 按一下​儲存，即可儲存您的管道。

管道已儲存，您現在可以在​計畫總覽​頁面的​管道​卡上管理您的管道。

完整堆疊計劃碼

完整堆疊計劃碼管道同時部署包含一個或多個 AEM 伺服器應用程序以及 HTTPD/Dispatcher 配置的後端和前端計劃碼構建。有關此類管道的更多資訊，請參閱文件 CI/CD 管道。

注意

如果所選環境已存在完整堆疊計劃碼管道，則此選項將會停用。

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

  1. 在​原始計劃碼​索引標籤上，您必須定義以下選項。

    • 存放庫 - 此選項會定義管道應該從哪個 Git 存放庫擷取計劃碼。
    秘訣

    如要了解如何在 Cloud Manager 中新增和管理存放庫，請參閱文件：新增和管理存放庫。

    • Git 分支 - 此選項會定義管道應該選取哪個分支來擷取計劃碼。
      • 輸入分支名稱的前幾個字元，該欄位的自動完成功能將會尋找相符的分支以幫助您進行選擇。
    • 計劃碼位置 - 此選項會定義管道應從所選存放庫的分支中擷取計劃碼的路徑。
    • 在部署到生產之前暫停 - 此選項會在部署到生產之前暫停管道。
    • 已排程 - 此選項可讓使用者啟用已排程的產生部署。

    完整堆疊計劃碼

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

    新增體驗稽核

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

    • 路徑的開頭必須是 /。
    • 例如，如果您想將 https://wknd.site/us/en/about-us.html 納入體驗稽核中，請輸入路徑 /us/en/about-us.html。

    定義體驗稽核的路徑

  4. 按一下​新增頁面，路徑將使用您的環境地址自動完成並新增到路徑表中。

    儲存表格的路徑

  5. 重複前兩個步驟根據需要繼續新增路徑。

    • 您最多可以新增 25 個路徑。
    • 如果您未定義任何路徑，則預設情況下該網站的首頁將包含在體驗稽核中。

  6. 按一下​儲存，即可儲存您的管道。

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

管道已儲存，您現在可以在​計畫總覽​頁面的​管道​卡上管理您的管道。

Web 層設定

Web 層設定管道部署 HTTPD/Dispatcher 設定。有關此類管道的更多資訊，請參閱文件 CI/CD 管道。

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

  1. 在​原始計劃碼​索引標籤上，您必須定義以下選項。

    • 存放庫 - 此選項會定義管道應該從哪個 Git 存放庫擷取計劃碼。
    秘訣

    如要了解如何在 Cloud Manager 中新增和管理存放庫，請參閱文件：新增和管理存放庫。

    • Git 分支 - 此選項會定義管道應該選取哪個分支來擷取計劃碼。
      • 輸入分支名稱的前幾個字元，該欄位的自動完成功能將會尋找相符的分支以幫助您進行選擇。
    • 計劃碼位置 - 此選項會定義管道應從所選存放庫的分支中擷取計劃碼的路徑。
      • 如果是 Web 層設定管道，這通常是包含 conf.d、conf.dispatcher.d 和 opt-in目錄的路徑。
      • 例如，如果專案結構是從 AEM 專案原型產生的，則路徑將為 /dispatcher/src。
    • 在部署到生產之前暫停- 此選項會在部署到生產之前暫停管道。
    • 已排程 - 此選項可讓使用者啟用已排程的產生部署。

    Web 層計劃碼

  2. 按一下​儲存，即可儲存您的管道。

注意

如果您將現有的完整堆疊管道部署到環境，則為同一環境建立 Web 層設定管道將忽略完整堆疊管道中的現有 Web 層設定。

管道已儲存，您現在可以在​計劃總覽​頁面的​管道​卡上管理您的管道。

使用前端管道開發 Sites

有了前端流水線，給前端開發者更多的獨立性，可以加快開發進程。

請參考文件使用前端管道開發 Sites 了解此過程的工作原理以及需要注意的一些注意事項，以充分發揮此過程的潛力。

跳過發送器套件

如果您希望將發送器套件建置為管道的一部分，但又不希望將它們發佈到建置儲存，您可以停用發佈它們，這可能會減少管道的執行時間。

必須透過您的專案 pom.xml 檔案新增以下停用發佈發送器套件的設定。這會根據環境變數 (作為一個標幟)，您可以在 Cloud Manager 建置容器中設定以定義何時應忽略發送器套件。

<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>

本頁內容