Phase 2: Add Reference section with 24 technical reference cards (#88)
## Summary
- Create `docs/reference/` section with 24 technical reference cards
- Services (16): alloy, argocd, borgmatic, 1password, forgejo, grafana, jellyfin, kiwix, loki, miniflux, navidrome, postgresql, prometheus, teslamate, transmission, zot
- Infrastructure (3): hosts, tailscale, routing
- Kubernetes (2): cluster, apps
- Storage (2): sifaka, backups
- Update README to mark Phase 2 as complete
- Add towncrier changelog fragment
## Deployment and Testing
- [ ] Build docs locally to verify wiki-links resolve
- [ ] Deploy via ArgoCD and verify at docs.ops.eblu.me/reference/
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/88
2026-02-03 14:27:37 -08:00
|
|
|
---
|
2026-02-03 16:06:35 -08:00
|
|
|
title: forgejo
|
Phase 2: Add Reference section with 24 technical reference cards (#88)
## Summary
- Create `docs/reference/` section with 24 technical reference cards
- Services (16): alloy, argocd, borgmatic, 1password, forgejo, grafana, jellyfin, kiwix, loki, miniflux, navidrome, postgresql, prometheus, teslamate, transmission, zot
- Infrastructure (3): hosts, tailscale, routing
- Kubernetes (2): cluster, apps
- Storage (2): sifaka, backups
- Update README to mark Phase 2 as complete
- Add towncrier changelog fragment
## Deployment and Testing
- [ ] Build docs locally to verify wiki-links resolve
- [ ] Deploy via ArgoCD and verify at docs.ops.eblu.me/reference/
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/88
2026-02-03 14:27:37 -08:00
|
|
|
tags:
|
|
|
|
|
- service
|
|
|
|
|
- git
|
|
|
|
|
- cicd
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Forgejo
|
|
|
|
|
|
|
|
|
|
Git forge and CI/CD platform. **Primary source of truth for blumeops** (mirrored to GitHub).
|
|
|
|
|
|
|
|
|
|
## Quick Reference
|
|
|
|
|
|
|
|
|
|
| Property | Value |
|
|
|
|
|
|----------|-------|
|
|
|
|
|
| **URL** | https://forge.ops.eblu.me |
|
|
|
|
|
| **SSH** | `ssh://forgejo@forge.ops.eblu.me:2222` |
|
|
|
|
|
| **Local Ports** | 3001 (HTTP), 2200 (SSH) |
|
|
|
|
|
| **Config** | `ansible/roles/forgejo/templates/app.ini.j2` |
|
|
|
|
|
|
|
|
|
|
## Repositories
|
|
|
|
|
|
|
|
|
|
| Repo | Description |
|
|
|
|
|
|------|-------------|
|
|
|
|
|
| `eblume/blumeops` | Infrastructure as code (primary) |
|
|
|
|
|
| `eblume/alloy` | Grafana Alloy fork (CGO build) |
|
|
|
|
|
| `eblume/tesla_auth` | Tesla OAuth helper |
|
|
|
|
|
| Helm chart mirrors | cloudnative-pg-charts, grafana-helm-charts |
|
|
|
|
|
|
|
|
|
|
## CI/CD (Forgejo Actions)
|
|
|
|
|
|
|
|
|
|
**Runner:** Kubernetes pod with Docker-in-Docker sidecar
|
|
|
|
|
- Namespace: `forgejo-runner`
|
|
|
|
|
- Labels: `k8s`
|
|
|
|
|
- ArgoCD app: `forgejo-runner`
|
|
|
|
|
|
|
|
|
|
**Workflows:** `.forgejo/workflows/`
|
|
|
|
|
- `build-container.yaml` - Container image builds on tag
|
|
|
|
|
|
|
|
|
|
## Secrets
|
|
|
|
|
|
|
|
|
|
Managed via 1Password: `lfs-jwt-secret`, `internal-token`, `oauth2-jwt-secret`, `runner_reg`
|
|
|
|
|
|
|
|
|
|
## Related
|
|
|
|
|
|
2026-02-03 16:06:35 -08:00
|
|
|
- [[argocd]] - Uses Forgejo as git source
|
|
|
|
|
- [[zot]] - Container registry for built images
|
