Como implantar o Jekyll Boilerplate

O Jekyll Boilerplate acelera a implantação de um projeto básico Jekyll, diretamente no edge.

Este template implanta um repositório com um projeto baseado no Jekyll, um framework escrito em Ruby, que permite criar sites estáticos usando arquivos Markdown e HTML. O repositório também inclui uma GitHub Action para garantir um fluxo de trabalho de implantação contínua, mantendo seu projeto atualizado.

Além disso, o template cria uma edge application e um domínio para facilitar seu acesso e gerenciamento através da Plataforma de Edge da Azion.

Este template usa a versão 4.3.3 do Jekyll.

Pré-requisitos

• Uma conta no GitHub para conectar com a Azion e criar seu novo repositório.
  • Cada push será implantado automaticamente neste repositório para manter seu projeto atualizado.
• Instale a versão 2.5.0 ou superior do Ruby.
  • Sem um ambiente de execução Ruby, você não será capaz de instalar a Jekyll gem ou executar o código Ruby que alimenta o Jekyll.

Obtenha o template

Para começar a usar o Jekyll Boilerplate:

1. Acesse o Azion Console.
2. Clique no botão + Create na página inicial.
3. No modal, selecione a opção Templates.
4. Navegue e selecione o card do Jekyll Boilerplate.

Configure o template

No formulário de configuração, forneça as informações para configurar sua aplicação. Preencha os campos apresentados.

Os campos identificados com asterisco são obrigatórios.

1. Conecte a Azion com sua conta no GitHub.

• Uma janela pop-up será aberta para confirmar a instalação da Azion GitHub App, uma ferramenta que conecta sua conta do GitHub com a plataforma da Azion.
• Defina suas permissões e acesso ao repositório conforme desejado.

2. Selecione o Git Scope com o qual trabalhar.
3. Defina um nome para sua edge application.

• O bucket para armazenamento usará o mesmo nome.
• Use um nome único e fácil de lembrar. Se o nome já tiver sido usado, a plataforma retornará uma mensagem de erro.

4. Clique no botão Deploy para iniciar o processo de implantação.

Durante a implantação, você poderá acompanhar o processo através de uma janela mostrando os logs. Quando estiver concluída, a página mostra informações sobre a aplicação e algumas opções para continuar sua jornada.

Gerencie o template

Considerando que essa configuração inicial pode não ser ideal para sua aplicação, todas as configurações podem ser personalizadas sempre que você precisar usando o Azion Console.

Para gerenciar e editar as configurações da sua aplicação, siga estas etapas:

1. Acesse o Azion Console.
2. No canto superior esquerdo, selecione Products menu > Edge Application.

• Você será redirecionado para a página de Edge Application. Ela lista todas as edge applications que você criou.

3. Encontre a edge application relacionada ao template e selecione-a.

• A lista é organizada em ordem alfabética. Você também pode usar a barra de busca localizada no canto superior esquerdo da lista; atualmente, ela é filtrada apenas pelo Application Name, ou nome da edge application.

Depois de selecionar a aplicação em que você trabalhará, você será direcionado para uma página que contém todas as configurações que você pode configurar.

Adicione um domínio personalizado

A edge application criada tem um domínio Azion atribuído para torná-la acessível através do navegador. O domínio tem o seguinte formato: xxxxxxxxxx.map.azionedge.net/. No entanto, você pode adicionar um domínio personalizado para que os usuários acessem sua aplicação por meio dele.