GitHub Action
Shortcut (Clubhouse) Workflow
A github action to update and transition the workflow state of clubhouse stories.
Currently the action supports updating stories listed in a github release, or pull request title.
While released is shown below, the action can be configured to run in response to any of the valid release action types that makes sense for your workflow.
name: Release Stories
on:
release:
types: ['released']
jobs:
update-clubhouse:
runs-on: ubuntu-latest
steps:
- uses: farmersdog/clubhouse-workflow-action@v1
with:
# Required. Auth token to use the clubhouse api for your workspace.
clubhouseToken: ${{ secrets.CLUBHOUSE_TOKEN }}
# Optional. The clubhouse workflow state released stories should be in.
# default: 'Completed'.
endStateName: Completed
# Optional. Whether to update story descriptions with a link to the release.
# default: false.
addReleaseInfo: falseThe only requirement for identifying stories in a release is that the id is prepended with ch or ch-. Any capitalization, surrounding brackets, or no brackets, will all work.
For example, if the below block is the release body the first three will be extracted, and the last one will not.
### Features
ch1234 Shiny New Thing
[ch-9876] Bug In Disguise
### Bugs
(CH5432) Some color was off
[1928] Lost $$$$If addReleaseInfo: true is set the action will update the story with a link back to the release like shown below.
### Release Info
https://github.com/org/repo/releases/tag/v1.0.0The action will only add ### Release Info to a story if it's not already present. In some case a story is released more than once it will have a link to the first release.
Clubhouse natively supports transitioning stories when a PR is opened or merged. This action can help with the in-between cases, like if a specific label is added to the PR.
name: Move Stories to Testing
on:
pull_request:
types: ['labeled']
jobs:
update-clubhouse:
runs-on: ubuntu-latest
if: github.event.label.name == 'Ready for QA'
steps:
- uses: farmersdog/clubhouse-workflow-action@v1
with:
# Required. Auth token to use the clubhouse api for your workspace.
clubhouseToken: ${{ secrets.CLUBHOUSE_TOKEN }}
# Optional. The clubhouse workflow state released stories should be in.
# default: 'Completed'.
endStateName: In TestingOr alternatively, you can run the action in response to a review request.
name: Move Stories to Testing
on:
pull_request:
types: ['review_requested']
jobs:
update-clubhouse:
runs-on: ubuntu-latest
if: contains(github.event.pull_request.requested_teams.*.name, 'QA')
steps:
- uses: farmersdog/clubhouse-workflow-action@v1
with:
# Required. Auth token to use the clubhouse api for your workspace.
clubhouseToken: ${{ secrets.CLUBHOUSE_TOKEN }}
# Optional. The clubhouse workflow state released stories should be in.
# default: 'Completed'.
endStateName: In Testing