Plantillas Copier DraftMK
Plantillas Copier para scaffolding de proyectos con Docker Compose, documentación MkDocs y configuración automatizada.
¿Qué es?
Plantillas Copier para generar proyectos con Docker Compose, documentación MkDocs y configuración automatizada mediante Jinja templates.
Disponible como código fuente.
Stack técnico
- Copier: motor de scaffolding basado en Jinja2 con soporte para actualizaciones
- Jinja2 templates: generación dinámica de archivos según respuestas del usuario
- Docker Compose: configuración de servicios incluida en el scaffold
- MkDocs: documentación del proyecto generada automáticamente con Material theme
- GitHub Actions: CI para validar que las plantillas generan proyectos correctos
Lecciones aprendidas
Copier supera a Cookiecutter en un aspecto clave: permite actualizar proyectos existentes cuando la plantilla evoluciona con copier update. Las plantillas Jinja2 con condicionales permiten generar configuraciones muy diferentes desde un solo template. La combinación de Docker Compose para servicios y MkDocs para documentación crea un scaffold completo que los equipos pueden usar desde el primer día sin configuración adicional.
Referencias
- Repositorio en GitHub — jonmatum, 2024. Código fuente y plantillas.
Contenido relacionado
- Prácticas DevOps
Conjunto de prácticas técnicas y culturales que implementan los principios DevOps — desde Infrastructure as Code hasta blameless post-mortems. El «cómo» detrás de la filosofía.
- Documentación como Código
Práctica de tratar la documentación con las mismas herramientas y procesos que el código: versionada en Git, revisada en PRs, y generada automáticamente cuando es posible.