forgejo-release/README.md
2024-02-01 12:50:40 +00:00

2 KiB

forgejo-release

Description

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

Inputs

parameter description required default
url URL of the Forgejo instance false
repo owner/project relative to the URL false
tag Tag of the release false
sha SHA of the release false
token Forgejo application token true
release-dir Directory in whichs release assets are uploaded or downloaded true
release-notes 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
verbose Increase the verbosity level false false
prerelease Mark Release as Pre-Release false false

Example

Upload

on: [tag]
jobs:
  upload-release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/forgejo-release@v1
        with:
	        direction: upload
	        url: https://code.forgejo.org
          release-dir: dist/release
          release-notes: "MY RELEASE NOTES"

Download

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

on: [tag]
jobs:
  download-release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/forgejo-release@v1
        with:
	        direction: download
	        url: https://code.forgejo.org
          repo: forgejo/forgejo
          tag: v1.21.4-0
          release-dir: ./  # by default, files are downloaded into dist/release

Update the README

With https://github.com/npalm/action-docs action-docs --update-readme