AEM as a Cloud Service的AEM Headless快速设置
AEM Headless快速设置允许您使用AEM Headless的实际操作,它使用WKND Site示例项目中的内容以及一个通过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
-
必须本地安装以下工具:
1.创建Cloud Manager Git存储库
首先,创建用于部署WKND站点的Cloud Manager Git存储库。 WKND站点是一个示例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站点项目提供了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创作服务
-
导航到 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形式使用其内容。