automerge
The automerge configuration can be used to automatically merge the pull request after all directories have been successfully applied.
Default Configuration
Section titled “Default Configuration”automerge: enabled: false delete_branch: false require_explicit_apply: false| Key | Type | Description |
|---|---|---|
| enabled | boolean | Specifies whether automerge is enabled. Default is false. |
| delete_branch | boolean | Specifies whether the branch should be deleted after the PR is merged. Default is false. |
| require_explicit_apply | boolean | Specifies whether an explicit “terrateam apply” is necessary for automerge functionality to be applied. Default is false. |
Examples
Section titled “Examples”Enable Automerge
Section titled “Enable Automerge”automerge: enabled: trueThis configuration will enable automerge, automatically merging the pull request after all directories have been successfully applied.
Enable Automerge and Delete Branch
Section titled “Enable Automerge and Delete Branch”automerge: enabled: true delete_branch: trueThis configuration will enable automerge and delete the source branch after a successful apply and git merge.
Considerations
Section titled “Considerations”When enabling automerge, keep the following in mind:
- Automerge will only trigger after all directories in the pull request have been successfully applied.
- If any directory fails to apply, automerge will not be triggered.
- Automerge will respect any branch protection rules configured in your repository. If a pull request cannot be merged due to branch protection rules, automerge will not force the merge.
- If
delete_branchis enabled, the source branch will only be deleted if the merge is successful.