Skip to content
This repository was archived by the owner on Oct 10, 2025. It is now read-only.

Commit 8c92927

Browse files
committed
docs: add deprecation notice for Perl PoC
- Mark repository as historical proof of concept - Add prominent warning about archived status - Provide clear migration path to production Torrust Tracker Deployer - Include context about PoC series and learnings from this implementation - Follow Phase 4 of repository rename refactoring plan
1 parent fca89e9 commit 8c92927

File tree

1 file changed

+58
-1
lines changed

1 file changed

+58
-1
lines changed

README.md

Lines changed: 58 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,63 @@
11
[![Testing](https://github.com/torrust/torrust-tracker-deploy-perl-poc/actions/workflows/testing.yml/badge.svg)](https://github.com/torrust/torrust-tracker-deploy-perl-poc/actions/workflows/testing.yml)
22

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
461

562
A modern Perl console application for deploying Torrust Tracker to cloud providers using
663
OpenTofu/Terraform and cloud-init for VM configuration.

0 commit comments

Comments
 (0)