Skip to content

feat(forge): Forgejo LTS in place of Gitea, "forge" where the name is generic - #116

Merged
Teg79 merged 4 commits into
mainfrom
feat/forgejo-lts
Nov 18, 2026
Merged

Teg79 merged 4 commits into
mainfrom
feat/forgejo-lts

Conversation

@Teg79

@Teg79 Teg79 commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

Summary

The forge is Forgejo 15 LTS (urbforge/urbex ADR-0034, in urbforge/urbex#89):

  • platform/ansible/roles/gitea/templates/docker-compose.yml.j2: codeberg.org/forgejo/forgejo:15.0.11, pinned by its index digest (built 2026-10-26), in place of gitea/gitea:1.24 (out of support, not pinned); the settings as FORGEJO__*. The image keeps the gitea command (forgejo links to it), uid 1000 and /data, so the role's tasks are unchanged.

"forge" where the name is generic, with the old names still read (a workspace written by 0.1.0 works unchanged):

  • internal/gitea → internal/forge.
  • Credentials: forgeAdminPassword, forgeToken (URBEX_FORGE_ADMIN_PASSWORD, URBEX_FORGE_TOKEN). giteaAdminPassword, giteaToken and URBEX_GITEA_* are still read, from the file and the environment; the new names win; the next write of credentials.yaml moves the values to the new keys. Get, Set and Env answer to both names.
  • Platform config: git.forgeUrl; git.giteaUrl still read (forgeUrl wins). urbex discover and the starter config write forgeUrl.
  • What the user reads says Forgejo: the bootstrap's phases and messages, teardown's warning, status's endpoints and logins (forgeAdminPassword), discover, apply --repo-dir's help.
  • Kept, as ADR-0034 decides, because existing platforms have them: the LXC and Stack urbex-gitea, the volume gitea-data, the catalog's service gitea (Grafana's labels), the webhook type gitea, the role's name, and Komodo's variables URBEX_GITEA_URL/USER/TOKEN, which the installed Actions read (commented where they are set).
  • e2e: the credentials it reads (forgeToken), git.forgeUrl, the progress and status checks. docs/layout.md.

Why

#112: the platform ran Gitea 1.24, out of support, and the first testers (the Reddit call) should get a forge with years of support. Teg and Stefano agreed to switch if the spike passed; it did.

Tests I ran

  • The spike (the image only): full e2e PASSED (24 steps). Same e2e on Gitea 1.24 for comparison, PASSED; the forge container's memory over the run, median/peak: Forgejo 106/196 MiB, Gitea 101/181 MiB; data volume peak 38 vs 34 MB.
  • On the test Proxmox node, on Teg's OK: projects destroyed, platform torn down, bootstrapped from scratch with Forgejo (1212 s, template 233 s), then demo: apply staging (webhook → Komodo build → registry → deploy, 342 s), release, apply prod, promote, status. The forge LXC: Gitea 1.24 124 MiB in its container / 316 MiB the LXC, Forgejo 150-160 / 293-313 MiB; disk 2.17 → 1.8 GB.
  • This branch (the renames): go test ./... and mise run lint pass; the e2e PASSED (24 steps), after updating its two checks that read the old wording. New tests: legacy credential keys and env (read, the new wins, moved on write), legacy git.giteaUrl.
  • Backwards compatibility, on the lab's workspace, written with the old names (giteaToken in credentials.yaml, git.giteaUrl in urbex.platform.yaml), with this branch's operator image:
    • urbex doctor: every workspace check ok, the platform config valid;
    • urbex status: the endpoints with Forgejo (web, git, registry), and the projects with no warning about updating the GitOps repo from the forge, so the legacy token is read;
    • urbex status staging: running;
    • credentials.yaml unchanged by these read-only commands.
  • Not run: a write (apply, release) against that workspace, which would move the file to the new keys. The unit test covers that move.

Checklist before review

Depends on urbforge/urbex#89 (the ADR).

Fixes #112

🤖 Generated with Claude Code

https://claude.ai/code/session_0182yxsfwRowwnxCfgrQwjnA

Teg79 and others added 4 commits November 17, 2026 17:06
…the Gitea names still read

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0182yxsfwRowwnxCfgrQwjnA
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0182yxsfwRowwnxCfgrQwjnA
@Teg79
Teg79 marked this pull request as ready for review November 17, 2026 17:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

spike(forge): Forgejo LTS in place of Gitea, then an ADR

2 participants