Compatibilidade com Frameworks | Gatsby

Sobre Gatsby

O Gatsby é um gerador de sites estáticos que compila seus componentes React em HTML estático. Ele utiliza uma arquitetura baseada em componentes, onde você escreve componentes React e o Gatsby os pré-renderiza como HTML estático no momento da build. Essa abordagem resulta em carregamento rápido das páginas, já que o HTML está pronto para ser servido imediatamente.

Principais recursos:

  • Geração de HTML estático no momento da build
  • Arquitetura baseada em componentes React
  • Camada de dados GraphQL para gerenciamento de conteúdo
  • Suporte nativo a Markdown e MDX
  • Suporte a TypeScript
  • Sistema de rotas baseado em arquivos
  • Ecossistema rico de plugins para estender funcionalidades

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

Templates disponíveis

Nome do templateCaso de usoDetaples
ButterCMS + Gatsby Starter ProjectE-commerceMais detalhes
Gatsby Blog Starter KitStarter projectMais detalhes
Gatsby Ecommerce ThemeBlogMais detalhes
Gatsby BoilerplateE-commerceMais detalhes

Realizando deploy de um template no Azion Console

  1. Faça login no Console.
  2. Clique no botão + Create.
  3. Naveegue para a seção Templates.
  4. Escolha o template Gatsby 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 Gatsby.
  6. Insira o comando de instalação:
npm install
  1. Clique em Deploy

Deploying a template using Azion CLI

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

  1. No terminal, inicialize o projeto:
Terminal window
azion init
  1. Dê um nome ao seu projeto ou pressione enter para aceitar a sugestão dada:
Terminal window
? Your application's name: (black-thor)
  1. Escolha o preset do Gatsby:
Terminal window
? 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.

Terminal window
? 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:
Terminal window
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:

Terminal window
Your Edge Application was built successfully
[Azion] [Server] › ✔ success Function running on port 0.0.0.0:3333, url: http://localhost:3333
  1. On the browser, go to http://localhost:3333/ and you can see your Gatsby project running.

Implantação 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:
Terminal window
cd [nome-do-seu-projeto]
  1. Implante o projeto:
Terminal window
azion deploy
  1. Aguarde enquanto o projeto é construído e implantado na Azion Web Platform.

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:
Terminal window
Do you want to deploy your project? (y/N)
  1. Instale as dependências do projeto. Digite y quando a interação solicitar:
Terminal window
Do you want to install project dependencies? This may be required to deploy your project (y/N)
  1. Aguarde enquanto o projeto é construído e implantado na plataforma da Azion.

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.

  1. Dentro da pasta de seu projeto existente, use o comando abaixo para vincular o seu projeto a uma edge application:
Terminal window
azion link
  1. Selecione o preset Gatsby.

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