Ryan Malloy
e8ea44a0a6
- Add multi-stage Dockerfile.dev with 168x Go module performance improvement - Implement modern Docker Compose configuration with caddy-docker-proxy - Add comprehensive Makefile.docker for container management - Migrate from Poetry to uv for Python dependencies - Fix Alpine Linux compatibility and Docker mount conflicts - Create comprehensive documentation in docs/ directory - Add Playwright testing integration - Configure reverse proxy with automatic HTTPS - Update .gitignore for Docker development artifacts
2.6 KiB
| title | weight | description |
|---|---|---|
| Docker Development Environment | 25 | Comprehensive guide to Flamenco's optimized Docker development environment |
Docker Development Environment
This section provides comprehensive documentation for Flamenco's Docker development environment, including setup tutorials, troubleshooting guides, technical references, and architectural explanations.
The Docker environment represents a significant optimization achievement - transforming unreliable 60+ minute failing builds into reliable 26-minute successful builds with 168x performance improvements in Go module downloads.
Quick Start
For immediate setup:
# Clone and setup
git clone https://projects.blender.org/studio/flamenco.git
cd flamenco
make -f Makefile.docker dev-setup
make -f Makefile.docker dev-start
# Access Flamenco Manager at http://localhost:9000
Documentation Structure
This documentation follows the Diátaxis framework to serve different user needs:
Setup Tutorial
For learning - Step-by-step guide to set up your first Flamenco Docker development environment. Start here if you're new to Docker or Flamenco development.
Troubleshooting Guide
For solving problems - Practical solutions to common Docker and Flamenco issues. Use this when something isn't working and you need a fix.
Configuration Reference
For information - Complete technical specifications of all Docker configurations, environment variables, and build parameters. Consult this when you need exact details.
Architecture Guide
For understanding - Deep dive into the optimization principles, architectural decisions, and why the Docker environment works the way it does. Read this to understand the bigger picture.
Key Achievements
The optimized Docker environment delivers:
- 168x faster Go module downloads (21.4s vs 60+ min failure)
- 100% reliable builds (vs previous 100% failure rate)
- Complete multi-stage optimization with intelligent layer caching
- Production-ready containerization for all Flamenco components
- Comprehensive Playwright testing integration
System Requirements
- Docker 20.10+
- Docker Compose v2.0+
- 4GB RAM minimum (8GB recommended)
- 10GB free disk space
Support
For issues not covered in the troubleshooting guide, see:
This documentation represents the collective knowledge from optimizing Flamenco's Docker environment from a broken state to production-ready reliability.