Replikering replication

Adobe Experience Manager as a Cloud Service använder funktionen Sling Content Distribution för att flytta innehållet som ska replikeras till en pipeline-tjänst som körs på Adobe Developer och som ligger utanför AEM.

Metoder för publicering av innehåll methods-of-publishing-content

Quick Un/Publish - Planerad UN/Publish publish-unpublish

Med den här funktionen kan du publicera de valda sidorna direkt, utan de ytterligare alternativ som är möjliga via Hantera publikation.

Mer information finns i Hantera publikation.

På- och avaktiveringstider - utlösarkonfiguration on-and-off-times-trigger-configuration

De ytterligare möjligheterna för På tid och Fråntid finns på fliken Grundläggande i Sidegenskaper.

Aktivera Automatisk replikering i OSGi-konfigurationen Vid utlösarkonfiguration om du vill genomföra den automatiska replikeringen för den här funktionen:

Hantera publikation manage-publication

Med Hantera publikation får du fler alternativ än med Quick Publish, där du kan inkludera underordnade sidor, anpassa referenserna och starta tillämpliga arbetsflöden och erbjuda möjlighet att publicera senare.

Om du tar med en mapps underordnade objekt för alternativet"publicera senare" anropas arbetsflödet för Publish Content Tree, som beskrivs i den här artikeln.

Mer detaljerad information om Hantera publikation finns i Dokumentationen om grunderna för publicering.

Publish Content Tree Workflow publish-content-tree-workflow

Du kan utlösa en trädreplikering genom att välja Verktyg - Arbetsflöde - Modeller och kopiera arbetsflödesmodellen Publish Content Tree som är körklar, vilket visas nedan:

Anropa inte den ursprungliga modellen. Kontrollera i stället att först kopiera modellen och anropa kopian.

Precis som med alla arbetsflöden kan den också anropas via API. Mer information finns i Interagera med arbetsflöden programmatiskt.

Du kan också skapa en arbetsflödesmodell som använder processsteget Publish Content Tree:

Parametrar

Loggar

När arbetsflödessteget för trädaktivering startar loggas dess konfigurationsparametrar på INFO-loggnivån. När sökvägar aktiveras loggas även en INFO-sats.

En slutgiltig INFO-sats loggas när arbetsflödessteget har replikerat alla sökvägar.

Du kan också öka loggningsnivån för loggarna under com.day.cq.wcm.workflow.process.impl till DEBUG/TRACE för att få ännu mer logginformation.

Om det finns fel avslutas arbetsflödessteget med WorkflowException, som omsluter det underliggande undantaget.

Här följer exempel på loggar som genereras under ett exempel på arbetsflöde för publiceringsinnehåll:

21.04.2021 19:14:55.566 [cm-p123-e456-aem-author-797aaaf-wkkqt] *INFO* [JobHandler: /var/workflow/instances/server60/2021-04-20/brian-tree-replication-test-2_1:/content/wknd/us/en/adventures] com.day.cq.wcm.workflow.process.impl.treeactivation.TreeActivationWorkflowProcess TreeActivation options: replicateAsParticipant=false(userid=workflow-process-service), agentId=publish, chunkSize=100, filter=, enableVersion=false

21.04.2021 19:14:58.541 [cm-p123-e456-aem-author-797aaaf-wkkqt] *INFO* [JobHandler: /var/workflow/instances/server60/2021-04-20/brian-tree-replication-test-2_1:/content/wknd/us/en/adventures] com.day.cq.wcm.workflow.process.impl.ChunkedReplicator closing chunkedReplication-VolatileWorkItem_node1_var_workflow_instances_server60_2021-04-20_brian-tree-replication-test-2_1, 17 paths replicated in 2971 ms

Återuppta support

Arbetsflödet bearbetar innehåll i segment, som representerar en delmängd av det fullständiga innehåll som ska publiceras. Om arbetsflödet stoppas av systemet startas det om och bearbetar det segment som ännu inte bearbetats. En loggsats anger att innehållet återupptogs från en viss sökväg.

Replikerings-API replication-api

Du kan publicera innehåll med det replikerings-API som finns i AEM as a Cloud Service.

Mer information finns i API-dokumentationen.

Grundläggande användning av API

@Reference
Replicator replicator;
@Reference
ReplicationStatusProvider replicationStatusProvider;

....
Session session = ...
// Activate a single page to all agents, which are active by default
replicator.replicate(session,ReplicationActionType.ACTIVATE,"/content/we-retail/en");
// Activate multiple pages (but try to limit it to approx 100 at max)
replicator.replicate(session,ReplicationActionType.ACTIVATE, new String[]{"/content/we-retail/en","/content/we-retail/de"});

// ways to get the replication status
Resource enResource = resourceResolver.getResource("/content/we-retail/en");
Resource deResource = resourceResolver.getResource("/content/we-retail/de");
ReplicationStatus enStatus = enResource.adaptTo(ReplicationStatus.class);
// if you need to get the status for more more than 1 resource at once, this approach is more performant
Map<String,ReplicationStatus> allStatus = replicationStatusProvider.getBatchReplicationStatus(enResource,deResource);

Replikering med specifika agenter

Vid replikering av resurser, som i exemplet ovan, används bara de agenter som är aktiva som standard. I AEM as a Cloud Service betyder det bara agenten"publish", som kopplar författaren till publiceringsnivån.

En ny agent med namnet"preview" har lagts till som stöd för förhandsvisningsfunktionen, som inte är aktiv som standard. Den här agenten används för att ansluta författaren till förhandsgranskningsnivån. Om du bara vill replikera via förhandsgranskningsagenten måste du uttryckligen välja den här förhandsgranskningsagenten med hjälp av en AgentFilter.

Se följande exempel:

private static final String PREVIEW_AGENT = "preview";

ReplicationStatus beforeStatus = enResource.adaptTo(ReplicationStatus.class); // beforeStatus.isActivated == false

ReplicationOptions options = new ReplicationOptions();
options.setFilter(new AgentFilter() {
  @Override
  public boolean isIncluded (Agent agent) {
    return agent.getId().equals(PREVIEW_AGENT);
  }
});
// will replicate only to preview
replicator.replicate(session,ReplicationActionType.ACTIVATE,"/content/we-retail/en", options);

ReplicationStatus afterStatus = enResource.adaptTo(ReplicationStatus.class); // afterStatus.isActivated == false
ReplicationStatus previewStatus = afterStatus.getStatusForAgent(PREVIEW_AGENT); // previewStatus.isActivated == true

Om du inte anger ett sådant filter och bara använder agenten för publicering, används inte agenten för förhandsgranskning och replikeringsåtgärden påverkar inte förhandsgranskningsnivån.

Den övergripande ReplicationStatus för en resurs ändras bara om replikeringsåtgärden innehåller minst en agent som är aktiv som standard. I exemplet ovan var detta inte fallet. Replikeringen använde just agenten för förhandsgranskning. Du måste därför använda den nya metoden getStatusForAgent() som tillåter att du frågar efter status för en viss agent. Den här metoden fungerar även för agenten"publish". Det returnerar ett värde som inte är null om någon replikeringsåtgärd har utförts med den angivna agenten.

Metoder för att verifiera innehåll invalidating-content

Du kan göra innehåll ogiltigt direkt genom att antingen använda Sling Content Invalidation (SCD) från författaren (den önskade metoden) eller genom att använda replikerings-API:t för att anropa den publicerade Dispatcher flush-replikeringsagenten. Mer information finns på sidan Caching.

Kapacitetsbegränsningar för replikerings-API

Replikera färre än 100 banor i taget, med 500 som gräns. Ovanför gränsen genereras en ReplicationException.
Om programlogiken inte kräver atomisk replikering kan den här gränsen överskridas genom att ReplicationOptions.setUseAtomicCalls anges till false, vilket tar ett valfritt antal sökvägar, men internt skapar bucklor som ligger under den här gränsen.

Storleken på innehållet som skickas per replikeringsanrop får inte överstiga 10 MB. Den här regeln omfattar noder och egenskaper, men inte binärfiler (arbetsflödespaket och innehållspaket betraktas som binärfiler).

Felsökning troubleshooting

Om du vill felsöka replikering går du till replikeringsköerna i webbgränssnittet för AEM författartjänst:

Om det inte gick att publicera innehållet återställs hela publikationen från AEM Publish-tjänst.

I så fall visar den huvudsakliga, redigerbara kön en röd status och bör granskas för att identifiera vilka objekt som gjorde att publiceringen avbröts. Genom att klicka på den kön visas de väntande objekten, från vilka ett eller alla objekt kan rensas vid behov.