Skip to content

mjstapp/frrbot

 
 

Repository files navigation

frrbot

A GitHub bot for managing the FRRouting/frr repo.

Quickstart

git clone https://github.com/frrouting/frrbot.git
cd frrbot
mkdir data
cp .env.sample .env
# Edit .env and fill in all values
docker compose up -d

The app will now be listening on 127.0.0.1:9091. You can either:

  • change the port in docker-compose.yml to 80, or
  • set up a reverse proxy from 80 to 9091

The latter is recommended; this way you can set up TLS in the reverse proxy.

  • GH_WEBHOOK_SECRET should be the webhook secret used to authenticate requests from GitHub
  • GH_APP_ID should be the ID of your GitHub App
  • GP_APP_ROUTE should be the URL you want to listen for webhooks on relative to the uWSGI mountpoint
  • GH_APP_PKEY_PEM_PATH should be the absolute path to the PEM format private key associated with your GitHub App; you should mount the key into the container at that path
  • GH_GIST_USER_TOKEN should be a personal access token for a real user. This user will be used to host gists, since GitHub apps can't use gists.

Miscellaneous notes:

  • uWSGI options within the container can be modified by changing uwsgi.ini in this repository root and rebuilding the container.
  • The job store sqlite database will be in data/jobstore.sqlite

Development

Running manually

  1. docker build --tag frrbot:latest .
  2. docker run -e GH_WEBHOOK_SECRET=<secret> GH_APP_ROUTE="/gh" GH_APP_ID=<ID> -e GH_APP_PKEY_PEM_PATH=<path> -e JOB_STORE_PATH=<path> --port 80:80 frrbot:latest
  3. frrbot will be listening on 0.0.0.0:80/frrbot/gh

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 98.5%
  • Dockerfile 1.5%