DokumentationAEM 6.4Administratorenanleitung

MSM-Rollout-Konflikte msm-rollout-conflicts

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

Konflikte sind möglich, wenn neue Seiten mit demselben Seitennamen im Blueprint-Zweig und in einer abhängigen Live Copy-Verzweigung erstellt werden.

Solche Konflikte müssen beim Rollout gehandhabt und aufgelöst werden.

Konfliktbehandlung conflict-handling

Wenn in Konflikt stehende Seiten vorhanden sind (in den Blueprint- und Live Copy-Verzweigungen), können Sie mit MSM definieren, wie diese verarbeitet werden sollen (oder auch wenn dies der Fall ist).

Um sicherzustellen, dass der Rollout nicht gesperrt ist, können mögliche Definitionen Folgendes umfassen:

  • welche Seite (Blueprint oder Live Copy) beim Rollout Priorität hat,

  • Welche Seiten umbenannt werden (und wie)

  • Wie dies jeglichen veröffentlichten Inhalt beeinflusst

    Das Standardverhalten von AEM (Out-of-the-Box) besteht darin, dass veröffentlichte Inhalte davon unbeeinflusst bleiben. Wenn also eine Seite veröffentlicht wurde, die manuell im Live Copy-Zweig erstellt wurde, wird dieser Inhalt nach der Konfliktbehandlung und dem Rollout weiterhin veröffentlicht.

Neben der Standardfunktion können auch benutzerdefinierte Konflikt-Handler hinzugefügt werden, um verschiedene Regeln zu implementieren. Diese können auch Veröffentlichungsaktionen als einzelner Prozess zulassen.

Beispiel-Szenario example-scenario

In den folgenden Abschnitten werden wir zum Veranschaulichen der verschiedenen Verfahren zur Konfliktbewältigung das Beispiel einer neuen Seite b verwenden, die sowohl im Blueprint- als auch im Live Copy-Zweig (manuell) erstellt wurde:

  • Blueprint: /b

    Primäre Seite mit 1 untergeordneten Seite, bp-level-1.

  • Live Copy: /b

    Eine im Live Copy-Zweig manuell erstellte Seite mit 1 untergeordneten Seite, lc-level-1.

    • Bei Veröffentlichung als /b aktiviert, zusammen mit der untergeordneten Seite.

Vor dem Rollout

Blueprint vor dem Rollout
Live Copy vor dem Rollout
Vor dem Rollout veröffentlichen
b
(In der Blueprint-Verzweigung erstellt, bereit für den Rollout)
b
(Manuell in der Live Copy-Verzweigung erstellt)
b
(Enthält den Inhalt der Seite b, die in der Live Copy-Verzweigung manuell erstellt wurde)
/bp-level-1
/lc-level-1
(Manuell in der Live Copy-Verzweigung erstellt)
/lc-level-1
(Enthält den Inhalt der Seite
„child-level-1“, die in der Live Copy-Verzweigung manuell erstellt wurde)

Rollout-Manager und Konfliktbehandlung rollout-manager-and-conflict-handling

Mit dem Rollout-Manager können Sie das Konflikt-Management aktivieren oder deaktivieren.

Dies erfolgt mithilfe der OSGi-Konfiguration von Day CQ WCM Rollout Manager:

  • So können Sie einen Konflikt mit manuell erstellten Seiten beheben:

    (rolloutmgr.conflicthandling.enabled)

    Legen Sie auf „true“ fest, wenn der Rollout-Manager Konflikte von einer Seite bewältigen soll, die in der Live Copy mit einem in der Blueprint vorhandenen Namen erstellt wurde.

AEM verfügt über ein vordefiniertes Verhalten, wenn das Konflikt-Management deaktiviert wurde.

Konflikt-Handler conflict-handlers

AEM nutzt Konflikt-Handler zum Lösen von Seitenkonflikten, die beim Rollout von Inhalten von einer Blueprint zu einer Live Copy vorliegen. Das Umbenennen von Seiten ist eine (übliche) Methode zur Lösung solcher Konflikte. Es können mehrere Konflikt-Handler verwendet werden, um eine Auswahl verschiedener Verhaltensweisen zu ermöglichen.

AEM bietet:

  • Die Standard-Konflikt-Handler:

    • ResourceNameRolloutConflictHandler

  • Die Möglichkeit, einen benutzerdefinierten Handler zu implementieren.

  • Den Service-Ranking-Mechanismus, mit dem Sie die Priorität jedes einzelnen Handlers festlegen können. Der Service mit dem höchsten Ranking wird verwendet.

