Release Mock Server

Release mock server

Bump version. Commit. Push. Poke the workflow. It builds the Docker image and throws it at JFrog.

Version lives in apps/device-mock-server/package.json. Workflow lives in .github/workflows/release_mock_server.yml.

Rules to remember

• Need gh installed and logged in. Need pnpm. Need push rights to LedgerHQ/device-sdk-ts.
• gh calls need required_permissions: ["all"].
• Workflow reads version from package.json AT THE PUSHED REF. So push the bump BEFORE you trigger. No push = old version = wrong tag.
• Do steps in order. Any step breaks → stop, tell user, do not go on.
• Collect warnings along the way. Dump them at the end.
• $BUMP = patch | minor | major. No $BUMP = patch.

The steps

# 1. Bump type. $BUMP or patch. Not one of patch/minor/major → stop.

# 2. On a branch? Empty = detached HEAD → stop.
git branch --show-current

# 3. Clean tree? Non-empty = dirty → stop, user commits/stashes first.
git status --porcelain

# 4. Old version (remember it for the summary).
jq -r '.version' apps/device-mock-server/package.json

# 5. Bump it. Remember new version.
(cd apps/device-mock-server && pnpm version "$BUMP" --no-git-tag-version --no-commit-hooks)
jq -r '.version' apps/device-mock-server/package.json

# 6. Commit just the package.json. Gitmoji style.
git add apps/device-mock-server/package.json
git commit -m "🔖 (mock-server): Bump version to <new_version>"

# 7. Push. Rejected/non-fast-forward → tell user to `git pull --rebase`
#    (or `git push --force` if they mean it). Other error → stop, report.
git push -u origin HEAD

# 8. Fire the workflow at the branch.
gh workflow run "release_mock_server.yml" -f ref=<branch>

Find the run

Wait 5s. Then hunt the fresh run:

gh run list --workflow=release_mock_server.yml --limit 5 --json url,name,status,createdAt

• No --branch filter. workflow_dispatch runs hang off the default branch, not your ref.
• Keep runs that are queued, in_progress, or pending. Newest createdAt wins.
• Empty list? Retry up to 6 times, 5s apart.

Guess the build time

gh run list --workflow=release_mock_server.yml --status completed --limit 20 --json conclusion,createdAt,updatedAt

• Keep conclusion == success. Take up to 5 newest.
• Duration = updatedAt - createdAt in minutes. Average them, round.
• No successes = can't guess.

Tell the user

Mock server Docker image release triggered

- Branch:   <branch>
- Version:  <old> → <new> (<bump>)
- Image:    jfrog.ledgerlabs.net/bcs-oci-prod-green/device-mock-server:<new>
- Run:      [<run name> (<status>)](<run url>)
- ETA:      ~<avg> min (last 5 good builds)   # or: Unknown (no good builds yet)
- All runs: https://github.com/LedgerHQ/device-sdk-ts/actions/workflows/release_mock_server.yml

Add a Warnings list only if you collected any.

Things that bite

• Image tag = jfrog.ledgerlabs.net/bcs-oci-prod-green/device-mock-server:<version>.
• Build context is the WHOLE monorepo root. The Dockerfile's pnpm workspace install needs it.
• Runs on the ledgerhq-device-sdk private runner. JFrog is invisible from public runners.