infra-bootstrap-tools
IaC configurations for small self-hosted projects and homelabs using Ansible, Terraform, Docker Swarm, Caddy, and Portainer.
Ficha actualizada 22 sept 2026, 20:55 · upstream 22 sept 2026, 20:44 · release ansible-role-k3s-server@0.1.3
Qué es infra-bootstrap-tools
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
This repository provides Ansible playbooks to set up a minimal infrastructure for a simple self-hosted application. Ideal for small hobby projects, it serves as a learning resource for DevOps and Cloud Infrastructure. The project includes a unified dispatcher command 'ibt' that simplifies tool installation, stack management, and Docker-based aliases. Development environments are supported via Nix shell (traditional or flakes), GitHub Codespaces, and Gitpod. Quick deployment is possible with a single `make up` command on DigitalOcean using Terraform for infrastructure provisioning.
- Set up a minimal self-hosted application environment
- Learn DevOps concepts through hands-on automation
- Manage small-scale homelab infrastructure
- Deploy Caddy web server and Portainer dashboard on Docker Swarm
- Automate Terraform-based infrastructure provisioning
- Provides a unified `ibt` command for tool installation, stack management, and Docker aliases
- Supports Nix shell (traditional or flakes) with multiple development shells including Ansible, Flux, Docs, and Full
- Offers GitHub Codespaces and Gitpod configurations for cloud-based development
- Quick deployment via `make up` on DigitalOcean using Terraform + Docker Swarm + Caddy + Portainer
- Includes Ansible collection available on Galaxy for reusable roles
- Designed primarily for small hobby projects; may not scale to production workloads
- Docker Swarm is deprecated and requires manual maintenance of node pools
- No CI/CD pipeline beyond basic GitHub Actions integration mentioned in README
- Terraform Cloud version used (v1.x) has known limitations compared to v2+
- Ansible roles are not fully documented with variable documentation
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Deploy using `make up` on DigitalOcean. This provisions infrastructure via Terraform, installs Docker on all hosts, initializes a Docker Swarm cluster, and deploys Caddy and Portainer applications. For production use, consider migrating to Terraform Cloud v2+, implementing proper secret management (e.g., HashiCorp Vault), adding CI/CD pipelines for automated testing and deployment, and using Ansible collections with proper role documentation.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.