Configuração de páginas de erro do CDN cdn-error-pages

No evento improvável de que o CDN gerenciado por Adobe não possa atingir a origem AEM, o CDN por padrão fornece uma página de erro genérica e sem marca que indica que o servidor não pode ser alcançado. Você pode substituir a página de erro padrão hospedando arquivos estáticos no armazenamento auto-hospedado, como o Amazon S3 ou o Armazenamento de Blob do Azure, e fazendo referência a eles em um arquivo de configuração implantado usando o pipeline de configuração do Cloud Manager.

Configurar setup

Antes de substituir a página de erro padrão, é necessário fazer o seguinte:

  1. Crie um arquivo com o nome cdn.yaml ou similar, fazendo referência à seção de sintaxe abaixo.

  2. Coloque o arquivo em algum lugar em uma pasta de nível superior chamada config ou similar, conforme descrito no artigo sobre o pipeline de configuração.

  3. Crie um pipeline de configuração no Cloud Manager, conforme descrito no artigo sobre configuração de pipeline.

  4. Implante a configuração.

Sintaxe syntax

A página de erro é implementada como um aplicativo de página única (SPA) e faz referência a algumas propriedades, como mostrado no exemplo abaixo. Os arquivos estáticos referenciados pelos urls devem ser hospedados por você em um serviço acessível pela Internet, como o Amazon S3 ou o Armazenamento de blobs do Azure.

Exemplo de configuração:

kind: "CDN"
version: "1"
metadata:
  envTypes: ["dev"]
data:
  errorPages:
    spa:
      title: the error page
      icoUrl: https://www.example.com/error.ico
      cssUrl: https://www.example.com/error.css
      jsUrl: https://www.example.com/error.js

Consulte o artigo sobre configuração de pipeline para obter uma descrição das propriedades acima do nó de dados. O valor da propriedade kind deve ser CDN e a propriedade version deve ser definida como 1.

Nome
Propriedades permitidas
Significado
spa
cargo
Título da página de erro.
icoUrl
URL para um arquivo de ícone.
cssUrl
URL para um arquivo CSS.
jsUrl
URL para um arquivo JavaScript.

HTML gerado por exemplo sample-generated-html

O código HTML gerado pelo CDN e fornecido ao cliente, como um navegador, será semelhante (mas não idêntico) ao seguinte trecho:

<!DOCTYPE html>
<html lang="en">
    <head>
        ...
        <title>the error page</title>
        <link rel="icon" href="https://www.example.com/error.ico">
        <link rel="stylesheet" href="https://www.example.com/error.css">
    </head>
    <body>
        ...
        <div id="root" status="403"></div>
        <script src="https://www.example.com/error.js"> </script>
    </body>
</html>

Testes testing

Para fins de teste, chame o endpoint dedicado com o código de erro compatível, por exemplo:

curl "https://publish-pXXXXX-eXXXXXX.adobeaemcloud.com/cdnstatus?code=403"

Os códigos compatíveis são: 403, 404, 406, 500 e 503.

Dessa forma, você aciona diretamente o manipulador de erros do CDN para testar a resposta sintética de um determinado código de erro.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab