A collection of bots, based on probot, for performing common maintenance tasks across the open-source repos managed by Google on GitHub.

In order to forward to your local machine, you can use smee.io. Visit https://smee.io/new and create a proxy for relaying webhooks to your local web-service.

In the root directory of repo-automation-bots, run:

npm run proxy -- -u <URL-OF-PROXY>

If it's your first time running your application, you should create a new GitHub application using the probot server:

1. cd packages/your-bot.
2. npm start.
3. visit: http://localhost:3000 and install.

1. By default there will be no permissions. Visit https://github.com/settings/installations, click configure, then 'app settings'.
2. Navigate to Permissions and Events. You likely need 'Repository > Pull Requests' for permissions.
3. You also will need to subscribe to events (bottom of page). For instance, if your bot responds to PR activity, the 'Events > Pull Request' should be enabled.

1. While on https://github.com/settings/apps/{YOUR_APP} navigate to 'Install App', if installed on the organization you desire (likely yourself for testing), click the gear.
2. Under permissions ensure that there aren't pending requests to be approved
3. Under repository access select only select repositories. Select the repository you wish to test against.

Once you've created your application, and installed it on some of your repos, start probot again, setting the following environment variables. Most can be found at https://github.com/settings/apps/{YOUR_APP}:

• APP_ID: the ID, listed near the top, App ID: 12345
• PRIVATE_KEY_PATH: path to App's private key, you can request a new one be created and downloaded at the bottom of the page.
• PRIVATE_KEY: private key for application. This is the client secret near the top, Client secret: a1bc23def4..........5678gh
• WEBHOOK_SECRET: secret key set in GitHub developer settings. Edit this to a known value in the settings page.

Environment variables set, run:

1. cd packages/your-bot.
2. npm start.

To run a bot on a schedule include a file in your bot's folder named cron whose content is valid unix -cron format. This will create a Cloud Scheduler Job which makes requests to your endpoint at the specified schedule.

1. create a token with Wombat Dressing Room.
2. run npm run release.