Atlantis can be configured to automatically merge a pull request after all plans have been successfully applied.
How To Enable
Automerging can be enabled either by:
- Passing the
atlantis server. This sets the parameter globally; however, explicit declaration in the repo config will be respected and take priority.
automerge: truein the repo's
version: 3 automerge: true projects: - dir: .
If a repo has an
atlantis.yamlfile, then each project in the repo needs to be configured under the
How to Disable
If automerge is enabled, you can disable it for a single
atlantis apply command with the
All Plans Must Succeed
When automerge is enabled, all plans in a pull request must succeed before any plans can be applied.
For example, imagine this scenario:
- I open a pull request that makes changes to two Terraform projects, in
- The plan for
dir2/fails because my Terraform syntax is wrong.
In this scenario, I can't run
atlantis apply -d dir1
Even though that plan succeeded, because all plans must succeed for any plans to be saved.
Once I fix the issue in
dir2, I can push a new commit which will trigger an autoplan. Then I will be able to apply both plans.
The Atlantis VCS user must have the ability to merge pull requests.