Skip to content
message-circle

GitHub Action

Publish Release Info

v3.3.0 Latest version

Publish Release Info

message-circle

Publish Release Info

Publish a release notification to Slack with a changelog and list to related tools

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Publish Release Info

uses: thedaviddias/[email protected]

Learn more about this action in thedaviddias/publish-release-info-action

Choose a version

Publish Release Info (Action)

Check dist/ Build tests

A GitHub Action that sends release notifications to Slack, integrating with JIRA, Sentry, and Grafana.

Usage

Screenshot of the Slack notification

Screenshot of the Slack notification

Create Workflow

To use this GitHub Action, you need to create a workflow file (e.g., .github/workflows/deploy.yml) in your repository. Here's an example workflow that runs when a tag matching the pattern v[0-9]+.[0-9]+.[0-9]+ is pushed:

name: Deploy to production

on:
  push:
    # Push/tags only work if you manually created the tag/release using Github GUI
    tags:
      - "v[0-9]+.[0-9]+.[0-9]+"

jobs:
  release:
    permissions:
      contents: read
      pull-requests: write

    runs-on: ubuntu-latest

    steps:

      - name: Release Notification
        uses: thedaviddias/[email protected]
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          slack_webhook_urls: https://hooks.slack.com/services/XXXXXX/XXXXX/XXXXXXX
          jira_ticket_prefix: ABC
          jira_instance_url: https://your-jira-instance.com
          sentry_project_name: MyProject
          sentry_project_id: "1234"
          grafana_dashboard_link: https://grafana.com/dashboards/XXXX
          contributor_replace_regex: "-"
          contributor_replace_char: "."
          time_zone_offset: "-4" # Toronto (Canada - Ontario)
          locale: "fr-FR"
          fail_on_slack_error: "true"

Inputs

Name Required Default Description
github_token yes Token to use to authorize label changes. Typically the GITHUB_TOKEN secret
repo no Name of the repo (e.g. owner/repo) if not the current one
tag_regex no ^v[0-9]+.[0-9]+.[0-9]+$ Regex to accommodate varying tag formatting.
time_zone_offset no 0 Timezone offset in minutes from UTC.
locale no en-US Preferred locale for date formatting, adhering to the BCP 47 language tag standard (e.g., 'en-US' for American English)
contributor_replace_regex no Regular expression (regex) pattern to identify characters in the contributor name that will be replaced
contributor_replace_char no The character that will replace specific characters in the contributor name
slack_webhook_urls no Slack webhook URL to receive release notifications
jira_ticket_prefix no Prefix for JIRA ticket references in PR titles (e.g. ABC)
jira_instance_url no URL for your JIRA instance to generate JIRA ticket links (e.g. https://your-jira-instance.com)
sentry_project_name no ID of the Sentry project for error tracking
sentry_project_name no Name of the Sentry project for error tracking
grafana_dashboard_link no Link to the Grafana dashboard for monitoring
fail_on_slack_error no true Allow you to fail or not your current workflow depending on the success of posting on Slack

Outputs

The is the list of the outputs. You can use another action and format the way you want.

{
  "repo": "",
  "repoLink": "",
  "releaseVersion": "",
  "releaseLink": "",
  "currentTagCommit": {
    "url": "",
    "author": {
      "name": "",
      "email": "",
      "date": ""
    }
  },
  "prList": [
    {
      "contributor": "",
      "prTitle": "",
      "prUrl": "",
      "prNumber": 0
    }
  ]
}

Examples

Example Workflow (Minimum Configuration)

name: Deploy to production

on:
  push:
    tags:
      - "v[0-9]+.[0-9]+.[0-9]+"

jobs:
  release:
    permissions:
      contents: read
      pull-requests: write
    runs-on: ubuntu-latest
    steps:
      - name: Release Notification
        uses: thedaviddias/[email protected]
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}

Example Workflow with Custom Slack template

We can use the output from publish-relase-info-action and use in combinaison with other actions like slack-send in case you want to use a custom notification template.

name: Deploy to production

on:
  push:
    tags:
      - "v[0-9]+.[0-9]+.[0-9]+"

jobs:
  release:
    permissions:
      contents: read
      pull-requests: write
    runs-on: ubuntu-latest
    steps:
      - name: Release Notification
        uses: thedaviddias/[email protected]
        id: release
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          time_zone_offset: "+5"

      - name: Post to a Slack channel
        uses: slackapi/[email protected]
        env:
          SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}
        with:
          channel-id: 'CHANNEL_ID'
          payload: |
            {
              "text": "New release!",
              "blocks": [
                {
                  "type": "section",
                  "fields": [
                    {
                      "type": "mrkdwn",
                      "text": "*Project:*\n<${{ steps.release.outputs.repoLink }}|${{ steps.release.outputs.repo}}>",
                    },
                    {
                      "type": "mrkdwn",
                      "text": "*Version:*\n<${{ steps.release.outputs.releaseLink }}|${{ steps.release.outputs.releaseVersion }}>",
                    }
                  ]
                }
              ]
            }

Contributors

Licence

This GitHub Action is licensed under the MIT License.