Documentação AEM as a Cloud Service Guia do usuário

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

Last update: Wed May 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Dispatcher

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

A variável cdn.yaml o arquivo de configuração deve conter metadados e as regras descritas nos exemplos abaixo. A variável kind O parâmetro deve ser definido como CDN e a versão deve ser definida como a versão do schema, que está 1.
Crie um pipeline de configuração de implantação direcionada no Cloud Manager. Consulte configuração de pipelines de produção e configuração de pipelines de não produção.

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