Skip to content

commoncurriculum/sentry-releases-action

 
 

Repository files navigation

sentry-releases-action

license GitHub Actions status Dependency Status devDependency Status

A GitHub action that creates releases for Sentry.io.

What is sentry-releases-action?

A GitHub action that makes is easy to create a release in Sentry.io based on events in GitHub. Examples:

  • a GitHub release is published
  • a commit is pushed to master
  • a pull request is merged to master

How do I use it?

First thing first, let's make sure you have the necessary pre-requisites.

Pre-requisites

Create a workflow .yml file in your repo's .github/workflows directory. An example workflow is available below. For more information, reference the GitHub Help Documentation for Creating a workflow file.

Inputs

tagName

Required The name of release in Sentry.

environment

Required The name of the environment the release was deployed to.

For more information on these inputs, see the API Documentation

Environment Variables

SENTRY_AUTH_TOKEN

Required Sentry auth token.

SENTRY_ORG

Required Sentry organization.

SENTRY_PROJECT

Required Sentry project name.

SENTRY_URL

Optional URL to the Sentry instance, useful for e.g. on-prem deployments.

Example usage

name: Create a Sentry.io release
uses: tclindner/[email protected]
env:
  SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
  SENTRY_ORG: myAwesomeOrg
  SENTRY_PROJECT: myAwesomeProject
with:
  tagName: ${{ github.ref }}
  environment: qa

Note: sentry-releases-action will automatically trim refs/tags/ from tagName. This means you can pass GITHUB_REF directly from release events without the need of mutating it first.

Full example workflow

On every GitHub release event.

name: ReleaseWorkflow

on:
  release:
    types: [published, prereleased]


jobs:
  createSentryRelease:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@master
      - name: Create a Sentry.io release
        uses: tclindner/[email protected]
        env:
          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
          SENTRY_ORG: myAwesomeOrg
          SENTRY_PROJECT: myAwesomeProject
        with:
          tagName: ${{ github.ref }}
          environment: qa

Note: This action only works on Linux x86_64 systems.

Contributing

Please see CONTRIBUTING.md.

Release History

Please see CHANGELOG.md.

License

Copyright (c) 2019-2020 Thomas Lindner. Licensed under the MIT license.

About

A GitHub action that creates releases for Sentry.io.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%