Desenvolva com Jekyll
Crie um site Jekyll 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 Jekyll na Azion a partir de um template no Azion Console ou com a Azion CLI. Os dois caminhos entregam um site Jekyll que roda na Azion e responde em um domínio da Azion.
A Azion serve um site Jekyll como uma aplicação estática. A configuração do projeto envia a pasta ./_site para um bucket de armazenamento, e uma aplicação serve os arquivos desse bucket. Para os outros frameworks de que a Azion faz o build, consulte Compatibilidade com web frameworks.
Escolha um caminho abaixo. Os pré-requisitos e as etapas de deploy mudam com a sua 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 deploy do template pede que você a conecte.
Templates Jekyll
Cada template é um projeto Jekyll do qual a Azion faz o deploy para você. O caminho pelo Console começa por um destes templates:
| Template | Uso |
|---|---|
| Jekyll Boilerplate | Projeto inicial |
| Jekyll Cart | Carrinho de compras |
| Supply | E-commerce |
Jekyll Cart e Supply compartilham um guia. Para mais informações sobre templates, consulte Marketplace da Azion. No caminho pela CLI, o seletor de templates do azion init lista os mesmos três templates.
Faça o deploy do site
Cada caminho faz o build do projeto Jekyll e cria os recursos que o servem na Azion. Use o painel do seu caminho:
Para criar o projeto, execute azion init e dê um nome a ele. No seletor de presets, selecione Jekyll. No seletor de templates, 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 Jekyll Boilerplate, a saída é:
O projeto fica em uma pasta my-site. O arquivo azion.config.cjs dele define o preset jekyll. Ele também envia ./_site para um bucket de armazenamento que os workloads podem ler, mas não alterar. Para todas as configurações do arquivo, consulte azion.config.js.
Para fazer o build do site, vá para a pasta do projeto e execute azion build:
O comando executa o Azion Bundler com o preset jekyll, que executa bundle install && bundle exec jekyll build. Por isso, a versão do Bundler que o Gemfile.lock indica precisa estar instalada. Para as flags do comando, consulte Azion CLI build.
Para fazer o deploy do site, execute azion deploy na pasta do projeto:
O comando envia o projeto e abre no navegador a página do deploy no Console. Ele também imprime a URL dessa página, para quando o navegador não abrir. 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 testar o site na sua máquina antes do deploy, consulte Azion CLI dev. Para um projeto Jekyll que já existe, execute azion link na pasta dele e selecione o preset Jekyll. Para mais informações, consulte 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 a URL, e o azion deploy a imprime no final. Abra a URL em um navegador para ver o site Jekyll.
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. Se você receber essa resposta, aguarde e solicite a URL novamente.