Skip to content

Latest commit

 

History

History
106 lines (68 loc) · 6.1 KB

next-app-middleware.mdx

File metadata and controls

106 lines (68 loc) · 6.1 KB
Raw
title description meta_tags namespace permalink
Como criar edge applications com o template Next.js App + Middleware
Esse template acelera a implantação de uma aplicação Next.js com configurações personalizadas, App Router e um middleware.
templates, guides, Azion Marketplace
docs_guides_next_app_middleware
/documentacao/produtos/guias/nextjs-app-middleware/

import Badge from '~/components/Badge.astro';

Preview

O template Next.js App + Middleware acelera a implantação de uma aplicação Next.js com configurações personalizadas, App Router e um middleware para executá-la diretamente no edge.

Este template implanta uma aplicação básica Next.js contendo um domínio para acessar a Single-Page Application (SPA), uma configuração do Edge Storage, configurações de cache, compressão Gzip e regras do Rules Engine para melhorar o desempenho e a entrega de arquivos estáticos. Além disso, ele cria um novo repositório no GitHub, incluindo uma GitHub Action para habilitar um fluxo de trabalho de desenvolvimento contínuo e manter sua aplicação atualizada.

O Next.js App + Middleware cria arquivos para implementar o formato do App Router, com a página de index, edge API routing e Custom Route Handler criados no novo repositório durante a implantação. Ele também inclui um middleware que permite modificar a resposta para uma requisição e controlar diferentes aspectos da aplicação, como realizar redirecionamentos, definir cabeçalhos e outros.

Esse template usa a versão 13.5.6 do Next.

Pré-requisitos

Para usar este template, você deve:

Para fazer isso:

  1. Acesse o Azion Console > Account menu.
  2. Selecione a opção Billing & Subscriptions.
  3. Clique na aba Subscriptions.
  4. Ative o switch de cada módulo.

:::caution[atenção] Se estes módulos estiverem ativados, a execução deste template pode gerar custos relacionados ao uso. Consulte a página de preços para mais informações. :::

Obtenha o template

Para usar este template, acesse o Azion Console e clique no botão + Create na página inicial.

Isso abrirá um modal onde você pode selecionar Templates > Next.js App + Middleware card.

Configure o template

No formulário de configuração, forneça as informações para configurar sua aplicação. Preencha os campos apresentados.

Os campos identificados com asterisco são obrigatórios.

  1. Conecte a Azion com sua conta no GitHub.
  • Uma janela pop-up será aberta para confirmar a instalação da Azion GitHub App, uma ferramenta que conecta sua conta do GitHub com a plataforma da Azion.
  • Defina suas permissões e acesso ao repositório conforme desejado.
  1. Selecione o Git Scope com o qual trabalhar.
  2. Defina um nome para sua edge application.
  • O bucket para armazenamento e a edge function usarão o mesmo nome.
  • Use um nome único e fácil de lembrar. Se o nome já tiver sido usado, a plataforma retornará uma mensagem de erro.
  1. Clique no botão Save para iniciar o processo de implantação.

Durante a implantação, você poderá acompanhar o processo através de uma janela mostrando os logs. Quando estiver concluída, a página mostra informações sobre a aplicação e algumas opções para continuar sua jornada.

:::note O link para sua edge application permite que você veja como ela fica no navegador. No entanto, leva um certo tempo para propagar e configurá-la nas edge locations da Azion. Pode ser necessário aguardar alguns minutos para que a URL seja ativada e para que a página da aplicação seja efetivamente exibida no navegador. :::

Gerencie o template

Considerando que essa configuração inicial pode não ser ideal para sua aplicação, todas as configurações podem ser personalizadas sempre que você precisar usando o Azion Console.

Para gerenciar e editar as configurações da sua edge application:

  1. Acesse o Azion Console > Edge Application.
  • Você será redirecionado para a página do Edge Application. Ela lista todas as edge applications que você criou.
  1. Selecione a aplicação relacionada ao template.
  • A lista é organizada em ordem alfabética. Você também pode usar a barra de busca localizada no canto superior esquerdo da lista; atualmente, ela é filtrada apenas pelo Application Name, ou nome da edge application.

Depois de selecionar a aplicação em que você trabalhará, você será direcionado para uma página que contém todas as configurações que você pode configurar.

:::tip Consulte a documentação sobre o gerenciamento de edge applications para obter mais detalhes. :::

Adicione um domínio personalizado

A edge application criada tem um domínio Azion atribuído para torná-la acessível através do navegador. O domínio tem o seguinte formato: xxxxxxxxxx.map.azionedge.net. No entanto, você pode adicionar um domínio personalizado para que os usuários acessem sua aplicação por meio dele.

import Button from '~/components/Button.astro';

import ContributorList from '~/components/ContributorList.astro'

Contribuidores Contributor