auxolotl/buildbot-nix
26
1
Fork 0
Code Issues Pull requests 1 Actions 1 Packages Projects Releases Wiki Activity

fix formatting of README

Browse source
This commit is contained in:
Jörg Thalheim 2024-06-25 16:43:50 +02:00 committed by mergify[bot]
parent 83849e86f8
commit 6e34215574
1 changed files with 19 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

33
README.md
View file

@ -53,7 +53,8 @@ At the moment all projects are visible without authentication.
For some actions a login is required. This login can either be based on GitHub For some actions a login is required. This login can either be based on GitHub
or on Gitea (more logins may follow). The backend is set by the or on Gitea (more logins may follow). The backend is set by the
`services.buildbot-nix.master.authBackend` NixOS option ("gitea"/"github", "github" by default). `services.buildbot-nix.master.authBackend` NixOS option ("gitea"/"github",
"github" by default).
We have the following two roles: We have the following two roles:
@ -73,20 +74,25 @@ This is the preferred option to setup buildbot-nix for GitHub.
To integrate with GitHub using app authentication: To integrate with GitHub using app authentication:
1. **GitHub App**: 1. **GitHub App**:
1. Create a new GitHub app by navigating to `https://github.com/settings/apps/new` for single-user installations or `https://github.com/organizations/<org>/settings/apps/new` for organisations where `<org>` is the name of your GitHub organizaction. 1. Create a new GitHub app by navigating to
2. GitHub App Name: "buildbox-nix <org>" `https://github.com/settings/apps/new` for single-user installations or
3. Homepage URL: `https://buildbot.<your-domain>` `https://github.com/organizations/<org>/settings/apps/new` for
4. Callback URL: `https://buildbot.<your-domain>/auth/login`. organisations where `<org>` is the name of your GitHub organizaction.
5. Disable the Webhook 2. GitHub App Name: "buildbox-nix <org>"
6. Repository Permissions: 3. Homepage URL: `https://buildbot.<your-domain>`
- Contents: Read-only 4. Callback URL: `https://buildbot.<your-domain>/auth/login`.
- Commit statuses: Read and write 5. Disable the Webhook
- Metadata: Read-only 6. Repository Permissions:
- Webhooks: Read and write - Contents: Read-only
- Commit statuses: Read and write
- Metadata: Read-only
- Webhooks: Read and write
2. **GitHub App private key**: Get the app private key and app ID from GitHub, 2. **GitHub App private key**: Get the app private key and app ID from GitHub,
configure using the buildbot-nix NixOS module. configure using the buildbot-nix NixOS module.
- Set `services.buildbot-nix.master.github.authType.app.id = <your-github-id>;` - Set
- Set `services.buildbot-nix.master.github.authType.app.secretKeyFile = "/path/to.pem";` `services.buildbot-nix.master.github.authType.app.id = <your-github-id>;`
- Set
`services.buildbot-nix.master.github.authType.app.secretKeyFile = "/path/to.pem";`
3. **Install App**: Install the app for an organization or specific user. 3. **Install App**: Install the app for an organization or specific user.
4. **Refresh GitHub Projects**: Currently buildbot-nix doesn't respond to 4. **Refresh GitHub Projects**: Currently buildbot-nix doesn't respond to
changes (new repositories or installations) automatically, it is therefore changes (new repositories or installations) automatically, it is therefore
@ -191,4 +197,3 @@ The following instances integrated with Gitea:
We have a matrix channel at We have a matrix channel at
[buildbot-nix](https://matrix.to/#/#buildbot-nix:thalheim.io). [buildbot-nix](https://matrix.to/#/#buildbot-nix:thalheim.io).