Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
message-square

GitHub Action

Release Commenter

v1.2.0

Release Commenter

message-square

Release Commenter

Comment on PRs and Issues when a fix is released

Installation

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

              

- name: Release Commenter

uses: apexskier/[email protected]

Learn more about this action in apexskier/github-release-commenter

Choose a version

Release Commenter

This GitHub Action automatically comments on Issues and PRs when a fix is released for them.

How it works

Use this action in a workflow triggered by a release. It will scan commits between that and the prior release, find associated Issues and PRs, and comment on them to let people know a release has been made. Associated Issues and PRs can be directly linked to the commit or manually linked from a PR associated with the commit.

Inputs

GITHUB_TOKEN

A GitHub personal access token with repo scope, such as secrets.GITHUB_TOKEN.

comment-template (optional)

Override the comment posted on Issues and PRs. Set to the empty string to disable commenting. The string {release_link} will be replaced with a markdown link to the release. {release_name} will be replaced with the release's name. {release_tag} will be replaced with the release's tag.

label-template (optional)

Add the given label. Multiple labels can be separated by commas. {release_name} will be replaced with the release's name. {release_tag} will be replaced with the release's tag.

Example

on:
  release:
    types: [published]

jobs:
  release:
    steps:
      - uses: apexskier/github-release-commenter@v1
        with:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          comment-template: |
            Release {release_link} addresses this.

Known limitations

These are some known limitations of this action. I'd like to try to address them in the future.

  • Non-linear releases aren't supported. For example, releasing a patch to a prior major release after a new major release has been bumped.
  • Non-sequential releases aren't supported. For example, if you release multiple prereleases between two official releases, this will only create a comment for the first prerelease in which a fix is released, not the final release.
  • The first release for a project will be ignored. This is intentional, as the use case is unlikely. Most projects will either have several alphas that don't need release comments, or won't use issues/PRs for the first commit.

Versions

Workflows will automatically update the tags v1 and latest, allowing you to reference one of those instead of locking to a specific release.