Primeiros passos com Custom Pages

Crie um conjunto de custom pages que substitui o 404 da sua origem por uma página sua, atribua-o no deployment do workload e veja-a ser servida.

Última atualização

Ver como Markdown Configurar agente

Este guia orienta você a substituir o 404 que a sua origem retorna pela sua primeira página de Custom Pages.

  • Crie um conjunto de custom pages com uma página para o código de status 404.
  • Atribua o conjunto no deployment do seu workload.
  • Envie uma requisição para um caminho que a sua origem não tem e receba a sua própria página no lugar.

Quatro objetos participam, e cada um se liga ao seguinte:

  1. O connector guarda a sua página de erro em um caminho. Ele já existe. Para mais informações, consulte Connectors.
  2. O conjunto de custom pages vincula o código de status 404 a esse caminho no connector.
  3. O deployment do workload nomeia o conjunto, ao lado da aplicação que ele já nomeia.
  4. A requisição chega a um caminho que o connector da aplicação responde com 404, e o conjunto substitui essa resposta.

Um conjunto não altera nada até que um deployment o nomeie. Quando o connector da aplicação responde 404, o visitante recebe o conteúdo da sua página no lugar, sem redirecionamento e com o código de status que a página define. Este guia trata do Azion Console e da API. Azion CLI não altera um deployment que já existe, por isso não consegue atribuir um conjunto ao seu workload.

Selecione a interface que você usa. Os pré-requisitos e cada etapa desta página seguem essa escolha.

Pré-requisitos

  • Um workload cujo deployment nomeia uma aplicação. Para criar um, consulte Primeiros passos com Workloads.
  • Um caminho que o connector da sua aplicação responde com 404, como uma página que não existe.
  • Um connector que serve a sua página de erro em um caminho. Para criar um, consulte Connectors.
  • Um personal token e curl. Para criar um token, consulte Tokens pessoais.
  • O ID do connector que serve a sua página de erro.
  • O ID do seu workload, do deployment dele e da aplicação que o deployment nomeia. Se o deployment nomeia um firewall, o ID dele também.

Crie o conjunto de custom pages

Um conjunto de custom pages é uma lista nomeada de páginas e precisa de pelo menos uma. Cada página vincula um código de status a um caminho em um connector e pode responder com um código de status próprio. O conjunto desta etapa mantém a página em cache por 0 segundos e responde com 404.

Para criar o conjunto com a API, envie uma requisição POST para o endpoint de custom pages. Substitua [TOKEN VALUE] pelo seu personal token e <connector-id> pelo ID do seu connector. Substitua /html pelo caminho no qual o connector serve a sua página:

Shell
01curl --request POST \
02 --url https://api.azion.com/v4/workspace/custom_pages \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data {"name": "my-custom-pages", "active": true, "pages": [
07 {"code": "404", "page": {"type": "page_connector", "attributes": {"connector": <connector-id>, "ttl": 0, "uri": "/html", "custom_status_code": 404}}}
08]}

A API responde com 201 e o conjunto novo, incluindo o id dele. Uma requisição com a lista pages vazia é recusada com Ensure this field has at least 1 elements. Anote o id do conjunto novo para atribuí-lo ao seu workload. O conjunto existe com uma página para o código 404 e não serve nada até que você o atribua.

Para criar o conjunto no Azion Console:

Abra a página Custom Pages

Acesse Azion Console > Custom Pages.

Inicie um conjunto

Selecione Create Custom Page. A página Create Custom Page abre.

Nomeie o conjunto

Em Name, digite um nome para o conjunto, como my-custom-pages.

Adicione um código de página

Selecione Create Custom Page Code.

Selecione o código de status

Em Page Code, selecione 404.

Mantenha o tipo de página connector

Em Type, mantenha Page Connector.

Selecione o seu connector

Em Connector, selecione o connector que serve a sua página de erro.

Digite o caminho da página

Em Page Path (URI), digite o caminho no qual o connector serve a sua página, como /html.

Defina o tempo de cache

Em Response TTL, digite 0.

Defina o status da resposta

Em Response Custom Status Code, digite 404.

Selecione Create

O conjunto existe com uma página para o código 404. Ele não serve nada até que você o atribua ao seu workload. Um conjunto sem código de página é recusado com a mensagem “You must have at least one custom page code”.

Atribua o conjunto ao seu workload

O deployment de um workload nomeia a aplicação, o firewall e o conjunto de custom pages que atendem o tráfego dele. Um workload contém um deployment, então você atribui o conjunto editando esse deployment. A aplicação que ele já nomeia continua no lugar.

Para atribuir o conjunto com a API, envie uma requisição PATCH para o deployment do seu workload. strategy.attributes contém a aplicação, o firewall e o conjunto de custom pages do deployment. Envie a aplicação que o deployment nomeia hoje, e o firewall dele se houver um, com o ID do seu conjunto em custom_page. Substitua <workload-id>, <deployment-id>, <application-id> e <custom-page-id>:

Shell
01curl --request PATCH \
02 --url https://api.azion.com/v4/workspace/workloads/<workload-id>/deployments/<deployment-id> \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data {
07 "strategy": {
08 "type": "default",
09 "attributes": {
10 "application": <application-id>,
11 "custom_page": <custom-page-id>
12 }
13 }
14}

A API responde com 202. O deployment do workload nomeia o seu conjunto em strategy.attributes.custom_page.

Para atribuir o conjunto no Azion Console:

Abra a página Workloads

Acesse Azion Console > Workloads.

Abra o seu workload

Selecione o seu workload. A página Edit Workload abre.

Selecione o conjunto

Em Deployment Settings, selecione o seu conjunto em Custom Page. Mantenha Application como está.

Selecione Save

Azion Console mostra a mensagem “Your workload has been updated”. O deployment do workload nomeia o seu conjunto.

Solicite uma página que a sua origem responde com 404

A verificação é a mesma, qualquer que seja a interface que atribuiu o conjunto. No comando, substitua <your-workload-domain> pelo workload domain do seu workload, no formato <id>.map.azionedge.net. Substitua <missing-path> pelo caminho que o connector da sua aplicação responde com 404.

Um conjunto atribuído não serve de imediato. A alteração no deployment se espalha pela infraestrutura distribuída da Azion, e isso leva vários minutos, sem duração garantida. Enquanto ela se espalha, uma requisição pode receber o 404 da sua origem ou a sua página. Repita a requisição até a sua página responder. Para mais informações, consulte Propagação.

Envie uma requisição para o caminho ausente e imprima os cabeçalhos da resposta com o corpo:

curl -s -D - https://<your-workload-domain>/<missing-path>

A resposta mantém o status 404, que vem do custom_status_code da página. O corpo dela é o documento que o seu connector serve no caminho da página. Quando esse documento é uma página HTML, a resposta fica assim:

Texto
01HTTP/2 404
02content-type: text/html; charset=utf-8
03
04<!DOCTYPE html>
05<html>
06 <head>
07 </head>
08 <body>
09 <h1>Herman Melville - Moby-Dick</h1>

A resposta não traz o cabeçalho Location, então o cliente não é redirecionado. O seu workload responde a um caminho ausente com a sua própria página.

Próximos passos

Configurações de custom pageCada campo de um conjunto e das páginas dele, e os 22 códigos de status que uma página pode substituir.Personalize uma página de erroSubstitua as respostas de erro de vários códigos de status de uma vez, cada página com o próprio tempo de cache.Configurações de workloadOs campos do deployment que nomeiam a aplicação, o firewall e o conjunto de custom pages.Solucionar problemas de WorkloadsEncontre a causa quando um workload responde com um erro em vez da resposta que você espera.