Replicação

O Adobe Experience Manager as a Cloud Service usa o recurso de Distribuição de conteúdo do Sling para mover o conteúdo e replica-lo em um serviço de pipeline executado no Adobe I/O, que está fora do tempo de execução do AEM.

Métodos de publicação de conteúdo

Publicação/Cancelamento de publicação rápidos — Publicação/Cancelamento de publicação planejados

Isso permite publicar as páginas selecionadas imediatamente, sem as opções adicionais possíveis por meio da abordagem Gerenciar publicação.

Para obter mais informações, consulte Gerenciar publicação.

Tempos de ativação e desativação — Configuração do acionador

As possibilidades adicionais de Tempo de ativação e Tempo de desativação estão disponíveis na guia Básico das propriedades de página.

Para efetuar a replicação automática para isso, você precisa ativar a Replicação automática na Configuração do OSGi Configuração do acionador ativado/desativado:

Gerenciar publicação

Gerenciar publicação oferece mais opções do que a Publicação rápida, permitindo a inclusão de páginas secundárias, a personalização das referências e o início de qualquer fluxo de trabalho aplicável, além de oferecer a opção de publicação em uma data posterior.

A inclusão dos derivados de uma pasta na opção “publicar mais tarde” chamará o fluxo de trabalho de publicação da árvore de conteúdo, descrito neste artigo.

Você pode encontrar informações mais detalhadas sobre Gerenciar publicação na Documentação sobre princípios básicos de publicação.

Fluxo de trabalho de publicação da árvore de conteúdo

Você pode acionar uma replicação em árvore ao escolher Ferramentas - Fluxo de trabalho - Modelos e copiar o modelo de fluxo de trabalho pronto para uso Publicar árvore de conteúdo, conforme mostrado abaixo:

Não modifique ou chame o modelo original. Em vez disso, primeiro copie o modelo e depois modifique ou chame essa cópia.

Como todos os fluxos de trabalho, também é possível chamá-lo por meio da API. Para obter mais informações, consulte Interação programática com fluxos de trabalho.

Como alternativa, também é possível fazer isso criando um modelo de fluxo de trabalho que usa a etapa Publish Content Tree do processo:

1. Na página inicial do AEM as a Cloud Service, acesse Ferramentas - Fluxo de trabalho - Modelos

2. Na página Modelos de fluxo de trabalho, clique em Criar no canto superior direito da tela

3. Adicione um título e um nome ao modelo. Para obter mais informações, consulte Criação de modelos de fluxo de trabalho

4. Selecione o modelo recém-criado na lista e clique em Editar

5. Na janela a seguir, arraste e solte a etapa do processo no fluxo do modelo atual:

   

6. Clique na etapa do processo no fluxo e selecione Configurar, selecionando o ícone de chave inglesa

7. Clique na guia Processo e selecione Publish Content Tree na lista suspensa

   

8. Defina quaisquer parâmetros adicionais no campo Argumentos. Vários argumentos separados por vírgula podem ser encadeados. Por exemplo:

   enableVersion=true,agentId=publish,includeChildren=true

   OBSERVAÇÃO

   Para obter a lista de parâmetros, consulte a seção Parâmetros abaixo.

9. Pressione Concluído para salvar o modelo de fluxo de trabalho.

Parâmetros

• includeChildren (valor booleano, padrão: false). “false” significa que somente o caminho é publicado. “true” significa que os derivados também são publicados.
• replicateAsParticipant (valor booleano, padrão: false). Se configurado como true, a replicação está usando o userid do principal que executou a etapa do participante.
• enableVersion (valor booleano, padrão: true). Esse parâmetro determina se uma nova versão será criada na replicação.
• agentId (valor da string; o valor padrão significa que apenas os agentes para publicação são usados). É recomendado ser explícito sobre o agentId; por exemplo, definir o valor como: publicar. Configurar o agente como preview publicará no serviço de visualização
• filters (valor da string; o valor padrão significa que todos os caminhos são ativados). Os valores disponíveis são:
  • onlyActivated - ativar apenas as páginas que (já) foram ativadas. Atua como uma forma de reativação.
  • onlyModified - ativar apenas os caminhos que já estejam ativados e tenham uma data de modificação posterior à data de ativação.
  • O conteúdo acima pode ser ORed com uma barra vertical “|”. Por exemplo, onlyActivated|onlyModified.

Logs

