nick-fields/Retry Step
Retry a step on failure or timeout
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| timeout_minutes | Minutes to wait before attempt times out. Must only specify either minutes or seconds | no | — |
| timeout_seconds | Seconds to wait before attempt times out. Must only specify either minutes or seconds | no | — |
| max_attempts | Number of attempts to make before failing the step | yes | 3 |
| command | The command to run | yes | — |
| retry_wait_seconds | Number of seconds to wait before attempting the next retry | no | 10 |
| shell | Alternate shell to use (defaults to powershell on windows, bash otherwise). Supports bash, python, pwsh, sh, cmd, and powershell | no | — |
| polling_interval_seconds | Number of seconds to wait for each check that command has completed running | no | 1 |
| retry_on | Event to retry on. Currently supported [any, timeout, error] | — | — |
| warning_on_retry | Whether to output a warning on retry, or just output to info. Defaults to true | — | true |
| on_retry_command | Command to run before a retry (such as a cleanup script). Any error thrown from retry command is caught and surfaced as a warning. | no | — |
| continue_on_error | Exits successfully even if an error occurs. Same as native continue-on-error behavior, but for use in composite actions. Default is false | — | false |
| new_command_on_retry | Command to run if the first attempt fails. This command will be called on all subsequent attempts. | no | — |
| retry_on_exit_code | Specific exit code to retry on. This will only retry for the given error code and fail immediately other error codes. | no | — |
Outputs
| name | description |
|---|---|
| total_attempts | The final number of attempts made |
| exit_code | The final exit code returned by the command |
| exit_error | The final error returned by the command |