ドキュメントExperience Cloud KCS

AEM as a Cloud Service:SDKのバージョンが一致しないため、コンポーネントはローカルにデプロイされますが、Cloudにはデプロイされません

最終更新日： 2026年10月16日

✨ このコンテンツはAIが生成したもので、不正確である可能性があります。 生成AI用語

この記事では、カスタム AEM コンポーネントがローカル SDKに正常にデプロイされても、Cloud Environmentsには表示されない理由について説明し、SDK バージョンの不一致とその解決方法に焦点を当てます。

説明 description

環境

  • Adobe Experience Manager as a Cloud Service
  • ローカル SDK バージョン：2026.3.*
  • Cloud SDK バージョン：2026.8.*

症状

  • カスタムコンポーネント（カウントダウンクロックなど）が、ローカルのAEM Cloud SDK インスタンスに正常にデプロイされます。
  • コンポーネントは、クラウド環境へのデプロイメント後に表示されません。
  • 特定のエラーメッセージは報告されませんが、パイプライン実行後にクラウド環境にコンポーネントが見つかりません。
  • ローカルデプロイメントは期待どおりに機能します。クラウドデプロイメントにはコンポーネントは含まれません。

再現手順

  1. カウントダウンクロックコンポーネントをローカルのAEM Cloud SDK インスタンス（2026.3.*）にデプロイします。
  2. Cloud SDK（2026.8.*）を使用して、同じコードベースをCloud Environmentにデプロイします。
  3. コンポーネントがローカルに存在するが、クラウド環境に存在しないことを確認します。

原因

ローカル版とクラウド版のSDK版のバージョンが一致していないと、デプロイメントの不一致が生じる可能性があります。多くの場合、最新のSDK リリースで導入された変更内容が破損したり、互換性がなかったりすることが原因です。

解決策 resolution

問題を解決するには、次の手順に従います。

  1. カスタムコンポーネントとその依存関係がCloud SDK バージョン（2026.8.*）と互換性があることを確認します。
  2. 2026.3.から2026.8.​の間の最新の変更については、AEM as a Cloud Service SDK リリースノートを参照してください。
  3. カウントダウンクロックコンポーネントがコードベースに含まれており、ビルドまたはデプロイメントフィルター（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