Trigger workflow only on pull request MERGE

Code to Cloud GitHub Actions
#1

I saw many posts about people asking if there is a way to trigger the workflow only on MERGE, which to me seems the most useful. However I did not see any answer, so I would like to find a solution.

At the moment I am stuck with:

on:
  pull_request:
    types: [closed]

Which is not ideal, as it would trigger the entire process even if I dismiss or close the PR without merging and I cannot see any reason on why this should happen.

I saw also: 

github.event.pull_request.merged == true

but as my understanding this would run only for a particular action not on the entire workflow.

So my question is: how can I trigger a workflow only on pull_request merge?

Thanks

11 Likes
📍 The GitHub Actions Guidepost
#2

same question

1 Like
#3

There’s no way to specify that a workflow should be triggered when a pull request is merged. However, because a merged pull request always results in a push, you can use the push event to accomplish your goal.

For example, let’s say that you want to run a workflow whenever a pull request is merged to your master branch. You can do something like this:

on:
  push:
    branches:
      - master

This workflow will run when a PR is merged or when a commit is made directly to the master branch.

You can list multiple branches if you’d like:

on:
  push:
    branches:
      - master
      - develop

Or use a more sophisticated filter pattern.

41 Likes
#4

For the event on.pull_request.closed , it is designed that whenever the PR is closed the workflow will be triggered. And currently, there is not a specialized event type for PR merged, such as on.pull_request.merged.

You mentioned the value of the property github.event.pull_request.merged is true when you close the PR without merged. I tried both manual and the GitHub REST API Update a pull request to close the PR without merged, the value of the property merged always is false on my side.

I also tried the API Get a single pull request, from the response body, the value of property “ merged ” is consistent with that in github context.

What methods did you use to dismiss or close the PR? Maybe you also can try using the API Get a single pull request to check whether the value of property “ merged ” is consistent with that in github context.

If the value is back to correct, as a workaround, you can use this property in the if conditionals to run all the jobs in the workflow only when the PR is closed with merged.

For example:

jobs:
  build:
    if: github.event.pull_request.merged == 'true'
    . . .

This will still trigger the workflow but can skip the jobs in the workflow.

8 Likes
#5

Even though I still would prefer a merge option, I think this makes sense. Thanks

2 Likes
#6

I use this which triggers on merge:

- name: pull request
        if: github.event_name == 'pull_request' && github.event.action == 'closed' && github.event.pull_request.merged == true

I also separate out the push/pull workflows into separate files.

12 Likes
#7

It’s work for me

on:
  pull_request:
    types: [closed]
#8

This can not work as expected. If the PR is closed without merging, the action will still run.

#9

When I say “this” I mean:

on:
  pull_request:
    types: [closed]

That code only looks for PRs that have been closed - and a merge is not necessarily a close - a PR can be closed without merging - so it’s not sufficient to guard against that case. I prefer:

on:
  pull_request:
    branches:
      - deploy
    types: [closed]

jobs:
  <job id>:
    if: github.event.pull_request.merged == true
    steps: // the rest of the code
7 Likes
#10

I think this is the best solution
I changed to only use
if: github.event.pull_request.merged == true since I already filtered on pull requests in the on: part

2 Likes
#11

I’ve tried the above but the workflow or Step is always skipped. Has something changed?

#12

Actually… using @nickbenedetti’s example worked. Had to follow it exactly.

1 Like
#13

Hey folks, I wrote a little blog post + showcase repo that explain how to execute a certain job or step only if a PR has been merged and not just closed. Hope that helps :slightly_smiling_face:

4 Likes
#14

This solution with the restriction to directly push commits to master solves the problem.

📍 The GitHub Actions Guidepost
#15

This is exactly what I was looking for. Thanks, Jen!