Show Menu
TÓPICOS×

Invalidar o cache CDN por meio do Dynamic Media

Os ativos de Mídia dinâmica são armazenados em cache pelo CDN (Content Delivery Network) para delivery rápido aos seus clientes. No entanto, ao fazer atualizações nesses ativos, você pode desejar que essas alterações entrem em vigor imediatamente em seu site. Limpar ou invalidar o cache de CDN permite que você atualize rapidamente os ativos entregues pelo Dynamic Media. Em vez de esperar que o cache expire usando um valor TTL (Time To Live) (o padrão é 10 horas), você pode enviar uma solicitação da interface do usuário do Dynamic Media para que o cache expire em minutos.
As etapas a seguir se aplicam somente ao modo Dynamic Media - Scene7 no AEM 6.5, Service Pack 6 (AEM 6.5.6) ou posterior. Este recurso de invalidação de CDN também exige que você use o CDN predefinido que é fornecido com AEM Dynamic Media; nenhum outro CDN personalizado é suportado.
Se você usar o Dynamic Media no AEM 6.5, Service Pack 5 (AEM 6.5.5) ou anterior, siga as etapas encontradas em Invalidar o cache CDN por meio do Dynamic Media Classic.
Consulte também Visão geral do cache no Dynamic Media .
Para invalidar o conteúdo em cache CDN para ativos de Dynamic Media:
Parte 1 de 2: Criando um modelo de Invalidação CDN
  1. No AEM 6.5.6 ou posterior, toque em Ferramentas > Ativos > Invalidação de CDN.
  2. Na página do modelo de Invalidação de CDN, execute uma das seguintes opções com base no seu cenário:
    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 previamente com os dados do modelo. Nesse caso, você pode editar o modelo ou continuar para a próxima etapa.
    Preciso criar um modelo. Em que eu entro?
    No campo de texto Criar modelo , insira um URL de imagem (incluindo predefinições de imagens 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> , o Dynamic Media preencherá https://<publishserver_name>/is/image/<company_name>/<ID> <publishserver_name> onde é o nome do Servidor de publicação definido em Configurações gerais no Dynamic Media Classic; o nome <company_name> é a raiz de sua empresa associada a essa instância AEM e <ID> são os ativos selecionados por meio do seletor de ativos a serem invalidados.
    Qualquer publicação de predefinições/modificadores <ID> é copiada como está na definição do URL.
    Somente as imagens - isto é, /is/image - podem ser formadas automaticamente com base no modelo.
    Por exemplo, /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 na Parte 2 de 2: Definindo opções de Invalidação de CDN.
    Exemplos:
    neste primeiro exemplo, o modelo de invalidação contém <ID> junto com o URL do ativo que tem /is/content . Por exemplo, http://my.publishserver.com:8080/is/content/dms7snapshot/<ID> . O Dynamic Media forma o URL com base nisso, 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 o URL completo do ativo usado nas propriedades da Web com /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 não são suportados para 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.
    Observe que você deve especificar URLs para os cortes inteligentes de imagem neste modelo de Invalidação de CDN ou no campo de texto Adicionar URL na Parte 2: Definindo opções de Invalidação de CDN.
    Importante: ​Cada entrada em um modelo de Invalidação CDN deve estar em sua própria linha.
    O exemplo de modelo a seguir serve apenas para fins ilustrativos.
  3. No canto superior direito da página de modelo de Invalidação de CDN, toque em Salvar e, em seguida, em OK.
    Parte 2 de 2: Definindo opções de invalidação de CDN
  4. Em AEM como um Cloud Service, toque em Ferramentas > Ativos > Invalidação de CDN.
  5. Na página Invalidação CDN - Adicionar detalhes , selecione os ativos para invalidação CDN.
    Se você 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. Você deve usar essa organização de opção apenas 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 imagem associados são formados automaticamente para a invalidação do 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 ativos que deseja invalidar. Você pode selecionar ativos publicados ou não publicados.
    O cache no CDN é baseado em URL, 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 em conjunto com as predefinições de imagens associadas ao ativo Invalidar no CDN , ou Invalidar com base no modelo , ou em ambos.
    Adicionar URL
    Adicione ou cole manualmente caminhos de URL completos em ativos do Dynamic Media cujo cache de CDN você deseja invalidar. Use esta opção se você não tiver criado um Modelo de Invalidação CDN na 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, não será possível tocar em Próximo . Nesses casos, você deve tocar em X à direita de um ativo selecionado ou em um URL adicionado manualmente para excluí-lo da lista de invalidação.
    Observe que você deve especificar URLs para os cortes inteligentes de imagem no modelo de Invalidação CDN ou neste campo de texto Adicionar URL .
  6. Near the upper-right corner of the page, tap Next.
  7. Na página Invalidação de CDN - Confirmar , na caixa lista URLs , você verá uma lista de um ou mais URLs gerados 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 que foi mostrado nas etapas anteriores, suponha que você tenha adicionado um único ativo chamado spinset . Quando você toca em Ferramentas > Ativos > Invalidação de CDN, isso resulta nos cinco seguintes URLs gerados na Invalidação de CDN - Confirmar interface do usuário:
    Se necessário, toque em X à direita de um URL para excluí-lo do processo de invalidação.
  8. Próximo ao canto superior direito da página, toque em Enviar 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 todo o lote falhou.
Erro
Explicação
Falha ao recuperar URL(s) para ativos selecionados.
Ocorre se qualquer uma das seguintes situações for atendida:
- Uma configuração de Dynamic Media não foi encontrada.
- Há uma exceção ao recuperar um usuário de serviço através do qual a configuração do Dynamic Media é lida.
- O servidor de publicação ou a raiz de 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 IPS retornar um erro de que o URL está fazendo referência a uma empresa diferente ou se o URL não é válido de acordo com a validação feita pela API cdnCacheInvalidation 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 CDN Invalidation - Confirm e você tocar em Submit (Enviar).