AEM as a Cloud Service: Komponente wird lokal bereitgestellt, aber nicht in der Cloud, da die SDK-Version nicht übereinstimmt

✨ Dieser Inhalt wird von KI generiert und könnte ungenau sein. Generative KI-Begriffe

In diesem Artikel wird erläutert, warum eine benutzerdefinierte AEM-Komponente erfolgreich auf einer lokalen SDK bereitgestellt werden kann, aber nicht in Cloud-Umgebungen angezeigt wird. Der Schwerpunkt liegt dabei auf nicht übereinstimmenden SDK-Versionen und deren Behebung.

Beschreibung description

Umgebung

  • Adobe Experience Manager as a Cloud Service
  • Lokale SDK-Version: 2026.3.*
  • Cloud SDK-Version: 2026.8.*

Symptome

  • Eine benutzerdefinierte Komponente (z. B. Countdown-Clock) wird erfolgreich auf der lokalen AEM Cloud SDK-Instanz bereitgestellt.
  • Die Komponente wird nach der Bereitstellung in Cloud-Umgebungen nicht angezeigt.
  • Es werden keine spezifischen Fehlermeldungen gemeldet, aber die Komponente fehlt nach der Pipeline-Ausführung in der Cloud-Umgebung.
  • Die lokale Bereitstellung funktioniert erwartungsgemäß. Die -Cloud-Bereitstellung umfasst nicht die -Komponente.

Schritte zum Nachstellen

  1. Stellen Sie die Countdown-Clock-Komponente in einer lokalen AEM Cloud SDK-Instanz bereit (2026.3.*).
  2. Stellen Sie dieselbe Code-Basis in einer Cloud-Umgebung mithilfe von Cloud SDK bereit (2026.8.*).
  3. Beachten Sie, dass die Komponente lokal vorhanden ist, aber in der Cloud-Umgebung fehlt.

Ursache

Eine Diskrepanz zwischen der lokalen und der Cloud-SDK-Version kann zu Bereitstellungsdiskrepanzen führen, die häufig auf laufende Änderungen oder Inkompatibilitäten zurückzuführen sind, die in neueren SDK-Versionen eingeführt wurden.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben.

  1. Stellen Sie sicher, dass die benutzerdefinierte Komponente und ihre Abhängigkeiten mit der Cloud SDK-Version (2026.8.*) kompatibel sind.
  2. Lesen Sie die Versionshinweise zu AEM as a Cloud Service SDK für wichtige Änderungen zwischen 2026.3.und 2026.8..
  3. Vergewissern Sie sich, dass die Countdown-Clock-Komponente in der Code-Basis enthalten ist und nicht durch Build- oder Bereitstellungsfilter (z. B. in filter.xml) ausgeschlossen wird.
  4. Überprüfen Sie vor der Bereitstellung, ob die Komponente im erstellten Paket (.zip oder .jar) vorhanden ist.
  5. Greifen Sie auf die Cloud Manager-Pipeline-Ausführungsprotokolle zu, um Fehler oder Warnungen im Zusammenhang mit der Komponentenbereitstellung zu finden, und suchen Sie nach übersprungenen oder fehlgeschlagenen Paketinstallationen.
  6. Richten Sie eine lokale AEM-Instanz mit der Cloud SDK-Version (2026.8.*) ein und versuchen Sie, die Komponente bereitzustellen.
  7. Wenn sich das Problem lokal in 2026.8.* wiederholt, untersuchen Sie Kompatibilitäts- oder Abhängigkeitsprobleme.
  8. Refaktorieren oder aktualisieren Sie die Komponente, um Kompatibilitätsprobleme zu lösen, die mit der neueren SDK-Version festgestellt wurden.
  9. Paket neu erstellen und bereitstellen.

Nachdem Sie diese Schritte abgeschlossen haben, überprüfen Sie, ob die Komponente in der Cloud-Umgebung angezeigt wird.

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