execute-layers
release execute-layers - Execute releases layer by layer in dependency order
Executes pending releases in dependency order, processing one layer at a time.
This command takes a JSON array of release layers (from check-pending-releases) and processes them in order: 1. For each module in the current layer: - Dispatches the release workflow with version info 2. Waits for all workflows in the layer to complete 3. Moves to the next layer
The release workflow is responsible for creating the git tag on success (via gh release create). This ensures tags only exist for successful releases.
The layers JSON format is: [[{module, version, tag, type}, ...], [...], ...]
Flags
| Flag | Description |
|---|---|
--layers |
JSON array of release layers |
--layers-file |
File containing JSON array of release layers |
--timeout (default: 900) |
Timeout per release in seconds (default: 900) |
--dry-run |
Preview without dispatching workflows |
Notes
Expected Output:
- Progress messages for each release
- Exit code 0 if all releases succeed
- Exit code 1 if any release fails
Examples
release execute-layers --layers '[[{"module":"docs","version":"2025.0116.1430","tag":"docs/2025.0116.1430","type":"calver"}]]'
release execute-layers --layers-file layers.json
See Also
Tutorials | How-to Guides | Explanation | Reference
You are here: Reference — information-oriented technical descriptions of the system.