|
1 | 1 | [](https://github.com/torrust/torrust-tracker-deploy-perl-poc/actions/workflows/testing.yml) |
2 | 2 |
|
3 | | -# Torrust Tracker Deployment Tool |
| 3 | +# Torrust Tracker Deploy - Perl PoC (Historical) |
| 4 | + |
| 5 | +> ⚠️ **PROOF OF CONCEPT - HISTORICAL REFERENCE ONLY** |
| 6 | +> |
| 7 | +> This repository contains the second proof of concept for Torrust Tracker deployment infrastructure. |
| 8 | +> It is **no longer actively developed** and exists only as a historical reference. |
| 9 | +> |
| 10 | +> **👉 For production use, see [Torrust Tracker Deployer](https://github.com/torrust/torrust-tracker-deployer)** |
| 11 | +> |
| 12 | +> --- |
| 13 | +
|
| 14 | +## Purpose |
| 15 | + |
| 16 | +This was the second proof of concept in a series exploring deployment automation for the Torrust Tracker: |
| 17 | + |
| 18 | +1. **[Bash/OpenTofu/cloud-init PoC](https://github.com/torrust/torrust-tracker-deploy-bash-poc)** |
| 19 | + |
| 20 | + - **Technologies**: Bash scripts, OpenTofu, cloud-init, Docker Compose |
| 21 | + - **Focus**: Infrastructure as Code with libvirt/KVM and cloud deployment |
| 22 | + - **Status**: ✅ Historical reference - Completed its research goals |
| 23 | + |
| 24 | +2. **[Perl/Ansible PoC](https://github.com/torrust/torrust-tracker-deploy-perl-poc)** (this repository) |
| 25 | + |
| 26 | + - **Technologies**: Perl, OpenTofu, Ansible, libvirt/KVM, cloud-init, Docker Compose |
| 27 | + - **Focus**: Declarative configuration management with mature automation tools |
| 28 | + - **Status**: ✅ Historical reference - Completed its research goals |
| 29 | + |
| 30 | +3. **[Torrust Tracker Deployer](https://github.com/torrust/torrust-tracker-deployer)** (production) |
| 31 | + - **Technologies**: Rust, OpenTofu, Ansible, LXD, cloud-init, Docker Compose |
| 32 | + - **Focus**: Type-safe, performance-oriented deployment tooling |
| 33 | + - **Status**: 🚀 Production-ready - Active development |
| 34 | + |
| 35 | +## What We Learned |
| 36 | + |
| 37 | +This proof of concept successfully validated: |
| 38 | + |
| 39 | +- ✅ Ansible for declarative configuration management |
| 40 | +- ✅ Perl as a viable deployment scripting language |
| 41 | +- ✅ Integration of OpenTofu with configuration management tools |
| 42 | +- ✅ Structured approach to deployment orchestration |
| 43 | +- ✅ Importance of type safety and testing infrastructure |
| 44 | + |
| 45 | +These learnings directly influenced the production Torrust Tracker Deployer's architecture. |
| 46 | + |
| 47 | +## Migration Path |
| 48 | + |
| 49 | +If you're using this PoC, migrate to the production [Torrust Tracker Deployer](https://github.com/torrust/torrust-tracker-deployer): |
| 50 | + |
| 51 | +1. Review the [Torrust Tracker Deployer README](https://github.com/torrust/torrust-tracker-deployer#readme) |
| 52 | +2. Check the [migration guide](https://github.com/torrust/torrust-tracker-deployer/docs/migration-from-pocs.md) |
| 53 | + (if available) |
| 54 | +3. Open an [issue](https://github.com/torrust/torrust-tracker-deployer/issues) if you need assistance |
| 55 | + |
| 56 | +--- |
| 57 | + |
| 58 | +## Original PoC Documentation |
| 59 | + |
| 60 | +### Torrust Tracker Deployment Tool |
4 | 61 |
|
5 | 62 | A modern Perl console application for deploying Torrust Tracker to cloud providers using |
6 | 63 | OpenTofu/Terraform and cloud-init for VM configuration. |
|
0 commit comments