Compatibilidade com Frameworks | Astro

Explore como o Azion Bundler se integra ao Astro, um moderno construtor de sites estáticos que oferece desempenho ultrarrápido com sua abordagem focada em conteúdo e a filosofia de zero JavaScript por padrão.

Ver como Markdown

Sobre Astro

Astro é um gerador de sites estáticos que compila seu conteúdo em HTML estático. Ele utiliza uma arquitetura baseada em componentes, permitindo que você escreva componentes no framework de sua preferência (React, Vue, Svelte, etc.), e o Astro irá renderizá-los como HTML estático em tempo de build. Essa abordagem resulta em um envio mínimo de JavaScript para o cliente, já que os componentes são renderizados como HTML por padrão.

Principais recursos:

  • Geração de HTML estático em tempo de build.
  • Arquitetura baseada em componentes com suporte a diversos frameworks.
  • Hidratação parcial por meio da Islands Architecture.
  • Suporte nativo a Markdown e MDX.
  • Suporte a TypeScript pronto para uso.
  • Sistema de rotas baseado em arquivos.

Você pode fazer o deploy do seu projeto Astro tanto utilizando nossos templates prontos para deploy quanto vinculando um projeto existente com o Azion CLI.

Templates disponíveis

Nome templateCaso de usoDetalhes
Astro AudiophileE-commerce Mais detalhes
Astro BoilerplateProjeto inicial Mais detalhes
Astro Blog Starter KitBlog Mais detalhes
Astro EcommerceE-commerce Mais detalhes
Astro with Multiple FrameworksProjeto inicial Mais detalhes
Astro with Framework PreactProjeto inicial Mais detalhes
Astro MinimalProjeto inicial Mais detalhes
Astro with Non-HTML PagesConteúdo não HTML Mais detalhes
Astro PortfolioPortfolio Mais detalhes
Astro QuickstoreE-commerce Mais detalhes
Astro StarlogRelease notes de projetos Mais detalhes
Astro with MarkdocProjeto inicial Mais detalhes
Astro Markdown with PluginsProjeto inicial Mais detalhes
Astro Markdown with ShikiDemonstração de código Mais detalhes
Astro with MDXProjeto inicial Mais detalhes
Astro with Nano StoresE-commerce Mais detalhes
Astro with Tailwind CSSProjeto inicial Mais detalhes
Astro with VitestProjeto inicial Mais detalhes
Cosmic - Simple Astro BlogBlog Mais detalhes
DevscardCurrículo Online Mais detalhes
Clean Astro App with SanityIntegração com CMS Mais detalhes
Webpage to PDF ResumeGerador de currículos Mais detalhes

Realizando deploy de um template no Azion Console

  1. Faça login no Console.
  2. Clique no botão + Create.
  3. Navegue para a seção Templates.
  4. Escolha o template Astro desejado.
  5. Conecte sua conta do GitHub.
  6. Escolha um nome para sua aplicação.
  7. Clique em Deploy.

Realizando deploy de um projeto existente usando importação do GitHub

  1. No Console, clique no botão + Create.
  2. Selecione Importar do Github.
  3. Selecione seu repositório.
  4. Escolha um nome para a aplicação.
  5. Selecione o Preset do Astro.
  6. Insira o comando de instalação:
npm install
  1. Clique em Deploy

Realizando deploy de um template via Azion CLI

Você pode usar a Azion CLI para realizar o deploy de um template.

Dica — Visite o Guia CLI para instruções detalhadas de instalação.

  1. No terminal, inicialize o projeto:
azion init
  1. Dê um nome ao seu projeto ou pressione enter para aceitar a sugestão dada:
? Your applications name: (black-thor)
  1. Escolha o preset do Astro:
? Choose a preset: [Use arrows to move, type to filter]
Angular
> Astro
Docusaurus
Eleventy
Emscripten
Gatsby
Hexo
Hono
Hugo
Javascript
...

  1. Escolha um dos templates disponíveis.

  2. Você pode optar por iniciar um servidor de desenvolvimento local ou não.

? Do you want to start a local development server? (y/N)

Os próximos passos dependem de sua resposta.

Resposta sim para desenvolvimento local

  1. Instale as dependências do projeto. Digite y quando a interação solicitar:
Do you want to install project dependencies? This may be required to start local development server (y/N)

Aguarde até que a instalação seja concluída.

Saída:

Your application was built successfully
[Azion] [Server] › ✔ success Function running on port 0.0.0.0:4321, url: http://localhost:4321
  1. No navegador, vá para http://localhost:4321/ e você verá o seu projeto Astro em execução.

Realizando deploy do projeto

Quando o seu projeto está em execução localmente, você ainda pode implantá-lo. Para fazer isso:

  1. Pare a execução no terminal com control + c.
  2. Acesse a pasta do projeto:
cd [nome-do-seu-projeto]
  1. Realize o deploy do projeto:
azion deploy
  1. Aguarde enquanto o projeto é construído e implantado na Azion Web Platform.

Uma vez que o deployment é iniciado, a Azion abrirá o navegador e levará o usuário a uma página no Azion Console onde os logs e o processo de implantação podem ser monitorados. Se não abrir automaticamente, basta clicar no link fornecido.

Após a implantação ser concluída, você receberá um domínio para acessar o seu projeto Astro na plataforma da Azion.

Aguarde alguns minutos para que a propagação ocorra e, em seguida, acesse a sua aplicação usando o domínio fornecido, que deve ser semelhante a https://xxxxxxx.map.azionedge.net.

Resposta não para desenvolvimento local

Após indicar que você não deseja executar um servidor local, implante o projeto.

  1. Digite y para a seguinte interação, indicando que deseja implantar o projeto:
Do you want to deploy your project?
  1. Instale as dependências do projeto. Digite y quando a interação solicitar:
Do you want to install project dependencies? This may be required to start local development server (y/N)
  1. Aguarde enquanto o projeto é construído e implantado na plataforma da Azion.

Uma vez que o deployment é iniciado, a Azion abrirá o navegador e levará o usuário a uma página no Azion Console onde os logs e o processo de implantação podem ser monitorados. Se não abrir automaticamente, basta clicar no link fornecido.

Após a implantação ser concluída, você receberá um domínio para acessar o seu projeto Astro na plataforma da Azion.

Aguarde alguns minutos para que a propagação ocorra e, em seguida, acesse a sua aplicação usando o domínio fornecido, que deve ser semelhante a https://xxxxxxx.map.azionedge.net.

Deploy de um projeto local com Azion CLI

Você pode utilizar o processo abaixo para realizar o deploy de um projeto local, compatível com as frameworks suportadas.

Dica — Visite o Guia CLI para instruções detalhadas de instalação.

  1. Dentro da pasta de seu projeto existente, use o comando abaixo para vincular o seu projeto a uma application:
azion link

  1. Selecione o preset Astro.

  2. A CLI vai lhe guiar pelo restante do processo.