1.0.2 • Published 4 years ago

@bharathvaj/netlify-plugin-airbrake v1.0.2

Weekly downloads
-
License
MIT
Repository
github
Last release
4 years ago

Airbrake Netlify build plugin

Automatically notify Airbrake of new releases being deployed to your site after it finishes building in Netlify.

The Airbrake Netlify build plugin:

  • Notifies Airbrake of new releases being deployed.
  • Sends Airbrake the commit SHA of HEAD to enable commit features.

You can get more benefits by enabling Github Integration - Optional

Make sure build plugins are enabled on your site to see the plugin run.

Installation

UI Installation

To install plugins via the Netlify UI, go to your team sites list and select the Plugins tab (or follow this direct link to the plugins directory). Then find "Airbrake Build Plugin" and click Install.

UI installation is the recommended way to install this Build Plugin unless you need advanced configuration.

File-based Installation

Alternatively, to install with file-based installation, add the following lines to your netlify.toml file:

[[plugins]]
  package = "@bharathvaj/netlify-plugin-airbrake"

  [plugins.inputs]
    airbrakeProjectId = "123456"
    airbrakeEnvironment = "staging"
    airbrakeDeployUserName = "john"
    airbrakeDeployUserEmail= "john@smith.com"
    airbrakeVersion= "v2"

Note: The [[plugins]] line is required for each plugin installed via file-based installation, even if you have other plugins in your netlify.toml file already.

You can also differentiate the production and deploy preview enviroments using the Netlify's deploy context feature.

Set Environment Variables in Netlify

Save the internal integration token and any other environment variables as site environment variables:

  1. In Netlify, go to your site's settings.
  2. Click on "Build & deploy".
  3. Click “Edit variables” and add AIRBRAKE_PROJECT_ID and AIRBRAKE_PROJECT_KEY. For more configuration options see the environment variables section below.
  4. Click "Save".

View of internal integration permissions.

For more information about the parameters below, please see the Airbrake API docs.

Environment Variables

You can use site environment variables to configure these values:

namedescriptionexample
AIRBRAKE_PROJECT_IDProject Id-
AIRBRAKE_PROJECT_KEYProject Key-
AIRBRAKE_ENVIRONMENTDeploy Environmentproduction
AIRBRAKE_DEPLOY_USER_NAMEDeploy user namejohn
AIRBRAKE_DEPLOY_USER_EMAILDeploy user emailjohn@smith.com
AIRBRAKE_VERSIONDeploy versionv2

Plugin Inputs

namedescriptionexample
airbrakeProjectIdProject Id-
airbrakeEnvironmentDeploy Environmentproduction
airbrakeDeployUserNameDeploy user namejohn
airbrakeDeployUserEmailDeploy user emailjohn@smith.com
airbrakeVersionDeploy versionv2