https://github.com/thermondo/heroku-buildpack-sigsci

Run the Signal Sciences Agent in Heroku
https://github.com/thermondo/heroku-buildpack-sigsci

Last synced: about 1 month ago
JSON representation

Run the Signal Sciences Agent in Heroku

• Host: GitHub
• URL: https://github.com/thermondo/heroku-buildpack-sigsci
• Owner: thermondo
• License: gpl-3.0
• Created: 2024-07-24T09:13:20.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2024-07-29T11:58:07.000Z (5 months ago)
• Last Synced: 2024-07-29T14:47:49.157Z (5 months ago)
• Language: Shell
• Size: 24.4 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# Signal Sciences Heroku Buildpack

Run the Signal Sciences ([Fastly WAF](https://www.fastly.com/products/web-application-api-protection))

agent inside Heroku.

## Why?

The [official Signal Sciences buildpack](https://docs.fastly.com/en/ngwaf/heroku) is unmaintained,

has no license, and does things we don't necessarily want (or need). This is thermondo's

implementation based on our [sigsci-container project](https://github.com/thermondo/sigsci-container).

## Quick Start

Get the `buildpack.tar.gz` download URL from [the latest release](https://github.com/thermondo/heroku-buildpack-sigsci/releases/latest).

It should look something like:

```plaintext

https://github.com/thermondo/heroku-buildpack-sigsci/releases/download/LATEST_VERSION_NUMBER/buildpack.tar.gz

```

Then run:

```bash

heroku buildpacks:add 

```

Then in your app's [Procfile](https://devcenter.heroku.com/articles/procfile) add something like this:

```plaintext

web: sigsci-wrap 

```

The buildpack is configured the same way the container is (same environment variables, etc.). See

the [Configuration section of the container README](https://github.com/thermondo/sigsci-container?tab=readme-ov-file#configuration)

for details.

## Developing

### Creating Releases

Go to [the release workflow](https://github.com/thermondo/heroku-buildpack-sigsci/actions/workflows/release.yml)

and manually trigger a release. Specify an appropriate tag name using semantic versioning rules.

Then go to the newly created draft release on the [releases page](https://github.com/thermondo/heroku-buildpack-sigsci/releases),

polish it up, and publish it.