Beheben von AEM as a Cloud Service-Pipeline-Fehlern während Indexaktualisierungen
In diesem Artikel wird erläutert, wie Fehler in der AEM as a Cloud Service Cloud Manager-Pipeline behoben werden, die während des Indexaktualisierungsschritts nach der Bereitstellung benutzerdefinierter oder erweiterter Indexdefinitionen auftreten. Die Anleitung behandelt häufige Ursachen und ausführbare Schritte, um eine erfolgreiche Bereitstellung sicherzustellen.
Beschreibung description
Umgebung
Adobe Experience Manager as a Cloud Service (AEMaaCS)
Problem/Symptome
- Pipeline-Fehler mit Fehlern, die auf Probleme beim Abrufen neuer Indexdefinitionen hinweisen
- Validierungswarnungen im Zusammenhang mit Indexkonfigurationsdateien
Ursache
Zu den Grundursachen gehören häufig Diskrepanzen zwischen benutzerdefinierten Indexdefinitionen und den vordefinierten Indexversionen in der Zielumgebung, unvollständige oder ungültige Tika-Konfigurationen oder falsche Verfahren für die Indexbenennung und Versionierung.
Lösung resolution
Gehen Sie wie folgt vor, um das Problem zu beheben:
- Vergleichen Sie Ihre benutzerdefinierten Indexdefinitionen mit den vorkonfigurierten Indexdefinitionen in der Zielumgebung. Rufen Sie die neueste vorkonfigurierte Indexdefinition (z. B. damAssetLucene-14) aus einer AEM as a Cloud Service-Umgebung ab, in der dieselbe oder eine neuere Version als in der Zielumgebung ausgeführt wird.
- Führen Sie Ihre benutzerdefinierten Änderungen mit der neuesten OOTB-Definition zusammen und weisen Sie einen entsprechenden versionierten benutzerdefinierten Namen zu (z. B. damAssetLucene-14-custom-2). Gehen Sie nicht davon aus, dass die OOTB-Version in der Entwicklungsumgebung mit der Version in anderen Umgebungen übereinstimmt.
- Validieren Sie die Tika-Konfiguration in der benutzerdefinierten Indexdefinition. Stellen Sie sicher, dass die vollständige Tika-Unterstruktur vorhanden und gültig ist, einschließlich der Einstellungen für tika/-Ordner, config.xml, jcr:content, jcr:data und jcr:mimeType für application/xml. Vermeiden Sie partielle Überschreibungen oder leere config.xml-Knoten.
- Befolgen Sie die AEM as a Cloud Service-Benennungskonventionen für benutzerdefinierte Indizes. Verwenden Sie für vollständig benutzerdefinierte Indizes einen eindeutigen benutzerdefinierten Namen und eine eindeutige Version (z. B. -custom-1). Verwenden Sie für Erweiterungen von OOTB-Indizes das OOTB-Benennungs- und Versionierungsmuster. Benennen oder löschen Sie bereitgestellte Indexknoten nicht direkt in der Cloud-Umgebung.
- Vergewissern Sie sich, dass sich alle Indexdefinitionen unter ui.apps/src/main/content/jcr_root/_oak_index befinden und im Anwendungs-Code-Paket enthalten sind, nicht aber in einem veränderlichen Inhaltspaket. Stellen Sie sicher, dass die Paketmetadaten „allowIndexDefinitions=true“ und „noIntermediateSaves=true“ enthalten. Alle Indexdefinitionen müssen eine Cloud-kompatible Lucene-Konfiguration verwenden und unterstützte asynchrone Einstellungen (z. B.
[async],[async, nrt]oder[fulltext-async]). - Stellen Sie das überarbeitete Paket in einer niedrigeren Umgebung bereit und stellen Sie sicher, dass die Bereitstellung erfolgreich abgeschlossen wurde, die erwarteten Indexdefinitionen vorhanden sind und Abfragen die vorgesehenen Indizes verwenden.
- Benennen oder löschen Sie Indexknoten nicht direkt, um alte Indexdefinitionen einzustellen. Behandeln Sie stattdessen die Außerkraftsetzung als separate Code-Änderung über Cloud Manager. Beim Entfernen von Einträgen aus „filter.xml“ allein werden bereitgestellte Indexdaten nicht entfernt. Verwenden Sie eine nachfolgende konforme Indexdefinition, um den vorherigen Index zu deaktivieren und ihn für eine periodische Bereinigung geeignet zu machen.
Führen Sie nach Abschluss dieser Schritte die Pipeline erneut aus und überprüfen Sie, ob die Bereitstellung erfolgreich war und die beabsichtigten Indizes aktiv sind.