Skip to content
git-branch

GitHub Action

Github Release

release-20241111151247 Latest version

Github Release

git-branch

Github Release

Publish Github releases from an action

Installation

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

              

- name: Github Release

uses: elgohr/Github-Release-Action@release-20241111151247

Learn more about this action in elgohr/Github-Release-Action

Choose a version

Github-Release-Action

Actions Status

Creates a plain Github release, without attaching assets or source code.

Usage

name: Publish Release
on:
  push:
    tags:
      - 'v*'
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3
    - name: Create a Release
      uses: elgohr/Github-Release-Action@v5
      env:
        GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      with:
        title: MyReleaseMessage

Mandatory Arguments

title

title is a message which should appear in the release. May contain spaces.

Optional Arguments

workdir

workdir can be used to specify a directory that contains the repository to be published.

with:
  title: MyReleaseMessage
  workdir: myDirectoryName

tag

tag can be used to set the tag of the release.

with:
  title: MyReleaseMessage
  tag: MyTag

prerelease

prerelease is used to publish a prerelease.

with:
  title: MyReleaseMessage
  prerelease: true

Notes

${{ secrets.GITHUB_TOKEN }} can be used for publishing, if you configure the correct permissions.

This can be done by giving the Github token all permissions (referred to as "Read and write permission") with the setting below available in Settings > Actions > General
Screenshot of permission setting OR alternatively it can be achieved via adding

permissions:
  packages: write
  contents: write

to the concrete job creating the release. For more details see the documentation on token permissions.

GitHub Enterprise

To publish your release to self-hosted GitHub Enterprise, include GH_ENTERPRISE_TOKEN and GH_HOST as environment variables.
For example:

      - name: Create Release
        if: ${{ github.event.inputs.create_release }}
        uses: elgohr/Github-Release-Action@v5
        env:
          GH_ENTERPRISE_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          GH_HOST: yourgithub.company.com
        with:
          title: "New release"
          tag: "v1.0.1"