Repolode
ChristianLempa

ChristianLempa/boilerplates

CLI para criar templates de infraestrutura reutilizáveis e gerar configurações específicas para cada ambiente em homelabs e setups self-hosted.

Estrelas
8,000
Forks
1,820
Issues abertas
11
Último commit
há 2 meses

O que é?

Boilerplates é um toolkit de templates para infraestrutura de homelab e self-hosted. Você cria templates reutilizáveis para tecnologias como Docker Compose, Kubernetes, Terraform, Ansible, Python, Bash e arquivos estáticos e, depois, gera configurações concretas preenchendo variáveis com valores padrão, prompts interativos ou parâmetros passados pela linha de comando.

Os templates usam uma sintaxe semelhante à do Jinja2, com delimitadores personalizados (<< >> para variáveis, <% %> para blocos, <# #> para comentários), e ficam em bibliotecas gerenciadas com Git. As bibliotecas podem ser sincronizadas nos dois sentidos ou mantidas localmente, e você pode adicionar seus próprios repositórios além da biblioteca oficial de templates.

A CLI do Boilerplates permite listar e inspecionar templates, validá-los, definir valores padrão salvos e gerar arquivos em qualquer diretório. Templates a partir da versão 0.2.0 devem usar um manifesto template.json e um diretório files/.

Recursos principais

  • 01Templates reutilizáveis para Docker Compose, Kubernetes, Terraform, Ansible, Python, Bash e arquivos estáticos
  • 02Sintaxe semelhante à do Jinja2, com delimitadores personalizados << >> para variáveis e blocos condicionais
  • 03Prompts interativos guiados, substituição de variáveis pela CLI e valores padrão salvos
  • 04Bibliotecas de templates baseadas em Git, que podem ser sincronizadas nos dois sentidos ou mantidas localmente
  • 05Comandos para listar, inspecionar, validar e gerar templates

Casos de uso

  • Gerar stacks do Docker Compose para um homelab com nomes de host e fusos horários específicos para cada ambiente
  • Manter um conjunto de templates do Terraform ou Ansible e gerar configurações para vários servidores
  • Compartilhar uma biblioteca privada de templates com uma equipe por meio de um repositório Git

Início rápido

  1. 1

    Execute o script oficial de instalação indicado no README (ele usa pipx).

  2. 2

    Atualize a biblioteca do repositório de modelos.

    boilerplates repo update
  3. 3

    Liste os modelos de Docker Compose disponíveis.

    boilerplates compose list
  4. 4

    Gere um modelo de forma interativa.

    boilerplates compose generate authentik

Antes de usar

  • Usa delimitadores de modelo personalizados (<< >>, <% %>, <# #>) em vez da sintaxe padrão do Jinja2.
  • Os modelos legados template.yaml e .j2 não são mais compatíveis desde a versão 0.2.0.
  • Por enquanto, a validação de modelos Python e Bash é mínima.

Em coleções

Tópicos

Perguntas frequentes

O que é boilerplates?
CLI para criar templates de infraestrutura reutilizáveis e gerar configurações específicas para cada ambiente em homelabs e setups self-hosted. Boilerplates é um toolkit de templates para infraestrutura de homelab e self-hosted. Você cria templates reutilizáveis para tecnologias como Docker Compose, Kubernetes, Terraform, Ansible, Python, Bash e arquivos estáticos e, depois, gera configurações concretas preenchendo variáveis com valores padrão, prompts interativos ou parâmetros passados pela linha de comando.
boilerplates é gratuito? Qual é a licença?
boilerplates é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
boilerplates ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de boilerplates foi em 31 de ago. de 2026.
Para que posso usar boilerplates?
Gerar stacks do Docker Compose para um homelab com nomes de host e fusos horários específicos para cada ambiente Manter um conjunto de templates do Terraform ou Ansible e gerar configurações para vários servidores Compartilhar uma biblioteca privada de templates com uma equipe por meio de um repositório Git
Como instalar boilerplates?
Execute o script oficial de instalação indicado no README (ele usa pipx). Atualize a biblioteca do repositório de modelos.: boilerplates repo update Liste os modelos de Docker Compose disponíveis.: boilerplates compose list Gere um modelo de forma interativa.: boilerplates compose generate authentik
Onde consigo boilerplates?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ChristianLempa/boilerplates

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados