tool: disinto backup create — export Forgejo issues + disinto-ops git bundle #1057

New issue

Closed

opened 2026-04-19 20:06:22 +00:00 by dev-bot · 0 comments

dev-bot commented

2026-04-19 20:06:22 +00:00

Collaborator

Goal: produce disinto backup create <outfile.tar.gz> command that snapshots factory state from the live disinto-dev-box for restore on a fresh Nomad cluster.

Scope (only what cutover needs — everything else is either regeneratable or discarded; see parent #1037):

Output tarball must contain:

metadata.json
  { "created_at": <iso8601>, "source_host": <hostname>,
    "schema_version": 1, "forgejo_url": <url> }

issues/
  disinto.json       # [{number, title, body, labels: ["bug-report", ...], state: "open"|"closed"}]
  disinto-ops.json   # same shape (ops-repo issues, typically 0)

repos/
  disinto-ops.bundle # git bundle --all, ~2MB

Explicitly NOT in scope (these are regenerated or not migrated):

disinto git history — migrated separately via existing Codeberg push mirror (done 2026-04-19)
Forgejo users, wiki, attachments, OAuth apps, releases
Woodpecker pipeline history
Agent-data and project-repos volumes
Caddy data (SSL terminates on DO box; no certs on dev-box)
Chat config, logs

File locations:

New command module: lib/disinto/backup.sh (or nearest matching module pattern — mirror lib/disinto/init.sh layout)
Wire into bin/disinto dispatcher: ./bin/disinto backup create <outfile>
Consumes env: FORGE_URL, FORGE_TOKEN (already in .env)

Acceptance:

./bin/disinto backup create /tmp/out.tar.gz on disinto-dev-box exits 0
tar -tzf /tmp/out.tar.gz shows metadata.json, issues/disinto.json, issues/disinto-ops.json, repos/disinto-ops.bundle
jq '.[].number' issues/disinto.json | sort -n | tail -5 matches latest 5 issue numbers from Forgejo
git bundle verify repos/disinto-ops.bundle returns success
Idempotent: running twice produces two tarballs with same contents (modulo timestamp field)
Total size under 25MB

Blocks: #1037 (cutover runbook) and the companion import tool (sibling issue).

**Goal**: produce `disinto backup create <outfile.tar.gz>` command that snapshots factory state from the live disinto-dev-box for restore on a fresh Nomad cluster. **Scope** (only what cutover needs — everything else is either regeneratable or discarded; see parent #1037): Output tarball must contain: ``` metadata.json { "created_at": <iso8601>, "source_host": <hostname>, "schema_version": 1, "forgejo_url": <url> } issues/ disinto.json # [{number, title, body, labels: ["bug-report", ...], state: "open"|"closed"}] disinto-ops.json # same shape (ops-repo issues, typically 0) repos/ disinto-ops.bundle # git bundle --all, ~2MB ``` **Explicitly NOT in scope** (these are regenerated or not migrated): - `disinto` git history — migrated separately via existing Codeberg push mirror (done 2026-04-19) - Forgejo users, wiki, attachments, OAuth apps, releases - Woodpecker pipeline history - Agent-data and project-repos volumes - Caddy data (SSL terminates on DO box; no certs on dev-box) - Chat config, logs **File locations**: - New command module: `lib/disinto/backup.sh` (or nearest matching module pattern — mirror `lib/disinto/init.sh` layout) - Wire into `bin/disinto` dispatcher: `./bin/disinto backup create <outfile>` - Consumes env: `FORGE_URL`, `FORGE_TOKEN` (already in `.env`) **Acceptance**: - `./bin/disinto backup create /tmp/out.tar.gz` on disinto-dev-box exits 0 - `tar -tzf /tmp/out.tar.gz` shows `metadata.json`, `issues/disinto.json`, `issues/disinto-ops.json`, `repos/disinto-ops.bundle` - `jq '.[].number' issues/disinto.json | sort -n | tail -5` matches latest 5 issue numbers from Forgejo - `git bundle verify repos/disinto-ops.bundle` returns success - Idempotent: running twice produces two tarballs with same contents (modulo timestamp field) - Total size under 25MB **Blocks**: #1037 (cutover runbook) and the companion import tool (sibling issue).