https://github.com/netdata/infra-trigger-workflow-and-wait
https://github.com/netdata/infra-trigger-workflow-and-wait
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/netdata/infra-trigger-workflow-and-wait
- Owner: netdata
- License: mit
- Created: 2022-10-14T12:35:01.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-05-19T08:20:42.000Z (almost 3 years ago)
- Last Synced: 2025-02-01T23:47:03.583Z (about 1 year ago)
- Language: Shell
- Size: 9.77 KB
- Stars: 1
- Watchers: 6
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Trigger Workflow and Wait
Sourced from: https://github.com/convictional/trigger-workflow-and-wait
Github Action for trigger a workflow from another workflow. The action then waits for a response.
**When would you use it?**
When deploying an app you may need to deploy additional services, this Github Action helps with that.
## Arguments
| Argument Name | Required | Default | Description |
| --------------------- | ---------- | ----------- | --------------------- |
| `owner` | True | N/A | The owner of the repository where the workflow is contained. |
| `repo` | True | N/A | The repository where the workflow is contained. |
| `github_token` | True | N/A | The Github access token with access to the repository. Its recommended you put it under secrets. |
| `workflow_file_name` | True | N/A | The reference point. For example, you could use main.yml. |
| `github_user` | False | N/A | The name of the github user whose access token is being used to trigger the workflow. |
| `ref` | False | main | The reference of the workflow run. The reference can be a branch, tag, or a commit SHA. |
| `wait_interval` | False | 10 | The number of seconds delay between checking for result of run. |
| `client_payload` | False | `{}` | Payload to pass to the workflow, must be a JSON string |
| `propagate_failure` | False | `true` | Fail current job if downstream job fails. |
| `trigger_workflow` | False | `true` | Trigger the specified workflow. |
| `wait_workflow` | False | `true` | Wait for workflow to finish. |
| `last_workflow_interval` | False | 0 | The number of seconds delay between checking for the last workflow. default: 0 |
## Example
### Simple
```yaml
- uses: netdata/ifnra-trigger-workflow-and-wait@v1.6.1
with:
owner: keithconvictional
repo: myrepo
github_token: ${{ secrets.GITHUB_PERSONAL_ACCESS_TOKEN }}
```
### All Options
```yaml
- uses: netdata/ifnra-trigger-workflow-and-wait@v1.6.1
with:
owner: keithconvictional
repo: myrepo
github_token: ${{ secrets.GITHUB_PERSONAL_ACCESS_TOKEN }}
github_user: github-user
workflow_file_name: main.yml
ref: release-branch
wait_interval: 10
client_payload: '{}'
propagate_failure: false
trigger_workflow: true
wait_workflow: true
last_workflow_interval: 1
```
## Testing
You can test out the action locally by cloning the repository to your computer. You can run:
```shell
INPUT_WAIT_INTERVAL=10 \
INPUT_PROPAGATE_FAILURE=false \
INPUT_TRIGGER_WORKFLOW=true \
INPUT_WORKFLOW_FILE_NAME="main.yml" \
INPUT_GITHUB_USER="github-user" \
INPUT_WAIT_WORKFLOW=true \
INPUT_LAST_WORKFLOW_INTERVAL=1 \
INPUT_OWNER="keithconvictional" \
INPUT_REPO="trigger-workflow-and-wait-example-repo1" \
INPUT_GITHUB_TOKEN="" \
INPUT_CLIENT_PAYLOAD='{}' \
busybox sh entrypoint.sh
```
You will have to create a Github Personal access token. You can create a test workflow to be executed. In a repository, add a new `main.yml` to `.github/workflows/`. The workflow will be:
```shell
name: Main
on:
workflow_dispatch
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@master
- name: Pause for 25 seconds
run: |
sleep 25
```
You can see the example [here](https://github.com/keithconvictional/trigger-workflow-and-wait-example-repo1/blob/master/.github/workflows/main.yml). For testing a failure case, just add this line after the sleep:
```yaml
...
- name: Pause for 25 seconds
run: |
sleep 25
echo "For testing failure"
exit 1
```
## Potential Issues
### Changes
If you do not want the latest build all of the time, please use a versioned copy of the Github Action. You specify the version after the `@` sign.
```yaml
- uses: netdata/ifnra-trigger-workflow-and-wait@v1.6.1
with:
owner: keithconvictional
repo: myrepo
github_token: ${{ secrets.GITHUB_PERSONAL_ACCESS_TOKEN }}
```