Awesome
GitHub Action for Uploading Release Artifacts
This repository contains a simple GitHub Action implementation which allows you to attach binaries to a new (github) release of your repository.
Enabling the action
There are two steps required to use this action:
- Enable the action inside your repository.
- This will mean creating a file
.github/workflows/release.yml
which is where the action is invoked. - You'll specify a pattern to describe which binary-artifacts are uploaded.
- This will mean creating a file
- Ensure your binary artifacts are generated.
- Ideally you should do this in your workflow using another action.
Sample Configuration
The following configuration file uses this action, along with the github-action-build action to generate the artifacts for a project, then attach them to a release.
on:
release:
types: [created]
name: Handle Release
jobs:
generate:
name: Create release-artifacts
runs-on: ubuntu-latest
steps:
- name: Checkout the repository
uses: actions/checkout@master
- name: Generate the artifacts
uses: skx/github-action-build@master
- name: Upload the artifacts
uses: skx/github-action-publish-binaries@master
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
args: 'example-*'
This is the preferred approach because it uses a pair of distinct actions, each having one job:
- skx/github-action-build
- Generates the build artifacts.
- i.e. Compiles your binaries.
- skx/github-action-publish-binaries
- Uploads the previously-generated the build artifacts.
Advanced Configuration
This action is primarily intended to be invoked upon a release-event, which means that Github itself will create a new release, and the action will upload the specified artifacts to that release.
However it might be that you wish to create a new release within an action, then modify it by populating the content and adding artifacts. This is possible, because we allow you to specify the ID of the release to which your artifacts should be associated.
You'll want to configure it using something like this:
upload_artifacts:
name: Upload Artifacts
needs: [create_release]
runs-on: ubuntu-latest
steps:
- name: Upload the artifacts
uses: skx/github-action-publish-binaries@release-1.3
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
releaseId: ${{ needs.create_release.outputs.id }}
args: '*.bin'
Here we're explicitly passing the releaseId
variable, such that the specified release ID will be used.
GITHUB_TOKEN
Your workflow configuration file, named .github/workflows/release.yml
, will contain a reference to secrets.GITHUB_TOKEN
, however you do not need to generate that as it is automatically created. You will however need to update your repository settings under Actions -> General
to give the GITHUB_TOKEN
write access to upload binaries to the release, without write access you will get a 403
response error.
You can inject secrets into workflows, defining them in the project settings, and referring to them by name, but the GITHUB_TOKEN
value is special and it is handled transparently, requiring no manual setup.