AEM as a Cloud Service的AEM Headless快速設定
AEM Headless快速設定讓您使用WKND Site範例專案中的內容,以AEM Headless進行操作,並提供在AEM Headless GraphQL API使用內容的範例React應用程式(SPA)。
先決條件
進行此快速設定需要下列專案:
-
AEM as a Cloud Service沙箱環境(最好是開發環境)
-
存取AEM as a Cloud Service和Cloud Manager
- AEM管理員 AEM as a Cloud Service的存取權
- Cloud Manager — 部署管理員 對Cloud Manager的存取權
-
下列工具必須安裝在本機:
- Node.js v18
- Git
- IDE (例如,Microsoft® Visual Studio Code)
1.建立Cloud Manager Git存放庫
首先,建立用於部署WKND網站的Cloud Manager Git存放庫。 WKND Site是範例AEM網站專案,其中包含快速設定的React應用程式所使用的內容(內容片段)和GraphQL AEM端點。
步驟的熒幕廣播
-
選取包含要用於此快速設定的AEM as a Cloud Service環境的Cloud Manager 方案
-
為WKND網站專案建立Git存放庫
- 在頂端導覽中選取 存放庫
- 在頂端動作列中選取 新增存放庫
- 命名新的Git存放庫:
aem-headless-quick-setup-wknd
- 每個Adobe組織的Git存放庫名稱必須是唯一的,
- 選取 儲存,並等待Git存放庫初始化
2.將範例WKND網站專案推送到Cloud Manager Git存放庫
建立Cloud Manager Git存放庫後,從GitHub複製WKND網站專案的原始程式碼,並將其推送到Cloud Manager Git存放庫。 現在,Cloud Manager可存取WKND網站專案,並將其部署至AEM as a Cloud Service環境。
步驟的熒幕廣播
-
從命令列,從GitHub複製範例WKND網站專案的原始程式碼
code language-shell $ mkdir -p ~/Code $ cd ~/Code $ git clone git@github.com:adobe/aem-guides-wknd.git
-
將Cloud Manager Git存放庫新增為遠端
-
在頂端導覽中選取 存放庫
-
從頂端動作列選取 存取存放庫資訊
-
執行 中找到的命令,從命令列將遠端加入您的Git存放庫
code language-shell $ cd aem-guides-wknd $ git remote add adobe https://git.cloudmanager.adobe.com/<YOUR ADOBE ORGANIZATION>/aem-headless-quick-setup-wknd/
-
-
將範例專案的原始程式碼從您的本機Git存放庫推送到Cloud Manager Git存放庫
code language-shell $ git push adobe main:main
出現認證提示時,請提供Cloud Manager 存放庫資訊 強制回應視窗中的 使用者名稱 和 密碼。
3.將WKND網站部署至AEM as a Cloud Service
由於WKND網站專案已推送至Cloud Manager Git存放庫,因此無法使用Cloud Manager管道將其部署至AEM as a Cloud Service。
請記住,WKND Site專案提供React應用程式透過AEM Headless GraphQL API使用的範例內容。
步驟的熒幕廣播
-
將 非生產部署管道 附加至新的Git存放庫
-
在上方導覽中選取 管道
-
從頂端動作列中選取 新增管道
-
在 組態 索引標籤上
- 選取 部署管道 選項
- 將 非生產管道名稱 設定為
Dev Deployment pipeline
- 選取 部署觸發程式>開啟Git變更
- 選取 重要量度失敗行為>立即繼續
- 選取 繼續
-
在 Source程式碼 索引標籤上
- 選取 完整棧疊代碼 選項
- 從 合格的部署環境 選取方塊中選取 AEM as a Cloud Service開發環境
- 在 存放庫 選取方塊中選取
aem-headless-quick-setup-wknd
- 從 Git分支 選取方塊中選取
main
- 選取 儲存
-
-
執行 開發部署管道
- 在頂端導覽中選取 概觀
- 在 管道 區段中找出新建立的 開發部署管道
- 選取管道專案右側的 …
- 選取 執行,並在強制回應視窗中確認
- 選取目前執行中管道右側的 …
- 選取 檢視詳細資料
-
從管道執行的詳細資訊,監視進度直到成功完成。 管道執行應需要30到40分鐘之間。
4.下載並執行WKND React應用程式
使用WKND Site專案中的內容啟動AEM as a Cloud Service,下載並啟動範例WKND React應用程式,該應用程式透過AEM Headless GraphQL API使用WKND網站的內容。
步驟的熒幕廣播
-
從命令列,從GitHub複製React應用程式的原始程式碼。
code language-shell $ cd ~/Code $ git clone git@github.com:adobe/aem-guides-wknd-graphql.git
-
在IDE中開啟資料夾
~/Code/aem-guides-wknd-graphql/react-app
。 -
在IDE中,開啟檔案
.env.development
。 -
從
REACT_APP_HOST_URI
屬性指向AEM as a Cloud Service Publish 服務的主機URI。code language-plain REACT_APP_HOST_URI=https://publish-pXXXX-eYYYY.adobeaemcloud.com ...
若要尋找AEM as a Cloud Service Publish服務的主機URI:
- 在Cloud Manager的頂端導覽列中選取 環境
- 選取 開發 環境
- 找到 Publish服務(AEM和Dispatcher) 連結 環境區段 表格
- 複製連結位址,並將其用作AEM as a Cloud Service Publish服務的URI
-
在IDE中,將變更儲存至
.env.development
-
從命令列,執行React應用程式
code language-shell $ cd ~/Code/aem-guides-wknd-graphql/react-app $ npm install $ npm start
-
本機執行的React應用程式從http://localhost:3000開始,並顯示冒險清單,這些冒險是使用AEM Headless的GraphQL API從AEM as a Cloud Service取得。
5.在AEM中編輯內容
使用範例WKND React應用程式連線到AEM Headless GraphQL API並使用其內容,在AEM Author服務中製作內容,並檢視React應用程式的體驗如何一致更新。
步驟的熒幕廣播
-
登入AEM as a Cloud Service Author服務
-
導覽至 Assets >檔案> WKND共用>英文>冒險
-
開啟 Cycling Southern Utah 資料夾
-
選取 Cycling Southern Utah 內容片段,並從上方動作列選取 編輯
-
更新內容片段的某些欄位,例如:
- 標題:
Cycling Utah's National Parks
- 行程長度:
6 Days
- 難度:
Intermediate
- 價格:
3500
- 主要影像:
/content/dam/wknd-shared/en/activities/cycling/mountain-biking.jpg
- 標題:
-
在頂端動作列中選取 儲存
-
從頂端動作列的 選取 快速Publish …
-
重新整理http://localhost:3000上執行的React應用程式。
-
在React應用程式中,選取現在更新的「循環冒險」,並驗證對內容片段進行的內容變更。
-
使用相同方法,在AEM作者服務中:
- 取消發佈現有的冒險內容片段,並確認該片段已從React應用程式體驗中移除
- 建立並發佈新的冒險內容片段,並確認它出現在React應用程式體驗中
note tip TIP 如果您不熟悉如何建立和發佈新的內容片段,或無法發佈現有的內容片段,請觀看上方的熒幕擷取畫面。
恭喜!
恭喜!您已成功使用AEM Headless來增強React應用程式!
若要詳細瞭解React應用程式如何使用AEM as a Cloud Service的內容,請檢視AEM Headless教學課程。 本教學課程會探索如何在AEM中建立內容片段,以及此React應用程式如何使用其JSON格式內容。