Skip to content
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.

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

chore: complete the README #38

Merged
merged 5 commits into from
Jul 22, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
18 changes: 15 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,11 @@ GitHub apps are used for authentication to limit the required permissions.

## Getting started

First you will need to create a GitHub app. Add the permissions required for the commands you are using.
Add a webhook to the app pointing at your endpoint, the path for the webhook receiver is `/api/github/webhooks`.
First you will need to create a GitHub app. Add the permissions required for the commands you are using (see next section), and tick "Subscribe to events" > "Issue comment"

This app is multiple organization aware and doesn't need any additional configuration to run in multiple organizations.
Add a webhook to the app pointing at your endpoint, the path for the webhook receiver is `<your-app-endpoint>/api/github/webhooks`.

This app is multiple organization aware and doesn't need any additional configuration to run in multiple organizations, you just need to install it on them.

_Note: You can't interact across organizations, like requesting reviews from teams in different organizations or transferring issues, this is a GitHub limitation._

Expand All @@ -22,6 +23,17 @@ Run `smee --path /api/github/webhooks` and point your webhook to the smee url th

The application runs on port 3000 by default, this can be customized with the `PORT` environment variable.

### Chart deployment

You can deploy this application to Kubernetes with the helm chart included in this repo:

```
helm repo add github-comment-ops https://timja.github.io/github-comment-ops
helm install github-comment-ops github-comment-ops/github-comment-ops
```

See more in the [chart README](charts/github-comment-ops/README.md)

### Required environment variables

- `GITHUB_APP_ID`
Expand Down
9 changes: 9 additions & 0 deletions charts/github-comment-ops/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,15 @@

A tool for managing GitHub issues and pull requests via comment-ops. It uses GitHub webhooks to scale across repositories without needing to add a GitHub action to each of them.

## Chart deployment

You can deploy this application to Kubernetes with the helm chart included in this repo:

```
helm repo add github-comment-ops https://timja.github.io/github-comment-ops
helm install github-comment-ops github-comment-ops/github-comment-ops
```

## Example

```yaml
Expand Down
10 changes: 10 additions & 0 deletions charts/github-comment-ops/README.md.gotmpl
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,16 @@

{{ template "chart.requirementsSection" . }}

## Chart deployment

You can deploy this application to Kubernetes with the helm chart included in this repo:

```
helm repo add github-comment-ops https://timja.github.io/github-comment-ops
helm install github-comment-ops github-comment-ops/github-comment-ops
```


## Example

```yaml
Expand Down