Replicación replication

Adobe Experience Manager as a Cloud Service usa la capacidad Sling Content Distribution para mover el contenido que se va a replicar a un servicio de canalización que se ejecute en Adobe Developer AEM que esté fuera del tiempo de ejecución de la.

Métodos de publicación de contenido methods-of-publishing-content

Cancelación/publicación rápida: cancelación/publicación planeada publish-unpublish

Esta función le permite publicar las páginas seleccionadas inmediatamente, sin las opciones adicionales posibles a través del enfoque Administrar publicación.

Para obtener más información, consulte Administrar publicación.

Horas de activación y desactivación: configuración del activador on-and-off-times-trigger-configuration

Las posibilidades adicionales de Tiempo de activación y Tiempo de inactividad están disponibles en la Pestaña básica de propiedades de página.

Para realizar la replicación automática de esta característica, habilite Replicar automáticamente en la configuración OSGi Configuración del Déclencheur de activación/desactivación:

Administrar publicación manage-publication

Administrar publicación ofrece más opciones que Quick Publish, pues permite incluir páginas secundarias, personalizar las referencias e iniciar cualquier flujo de trabajo aplicable, además de poder publicar más adelante.

Si se incluyen los elementos secundarios de una carpeta para la opción "publicar más tarde", se invoca el flujo de trabajo del árbol de contenido de Publish que se describe en este artículo.

Puede encontrar información más detallada sobre Administrar publicación en la Documentación de aspectos básicos de la publicación.

Publicación del flujo de trabajo del árbol de contenido publish-content-tree-workflow

Puede activar una replicación de árbol seleccionando Herramientas - Flujo de trabajo - Modelos y copiando el modelo de flujo de trabajo integrado Árbol de contenido de publicación, como se muestra a continuación:

No invoque el modelo original. En su lugar, asegúrese de copiar primero el modelo e invocar esa copia.

Al igual que todos los flujos de trabajo, también se puede invocar mediante una API. Para obtener más información, vea Interactuar con flujos de trabajo mediante programación.

También puede crear un modelo de flujo de trabajo que utilice el paso de proceso Publish Content Tree:

Parámetros

Registro

Cuando se inicia el paso del flujo de trabajo de activación de árbol, registra sus parámetros de configuración en el nivel de registro INFO. Cuando se activan las rutas, también se registra una instrucción INFO.

Se registra una instrucción INFO final después de que el paso del flujo de trabajo haya duplicado todas las rutas.

Además, puede aumentar el nivel de registro de los registradores por debajo de com.day.cq.wcm.workflow.process.impl a DEBUG/TRACE para obtener aún más información de registro.

Si hay errores, el paso del flujo de trabajo finaliza con un WorkflowException, que ajusta la excepción subyacente.

A continuación se muestran ejemplos de registros generados durante un flujo de trabajo de árbol de contenido de publicación de muestra:

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

Reanudar compatibilidad

El flujo de trabajo procesa el contenido en fragmentos, cada uno de los cuales representa un subconjunto del contenido completo que se va a publicar. Si el sistema detiene el flujo de trabajo, se reinicia y procesa el fragmento que aún no se ha procesado. Una instrucción de registro indica que el contenido se reanudó desde una ruta específica.

API de replicación replication-api

Puede publicar contenido mediante la API de replicación que aparece en AEM as a Cloud Service.

Para obtener más información, consulte la Documentación de la API.

Uso básico de la 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);

Replicación con agentes específicos

Al replicar recursos, como en el ejemplo anterior, solo se utilizan los agentes activos de forma predeterminada. En AEM as a Cloud Service, solo significa el agente denominado "publicar", que conecta al autor con el nivel de publicación.

Para admitir la funcionalidad de previsualización, se ha agregado un nuevo agente llamado “previsualización”, que no está activo de forma predeterminada. Este agente se utiliza para conectar al autor al nivel de previsualización. Si desea replicar solo mediante el agente de vista previa, debe seleccionar explícitamente este agente de vista previa mediante un AgentFilter.

Consulte el siguiente ejemplo:

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

Si no proporciona dicho filtro y solo utiliza el agente “publicar”, no se utiliza el agente “previsualización” y la acción de replicación no afecta al nivel de previsualización.

El conjunto ReplicationStatus de un recurso solo se modifica si la acción de replicación incluye al menos un agente activo de forma predeterminada. En el ejemplo anterior, este flujo no era el caso. La replicación estaba utilizando el agente de "previsualización". Por lo tanto, debe utilizar el nuevo método getStatusForAgent(), que permite consultar el estado de un agente específico. Este método también funciona para el agente “publicar”. Devuelve un valor no nulo si se ha realizado alguna acción de replicación con el agente proporcionado.

Métodos de invalidación de contenido invalidating-content

Puede invalidar contenido directamente utilizando Invalidación de contenido de Sling (SCD) del autor (el método preferido) o utilizando la API de replicación para invocar el agente de replicación de vaciado de Dispatcher de publicación. Consulte la página Almacenamiento en caché para obtener más información.

Límites de capacidad de la API de replicación

Repita menos de 100 rutas a la vez, siendo 500 el límite. Por encima del límite, se arroja un ReplicationException.
Si la lógica de la aplicación no requiere replicación atómica, este límite se puede superar configurando ReplicationOptions.setUseAtomicCalls como false, que acepta cualquier número de rutas, pero crea bloques internamente para permanecer por debajo de este límite.

El tamaño del contenido transmitido por llamada de replicación no debe superar 10 MB. Esta regla incluye los nodos y las propiedades, pero no ningún binario (los paquetes de flujo de trabajo y los paquetes de contenido se consideran binarios).

Solución de problemas troubleshooting

Para solucionar problemas de replicación, vaya a las colas de replicación en la interfaz de usuario web del servicio de autor de AEM:

AEM Si no se ha podido publicar el contenido, toda la publicación se revierte desde el servicio de Publish de.

En ese caso, la cola principal editable muestra un estado rojo y debe revisarse para identificar qué elementos provocaron la cancelación de la publicación. Al hacer clic en esa cola, se muestran los elementos pendientes, desde los cuales se puede borrar un solo elemento o todos los elementos si es necesario.