Thanks to visit codestin.com
Credit goes to github.com

Skip to content

only rust-lang/rust uses bors now #954

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Sep 22, 2025
+1 −68
Merged

only rust-lang/rust uses bors now #954

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 1 addition & 68 deletions src/infra/docs/bors.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Bors

The infrastructure team manages an instance of [Homu] called "Bors", to be used
by repositories inside the `rust-lang` organization. The instance is available
for `rust-lang/rust`. The instance is available
at [bors.rust-lang.org], and is backed by the [@bors] GitHub account.

The service is configured [with Terraform][tf], and it's automatically deployed
Expand All @@ -17,76 +17,9 @@ actual state in the repositories.
See [Fixing inconsistencies in the bors queue](./bors/queue-resync.md) for
instructions on how to do this properly.

### Adding a new repository to bors

There are multiple steps needed to add a repository to our Bors instance:

1. The [@bors] GitHub account needs to be granted write access to the
repository.

2. Each CI provider needs to have a single GitHub Check Run to gate on. This is
not provided by default on GitHub Actions, but it can be simulated with
these two jobs, which will generate a `bors build finished` check:

```yaml
end-success:
name: bors build finished
if: success()
runs-on: ubuntu-latest
needs: [ALL, OTHER, JOBS]
steps:
- name: Mark the job as successful
run: exit 0

end-failure:
name: bors build finished
if: "!success()"
runs-on: ubuntu-latest
needs: [ALL, OTHER, JOBS]
steps:
- name: Mark the job as a failure
run: exit 1
```

Make sure to replace `[ALL, OTHER, JOBS]` with a list of all the jobs you
want to gate on.

These jobs need to run on specific branches (`auto` and `try`) so it's necessary
to add those branches to the list of branches tested by the CI provider. For GitHub
Actions that looks like this:

```yaml
on:
push:
branches: [
auto, # Added for bors
try # Added for bors
]
```

3. Add the repository name to the bors permissions array in the [team
repository][team-permissions.rs], and grant the `bors.REPOSITORY.review`
permission to the right teams or people. You can see an example of adding
bors permissions to a team [here][bors-permission].

4. Add the repository to the `repositories` map in [the Terraform configuration
file][tf-repos]. This will create a webhook and inject its secret key in the
bors execution environment.

5. Add the repository to the [Bors configuration][bors-config], taking
inspiration from other repositories. Note that the environment variables used
in that config will be set automatically as long as you completed step 3 above.

6. Give it a test by commenting `@bors ping` in any PR. If you get a response back,
you can then try to approve the PR with `@bors r+`.

[@bors]: https://github.com/bors
[Homu]: https://github.com/rust-lang/homu
[bors-config]: https://github.com/rust-lang/homu/blob/master/cfg.production.toml
[bors.rust-lang.org]: https://bors.rust-lang.org
[ecs]: ./ecs-services.md
[rust-lang/homu]: https://github.com/rust-lang/homu
[team-permissions.rs]: https://github.com/rust-lang/team/blob/52b4370214e1c8eabe483f3a26f22733d94b326f/config.toml#L18-L37
[bors-permission]: https://github.com/rust-lang/team/blob/a1532ec2b08c9d40c0a2c7643ffe72de9671e265/teams/wg-compiler-performance.toml#L25-L26
[tf-repos]: https://github.com/rust-lang/simpleinfra/blob/master/terraform/bors/_config.auto.tfvars
[tf]: https://github.com/rust-lang/simpleinfra/tree/master/terraform/bors/