Desenvolva com Gatsby
Crie um site Gatsby a partir de um template da Azion ou com a Azion CLI e faça o deploy dele em um domínio da Azion.
Você pode fazer o deploy de um site Gatsby na Azion a partir de um template no Azion Console ou de um projeto que você cria com a Azion CLI. As duas rotas terminam com o site servido pela Azion em um domínio da Azion.
Um site Gatsby roda na Azion como uma aplicação estática. O build do Gatsby grava as páginas em ./public, e o deploy envia essa pasta para um bucket de storage que uma aplicação serve. Para verificar em quais outros frameworks a Azion faz o build, consulte Compatibilidade com web frameworks.
Escolha uma rota. Os pré-requisitos e o procedimento de deploy abaixo mudam conforme a sua escolha.
Pré-requisitos
- Uma conta da Azion. Para criar uma, consulte Criar uma conta.
- Acesso ao Azion Console. Para entrar, consulte Como acessar o Azion Console.
- Uma conta do GitHub, que o formulário do template conecta quando pede uma.
Templates do Gatsby
Um template do Gatsby é um projeto Gatsby completo, e a Azion faz o deploy dele por você. A rota do Console faz o deploy de um destes templates:
| Template | Uso |
|---|---|
| Gatsby Blog Starter Kit | Blog |
| Gatsby Boilerplate | Aplicação de página única |
| Gatsby Ecommerce Theme | E-commerce |
| Gatsby with ButterCMS Starter Project | Integração com CMS |
Três dos templates têm um guia próprio, com link na tabela. Para mais informações sobre o quarto, consulte Azion Marketplace. Na rota da CLI, o seletor de templates do azion init oferece os mesmos quatro templates do Gatsby.
Fazer o deploy do site
Toda rota faz o build do projeto Gatsby e cria os recursos da Azion que o servem. Use o painel da rota que você escolheu:
Para criar um projeto Gatsby, execute azion init com um nome de projeto. Selecione Gatsby no seletor de presets e, em seguida, selecione um template:
Com -y, o comando instala as dependências do projeto. Com --auto, ele não pergunta se deve iniciar um servidor de desenvolvimento local nem se deve fazer o deploy. Sem as duas opções, o comando faz as perguntas listadas em Azion CLI init. Com o template Gatsby Blog Starter Kit, a saída é:
A instalação npm do template exibe linhas npm warn sobre peer dependencies, e o projeto é inicializado mesmo assim. O projeto fica em uma pasta my-site. O arquivo azion.config.cjs dele define o preset gatsby e envia ./public para um bucket de storage com acesso somente de leitura para os workloads. Para cada configuração desse arquivo, consulte azion.config.js.
Para fazer o build do site, vá para a pasta do projeto e execute azion build:
O Azion Bundler executa o build do Gatsby com o preset gatsby e grava o site em public. A saída é:
Para fazer o deploy do site, execute azion deploy na pasta do projeto:
O deploy envia o projeto e abre a página do Console que acompanha o deploy. Ele também exibe a URL dessa página, caso o navegador não abra. Ao final, o comando exibe a URL do domínio do site. Para a saída completa e as flags que mudam um deploy, consulte Azion CLI deploy.
Para testar o site na sua máquina antes do deploy, consulte Azion CLI dev. Para um projeto Gatsby que já existe, execute azion link na pasta do projeto e selecione o preset do Gatsby, como descrito em Azion CLI link.
Verificar o site
Cada rota fornece a URL do domínio da Azion do site, no formato https://xxxxxxxxxx.map.azionedge.net. No Azion Console, a URL fica na página de deploy. Na CLI, azion deploy a exibe ao final. Abra a URL em um navegador para carregar o site Gatsby.
O primeiro deploy pode levar vários minutos para responder em todas as localidades; os deploys seguintes levam cerca de dois minutos. Uma localidade que ainda não tem o site retorna uma página 404 com o texto There's nothing here yet. Se você receber essa página, aguarde e carregue a URL novamente.