AEM as a Cloud Service:元件部署在本機,但由於SDK版本不符,元件不會部署在雲端

✨ 此內容是AI產生的,可能不準確。 產生AI辭彙

本文介紹為何自訂AEM元件可在本機SDK上成功部署,卻未出現在雲端環境中,並著重說明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