Quando a etapa do fluxo de trabalho de ativação da árvore for iniciada, ela registrará os parâmetros de configuração no nível de log INFO. Quando os caminhos são ativados, uma declaração INFO também é registrada.

Uma declaração INFO final será registrada depois que a etapa do fluxo de trabalho replicar todos os caminhos.

Além disso, você pode aumentar o nível de log dos registradores abaixo de com.day.cq.wcm.workflow.process.impl para DEBUG/TRACE para obter ainda mais informações de log.

No caso de erros, a etapa do fluxo de trabalho é finalizada com uma WorkflowException, que envolve a exceção subjacente.

Abaixo, você encontrará exemplos de logs gerados durante um exemplo de fluxo de trabalho de publicação da árvore de conteúdo:

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

Retomar suporte

O fluxo de trabalho processa o conteúdo em partes, cada uma representando um subconjunto do conteúdo completo a ser publicado. Se, por qualquer motivo, o fluxo de trabalho for interrompido pelo sistema, ele reiniciará e processará a parte que ainda não foi processada. Uma declaração de log indicará que o conteúdo foi retomado de um caminho específico.

API de replicação

Você pode publicar conteúdo usando a API de replicação disponível no AEM as a Cloud Service.

Para obter mais informações, consulte a Documentação da API.

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

Replicação com agentes específicos

Ao replicar recursos como no exemplo acima, somente os agentes que estão ativos por padrão serão usados. No AEM as a Cloud Service, esse será apenas o agente chamado “publicar”, que conecta o autor ao nível de publicação.

Para auxiliar a funcionalidade de visualização, um novo agente chamado “visualização” foi adicionado; esse agente não está ativo por padrão. Esse agente é usado para conectar o autor ao nível de visualização. Se desejar replicar somente por meio do agente de visualização, é necessário selecionar explicitamente esse agente de visualização por meio de um AgentFilter.

Veja o exemplo abaixo sobre como fazer isso:

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

Caso você não forneça esse filtro e use apenas o agente “publicar”, o agente “visualizar” não será usado e a ação de replicação não afetará o nível de visualização.

O ReplicationStatus geral de um recurso só será modificado se a ação de replicação incluir pelo menos um agente que esteja ativo por padrão. No exemplo acima, isso não ocorre, pois a replicação está usando apenas o agente “visualização”. Portanto, é necessário usar o novo método getStatusForAgent(), que permite consultar o status de um agente específico. Esse método também funciona para o agente “publicar”. Ele retorna um valor não nulo se houver alguma ação de replicação feita usando o agente fornecido.

Métodos de invalidação de conteúdo

Você pode invalidar o conteúdo diretamente usando a Invalidação de conteúdo do Sling (SCD) a partir do autor (o método preferencial) ou usando a API de replicação para chamar o agente de replicação de limpeza do Dispatcher de publicação. Consulte a página Armazenamento em cache para obter mais detalhes.

Limites de capacidade da API de replicação

Recomenda-se replicar menos de 100 caminhos de cada vez, sendo 500 o limite rígido. Acima do limite rígido, uma ReplicationException será lançada.
Se a lógica do aplicativo não exigir uma replicação precisa, esse limite poderá ser ultrapassado definindo ReplicationOptions.setUseAtomicCalls como “false”, o que aceitará qualquer número de caminhos, mas criará compartimentos internamente para permanecer abaixo desse limite.

O tamanho do conteúdo transmitido por chamada de replicação não deve exceder 10 MB. Isso inclui os nós e as propriedades, mas não os binários (pacotes de fluxo de trabalho e de conteúdo são considerados binários).

Resolução de problemas

Para solucionar problemas de replicação, navegue até as filas de replicação na interface web do serviço do autor do AEM:

1. No menu inicial do AEM, navegue até Ferramentas > Implantação > Distribuição
2. Selecione o cartão publicar
   
3. Verifique o status da fila, que deve estar em verde
4. Você pode testar a conexão com o serviço de replicação
5. Selecione a guia Logs, que mostra o histórico de publicações de conteúdo

Se o conteúdo não puder ser publicado, toda a publicação será revertida do serviço de publicação do AEM.
Nesse caso, a fila principal e editável mostrará um status vermelho e deverá ser revisada para identificar quais itens causaram o cancelamento da publicação. Ao clicar nessa fila, seus itens pendentes serão exibidos, a partir dos quais um único item ou todos os itens podem ser apagados, se necessário.

Recursos do Business.Adobe.com