Desenvolva com Docusaurus
Crie um site Docusaurus a partir de um template da Azion ou da Azion CLI, e faça o deploy dele em um domínio da Azion.
Você pode fazer o deploy de um site Docusaurus na Azion a partir de um template no Azion Console ou com a Azion CLI. As duas rotas terminam com o site em execução na Azion, respondendo em um domínio da Azion.
A Azion executa um site Docusaurus como uma aplicação estática. O build grava o site em ./build, 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 Docusaurus
Um template é um projeto Docusaurus pronto do qual a Azion faz o deploy para você. A rota do Console começa a partir de um destes templates:
| Template | Uso |
|---|---|
| Docusaurus JavaScript Boilerplate | Projeto inicial em JavaScript |
| Docusaurus TypeScript Boilerplate | Projeto inicial em TypeScript |
Cada template tem um guia próprio, com link na tabela. Para mais informações sobre templates, consulte Marketplace da Azion. Na rota da CLI, o azion init lista os mesmos dois projetos iniciais como Docusaurus Boilerplate (JS) e Docusaurus Boilerplate (TS).
Fazer o deploy do site
Cada rota faz o build do projeto Docusaurus 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 Docusaurus 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 Docusaurus Boilerplate (JS), o comando imprime:
O comando cria o projeto em uma pasta my-site. O azion.config.cjs do projeto define o preset docusaurus e envia ./build 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 Docusaurus pelo Azion Bundler com o preset docusaurus e grava o site em build. O build do Docusaurus imprime avisos sobre a configuração e os posts de blog do template e, mesmo assim, termina com sucesso:
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 Docusaurus que já existe, execute azion link na pasta dele e selecione o preset Docusaurus, 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 Docusaurus.
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.