tahoe-lafs/trac-2024-07-25
2
0
Issues 1.1k Wiki Activity

Create the page with the scope so far - WiP with meejah 

[Imported from Trac: page MoveOffTrac, version 1]
btlogy 2024-06-18 15:09:42 +00:00
parent 04a0f0e9ae
commit 5a1e3d70f0
1 changed files with 49 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

49
MoveOffTrac.md Normal file

@ -0,0 +1,49 @@
# Move Off Trac
The goal of this page is to cover the phases of a project aiming at moving some critical features from Trac to an other solution (or combination of).
## Scope
### Goals and Requirements
1. MUST replace Trac as currently used for Ticket and Wiki by some alternative(s):
* MUST look better: current UI looks old which makes the Tahoe-LAFS project looking dead
* MUST be better maintained: Trac is dying? max 2 contributors per month - <https://openhub.net/p/trac>
* MUST be easier to maintain: Trac is difficult to update (current = v1.0.13/2016-09-11, latest = v1.6.0/2023-09-23)?
* MUST allow Self-Registration (Trac requires manual registration via email)
* COULD support OAuth2 with [GitHub](GitHub)?
* MUST be (F)OSS
* MUST be self-hostable
2. MUST replace the current landing page (StartPage from the Wiki):
* preferably with a static blog/page generator updated from a Git repo (e.g.: (Go)Jekyll, [HuGo](HuGo))
* possibly with a LAMP stack as discussed: <https://tahoe-lafs.org/trac/tahoe-lafs/ticket/3892>
3. COULD be used to replace:
* [GitHub](GitHub) code hosting and review (pull request), keeping only a mirrored clone
* [GitHub](GitHub) Actions (to avoid leaving secrets in environment variables)
* Circle CI (to avoid giving them too many permissions)
### Inclusions
* Trac issues of the Tahoe-LAFS project
* Trac wiki pages of the Tahoe-LAFS project
* Trac HTML home page of the Tahoe-LAFS project
* Hall of Fame HTML page of the Tahoe-LAFS project
* The related DNS records (mostly: tahoe-lafs.org)
### Exclusions
* Binary repository for Tahoe-LAFS releases (<https://tahoe-lafs.org/downloads>)
* Other Trac projects (see [DevInfra](DevInfra))
* Buildbot master instances for some other Trac projects
* DARCS SCM for some of the other Trac projects
* Any other services provided by the current server and not yet documented in [DevInfra](DevInfra)
### Deliverables
1. A VPS (hosted by Hetzner) providing 4 features powered by NixOS and Gitea:
* a tracking system provisioned with the issues migrated from Trac (same numbers)
* a Wiki system provisioned with the relevant pages migrated from Trac (same names)
* a static website replacing the landing page from Trac with the code required for CI and CD
* a repository defining the VPS it-self and its configuration as code (including the secrets)
2. A detailed migration plan to handle the transition (DNS changes and/or redirections)
3. An high-level migration plan for the 3 first features above to be later hosted on Codeberg SaaS (assuming it is possible)