Desenvolva com VitePress
Crie um site de documentação VitePress a partir de um template da Azion ou com a Azion CLI e faça o deploy dele em um domínio da Azion.
Você pode colocar um site VitePress na Azion a partir de um template no Azion Console ou com a Azion CLI. Com qualquer um dos caminhos, o site fica em execução na Azion, respondendo em um domínio da Azion.
A Azion serve um site VitePress como uma aplicação estática. O build coloca as páginas geradas na pasta .edge/assets do projeto. O deploy envia essa pasta para um bucket de armazenamento, e uma aplicação serve os arquivos a partir dele. Para os outros frameworks de que a Azion faz o build, consulte Compatibilidade com web frameworks.
Escolha o caminho que você vai seguir. Os pré-requisitos e o procedimento de deploy desta página mudam com essa escolha.
Pré-requisitos
- Uma conta na Azion. Para criar uma, consulte Criar uma conta.
- Acesso ao Azion Console. Para entrar, consulte Como acessar o Azion Console.
- Uma conta no GitHub. O formulário do template conecta essa conta quando a solicita.
Templates VitePress
Cada template VitePress é um projeto completo de que a Azion faz o deploy para você. O caminho pelo Console começa por um destes dois templates:
| Template | Uso |
|---|---|
| VitePress Boilerplate (JS) | Site de documentação em JavaScript |
| VitePress Boilerplate (TS) | Site de documentação em TypeScript |
Os dois templates têm um guia próprio, com link na tabela. Para mais informações sobre templates, consulte Marketplace da Azion. No caminho pela CLI, o seletor de templates do azion init lista os mesmos dois nomes para o preset Vitepress.
Faça o deploy do site
Cada caminho faz o build do projeto VitePress e cria os recursos que o servem na Azion. Siga o painel do caminho que você escolheu:
Para criar o projeto, execute azion init com um nome. Selecione Vitepress no primeiro seletor e um template no segundo:
Com -y, o comando instala as dependências, e --auto pula as perguntas sobre um servidor de desenvolvimento local e sobre um deploy. Sem as duas opções, o comando faz as perguntas que Azion CLI init lista. Para o template VitePress Boilerplate (JS), o comando imprime:
O comando coloca o projeto em uma pasta my-site. O arquivo azion.config.cjs dessa pasta define o preset vitepress. Ele também envia ./.edge/assets para um bucket de armazenamento que os workloads só podem ler. Para todas as configurações desse arquivo, consulte azion.config.js.
Para fazer o build do site, entre na pasta do projeto e execute azion build:
O Azion Bundler aplica o preset vitepress e executa o script docs:build do template, que chama vitepress build docs:
Depois do build, .edge/assets contém as páginas do site, como index.html e 404.html, com os scripts, os estilos e as fontes delas.
Para fazer o deploy do site, execute azion deploy na pasta do projeto:
A CLI envia o projeto e abre uma página do Console em que você acompanha o deploy. Ela também imprime a URL dessa página, para o caso de nenhum navegador abrir. Quando o deploy termina, a CLI 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 no seu computador antes do deploy, consulte Azion CLI dev. Para fazer o deploy de um projeto VitePress que você já tem, execute azion link na pasta dele e selecione o preset VitePress. Para mais informações, consulte Azion CLI link.
Verifique o site
Todo deploy retorna a URL do domínio da Azion do site, no formato https://xxxxxxxxxx.map.azionedge.net. A página do deploy no Console mostra essa URL, e o azion deploy a imprime no final. Abra a URL em um navegador para ver o site VitePress.
O primeiro deploy pode levar vários minutos para responder em todas as localidades; os deploys seguintes levam cerca de dois minutos. Uma localidade que ainda não tem o site responde com uma página 404 que diz There's nothing here yet. Com essa resposta, aguarde e abra a URL novamente.