Standard-Konflikt-Handler default-conflict-handler

Der standardmäßige Konflikt-Handler:

  • Heißt ResourceNameRolloutConflictHandler

  • Mit diesem Handler hat die Blueprint-Seite Vorrang.

  • Das Service-Ranking für diesen Handler wurde als niedrig festgelegt (d. h. unterhalb des Standardwerts für die Eigenschaft service.ranking), da davon ausgegangen wird, dass benutzerdefinierte Handler ein höheres Ranking benötigen. Das Ranking ist jedoch nicht das absolute Minimum, um bei Bedarf Flexibilität zu gewährleisten.

Dieser Konflikt-Handler hat Vorrang vor dem Blueprint. Die Live Copy-Seite /b wird (innerhalb der Live Copy-Verzweigung) nach /b_msm_moved verschoben.

  • Live Copy: /b

    Wird (innerhalb der Live Copy) nach /b_msm_moved verschoben. Dies dient als Sicherung und stellt sicher, dass keine Inhalte verloren gehen.

    • lc-level-1 wird nicht verschoben.

  • Blueprint: /b

    Wird beim Rollout auf die Live Copy-Seite /b verschoben.

    • bp-level-1 wird beim Rollout auf die Live Copy-Seite verschoben.

Nach dem Rollout

Blueprint nach dem Rollout
Live Copy nach dem Rollout
Live Copy nach dem Rollout
Nach dem Rollout veröffentlichen
b
b
(Enthält den Inhalt der Blueprint-Seite b, die beim Rollout verschoben wurde)
b_msm_moved
(Enthält den Inhalt der Seite b, die in der Live Copy-Verzweigung manuell erstellt wurde)
b
(Keine Änderung, enthält den Inhalt der Originalseite b, die manuell in der Live Copy-Verzweigung erstellt wurde und jetzt b_msm_moved heißt)
/bp-level-1
/bp-level-1
/lc-level-1
(Keine Änderung)
``
/lc-level-1
(Keine Änderung)

Angepasste Handler customized-handlers

Mit benutzerdefinierten Konflikt-Handlern können Sie Ihre eigenen Regeln implementieren. Mit dem Service-Ranking-Mechanismus können Sie auch definieren, wie sie mit anderen Handlern interagieren.

Benutzerdefinierte Konflikt-Handler können:

  • gemäß Ihren Anforderungen benannt werden; ``

  • entsprechend Ihren Anforderungen entwickelt/konfiguriert werden; Sie können beispielsweise einen Handler entwickeln, der der Live Copy-Seite Vorrang einräumt.

  • Kann für die Konfiguration mit dem OSGi-Konfiguration; insbesondere

    • Dienstpriorität:

      Bestimmt die Reihenfolge in Bezug auf andere Konflikt-Handler (service.ranking).

      Der Standardwert ist 0.

Verhalten bei deaktivierter Konfliktbehandlung behavior-when-conflict-handling-deactivated

Wenn Sie manuell Deaktivieren der Konfliktbehandlung AEM keine Maßnahmen auf Konfliktseiten ergreifen (nicht widersprüchliche Seiten werden erwartungsgemäß bereitgestellt).

CAUTION
AEM gibt keinen Hinweis darauf, dass Konflikte ignoriert werden, da dieses Verhalten explizit konfiguriert werden muss. Daher wird davon ausgegangen, dass es sich um das erforderliche Verhalten handelt.

In diesem Fall hat die Live Copy effektiv Vorrang. Die Blueprint-Seite /b wird nicht kopiert und die Live Copy-Seite /b bleibt unberührt.

  • Blueprint: /b

    wird überhaupt nicht kopiert, sondern ignoriert.

  • Live Copy: /b

    Bleibt gleich.

Blueprint nach dem Rollout
Live Copy nach dem Rollout
Nach dem Rollout veröffentlichen
b
b
(keine Änderung; enthält den Inhalt der Seite b, die in der Verzweigung der Live Copy manuell erstellt wurde)
b
(keine Änderung; enthält den Inhalt der Seite b, die manuell in der Verzweigung der Live Copy erstellt wurde)
/bp-level-1
/lc-level-1
(Keine Änderung)
/lc-level-1
(Keine Änderung)

Service-Rangfolge service-rankings

Die OSGi-Service-Rangfolge kann zum Definieren der Priorität von einzelnen Konflikt-Handlern verwendet werden.

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8