Skip to content

GitHub action for deleting assets from a GitHub release.

License

Notifications You must be signed in to change notification settings

mknejp/delete-release-assets

Repository files navigation

GitHub Action - Delete Release Assets

This GitHub action lets you delete assets from existing GitHub releases. This is useful for scenarios where the artifacts of nightly builds are made available in a GitHub release and cannot be just overwritten because the asset names contain changing information like the build date or commit ID.

⚠ WARNING ⚠

Because this action has the power to delete any asset from any release in the repository (via the access token) be extra careful that you specify the correct tag!

Usage

Typical usage would be adding this action as a step before uploading new assets to a release (for example using the @actions/upload-release-asset GitHub action).

Inputs

name required default description
assets yes Newline-delimited globs of asset names to delete from the release. See the example below for supported formats.
fail-if-no-assets no true Fail the action if the release contains no matching assets.
fail-if-no-release no true Fail the action if no release associated with the given tag was found.
token yes The token for authenticating against the GitHub API.
tag yes The name of the tag. This uniquely identifies the release. May either be a tag name directly (like v1.0.0) or a tag ref (like refs/tags/v1.0.0 as is provided by github.ref or GITHUB_REF).

Outputs

name example description
deleted-assets file1.txt;file2.zip Semicolon-delimited list of deleted asset names.
release-id 1234 The unique ID of the github release from which the assets were deleted.

Example workflow

On every push to the staging branch delete existing assets from the release with the tag staging.

name: Stage build

on:
  push:
    branches:
      - stage

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v2

      - name: Build project
        run: ./build

      - name: Delete old release assets
        uses: mknejp/delete-release-assets@v1
        with:
          token: ${{ github.token }}
          tag: staging # This may also be of the form 'refs/tags/staging'

          # Optional another repository
          repository: owner/repo

          # Pick one of:
          # 1. a single file name
          assets: changelog.txt
          # 2. a glob pattern (note the quotes if it begins with *)
          assets: '*.zip'
          # 3. multiple names/globs, one per line
          assets: |
            changelog.txt
            *.zip

      - name: Upload new release assets
        uses: actions/upload-release-assets@v1
        ...

License

The scripts and documentation in this project are released under the MIT License.

About

GitHub action for deleting assets from a GitHub release.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published