設定生產管道

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

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

注意

直到計畫建立完成,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.dconf.dispatcher.dopt-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>

本頁內容