This GitHub Action waits on a specified workflow to complete before proceeding with the next steps in your workflow. It is useful when you have dependent workflows and want to ensure that one completes successfully before continuing with the next. For example, you might want to ensure that a build or test workflow finishes successfully before starting a deployment workflow.

This is a fork of the original wait-for-workflow-action by @kamilchodola, with some improvements and bug fixes. Thanks to the original author for the great work!

This action performs the following steps:

1. If the workflow provided is not a run ID, loop until the specified workflow is triggered:
   • Sends a request to the GitHub API to get the list of workflow runs for the specified workflow.
   • Filters the list of workflow runs based on the provided sha (head commit).
   • Checks if the maximum waiting time max-wait has been reached. If so, exits with an error message.
   • Sleeps for interval seconds before checking again if the workflow has been triggered.
2. Once the workflow is triggered, sets the run-id output and loops until the workflow run is completed:
   • Sends a request to the GitHub API to get the status of the specified workflow run.
   • Checks if the status is "completed". If so, proceeds to the next step.
   • Checks if the maximum waiting time timeout has been reached. If so, exits with an error message.
   • Sleeps for interval seconds before checking again if the workflow has been completed.
3. When the workflow run is completed, sets the conclusion output to the conclusion of the workflow run.

To use this action, add it to your workflow file with the appropriate inputs. Example:

- name: Wait on Workflow
  uses: lucasssvaz/wait-on-workflow@v1
  with:
    workflow: workflow.yml
    max-wait: 3
    interval: 5
    timeout: 60
    sha: ${{ github.event.pull_request.head.sha || github.sha }}

In case, you already have a workflow run ID, you can pass it this way:

- name: Wait on Workflow
  uses: lucasssvaz/wait-on-workflow@v1
  with:
    workflow: 123123123
    max-wait: 3
    interval: 5
    timeout: 60

To access the outputs of this action, you can use the id specified in the action step:

- name: Wait on Workflow
  uses: lucasssvaz/wait-on-workflow@v1
  id: wait-on-workflow
  with:
    workflow: workflow.yml
    sha: ${{ github.event.pull_request.head.sha || github.sha }}

- name: Get the workflow run ID
  run: |
    echo "Workflow run ID: ${{ steps.wait-on-workflow.outputs.run-id }}"
    echo "Workflow conclusion: ${{ steps.wait-on-workflow.outputs.conclusion }}"

• The maximum wait time is specified in minutes. If the workflow has not been triggered or completed after the specified maximum wait time, the action will exit with an error. You can increase this value if you expect the workflow to take longer to start or complete. Keep in mind that the GitHub Actions runner has a default timeout of 6 hours for a job, so ensure your wait time falls within this limit.