Invalidar o cache da CDN por meio do Dynamic Media invalidating-cdn-cache-for-dm-assets-in-aem-cs

Os ativos do Dynamic Media são armazenados em cache pela CDN (Content Delivery Network) para entrega rápida aos clientes. No entanto, ao atualizar esses ativos, você deseja que essas alterações entrem em vigor imediatamente no site. A limpeza ou invalidação do cache CDN permite atualizar rapidamente os ativos entregues pelo Dynamic Media. Não é mais necessário aguardar a expiração do cache usando um valor TTL (Time To Live) (o padrão é dez horas). Em vez disso, você pode enviar uma solicitação de dentro da interface do usuário do Dynamic Media para que o cache expire em minutos.

NOTE
Esse recurso exige que você use o CDN em pacote de Adobe que vem com o Adobe Experience Manager Dynamic Media. Qualquer outra CDN personalizada não é compatível com esse recurso.

Se você ativou Imagem inteligente em sua conta e estiver usando o CDN agrupado por Adobe, você poderá limpar todos os URLs com diferentes cadeias de caracteres de consulta limpando o URL de base única.

Por exemplo, invalidar https://weekendsite.scene7.com/is/image/<CUSTOMER-NAME>/image, também invalida os seguintes URLs:

  • https://weekendsite.scene7.com/is/image/<CUSTOMER-NAME>/image
  • https://weekendsite.scene7.com/is/image/<CUSTOMER-NAME>/image?wid=300
  • https://weekendsite.scene7.com/is/image/<CUSTOMER-NAME>/image?$PLP$
  • e assim por diante.

No entanto, esse não é o caso para domínios genéricos que não oferecem suporte à Imagem inteligente, como s7d1.scene7.com. Esses domínios ainda precisam do URL completo para que a invalidação funcione com êxito.

Para invalidar o cache CDN por meio do Dynamic Media:

