Tag Release Upload
ActionsTags
(1)Creates a tag, release, and uploads assets based on the version string specified. But there are already dozens of these, including ones created by GitHub, right? Well I did ths for 2 reasons.
- To learn how to build GitHub workflows and actions
- This doesn't fail if something already exists! The logic is:
- Check for existing tag
- Create it if it doesn't exist
- Check for existing release for the tag
- Create it if it doesn't exit
- Check for each specified asset in the release
- If the asset already exists
- if overwrite, then delete it and upload the new version
- else
- Upload
- If the asset already exists
- Check for existing tag
I designed this to work with the actions AssemblyInfo Version and .Net SDK Project file Version. The idea is if I want a new release, I can change the assembly version attribute in my Visual Studio project, and push. This will create a new release when the version number changes, but will do nothing if the version already exists (instead of failing).
Create new .github/workflows/my-workflow.yml file:
name: .NET Core
on:
push:
branches: [ master ]
pull_requests:
branches: [ master ]
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v2
- name: Setup .NET Core
uses: actions/setup-dotnet@v1
with:
dotnet-version: 3.1.101
- name: Build
run: |
dotnet build -c Release
zip -r binaries.zip ./MyProject/bin/release/netcoreapp3.1
zip -r otherstuff.zip ./otherstuff
# Get the assembly version, use this as the tag.
# That way, to do a new release, just update the assembly version on the next commit
- name: Get Assembly Version
id: get_version
uses: jasondavis303/[email protected]
with:
PROJ_FILE: MyProject/MyProject.csproj
- name: Tag and Release
uses: jasondavis303/[email protected]
with:
github-token: ${{ secrets.GITHUB_TOKEN }}
# Use the version from the previous step
version: v${{ steps.get_version.outputs.ASSEMBLY_VERSION }}
assets: '[ "binaries.zip", "otherstuff.zip" ]'
overwrite: false | Input | Description |
|---|---|
| github-token | Needed to create tags, releases and uploads |
| version | Version of the tag/release to create |
| assets | Optional: json array of filenames to upload, relative to the root of the repository |
| overwrite | Optional: weather to overwrite existing assets |
Tag Release Upload is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.