Auto Pull Request Merge

A GitHub Action that merges a pull request automatically by the latest commit check status.

Other GitHub Actions that do merge automatically are like merging based on some user input. This GitHub Actions is designed to merge automatically when a pull request comes in.

This action extract the number from a pull request which has triggered this by default. You don't need to specify the pull request number by ${{ github.event.pull_request.number }}.

Usage

      - name: Merge
        uses: KeisukeYamashita/auto-pull-request-merge@v1

Trigger by pull_request event with custom check

This is just an example to show one way in which this action can be used.

on: pull_request
jobs:
  auto-merge:
    - name: Merge
      uses: KeisukeYamashita/auto-pull-request-merge@v1
      with:
        intervalSeconds: 10
        timeoutSeconds: 30

Action inputs

Name	Description	Default
checkStatus	Check all status before merge'	true
comment	Comments to post before merging the pull request	-
dryRun	Dry run the merge or not	false
failStep	Fail the step if no PR has merged	true
ignoreLabels	Label that the target pull request shouldn't have	-
ignoreLabelsStrategy	Check condition on how to check the labels (Options are all, atLeastOne).	all
labels	Label that the target pull request should have	-
labelsStrategy	Check condition on how to check the labels (Options are all, atLeastOne).	all
intervalSeconds	Seconds between the check	0.1
repository	The GitHub repository containing the pull request	Current repository
pullRequestNumber	The number of the pull request.	github.event.pull_request.number
sha	SHA of the commit.	github.event.pull_request.head.number
strategy	How to merge. merge, squash and rebase is supported.	merge
timeoutSeconds	Seconds to timeout this action	60
token	GITHUB_TOKEN or a repo scoped PAT.	GITHUB_TOKEN

Action outputs

Name	Description
commentID	ID of the comment if you specify comment in input
merged	If the PR has merged or not

Disclaimer

GitHub API rate limit consumption

When a Pull Request is created, this GitHub Actions polls the commit status of the Pull Request and if it's ready to merge, it will merge it. You can set the interval by intervalSeconds, but depending on the user's input, you may be subject to an inordinate number of API calls. Be careful when setting this up.

GitHub Actions charge and quota

GitHub Actions are charged by runtime, and quotas are set for some users on free plans and other plans. This action checks for other statuses to pass, so it can take a lot of time to run. By default, it is set to time out after 1 minute, but you can change by timeoutSeconds if you need to.

License

MIT