forgejo-release

Description

Upload or download the assets of a release to a Forgejo instance.

Inputs

name	description	required	default
url	URL of the Forgejo instance	false	${{ env.FORGEJO_SERVER_URL }}
repo	owner/project relative to the URL	false	${{ forge.repository }}
tag	Tag of the release	false	${{ forge.ref_name }}
title	Title of the release (defaults to tag)	false	""
sha	SHA of the release	false	${{ forge.sha }}
token	Forgejo application token (must have write:repository)	false	${{ forge.token }}
release-dir	Directory in which release assets are uploaded or downloaded	false	dist/release
release-notes	Release notes	false	""
release-notes-file	Path to a file containing your release notes (takes priority over release-notes)	false	""
direction	Can either be download or upload	true	""
gpg-private-key	GPG Private Key to sign the release artifacts	false	""
gpg-passphrase	Passphrase of the GPG Private Key	false	""
download-retry	Number of times to retry if the release is not ready (default 1)	false	""
download-latest	Download the latest release	false	false
verbose	Increase the verbosity level	false	false
override	Override an existing release by the same {tag}	false	false
prerelease	Mark Release as Pre-Release	false	false
release-notes-assistant	Generate release notes with Release Notes Assistant	false	false
hide-archive-link	Hide the archive links	false	false
skip-assets	Skip uploading release assets	false	false

Examples

Upload

Upload the release located in release-dir to the release section of a repository (url and repo):

jobs:
  upload-release:
    runs-on: docker
    steps:
      - uses: actions/checkout@v4
      - uses: actions/forgejo-release@v2.12.0
        with:
          direction: upload
          url: https://my-forgejo-instance.net
          repo: myuser/myrepo
          token: ${{ secrets.WRITE_TOKEN_TO_MYREPO }}
          tag: v1.0.0
          release-dir: dist/release
          release-notes: "MY RELEASE NOTES"

Upload a release with custom release notes located in a file:

jobs:
  upload-release:
    runs-on: docker
    steps:
      - uses: actions/checkout@v4
      - name: Generate Changelog
        run: ./generate-changelog.sh > dist/changelog.md
      - uses: actions/forgejo-release@v2.12.0
        with:
          direction: upload
          url: https://my-forgejo-instance.net
          repo: myuser/myrepo
          token: ${{ secrets.WRITE_TOKEN_TO_MYREPO }}
          tag: v13.0.2
          release-dir: dist/release
          release-notes-file: dist/changelog.md

Download

Example downloading the forgejo release v1.21.4-0 into the working directory:

jobs:
  download-release:
    runs-on: docker
    steps:
      - uses: actions/checkout@v4
      - uses: actions/forgejo-release@v2.12.0
        with:
          direction: download
          url: https://my-forgejo-instance.net
          repo: myuser/myrepo
          token: ${{ secrets.READ_TOKEN_TO_MYREPO }}
          tag: v1.0.0
          release-dir: ./  # by default, files are downloaded into dist/release

Real world example

This action is used to publish the release notes assistant assets.

Update the input section of the README

Using action-docs:

# Edit the action.yml file and run:
npx action-docs --update-readme