---
name: azion-como-implantar-o-jekyll-boilerplate
description: >-
  O Jekyll Boilerplate 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.
---

# Como implantar o Jekyll Boilerplate

O **Jekyll Boilerplate** acelera a implantação de um projeto básico Jekyll, diretamente na infraestrutura distribuída da Azion.

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 application e um domínio para facilitar seu acesso e gerenciamento através da Azion Web Platform.

Este template usa a versão `4.3.3` do Jekyll.

---

## Pré-requisitos

- Uma [conta no GitHub](https://github.com/signup) 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](https://jekyllrb.com/docs/ruby-101/).
  - 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.

---

## Implante o template

Você pode obter e configurar seu template pelo Azion Console. Para implantá-lo facilmente na Azion, selecione o botão abaixo.

[Implantar](https://console.azion.com/create/jekyll/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 do GitHub**

   - Uma janela pop-up será aberta para confirmar a instalação da [Azion GitHub App](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/automacao/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**

   Selecione o **Git Scope** com o qual trabalhar.

3. **Defina um nome para sua aplicação**

   - 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. **Selecione Deploy**

   Selecione o 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.

> **nota**
>
> O link para sua application permite que você veja como ela fica no navegador. No entanto, leva um certo tempo para propagar e configurá-la na infraestrutura distribuída da Azion. Pode ser necessário aguardar alguns minutos para que a URL seja ativada e para que a página da aplicação seja efetivamente exibida no navegador.

---

## 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 Azion Console**

   [Acesse Azion Console](https://console.azion.com).

2. **Selecione Applications**

   No canto superior esquerdo, selecione **Products menu** > **Applications**.

   - Você será redirecionado para a página de **Applications**. Ela lista todas as applications que você criou.

3. **Selecione sua aplicação**

   Encontre a 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 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 ajustar.

> **dica**
>
> Leia a documentação sobre o [gerenciamento de applications](/pt-br/documentacao/plataforma/applications/primeiros-passos/) para obter mais detalhes.

### Adicione um domínio personalizado

A application criada tem um Azion Workload Domain 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.

Para mais informações, consulte [Adicione um domínio a um workload](/pt-br/documentacao/guias/plataforma/migracao/configurar-dominio/).
