docs(plan): add 11.5 - how to re-run a failed release
dev / Build debug APK (push) Successful in 19s
dev / Build debug APK (push) Successful in 19s
Records why re-running a red release run replays the tag's old workflow (and wipes assets on the way down), the dispatch-from-main retry path, and the task-id-vs-run-number / script-echo log gotchas.
This commit is contained in:
1 parent
c8c2c98c8e
commit
7e335d14ef
1 file changed
+33
@@ -522,6 +522,39 @@ adb install -r incido-<versionName>-debug.apk
|
||||
have to type it — `./gradlew assembleRelease` has already deposited
|
||||
both stamped APKs at the repo root by the time you reach it.)
|
||||
|
||||
### 11.5 Re-running a failed release
|
||||
|
||||
**Never "Re-run" a red release run.** A tag push pins the workflow file to
|
||||
that tag's own commit, so a re-run replays the workflow as it was when the
|
||||
tag was cut — even after `main` has been fixed. It is also destructive: the
|
||||
release step deletes each stale asset before re-uploading it, so a retry that
|
||||
dies mid-step leaves the release with *fewer* assets than it started with.
|
||||
(This is exactly what happened to v0.3.8.1 run 78, twice, over a `cp` bug
|
||||
already patched on `main`.)
|
||||
|
||||
Instead, dispatch the workflow from `main`, which runs `main`'s current
|
||||
workflow against an existing tag:
|
||||
|
||||
```bash
|
||||
# Gitea: POST .../actions/workflows/release.yml/dispatches (expect 204)
|
||||
curl -s -X POST \
|
||||
-H "Authorization: token $TOKEN" -H 'Content-Type: application/json' \
|
||||
-d '{"ref":"main","inputs":{"tag":"v0.3.8.1"}}' \
|
||||
http://192.168.8.17:3000/api/v1/repos/nick/incido/actions/workflows/release.yml/dispatches
|
||||
```
|
||||
|
||||
Equivalently: Actions → "release" → Run workflow → branch `main` → tag input.
|
||||
The job reuses the existing release entry, refreshes its description, and
|
||||
re-attaches both APKs and `Incido-<version>-changes.md`.
|
||||
|
||||
Two API gotchas found the hard way: a run's **task id is not its run number**
|
||||
(`GET /actions/runs/<n>/logs` 404s; logs live at
|
||||
`GET /actions/jobs/<task-id>/logs`), and job logs echo the whole script before
|
||||
executing it, so grep below the last `::endgroup::` to see real output.
|
||||
|
||||
If CI cannot attach the changelog file at all, `scripts/ci/backfill-release-notes.sh <version>`
|
||||
patches description + notes asset after the fact (idempotent, never touches the APKs).
|
||||
|
||||
---
|
||||
|
||||
## Appendix A — Key Library Versions (for the version catalog)
|
||||
|
||||
Reference in new issue
Block a user