How bhatti/formicary works
Main Components
a. Queen (Leader/Server) Layer:
• Subcomponents:
• Job Scheduler
• Resource Manager
• Job Supervisor
• Task Supervisor
• WebSocket Gateway
• Authentication/Authorization
b. Ant (Worker) Layer:
• Executor types:
• Docker Executor
• Kubernetes Executor
• Shell Executor
• HTTP Executor
• WebSocket Executor
• Messaging Executor
c. Storage Layer:
• Database (GORM)
• Object Store (MinIO)
• Message Queue (Redis/Pulsar)
d. External Integration Layer:
• OAuth Providers
• Email/Slack Notifications
• CI/CD Systems
• Monitoring/Metrics
Component Relationships
• Queen-to-Ant communication (bidirectional)
• Task distribution flow
• Artifact storage flow
• Event propagation
• Authentication flow
• Resource management flow
Architectural Patterns to Highlight
Clear boundaries for:
• Leader-Follower Pattern
• Pipes-Filter Pattern
• Fork-Join Pattern
• SEDA (Staged Event-Driven Architecture)
Key Elements to Label
• Job/Task Flow
• Resource Management
• Authentication Points
• Event Broadcasting
• Artifact Storage
• Monitoring Points
Implementation Details
Technical annotations for:
• GO Templates
• GORM Integration
• Echo Web Framework
• Viper Configuration
• Database Migration (Goose)