Desenvolva com Astro
Crie um site Astro a partir de um template da Azion, de um repositório do GitHub ou da Azion CLI, e faça o deploy dele em um domínio da Azion.
Você pode fazer o deploy de um site Astro na Azion a partir de um template no Azion Console, do seu repositório do GitHub ou com a Azion CLI. Todas as rotas terminam com o site em execução na Azion, respondendo em um domínio da Azion.
A Azion executa um site Astro como uma aplicação estática. O build grava o site em ./dist, e o deploy envia essa pasta para um bucket de storage que uma application serve. Para os outros frameworks dos quais a Azion faz o build, consulte Compatibilidade com web frameworks.
Selecione a rota que você vai usar. Os pré-requisitos e as etapas de deploy abaixo seguem essa 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. O deploy de um template conecta essa conta quando o formulário pede.
Templates do Astro
Um template é um projeto Astro pronto do qual a Azion faz o deploy para você. A rota do Console começa a partir de um destes templates:
| Template | Uso |
|---|---|
| Astro Audiophile | E-commerce |
| Astro Boilerplate | Projeto inicial |
| Astro Blog Starter Kit | Criação de blog |
| Astro Ecommerce | Plataforma de e-commerce |
| Astro with Multiple Frameworks | Projeto inicial |
| Astro with Framework Preact | Projeto inicial |
| Astro Minimal | Projeto inicial |
| Astro with Non-HTML Pages | Conteúdo não HTML |
| Astro Portfolio | Site de portfólio |
| Astro Quickstore | E-commerce |
| Astro Starlog | Notas de versão de projeto |
| Astro with Markdoc | Projeto inicial |
| Astro Markdown with Plugins | Projeto inicial |
| Astro Markdown with Shiki | Demonstração de código |
| Astro with MDX | Projeto inicial |
| Astro with Nano Stores | E-commerce |
| Astro with Tailwind CSS | Integração com Tailwind |
| Astro with Vitest | Projeto inicial |
| Cosmic - Simple Astro Blog | Blog |
| Devscard | Portfólio de desenvolvedor |
| Clean Astro App with Sanity | Integração com CMS |
| Webpage to PDF Resume | Gerador de currículo |
Dois templates têm um guia próprio, com link na tabela. Para mais informações sobre os outros, consulte Marketplace da Azion. Na rota da CLI, o azion init lista os templates do preset Astro no seu próprio seletor.
Fazer o deploy do site
Cada rota faz o build do projeto Astro e cria os recursos que o servem na Azion. Siga o painel da rota que você selecionou:
Para criar o projeto, execute azion init com um nome. Nos dois seletores, selecione Astro e depois um template:
A opção -y instala as dependências, e --auto pula as perguntas sobre um servidor de desenvolvimento local e sobre um deploy. Sem elas, o comando faz as perguntas que Azion CLI init lista. Com o template Astro Audiophile, o comando imprime:
O comando cria o projeto em uma pasta my-site. O azion.config.mjs do projeto define o preset astro e envia ./dist para um bucket de storage que os workloads só podem ler. Para todas as configurações desse arquivo, consulte azion.config.js.
Para fazer o build do site, mude para a pasta do projeto e execute azion build:
O comando executa o build do Astro pelo Azion Bundler com o preset astro e grava o site em dist:
Para fazer o deploy do site, execute azion deploy na pasta do projeto:
O comando envia o projeto e abre a página do Console que acompanha o deploy. Ele também imprime a URL dessa página caso o navegador não abra. Quando o deploy termina, o comando imprime a URL do domínio do site. Para a saída completa e todas as flags, consulte Azion CLI deploy.
Para executar o site na sua máquina antes do deploy, consulte Azion CLI dev. Para fazer o deploy de um projeto Astro que já existe, execute azion link na pasta dele e selecione o preset Astro, como descreve Azion CLI link.
Verificar o site
O deploy retorna a URL do domínio da Azion do site, no formato https://xxxxxxxxxx.map.azionedge.net. O Azion Console mostra essa URL na página de deploy, e o azion deploy a imprime ao terminar. Abra a URL em um navegador para ver o site Astro.
O primeiro deploy pode levar vários minutos para responder a partir de todas as localidades; os deploys seguintes levam cerca de dois minutos. Até que uma localidade receba o site, o domínio responde com uma página 404 que diz There's nothing here yet. Diante dessa resposta, aguarde e solicite a URL novamente.