Como realizar o deploy de uma aplicação Jamstack com Docusaurus

O Docusaurus é um gerador de sites estáticos, construindo uma single page application com navegação rápida no lado do cliente e baseado em React para tornar o site interativo.

Saiba mais sobre o Docusaurus.

Pré-requisitos

Antes de começar, você deve ter:

• Uma conta na plataforma da Azion com o produto Edge Functions habilitado.
• A versão mais recente do Azion CLI instalada.
• Um editor de código.
• Acesso ao terminal.
• Node.js ≥ 18 instalado.

Inicialize um projeto Docusaurus

1. No terminal, inicialize o projeto:

  azion init

2. Dê um nome ao seu projeto ou pressione enter para aceitar a sugestão dada:

? Your application's name:  (black-thor)

3. Escolha o preset do Docusaurus:

? Choose a preset:  [Use arrows to move, type to filter]
  Angular
  Astro
> Docusaurus
  Eleventy
  Emscripten
  Gatsby
  Hexo
  Hono
  Hugo
  Javascript
  ...

4. Escolha um dos templates disponíveis.

5. 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.

• Se você optou por executar um servidor de desenvolvimento local.
• Se você optou por não executar um servidor de desenvolvimento local.

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 edge application was built successfully
[Azion] [Server] › ✔  success   Function running on port 0.0.0.0:3333, url: http://localhost:3333

2. No navegador, vá para http://localhost:3333/ e você verá o seu projeto Docusaurus em execução.

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:

cd [nome-do-seu-projeto]

3. Implante o projeto:

azion deploy

4. Aguarde enquanto o projeto é construído e implantado na Plataforma de Edge da Azion.

Após a implantação ser concluída, você receberá um domínio para acessar o seu projeto Docusaurus 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?

2. 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)

3. 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 Docusaurus 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.