新增非生產管道 configuring-non-production-pipelines

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

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

非生產管道 non-production-pipelines

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

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

  • 程式碼品質管道 - 這些會對 Git 分支中的程式碼執行程式碼品質掃描並執行組建和程式碼品質步驟。
  • 部署管道 - 除了執行程式碼品質管道之類的組建和程式碼品質步驟之外,這些管道還會將程式碼部署到非生產環境。
NOTE
你可以在初始設定後編輯管道設定

新增一個全新非生產管道 adding-non-production-pipeline

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

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

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

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

    新增非生產管道

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

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

    新增非生產管道對話框

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

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

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

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

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

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

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

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

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

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

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

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

    • 符合條件的部署環境- 如果您的管道是部署管道,您必須選擇它應該部署到哪些環境。
    • 存放庫 - 此選項會定義管道應該從哪個 Git 存放庫擷取程式碼。
    note tip
    TIP
    請參閱新增和管理存放庫,以便了解如何在 Cloud Manager 中新增和管理存放庫,
    • Git 分支 - 此選項會定義管道應該選取哪個分支來擷取程式碼。

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

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

    完整堆疊管道

  2. 按一下「儲存」。

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

目標部署 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 分支 - 此選項會定義管道應該選取哪個分支來擷取程式碼。
      • 輸入分支名稱的前幾個字元,該欄位的自動完成功能。會尋找相符的分支以幫助您進行選取。
    • 程式碼位置 - 此選項會定義管道應從所選存放庫的分支中擷取程式碼的路徑。
    • 管道 — 對於前端非生產管道,您可以選擇啟用​ 體驗稽核

    設定管道

  3. 如果您已啟用體驗稽核,請按一下「繼續」以前往「體驗稽核」標籤,您可以在其中定義應一律包含在體驗稽核中的路徑。

    • 如果您已啟用​ 體驗稽核,請參閱檔案體驗稽核以瞭解如何設定的詳細資訊。
    • 如果您沒有這麼做,請略過此步驟。
  4. 按一下​ 儲存,即可儲存管道。

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

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