設定非生產管道

了解如何設定非生產管道以在部署到生產環境之前測試程式碼的品質。

非生產管道

此外生產管道部署到登台和生產環境,您還可以設定非生產管道來驗證您的程式碼。

有兩種類型的非生產管道:

  • 程式碼品質管道 - 這些會對 Git 分支中的程式碼執行程式碼品質掃描並執行組建和程式碼品質步驟。
  • 部署管道 - 除了執行程式碼品質管道之類的組建和程式碼品質步驟之外,這些管道還會將程式碼部署到非生產環境。
注意

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

新增新的非生產管道

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

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

  2. 從 Cloud Manager 首頁畫面存取​管道​卡。按一下 + 新增​並選取​新增非生產管道

    新增非生產管道

  3. 在​新增非生產管道​對話框的​設定​索引標籤上,選取您要新增的非生產管道。

    • 程式碼品質管道 - 建立管道來建構您的程式碼、執行單元測試和評估程式碼品質但「不」部署。
    • 部署管道 - 建立管道來建構您的程式碼、執行單元測試、評估程式碼品質,並部署到環境。

    新增非生產管道對話框

  4. 在​非生產管道名稱​以識別您的管道以及以下附加資訊。

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

      • 手動 - 使用此選項以手動方式啟動管道。
      • 開啟 Git 變更 - 只要將認可新增到已設定的 Git 分支,此選項就會啟動 CI/CD 管道。使用此選項,您仍然可以在需要時手動啟動管道。
  5. 如果您選擇建立​部署管道,您還需要定義​重要的量度失敗行為

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

  7. 在​新增非生產管道​對話框的​來原始程式碼​索引標籤上,您必須選擇管道應處理的程式碼類型。

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

前端程式碼

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

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

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

    • 符合條件的部署環境- 如果您的管道是部署管道,您必須選擇它應該部署到哪些環境。
    • 存放庫 - 此選項會定義管道應該從哪個 Git 存放庫擷取程式碼。
    秘訣

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

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

    前端管道

  2. 按一下「儲存」。

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

完整堆疊程式碼

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

注意

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

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

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

    • 符合條件的部署環境- 如果您的管道是部署管道,您必須選擇它應該部署到哪些環境。
    • 存放庫 - 此選項會定義管道應該從哪個 Git 存放庫擷取程式碼。
    秘訣

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

    • Git 分支 - 此選項會定義管道應該選取哪個分支來擷取程式碼。

      • 輸入分支名稱的前幾個字元,該欄位的自動完成功能將會尋找相符的分支以幫助您進行選擇。
    • 忽略 Web 層配置- 選中後,管道將不會部署您的 Web 層配置。

    • 管道 - 如果您的管道是部署管道,您可以選擇執行測試階段。確認您希望在此階段啟用的選項。如果沒有選擇任何選項,則在管道執行期間不會顯示測試階段。

    完整堆疊管道

  2. 按一下「儲存」。

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

Web 層設定

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

注意

如果所選環境已存在網頁層級程式碼管道,則此選項將會停用。

若要完成網頁層級程式碼非生產管道的設定,請按照以下步驟操作。

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

    • 符合條件的部署環境- 如果您的管道是部署管道,您必須選擇它應該部署到哪些環境。
    • 存放庫 - 此選項會定義管道應該從哪個 Git 存放庫擷取程式碼。
    秘訣

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

    • Git 分支 - 此選項會定義管道應該選取哪個分支來擷取程式碼。
    • 程式碼位置 - 此選項會定義管道應從所選存放庫的分支中擷取程式碼的路徑。
      • 如果是 Web 層設定管道,這通常是包含 conf.dconf.dispatcher.dopt-in目錄的路徑。
      • 例如,如果專案結構是從 AEM 專案原型產生的,則路徑將為 /dispatcher/src

    網頁層級管道

  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>

本頁內容