blumeops/docs/how-to
Erich Blume 430f2c6ec5 Add plans for Dagger CI/CD and upstream fork strategy (#150)
## Summary

Two new plan documents in `docs/how-to/plans/`:

- **adopt-dagger-ci** — Migrate CI/CD build logic from Forgejo Actions YAML to Dagger (Python SDK). Forgejo Actions stays as a thin trigger layer. Covers:
  - Container builds with local iteration (`dagger call build ... terminal`)
  - Docs builds with Forgejo packages migration (replacing Forgejo releases)
  - Runner simplification (only Docker + dagger CLI needed)
  - Secrets handling via Dagger's `Secret` type
  - Future: forked project builds, Python packages, pre-merge validation

- **upstream-fork-strategy** — Stacked-branch pattern for maintaining forks of upstream projects. Covers:
  - Daily automated rebase with conflict detection and issue creation
  - Branch model: `upstream/main` → `blumeops` → `feature/*`
  - Quartz fork as first instance, enabling `last-reviewed` frontmatter rendering in docs
  - Upstream PR path for contributing changes back

## Context

These plans emerged from evaluating alternatives to the GHA ecosystem (BuildKite, Concourse, Earthly) for CI/CD. Dagger was chosen for its local iteration story, Python-native pipelines, and zero-infrastructure requirements. The fork strategy is a prerequisite for customizing Quartz and other upstream tools.

Neither plan is ready for execution yet — they are design documents for future work.

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/150
2026-02-11 10:20:14 -08:00
..
knowledgebase Add docs-review task with last-reviewed frontmatter tracking (#129) 2026-02-09 07:29:45 -08:00
plans Add plans for Dagger CI/CD and upstream fork strategy (#150) 2026-02-11 10:20:14 -08:00
add-ansible-role.md Update all docs titles to human-readable (#117) 2026-02-07 21:44:57 -08:00
deploy-k8s-service.md Update all docs titles to human-readable (#117) 2026-02-07 21:44:57 -08:00
expose-service-publicly.md Restrict flyio-proxy ACLs to dedicated tag:flyio-target endpoints (#126) 2026-02-08 21:54:18 -08:00
gandi-operations.md Restrict flyio-proxy ACLs to dedicated tag:flyio-target endpoints (#126) 2026-02-08 21:54:18 -08:00
how-to.md Add plans for Dagger CI/CD and upstream fork strategy (#150) 2026-02-11 10:20:14 -08:00
manage-flyio-proxy.md Add Fly.io public reverse proxy for docs.eblu.me (#120) 2026-02-08 02:36:19 -08:00
restart-indri.md Add CNI conflict troubleshooting to restart-indri how-to (#139) 2026-02-10 07:24:42 -08:00
restore-1password-backup.md Add how-to guide for restoring 1Password backup from borgmatic (#141) 2026-02-10 10:55:00 -08:00
troubleshooting.md Update all docs titles to human-readable (#117) 2026-02-07 21:44:57 -08:00
update-documentation.md Add Fly.io public reverse proxy for docs.eblu.me (#120) 2026-02-08 02:36:19 -08:00
update-tailscale-acls.md Update all docs titles to human-readable (#117) 2026-02-07 21:44:57 -08:00
use-pypi-proxy.md Update all docs titles to human-readable (#117) 2026-02-07 21:44:57 -08:00