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ê habilitou Smart Imaging em sua conta e está usando o CDN agrupado em Adobe, é possível 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 as 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 para Smart Imaging, 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: Criando um modelo de Invalidação da CDN

  1. No Adobe Experience Manager as a Cloud Service, vá para Ferramentas > Assets > Modelo de Invalidação da CDN.

    Recurso de validação da CDN

  2. Na página 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. O campo de texto Criar Modelo é preenchido automaticamente com seus dados de modelo. Nesse caso, você pode editar o modelo ou continuar para a próxima etapa.
    Preciso criar um template. O que eu insiro? No campo de texto Criar Modelo, insira uma URL de imagem (incluindo predefinições de imagem ou modificadores) que faça referência a <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>, o Dynamic Media preencherá https://<publishserver_name>/is/image/<company_name>/<ID>, em que <publishserver_name> é o nome do Publish Server definido em Configurações Gerais no Dynamic Media Classic. O <company_name> é o nome da raiz da sua empresa associada a esta instância de Experience Manager e <ID> são os ativos selecionados por meio do seletor de ativos que serão invalidados.
    Quaisquer predefinições/modificadores após <ID> são copiados como estão na definição de URL.
    Somente imagens, ou seja, /is/image, podem ser formadas automaticamente com base no modelo.
    Para /is/content/, adicionar 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 a URL a esses ativos em Parte 2 de 2: Definindo opções de Invalidação da CDN.
    Exemplos:
    Neste primeiro exemplo, o modelo de invalidação contém <ID> junto com a URL do ativo que tem /is/content. Por exemplo, http://my.publishserver.com:8080/is/content/dms7snapshot/<ID>. O Dynamic Media forma a URL com base nesse caminho, sendo <ID> os ativos selecionados por meio do seletor de ativos que você deseja invalidar.
    Neste segundo exemplo, o modelo de invalidação contém a URL completa do ativo usado em suas 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 com suporte no Dynamic Media estão qualificados para invalidação. Os tipos de arquivos de ativos que não são compatíveis com a invalidação da 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 as URLs para recortes inteligentes de imagem neste modelo de Invalidação de CDN ou no campo de texto Adicionar URL em Parte 2: Definição de opções de Invalidação de CDN.
    · Cada entrada em um modelo de Invalidação CDN deve estar em sua própria linha.
    · O exemplo de modelo de Invalidação da CDN a seguir é 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 página Modelo de invalidação da CDN, selecione Salvar e OK.

    Parte 2 de 2: Definindo opções de Invalidação da CDN

  4. No Experience Manager as a Cloud Service, vá para Ferramentas > Assets > Invalidação de CDN.

    Recurso de validação da CDN

  5. Na página Invalidação de CDN - Adicionar Detalhes, selecione os ativos para invalidação de CDN.

    Invalidação da CDN - Adicionar Detalhes

    note note
    NOTE
    Se você decidir deixar as opções Invalidar predefinições de imagens associadas a ativos na CDN e Invalidar com base no modelo desmarcadas, a URL de base dos ativos selecionados será formada 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.
    O Assets e suas URLs predefinidas predefinidas associadas são formados automaticamente para invalidação. Essa opção funciona somente para ativos de imagem.
    Invalidação baseada no modelo (Opcional) Marque essa opção para usar somente o modelo definido para a formação de URL.
    Adicionar Assets 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 e 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 tiver criado um Modelo de Invalidação CDN em Parte 1 de 2: Criação de um Modelo de Invalidação CDN e tiver apenas alguns ativos para invalidar.
    Importante: cada URL adicionado deve estar em sua própria linha.
    Você pode invalidar até 1000 URLs em um determinado momento. Se o número de URLs no campo de texto Adicionar URL for maior que 1000, você não poderá selecionar Avançar. Nesses casos, você deve selecionar X à direita de um ativo selecionado ou uma URL adicionada manualmente para excluí-lo da lista de invalidação.
    Especifique as URLs para cortes inteligentes de imagem no modelo de Invalidação CDN ou neste campo de texto Adicionar URL.
  6. Próximo ao canto superior direito da página, selecione Avançar.

  7. Na página Invalidação de CDN - Confirmar, na caixa de listagem URLs, você verá uma lista de uma ou mais URLs geradas a partir do Modelo de Invalidação de CDN criado anteriormente e dos ativos que você acabou de adicionar.

    Por exemplo, usando o exemplo de Modelo de invalidação CDN mostrado nas etapas anteriores, suponha que você tenha adicionado um único ativo chamado spinset. Ao acessar Ferramentas > Assets > Invalidação de CDN, você obterá as cinco URLs geradas a seguir na interface de usuário Invalidação de CDN - Confirmar:

    Invalidação da CDN - Confirmar

    Se necessário, selecione X à direita de uma URL para excluí-la 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 as 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 as URLs está ausente na configuração do Dynamic Media.
Algumas URLs não estão definidas corretamente. Corrigir e reenviar.
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.
Nenhuma URL inserida para ser invalidada.
Ocorre se não houver URLs na página Invalidação de CDN - Confirmar e você selecionar Enviar.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab