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 que esté fuera del tiempo de ejecución de AEM.

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 Publicación rápida, pues permite incluir páginas secundarias, personalizar las referencias e iniciar cualquier flujo de trabajo aplicable, además de poder publicar más adelante.

Al incluir los elementos secundarios de una carpeta para la opción “publicar más tarde” se invoca el flujo de trabajo Publicar árbol de contenido, descrito en Flujos de trabajo de replicación de árbol.

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

Para replicar jerarquías de contenido profundo de forma masiva, utilice un método basado en flujos de trabajo. Consulte Flujos de trabajo de replicación de árbol para ver el paso recomendado del flujo de trabajo de activación de árbol, los parámetros de configuración y las instrucciones de supervisión. El flujo de trabajo obsoleto Publicar árbol de contenido también se documenta allí como referencia.

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 than 1 resource at once, this approach is more performant
Map<String,ReplicationStatus> allStatus = replicationStatusProvider.getBatchReplicationStatus(enResource,deResource);

Agentes de replicación

AEM as a Cloud Service proporciona dos agentes de replicación predefinidos que enrutan el contenido de autor a un nivel de destino a través de Sling Content Distribution:

Puede ver y supervisar ambos agentes desde Herramientas > Implementación > Distribución:

Al seleccionar una tarjeta de agente, se abre su estado, los registros y detalles de la cola.

Replicación con agentes específicos

Al replicar con la API como se muestra arriba, solo se usan los agentes habilitados de forma predeterminada; es decir, solo publicar en AEM as a Cloud Service. Para replicar exclusivamente en el nivel de vista previa, pase un AgentFilter que seleccione el agente de vista previa:

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 replica sin AgentFilter, solo se usa publish y el nivel de vista previa no se ve afectado.

El ReplicationStatus general de un recurso se actualiza solamente cuando la replicación incluye al menos un agente habilitado de manera predeterminada. En el ejemplo anterior, solo se usó preview, de modo que ReplicationStatus.isActivated permanece false. Use getStatusForAgent() para comprobar el estado de un agente específico; por ejemplo, getStatusForAgent("preview") después de una replicación de solo vista previa o getStatusForAgent("publish") para el nivel de publicación activa.

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 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).

Colas de replicación replication-queues

Cada agente de replicación muestra dos colas de replicación. AEM as a Cloud Service ya no muestra una cola independiente para cada pod de publicación: el nivel de publicación se adapta automáticamente, por lo que las colas por pod añaden complejidad sin ninguna ventaja práctica. El estado de la cola se consolida de la siguiente manera:

Supervisar colas de replicación monitor-replication-queues

Resolución de problemas troubleshooting

Si el contenido no se puede publicar, la publicación se revierte desde el servicio de publicación de AEM. Use Supervisar colas de replicación para abrir la ficha Estado del agente e identificar la cola afectada.

Cuando una cola muestra un estado rojo, revise sus elementos pendientes para averiguar la causa del error. Seleccione la cola para ver los elementos pendientes y, a continuación, borre los elementos individuales o toda la cola si es necesario.