Invalidar o cache CDN por meio do Dynamic Media

Os ativos da Dynamic Media são armazenados em cache pela CDN (Content Delivery Network) para entrega rápida a seus clientes. No entanto, quando você faz atualizações nesses ativos, deseja que essas alterações entrem em vigor imediatamente no seu site. Limpar ou invalidar o 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 (Tempo de vida útil) (o padrão é dez horas). Em vez disso, você pode enviar uma solicitação da interface do usuário do Dynamic Media para que o cache expire em minutos.

OBSERVAÇÃO

Esse recurso exige que você use a CDN predefinida fornecida com o Adobe Experience Manager Dynamic Media. Nenhum outro CDN personalizado é compatível com esse recurso.

Consulte também Visão geral do cache no Dynamic Media.

Para invalidar o cache CDN por meio do Dynamic Media:

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

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

    Recurso de validação CDN

  2. Na página Modelo de Invalidação CDN, execute uma das seguintes opções com base no seu cenário:

    Cenário Opção
    Eu já criei um modelo de invalidação de CDN no passado usando o Dynamic Media Classic. O campo de texto Criar modelo é preenchido previamente com seus dados do modelo. Nesse caso, você pode editar o modelo ou continuar para a próxima etapa.
    Eu tenho que criar um template. O que devo digitar? No campo de texto Criar modelo, insira um URL de imagem (incluindo predefinições ou modificadores de imagem) referenciando <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>, onde <publishserver_name> é o nome do Servidor de Publicação definido nas Configurações Gerais no Dynamic Media Classic . O <company_name> é o nome da raiz da sua empresa associada a esta instância do Experience Manager e <ID> são os ativos selecionados por meio do seletor de ativos a serem invalidados.
    Quaisquer predefinições/modificadores a seguir <ID> são copiados como estão na definição do URL.
    Somente imagens, ou seja, /is/image, podem ser formadas automaticamente com base no modelo.
    Para /is/content/, adicionar ativos, como vídeos ou PDFs, usando o seletor de ativos não gera URLs automaticamente. Em vez disso, você deve especificar esses ativos no modelo de Invalidação CDN ou pode adicionar manualmente o URL a esses ativos em Parte 2 de 2: Definindo opções de Invalidação de CDN.
    Exemplos:
    neste primeiro exemplo, o modelo 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> sendo 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 em suas propriedades da Web com o /is/content (não dependente do seletor de ativos). Por exemplo, http://my.publishserver.com:8080/is/content/dms7snapshot/backpack onde o backpack é a ID do ativo.
    Os formatos de ativos compatíveis com o Dynamic Media são elegíveis para invalidação. Os tipos de arquivos de ativos que são not 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 certifique-se de prestar atenção à sintaxe e erros de digitação; O Dynamic Media não faz nenhuma validação de modelo.
    ・ O Modelo de Invalidação CDN pode salvar texto até 2500 caracteres.
    ・ Especifique os URLs para as recortes inteligentes de imagem neste modelo de Invalidação de CDN ou no campo Adicionar URLtext na Parte 2: Definindo opções de Invalidação de CDN.
    ・ Cada entrada em um modelo de Invalidação de 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 CDN - Criar

    OBSERVAÇÃO

    O Modelo de Invalidação CDN pode salvar texto até 2500 caracteres.

  3. No canto superior direito da página Modelo de Invalidação CDN, selecione Salvar e selecione OK.

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

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

    Recurso de validação CDN

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

    Invalidação de CDN - Adicionar detalhes

    OBSERVAÇÃO

    Se decidir deixar as opções Invalidar predefinições de imagens associadas a ativos em CDN e Invalidar com base no modelo desmarcadas, o URL base dos ativos selecionados será formado para invalidação. Use essa opção de organização somente para imagens.

    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 predefinidos de imagens associados são formados automaticamente para invalidação de cache.
    Os ativos e seus URLs 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 e não em ativos. Portanto, é necessário que você esteja ciente dos URLs completos 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 essa opção com Invalidar predefinições de imagens associadas ao ativo em CDN, ou Invalidação com base no modelo, ou ambos.
    Adicionar URL Adicione ou cole manualmente caminhos de URL completos em ativos do Dynamic Media cujo cache CDN você deseja invalidar. Use esta opção se você não tiver criado um Modelo de Invalidação CDN em Parte 1 de 2: Criando um modelo de Invalidação CDN, e tendo 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 Próximo. Nesses casos, você deve selecionar X à direita de um ativo selecionado ou um URL adicionado manualmente para excluí-lo da lista de invalidação.
    Especifique URLs para recortes inteligentes de imagem no modelo de Invalidação CDN ou neste campo Adicionar URLtext.
  6. Próximo ao canto superior direito da página, selecione Próximo.

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

    Por exemplo, usando o exemplo de Modelo de Invalidação CDN mostrado nas etapas anteriores, suponhamos que você tenha adicionado um único ativo chamado spinset. Quando você vai para Ferramentas > Ativos > Invalidação CDN, isso resulta nos seguintes cinco URLs gerados na Invalidação CDN - Confirmar interface do usuário:

    Invalidação de 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 Submit para iniciar o processo de invalidação de CDN.

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

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

Erro Explicação
Falha ao recuperar URLs para ativos selecionados. Ocorre se qualquer um dos seguintes cenários for atendido:
- Uma configuração do Dynamic Media não foi encontrada.
- Há uma exceção ao recuperar um usuário de serviço pelo 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 reenvie. 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 CDN. Ocorre se a solicitação de invalidação do cache CDN falhar por qualquer outro motivo.
Nenhum URL inserido para ser invalidado. Ocorre se não houver URLs presentes na página Invalidação CDN - Confirmar e você selecionar Enviar.

Nesta página