Replikering replication

Adobe Experience Manager as a Cloud Service använder Distribution av säljinnehåll möjlighet att flytta det innehåll 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

Snabb borttagning/publicering - planerad avstängning/publicering 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

Ytterligare möjligheter för I tid och Fråntid är tillgängliga från Fliken Grundläggande i Sidegenskaper.

Aktivera om du vill genomföra den automatiska replikeringen för den här funktionen Automatisk replikering i OSGi-konfiguration Konfiguration av utlösare vid avstängning:

Hantera publikation manage-publication

Med Hantera publikation får du fler alternativ än Snabbpublicering, så att 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 Publicera innehållsträd, som beskrivs i den här artikeln.

Mer information om Hantera publikation finns i Dokumentation för Publishing Fundamentals.

Publicera arbetsflöde för innehållsträd publish-content-tree-workflow

Du kan aktivera en trädreplikering genom att välja Verktyg - Arbetsflöde - Modeller och kopiera Publicera innehållsträd körklar arbetsflödesmodell, enligt 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 Publish Content Tree processteg:

Parametrar

Loggning

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 även öka loggningsnivån nedan 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 ett 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 hjälp av replikerings-API:t på AEM as a Cloud Service.

Mer information finns i API-dokumentation.

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. På 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 via 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.

Det ö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. Därför måste du använda den nya getStatusForAgent() -metod, som tillåter frågor om 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 föredragna metoden) eller genom att använda replikerings-API:t för att anropa replikeringsagenten för publiceringsrensningen för Dispatcher. Se Cachning sida för mer information.

Kapacitetsbegränsningar för replikerings-API

Replikera färre än 100 banor i taget, med 500 som gräns. Ovanför gränsen är ReplicationException kastas.
Om programlogiken inte kräver atomisk replikering kan den här gränsen överskridas genom att du ställer in ReplicationOptions.setUseAtomicCalls till false, vilket accepterar valfritt antal banor, men internt skapar buketter som ligger under denna gräns.

Storleken på innehållet som skickas per replikeringsanrop får inte överskrida 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 innehållet inte kunde publiceras återställs hela publikationen från AEM Publiceringstjä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.