Bors

Home of a (WIP) rewrite of the homu bors implementation in Rust.

There are a few documents that should help with understanding the bot:

If you want to help testing the bot, please ask around on the #t-infra stream on Rust Zulip.

Configuration

There are several parameters that can be configured when launching the bot. Parameters without a default value are required.

CLI flag	Environment var.	Default	Description
`--app-id`	`APP_ID`		GitHub app ID of the bors bot.
`--private-key`	`PRIVATE_KEY`		Private key of the GitHub app.
`--webhook-secret`	`WEBHOOK_SECRET`		Key used to authenticate GitHub webhooks.
`--db`	`DB`		Database connection string. PostgreSQL and SQLite are supported.
`--cmd-prefix`	`CMD_PREFIX`	@bors	Prefix used to invoke bors commands in PR comments.

The bot uses the following two branch names for its operations.

automation/bors/try-merge
- Used to perform merges of a pull request commit with a parent commit.
- Should not be configured for any CI workflows!
automation/bors/try
- This branch should be configured for CI workflows corresponding to try runs.

The two branches are currently needed because we cannot set try-merge to parent and merge it with a PR commit atomically using the GitHub API.

If you want to attach bors to a GitHub app, you should point its webhooks at <http address of bors>/github.

Here is a guide on how to add a repository so that this bot can be used on it:

Add a file named rust-bors.toml to the root of the main branch of the repository. The configuration struct that describes the file can be found in src/config.rs. Here is an example configuration file.
Install the GitHub app corresponding to this bot to the corresponding repository. You can use the https://github.com/settings/apps/<app-name>/installations link (to be automated via team repo).
Configure a CI workflow on push to the automation/bors/try branch.
Give the bot permissions to push to automation/bors/try and automation/bors/try-merge (to be automated via team repo).