AEM as a Cloud Service:组件在本地部署,但由于SDK版本不匹配,无法在Cloud中部署

✨ 此内容是AI生成的,可能不准确。 生成AI术语

本文介绍了自定义AEM组件为何可在本地SDK上成功部署却未出现在Cloud Environments中,并重点介绍了SDK版本不匹配以及如何解决这些不匹配问题。

描述 description

环境

  • Adobe Experience Manager as a Cloud Service
  • 本地SDK版本:2026.3.*
  • Cloud SDK版本:2026.8.*

症状

  • 自定义组件(例如countdown-clock)已成功部署在本地AEM Cloud SDK实例上。
  • 部署到云环境后,该组件未显示。
  • 未报告特定错误消息,但管道执行后云环境中缺少组件。
  • 本地部署按预期工作;云部署不包括组件。

重现问题的步骤

  1. 将倒计时组件部署到本地AEM Cloud SDK实例(2026.3.*)。
  2. 使用Cloud SDK (2026.8.*)将相同的代码库部署到云环境中。
  3. 请注意,组件在本地存在但在云环境中缺失。

原因

本地和云的SDK版本之间不匹配可能会导致部署差异,通常是由于较新的SDK版本中引入了重大更改或不兼容所致。

解决方法 resolution

请按照以下步骤解决问题。

  1. 确保自定义组件及其依赖项与Cloud SDK版本(2026.8.*)兼容。
  2. 查看AEM as a Cloud Service SDK发行说明,了解2026.3.和2026.8.​之间的重大变更。
  3. 确认代码库中包含countdown-clock组件,且未被任何构建或部署筛选器(如filter.xml中的)排除。
  4. 在部署之前,验证组件是否在构建包(.zip或.jar)中存在。
  5. 访问Cloud Manager管道执行日志,查找与组件部署相关的错误或警告,并查找跳过的或失败的包安装。
  6. 使用Cloud SDK版本(2026.8.*)设置本地AEM实例,并尝试部署该组件。
  7. 如果问题在2026.8.*本地重现,请调查兼容性或依赖性问题。
  8. 重构或更新组件以解决使用较新SDK版本发现的任何兼容性问题。
  9. 重建并重新部署包。

完成这些步骤后,验证组件是否显示在云环境中。

recommendation-more-help
experience-cloud-kcs-help-kbarticles