Sha256: 64b0907b8b16ad4e8e181ae495ab18008a04274198587db1f4764f2e6312ba39

Contents?: true

Size: 1.12 KB

Versions: 14

Compression:

Stored size: 1.12 KB

Contents

# Rodbot Plugin – GitHub Webhook

Pipeline event announcements from GitHub

## Preparation

The Rodbot app binds to `localhost` by default which cannot be reached from GitHub. Make sure this connection is possible by setting a different IP in `config/rodbot.rb`:

```ruby
app do
  host '0.0.0.0'
end
```

To authenticate the webhook calls from GitHub, create a new random secret token:

```
ruby -r securerandom -e "puts SecureRandom.alphanumeric(20)"
```

## Activation

Activate and configure this plugin in `config/rodbot.rb`:

```ruby
plugin :github_webhook do
  secret_tokens '<TOKEN>'
end
```

You can set any number of secure tokens here separated with colons.

## Add Repositories

Add a webhook to every GitHub repository you'd like to see pipeline event announcements for. Go to `https://github.com/<USER>/<REPO>/settings/hooks` and create a new webhook with the following properties:

* Payload URL: `https://<RODBOT-APP>/github_webhook`
* Content type: `application/json`
* Secret: `<TOKEN>`
* SSL verification: (o) Enable SSL verification
* Which events? (o) Let me select individual events: [x] Workflow runs
* And... [x] Active

Version data entries

14 entries across 14 versions & 1 rubygems

Version Path
rodbot-0.4.5 lib/rodbot/plugins/github_webhook/README.github_webhook.md
rodbot-0.4.4 lib/rodbot/plugins/github_webhook/README.github_webhook.md
rodbot-0.4.3 lib/rodbot/plugins/github_webhook/README.github_webhook.md
rodbot-0.4.2 lib/rodbot/plugins/github_webhook/README.github_webhook.md
rodbot-0.4.1 lib/rodbot/plugins/github_webhook/README.github_webhook.md
rodbot-0.4.0 lib/rodbot/plugins/github_webhook/README.github_webhook.md
rodbot-0.3.4 lib/rodbot/plugins/github_webhook/README.github_webhook.md
rodbot-0.3.3 lib/rodbot/plugins/github_webhook/README.github_webhook.md
rodbot-0.3.2 lib/rodbot/plugins/github_webhook/README.github_webhook.md
rodbot-0.3.1 lib/rodbot/plugins/github_webhook/README.github_webhook.md
rodbot-0.3.0 lib/rodbot/plugins/github_webhook/README.github_webhook.md
rodbot-0.2.0 lib/rodbot/plugins/github_webhook/README.github_webhook.md
rodbot-0.1.1 lib/rodbot/plugins/github_webhook/README.github_webhook.md
rodbot-0.1.0 lib/rodbot/plugins/github_webhook/README.github_webhook.md