Desenvolva com Hugo
Crie um site Hugo 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 fazer o deploy de um site Hugo na Azion a partir de um template no Azion Console ou com a Azion CLI. Os dois caminhos deixam o site em execução na Azion, respondendo em um domínio da Azion.
A Azion serve um site Hugo como uma aplicação estática. O build grava o site em ./public, e o deploy envia essa pasta para um bucket de armazenamento que uma aplicação serve. Para a lista completa de frameworks de que a Azion faz o build, consulte Compatibilidade com web frameworks.
Escolha seu caminho aqui. Os pré-requisitos e o procedimento de deploy abaixo mudam com ele.
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 Hugo
A Azion faz o deploy de um template Hugo como um projeto pronto. O caminho pelo Console começa por um destes templates, e a CLI oferece os mesmos três:
| Template | Uso |
|---|---|
| Hugo Boilerplate | Projeto inicial |
| Influencer Hugo | Vitrine de produtos |
| Vex Hugo | Landing page de produto |
O Hugo Boilerplate tem um guia próprio, com link na tabela. Influencer Hugo e Vex Hugo compartilham um guia: Deploy de e-commerce com Hugo usando templates. Para mais informações sobre templates, consulte Marketplace da Azion.
Faça o deploy do site
Os dois caminhos fazem o build do projeto Hugo e criam os recursos que o servem na Azion. Siga o painel do seu caminho:
Execute azion init com um nome de projeto. No primeiro seletor, selecione Hugo; no segundo, selecione um template:
Com -y, o comando instala as dependências. Com --auto, ele não pergunta sobre um servidor de desenvolvimento local nem sobre um deploy. Para as perguntas que ele faz sem essas opções, consulte Azion CLI init. Com o template Hugo Boilerplate, a saída é:
O projeto fica em uma pasta my-site. O azion.config.cjs dele define o preset hugo e envia ./public 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, execute azion build na pasta do projeto:
O Azion Bundler executa o build do Hugo com o preset hugo, usando a cópia do Hugo que o template instalou, e o site fica em public:
Para fazer o deploy do site, execute azion deploy na pasta do projeto:
O deploy envia o projeto e abre a página do Console que o acompanha, e imprime a URL dessa página caso nenhum navegador abra. No final, ele imprime a URL do domínio do site. Para a saída completa e todas as flags, consulte Azion CLI deploy.
Para visualizar o site na sua máquina antes, consulte Azion CLI dev. Para um projeto Hugo que você já tem, execute azion link na pasta dele e selecione o preset Hugo, como descreve Azion CLI link.
Verifique o site
O deploy fornece 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 ao terminar. Abra essa URL em um navegador para ver o site Hugo.
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 recebeu o site responde com uma página 404 que diz There's nothing here yet. Se você receber essa página, aguarde e solicite a URL novamente.