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
-
A variável
cdn.yaml
o arquivo de configuração deve conter metadados e as regras descritas nos exemplos abaixo. A variávelkind
O parâmetro deve ser definido comoCDN
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
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.