Source: .github/workflows/createRelease.yml · reusable workflow
Refresh a GitHub Release boundary and report its name.
Intended for: Internal reusable release coordination, especially library jobs.
Release behavior#
Deletes and recreates an existing release. For development it also removes the development tag. This behavior is intentional and destructive to prior release assets; dependent uploads must run afterward.
Artifacts and effects#
- GitHub Release
- release_name output
Assumptions and permissions#
- Caller grants contents: write.
- Tagged calls use the tag name; non-tag calls use development.
Failure modes#
- Insufficient token permission prevents refresh.
- Concurrent or premature uploads can be deleted by release refresh; honor the dependency graph.
Example#
No StroggForge workflow calls it any more: rustGlobalBuild's and libGlobalBuild's publish jobs refresh the release with the same script. Kept for callers of their own.
Outputs#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
release_name | — | — | ${{ jobs.ensure-fresh-release.outputs.release_name }} | Release name generated based on tag or branch. |
Permissions#
Top-level: —. Undeclared means inherited from the caller, not "none needed".
Job dependency graph#
Edges are YAML needs; conditional jobs may not run. Conditions are listed below.
Read diagram source
flowchart TD
n_ensure_fresh_release["ensure-fresh-release"]
Jobs#
| Job | Needs | Runner / delegate | Container / strategy | Condition |
|---|---|---|---|---|
ensure-fresh-release | ubuntu-latest / — | — / — | — |
Steps#
ensure-fresh-release#
| Step | Action / command | Condition |
|---|---|---|
| — | actions/checkout@v6 | — |
| — | actions/checkout@v6 | — |
| Setup Release Environment | if [[ "$RELEASE_IS_TAG" == true ]]; then RELEASE_NAME="$RELEASE_REF_NAME" else RELEASE_NAME=development fi echo "release_name=$RELEASE_NAME" >> "$GITHUB_OUTPUT" | — |
| Ensure Fresh Release | bash .stroggforge/scripts/shared/refresh-github-release.sh "$RELEASE_NAME" "$WORKFLOW_RUN_ID" "$RELEASE_REPOSITORY" | — |