AEM as a Cloud Service Developer Console developer-console
AEM as a Cloud Service Developer Console包含一组用于调试云环境的只读工具。 可以通过Cloud Manager中的按环境链接访问它,并提供查看捆绑包、OSGi设置、服务和servlet等的功能。
- 不应将AEM Developer Console (Cloud Service)与名称相似的Adobe Developer Console.混淆
AEM Developer Console访问权限
要访问和使用AEM Developer Console,必须通过Adobe的Admin Console向开发人员的Adobe ID授予以下权限。
- 确保在Adobe组织切换器中查看与您要在Adobe Developer Console中检查的环境相关的AEM组织。
- 为了能够登录到AEM Developer Console,开发人员必须是以下任意角色的成员:
+ Cloud Manager产品的 开发人员 — Cloud Service 产品配置文件:在这种情况下,开发人员将看到所选AEM Developer Console URL下可用环境的完整列表;如果已在Cloud Manager中选择开发环境或RDE,则可能会显示同一程序中的其他开发环境或RDE。
+ AEM Author上的AEM Administrators 产品配置文件:在这种情况下,上一个项目符号中描述的环境列表将限制为分配此角色的相关产品配置文件。 - 开发人员必须是AEM Author和/或Publish🔗上的 AEM Users 或 AEM Administrators 产品配置文件的成员。
+ 如果此成员资格不存在,则状态转储将超时,并出现401未授权错误。
请清除浏览器的Cookie以及应用程序状态(本地存储),然后重新登录到AEM Developer Console
AEM Developer Console访问疑难解答
登录时,我没有看到所查找的环境已列出
确保以下各项:
+ 通过通过AEM单击选定环境的三个圆点,然后选择Developer Console AEM Developer Console,您已选择正确的Cloud Manager URL。
+ 您或者拥有Cloud Manager产品的 开发人员 — Cloud Service 产品配置文件以查看环境的完整列表,或者您是未找到环境的AEM作者🔗上的 AEM管理员 产品配置文件的一部分。
401转储状态时发生未授权错误
要解决未授权问题,请执行以下操作:
- 确保您的用户是AEM Developer Console关联的AEM产品实例相应的Adobe IMS产品配置文件(AEM管理员或AEM as a Cloud Service用户)的成员。
+ 请记住,AEM Developer Console访问2个Adobe IMS产品实例;AEM as a Cloud Service创作和发布产品实例,因此请确保根据需要通过AEM Developer Console访问的服务层使用正确的产品配置文件。 - 最多等待30分钟,以便Adobe IMS产品配置文件成员资格同步到AEM as a Cloud Service。
- 登录到AEM as a Cloud Service(创作或发布),并确保您的用户和组已正确同步到AEM中。
+ AEM Developer Console要求在相应的AEM服务层中创建您的用户记录,以便对该服务层进行身份验证。 - 清除您的浏览器Cookie以及应用程序状态(本地存储)并重新登录到AEM Developer Console,从而确保AEM Developer Console所使用的访问令牌正确且未过期。
IP限制 ip-restrictions
对Developer Console的访问取决于您访问创作实例的能力。 如果您的组织在Cloud Manager中的创作服务上配置了IP允许列表,则必须从该允许范围内的IP地址进行连接。
例如,如果创作实例仅限于您的公司VPN,则您只能在连接到该VPN时使用Developer Console。
导航到Developer Console
通过Cloud Manager,每个AEM as a Cloud Service环境可访问Developer Console。
- 导航到Cloud Manager
- 打开包含AEM as a Cloud Service环境的 项目 以打开Developer Console。
- 找到环境,然后选择
...。 - 从下拉列表中选择Developer Console。
或打开此URL以登录: https://experience.adobe.com/skyline-console
或者从Cloud Manager CLI使用此命令:
aio cloudmanager:open-developer-console <ENVIRONMENTID> --programId <PROGRAMID>
环境/项目选择器
要使用AEM Developer Console,您必须选择要检查的环境和程序。
选择器位于AEM Developer Console UI的左上角和右上角。
选择环境将触发AEM Developer Console中的数据刷新,您会看到所选环境的数据。
转到存储库浏览器时,将使用选定的环境在新的选项卡中打开存储库浏览器。
选择器旁边的刷新按钮会触发浏览器缓存清除,以便程序/环境调用Cloud Manager。
如果创建了新环境,但在环境列表中未看到该环境,则可以使用此项。
新环境仍可能需要几分钟才能在AEM Developer Console中可用。
状态指示灯指示环境的运行状况。
- 红色:表示环境不健康且不可用(可能处于休眠状态)。
- 橙色:环境可能正在重新启动或降级(某些pod暂时关闭,但仍有正常的pod可用)。
- 绿色:正在运行,所有pod均已启动且运行正常
选择环境后,您可以使用选项卡导航到AEM Developer Console的各种视图。
您可以查看环境每一层的状态。
OSGi包
- 在所选环境类型中部署的OSGi包概述。 它支持全文搜索。
- 获取环境中捆绑包的实际状态信息很有用。 您可以获取相关信息,例如导出的资源包、导入的资源包、使用的服务等。
- 开发人员希望在实际环境中进行验证,并检查捆绑包是否实现了他们期望的功能。
- 示例用例:您的捆绑包中指定了依赖项的版本范围。 依赖项出现问题。 您希望检查将哪个依赖项版本连接到捆绑包中。 要进行检查,请转到捆绑包详细信息,然后使用导入捆绑包/包来检查运行时使用的捆绑包版本或包版本。 利用此信息,您可以调整maven依赖项版本范围或调整代码。
要搜索,请使用搜索栏。 要将捆绑包列表下载为json,请单击右上角的下载列表按钮以获取完整的JSON转储。
如果要获取发布或预览转储,可以使用环境选择器选择发布或预览环境,然后下载列表。
Java包
开发控制台UI中的
Java包用于对由于未解析的导入或脚本(HTL、JSP等)中的类未解析而导致捆绑包无法启动进行故障排除。 如果Java包报告没有捆绑包导出Java包(或版本与OSGi捆绑包导入的版本不匹配):
+ 确保项目的AEM API Maven依赖项的版本与环境的AEM发行版本匹配(如果可能,请将所有内容更新为最新版本)。
+ 如果在Maven项目中使用额外的Maven依赖项
+ 确定是否可改用AEM SDK API依赖项提供的替代API。
+ 如果需要额外的依赖关系,请确保它作为OSGi捆绑包(而不是纯Jar)提供,并且嵌入到项目的代码包(ui.apps)中,类似于核心OSGi捆绑包嵌入到ui.apps包中的方式。
单击某个资源包将转到资源包详细信息:
开发控制台UI中的
配置 configurations
开发控制台UI中的
- 环境中活动的配置的可搜索列表。 您可以通过查看详细信息页面来查看配置提供了哪些属性。
- 示例用例:开发人员希望确保他们指定的配置实际存在于环境中。 如果缺少配置,他们可以检查特征模型或配置运行模式或文件夹。
有关设置用户权限的详细信息,请参阅Cloud Manager文档。
Servlet servlets
开发控制台UI中的
- 搜索提示,您可以在其中指定带有选择器的路径和带有GET或POST的扩展名。 然后,它会按优先顺序提供servlet的结果,以在Sling中处理请求。
- 示例用例:您有一个OSGI servlet,它应在请求时激活并将输出打印到响应。 但是,响应将返回空,而不是预期的输出。 您需要检查由于更具体的选择器、
resourceType、扩展或排名,某些其他servlet是否优先于您的servlet。 搜索预期路径,然后发现另一个排名较高的servlet处于活动状态。 然后,您决定是否可以通过添加选择器来获得排名在前的servlet,例如。
服务 services
开发控制台UI中的
组件列出了所有OSGi服务。
OSGi Services帮助通过以下方式调试:
+ 列出AEM中的所有OSGi服务,以及其提供的OSGi捆绑包和使用该捆绑包的所有OSGi捆绑包
OSGi组件 osgi-components
开发控制台UI中的
组件通过以下方式帮助进行调试:
+ 列出部署到AEM as a Cloud Service的所有OSGi组件
+ 提供每个OSGi组件的状态;包括它们是活动的还是不满足的
+ 向不满足的服务引用提供详细信息可能会导致OSGi组件变为活动状态
+ 列出绑定到OSGi组件的OSGi属性及其值。
+ 这将显示通过OSGi环境配置变量插入的实际值。
集成 integrations
- 系统管理员能够生成、重命名和删除服务凭据和开发人员令牌。
- 可在此处找到有关此内容的更多信息:为服务器端API生成访问令牌。
存储库 repository
- 打开存储库浏览器。
- 注意:您需要能够登录AEM服务才能访问存储库浏览器。 如果您无法登录,请联系您的系统管理员以获取访问权限。
- 您需要对尝试访问的层授予访问权限。 例如,如果您尝试在发布层访问存储库浏览器,则需要具有在发布层上授予的访问权限(AEM管理员或AEM用户)。
状态转储/查询 status-dumps-queries
- 包、包、配置、服务、组件、sling作业或Oak定义的当前状态的全文或JSON转储。
- 当开发人员发现一些意外的状态,并希望与其他开发人员通信或记录此状态时特别有用。 下载转储将为您提供状态的快照以供以后参考。
Sling 作业
Sling作业列出了所有Sling作业队列。
Sling作业通过以下方式帮助进行调试:
+ Sling作业队列及其配置列表
+ 提供对活动、已排队和已处理Sling作业数量的分析,这有助于在AEM中调试工作流、瞬态工作流和Sling作业执行的其他工作中存在的问题。
Oak定义
Oak索引提供/oak:index下定义的节点的转储。 请记住,这不会显示合并的索引,在修改AEM索引时会发生这种情况。
Oak索引通过以下方式帮助进行调试:
+ 列出所有Oak索引定义,深入分析如何在AEM中执行搜索查询。 请记住,此处不反映对AEM索引所做的修改。 此视图仅对由AEM单独提供或仅由自定义代码提供的索引有用。
查询性能工具
- 查询有助于深入分析在AEM上执行搜索查询的内容和方式。
- 仅当选择了特定的面板时,查询才起作用,因为它打开该面板的查询性能Web控制台,要求开发人员有权登录到AEM服务。
查询可通过以下方式帮助进行调试:
+ 解释Oak如何解释、分析和执行查询。 在跟踪为什么查询速度缓慢并了解如何加快查询速度时,这一点非常重要。
+ 列出在AEM中运行的最受欢迎的查询,并可解释这些查询。
+ 列出在AEM中运行最慢的查询,并可解释这些查询。
更多文档可在此处找到。