Parte 1 de 2: Criação de um modelo de Invalidação da CDN

  1. No Adobe Experience Manager as a Cloud Service, acesse Ferramentas > Assets > Modelo de invalidação da CDN.

    Recurso de validação da CDN

  2. No Modelo de invalidação da CDN execute uma das seguintes opções com base no seu cenário:

    table 0-row-2 1-row-2 2-row-2
    Cenário Opção
    Já criei um modelo de invalidação CDN no passado usando o Dynamic Media Classic. A variável Criar modelo O campo de texto é pré-preenchido com os dados do modelo. Nesse caso, você pode editar o modelo ou continuar para a próxima etapa.
    Preciso criar um template. O que eu insiro? No Criar modelo campo de texto, insira um URL de imagem (incluindo predefinições de imagem ou modificadores) que faça referência <ID>, em vez de uma ID de imagem específica, como no exemplo a seguir:
    https://my.publishserver.com/is/image/company_name/<ID>?$product$
    Se o modelo contiver apenas <ID>, então o Dynamic Media preenche https://<publishserver_name>/is/image/<company_name>/<ID> onde <publishserver_name> é o nome do servidor de publicação definido em Configurações gerais no Dynamic Media Classic. A variável <company_name> é o nome da raiz da empresa associada a essa instância do Experience Manager e <ID> Os ativos selecionados por meio do seletor de ativos estão sendo invalidados.
    Quaisquer predefinições/modificadores após <ID> são copiados como estão na definição do URL.
    Somente imagens, ou seja, /is/image- pode ser formado automaticamente com base no modelo.
    Para /is/content/, a adição de ativos como vídeos ou PDF usando o seletor de ativos não gera URLs automaticamente. Em vez disso, você deve especificar esses ativos no modelo de Invalidação da CDN ou pode adicionar manualmente o URL a esses ativos no Parte 2 de 2: Definição de opções de invalidação de CDN.
    Exemplos:
    Neste primeiro exemplo, o template de invalidação contém <ID> juntamente com o URL do ativo com /is/content. Por exemplo, http://my.publishserver.com:8080/is/content/dms7snapshot/<ID>. O Dynamic Media forma o URL com base nesse caminho, com <ID> são os ativos selecionados por meio do seletor de ativos que você deseja invalidar.
    Neste segundo exemplo, o modelo de invalidação contém o URL completo do ativo usado nas propriedades da Web com /is/content (não depende do seletor de ativos). Por exemplo, http://my.publishserver.com:8080/is/content/dms7snapshot/backpack onde backpack é a ID do ativo.
    Os formatos de ativos compatíveis com o Dynamic Media são qualificados para invalidação. Tipos de arquivos de ativos que são não Os compatíveis com a invalidação de CDN incluem PostScript®, Encapsulated PostScript®, Adobe Illustrator, Adobe InDesign, Microsoft® Powerpoint, Microsoft® Excel, Microsoft® Word e Rich Text Format.

    · Ao criar o modelo, mas preste muita atenção à sintaxe e aos erros de digitação; o Dynamic Media não faz nenhuma validação de modelo.
    · O Modelo de invalidação da CDN pode salvar texto de até 2500 caracteres.
    · Especifique URLs para cortes inteligentes de imagem neste modelo de Invalidação da CDN ou no Adicionar URL campo de texto em Parte 2: Definir opções de invalidação da CDN.
    · Cada entrada em um modelo de Invalidação da CDN deve estar em sua própria linha.
    · O seguinte exemplo de modelo de Invalidação de CDN é somente para fins de demonstração.

    Modelo de invalidação da CDN - Criar

    note note
    NOTE
    O Modelo de invalidação da CDN pode salvar texto de até 2500 caracteres.
  3. No canto superior direito da Modelo de invalidação da CDN selecione Salvar e selecione OK.

    Parte 2 de 2: Definição de opções de invalidação de CDN

  4. No Experience Manager as a Cloud Service, acesse Ferramentas > Assets > Invalidação da CDN.

    Recurso de validação da CDN

  5. No Invalidação da CDN - Adicionar detalhes selecione os ativos para invalidação da CDN.

    Invalidação da CDN - Adicionar detalhes

    note note
    NOTE
    Se você decidir deixar as opções Invalidar predefinições de imagem associadas a ativos na CDN e Invalidar com base no modelo desmarcada, o URL básico dos ativos selecionados é formado para invalidação. Use esta organização de opção somente para imagens.
    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Opção Descrição
    Invalidar predefinições de imagem associadas a ativos na CDN (Opcional) Ao marcar essa opção, os ativos selecionados e todos os URLs de predefinição de imagem associados são formados automaticamente para invalidação de cache.
    Os ativos e seus URLs predefinidos predefinidos associados são formados automaticamente para invalidação. Essa opção funciona somente para ativos de imagem.
    Invalidação com base no modelo (Opcional) Marque essa opção para usar somente o modelo definido para a formação de URL.
    Adicionar ativos Use o Seletor de ativos para selecionar os ativos que deseja invalidar. Você pode selecionar ativos publicados ou não publicados.
    O armazenamento em cache na CDN é baseado em URL, não em ativo. Portanto, é necessário que você esteja ciente de todos os URLs que estão em seu site. Depois de determinar esses URLs, você pode adicioná-los ao modelo. Em seguida, você pode selecionar e adicionar esses ativos e invalidar os URLs em uma etapa.
    Use esta opção com Invalidar predefinições de imagem associadas a ativos na CDN ou Invalidação com base no modelo, ou ambos.
    Adicionar URL Adicione ou cole manualmente caminhos completos de URL para ativos do Dynamic Media cujo cache do CDN você deseja invalidar. Use essa opção se você não criou um Modelo de invalidação CDN no Parte 1 de 2: Criação de um modelo de Invalidação da CDN e têm apenas alguns ativos para invalidar.
    Importante: Cada URL que você adicionar deve estar em sua própria linha.
    Você pode invalidar até 1000 URLs em um determinado momento. Se o número de URLs na variável Adicionar URL o campo de texto for maior que 1000, você não poderá selecionar Próxima. Nesses casos, você deve selecionar X à direita de um ativo selecionado ou de um URL adicionado manualmente para excluí-lo da lista de invalidação.
    Especifique URLs para cortes inteligentes de imagem no modelo de Invalidação da CDN ou neste Adicionar URL campo de texto.
  6. Próximo ao canto superior direito da página, selecione Próxima.

  7. No Invalidação da CDN - Confirmar o página, no campo URLs , você verá uma lista de um ou mais URLs gerados a partir do Modelo de invalidação CDN criado anteriormente e dos ativos que você acabou de adicionar.

    Por exemplo, usando o exemplo de Modelo de invalidação CDN que foi mostrado nas etapas anteriores, suponha que você tenha adicionado um único ativo chamado spinset. Quando você vai para o Ferramentas > Assets > Invalidação da CDN, isso resulta nos cinco URLs gerados a seguir no Invalidação da CDN - Confirmar interface do usuário:

    Invalidação da CDN - Confirmar

    Se necessário, selecione X à direita de um URL para excluí-lo do processo de invalidação.

  8. Próximo ao canto superior direito da página, selecione Enviar para iniciar o processo de invalidação da CDN.

Solução de problemas de erros de invalidação da CDN

Em todos os casos, o lote inteiro é processado para invalidação ou o lote inteiro falha.

Erro
Explicação
Falha ao recuperar URLs dos ativos selecionados.
Ocorre se qualquer um dos seguintes cenários for atendido:
- Uma configuração Dynamic Media não foi encontrada.
- Há uma exceção ao recuperar um usuário de serviço por meio do qual a configuração do Dynamic Media é lida.
- O servidor de publicação ou a raiz da empresa usada para formar os URLs está ausente na configuração do Dynamic Media.
Alguns URLs não estão definidos corretamente. Corrija e envie novamente.
Ocorre se a API de invalidação do cache CDN do IPS retornar um erro. O erro indica que o URL se refere a uma empresa diferente ou o URL não é válido de acordo com a validação feita pela API cdnCacheInvalidation do IPS.
Falha ao invalidar o cache da CDN.
Ocorre se a solicitação de invalidação de cache CDN falhar por qualquer outro motivo.
Nenhum URL inserido para ser invalidado.
Ocorre se não houver URLs na variável Invalidação da CDN - Confirmar o e selecione Enviar.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab