使用前端管道進行部署

在本章中,我們在 Adobe Cloud Manager 中建立並執行前端管道。此管道只會建置 ui.frontend 模組中的檔案並部署至 AEM as a Cloud Service 中內建的內容傳遞網路。因此,便不再使用以 /etc.clientlibs 為基礎的前端資源傳遞。

目標 objectives

  • 建立並執行前端管道。
  • 請驗證前端資源不是從 /etc.clientlibs 而是以 https://static- 開頭的全新主機名稱傳遞出來

使用前端管道

先決條件 prerequisites

這是包含多個部分的教學課程,並假設您已經完成「更新標準 AEM 專案」所述的步驟。

請確認您擁有在 Cloud Manager 中建立和部署管道以及存取 AEM as a Cloud Service 環境的權限

重新命名現有管道

請至「設定」索引標籤的「非生產管道名稱」欄位,將現有管道從「部署至開發」重新命名為「全堆疊 WKND 部署至開發」。這樣只需查看名稱,便可以明確知道是全堆疊或是前端管道。

重新命名管道

此外,在「原始碼」索引標籤中,確認「存放庫」和「Git 分支」欄位的值皆正確,而且分支已套用您的前端管道合約變更。

原始碼設定管道

建立前端管道

若要​ 只是 ​建置和部署 ui.frontend 模組中的前端資源,請執行以下步驟:

  1. 在 Cloud Manager UI 中,在「管道」區段按一下「新增」按鈕,然後根據您要部署的 AEM as a Cloud Service 環境,選取「新增非生產管道」(或「新增生產管道」)。

  2. 在「新增非生產管道」對話框中,作為「設定」步驟的一部分,請選取「部署管道」選項,將其命名為「前端 WKND 部署至開發」,然後按一下「繼續

建立前端管道設定

  1. 作為「原始碼」步驟的一部分,選取「前端程式碼」選項,並從「合格的部署環境」中選擇環境。在「原始碼」區段,請確認「存放庫」和「Git 分支」欄位的值皆正確,而且分支已套用您的前端管道合約變更。
    而__最重要的是__,「程式碼位置」欄位的值是「/ui.frontend」,然後最後按一下「儲存」。

建立前端管道原始碼

部署順序

  • 首先執行重新命名的「全堆疊 WKND 部署至開發」管道,把 AEM 存放庫中的 WKND clientlib 檔案移除。最重要的是,新增 Sling 設定 ​檔 (SiteConfigHtmlPageItemsConfig),為前端管道合約準備 AEM。

無樣式 WKND 網站

WARNING
之後,「全堆疊 WKND 部署至開發」管道完成後,您將擁有一個​__無樣式的__ WKND 網站,而該網站可能看起來已損壞。請做好故障停機應變計劃,或是在非工作時間進行部署。當您從使用全堆疊管道初次變更為使用前端管道時,必須做好規劃因應這種一次性的服務中斷情形。
  • 最後,執行「前端 WKND 部署至開發」管道,以便僅建置 ui.frontend 模組並將前端資源直接部署到內容傳遞網路。
IMPORTANT
您注意到​__無樣式__ WKND 網站已恢復正常,而且這次​__前端__​管道執行的速度比全堆疊管道快上許多。

驗證樣式變更和新的傳遞典範

  • 開啟 WKND 網站的任一頁面,都可以看到文字顏色是 Adobe 紅色,而且前端資源 (CSS、JS) 檔案皆從內容傳遞網路傳遞過來。資源請求主機名稱,以及 site.js 或是您在 HtmlPageItemsConfig 檔案中參考的任何其他靜態資源,都是一樣以 https://static-pXX-eYY.p123-e456.adobeaemcloud.com/$HASH_VALUE$/theme/site.css 開頭。

設定新樣式的 WKND 網站

TIP
這裡顯示的 $HASH_VALUE$ 與您在「前端 WKND 部署至開發」管道的「CONTENT HASH」欄位所看到的相同。AEM 收到前端資源內容傳遞網路 URL 的通知,該值儲存在 /conf/wknd/sling:configs/com.adobe.cq.wcm.core.components.config.HtmlPageItemsConfig/jcr:content,位於「prefixPath」屬性之下。

雜湊值關聯

恭喜! congratulations

恭喜,您已經建立、執行並確認只會建置和部署 WKND 網站專案的「ui.frontend」模組的前端管道。現在,您的前端團隊可以在完整的 AEM 專案生命週期以外,快速地進行網站設計和前端行為的疊代。

後續步驟 next-steps

在下一章「考量事項」中,您將檢閱對於前端和後端開發流程的影響。

recommendation-more-help
b2a561c1-47c0-4182-b8c1-757a197484f9