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

No caso improvável de a CDN gerenciada por Adobe não puder acessar a origem do 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 acessado. 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 blobs 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:

  • Crie esta pasta e estrutura de arquivo na pasta de nível superior do seu projeto Git:
config/
     cdn.yaml

Notas

  • Atualmente, os RDEs não oferecem suporte ao pipeline de configuração.
  • Você pode usar yq para validar localmente a formatação YAML do seu arquivo de configuração (por exemplo, yq cdn.yaml).

Configuração configuration

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
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