設定和使用 AEM GraphQL 與內容片段的最佳做法 best-practices-setup-use-aem-graphql-content-fragments
這些指南總結了設定、設定 AEM,以及將 AEM 與 GraphQL 和內容片段搭配使用的建議最佳做法。
快速入門 getting-started
為了幫助您快速上手:
- 什麼是 Headless?
- AEM 架構中各種環境的概觀
設定 setup
為了安全地設定 AEM GraphQL 以用於內容片段和您的應用程式,您需要設定各種元件。
GraphQL 端點建立 (包括安全性) graphql-endpoint-creation
端點是用於存取 AEM GraphQL 的路徑。需要建立和發佈這些端點,以便安全地存取它們。
詳細資料 details-graphql-endpoint-creation
環境 environments-graphql-endpoint-creation
端點需要設定為:
- 作者
- 預覽
- 發佈
用於:
- 開發
- 測試
- 生產
AEM Dispatcher 快取 dispatcher-caching
根據預設,不啟用 Dispatcher 的持續性查詢快取。因為使用具有多個來源的 CORS (跨來源資源共用) 的客戶必須檢閱,且可能更新其 Dispatcher 設定,因此無法預設啟用。
詳細資料 details-dispatcher-caching
GraphQL 持續性查詢 - 在 Dispatcher 中啟用快取
環境 environments-dispatcher-caching
Dispatcher 通常設定為:
- 發佈:生產
CORS 設定 cors-setup
若要存取 GraphQL 端點,必須設定 CORS 原則並新增至透過 Cloud Manager 部署到 AEM 的 AEM 專案。做法是為所需端點新增適當的 OSGi CORS 設定。
詳細資料 details-cors-setup
環境 environments-cors-setup
CORS 通常設定為:
- 發佈:生產
驗證 authentication
用於內容片段傳遞的 Adobe Experience Manager as a Cloud Service (AEM) GraphQL API 的主要使用案例是接受協力廠商應用程式或服務的遠端查詢。這些遠端查詢可能需要經驗證的 API 存取權,以確保 Headless 內容傳遞的安全。
詳細資料 details-authentication
環境 environments-authentication
驗證通常設定為:
- 預覽
- 發佈
用於:
- 開發
- 測試
- 生產
權限 permissions
進行 Headless 實作時,應該處理幾個安全和權限方面的問題。權限和角色可以根據 AEM 環境:作者或 發佈 進行廣泛的考量。每個環境都包含不同的角色和不同的需求。
詳細資料 details-permissions
環境 environments-permissions
權限通常設定為:
- 作者
- 預覽
- 發佈
用於:
- 開發
- 測試
- 生產
使用內容傳遞網路 (CDN) cdn
使用 CDN 時,如果作為目標 GET 要求,則可以快取 GraphQL 查詢及其 JSON 回應。相反地,未快取的要求可能非常昂貴 (資源) 且處理速度緩慢,並且可能對來源資源產生進一步的有害影響。
詳細資料 details-cdn
環境 environments-cdn
CDN 通常設定為:
- 發佈:生產
設定和建立內容片段 cconfigure-create-content-fragments
AEM GraphQL 用於從您的內容片段中擷取資訊。需要先進行設定,定義結構和位置,然後才能建立內容。
詳細資料 details-content-fragments
環境 eenvironments-content-fragments
內容片段的定義、編輯、測試、發佈和存取:
- 作者
- 預覽
- 發佈
用於:
- 開發
- 測試
- 生產
使用 AEM GraphQL use-aem-graphql
最佳化 GraphQL 查詢 optimize-graphql-queries
提供這些指南是為了幫助防止 GraphQL 查詢出現效能問題。
詳細資料 details-optimize-graphql-queries
從您的應用程式存取 GraphQL access-graphql-from-your-apps
AEM 無頭 CMS 使開發者可以自由地使用他們已經熟悉的語言、框架和工具來建置和交付卓越的體驗。
詳細資料 details-your-apps
環境 environments-your-apps
應用程式通常在以下環境中開發、測試和使用:
- 預覽
- 發佈
用於:
- 開發
- 測試
- 生產
其他資源
如需更多 AEM GraphQL 和內容片段的詳細資料,請參閱以下內容: