Skip to content

await-release

pipeline await-release - Wait for release workflows to complete for a specific commit

Wait for release workflows (release-*.yaml) to complete for a specific commit SHA.

This command polls GitHub Actions for in_progress or queued release workflow runs that match the specified SHA and waits until all complete.

SHA Detection (in order of precedence): 1. --sha flag (explicit override) 2. GITHUB_SHA environment variable (GitHub Actions) 3. origin/main HEAD after fetch (local devbox)

Flags

Flag Description
--sha Commit SHA to filter runs (auto-detected if not provided)
--timeout (default: 600) Maximum wait time in seconds (default: 600)
--interval (default: 30) Poll interval in seconds (default: 30)
--pattern (default: release-*.yaml) Workflow file pattern to match
--exclude Workflow name substring to exclude (e.g., r2r-eac-bundle)

Notes

Expected Output:

  • Live progress display showing active workflow count
  • Exit code 0 when all workflows complete successfully
  • Exit code 1 on timeout or failure

Examples

pipeline await-release                              # Auto-detect SHA
pipeline await-release --sha abc123                 # Explicit SHA
pipeline await-release --timeout 300                # 5 minute timeout
pipeline await-release --exclude r2r-eac-bundle     # Exclude bundle workflow

See Also


Tutorials | How-to Guides | Explanation | Reference

You are here: Reference — information-oriented technical descriptions of the system.