GitHub Action
CI-SKIP-ACTION
GitHub Actions to skip build execution based on commit message.
|
Important
|
Since 8th February 2021 GitHub Actions supports skipping workflows out of the box. This GitHub Action is not needed anymore and will be not developed anymore. This repo is in read only mode. |
|
Note
|
Thank you for using and support! Implemented issue: #774. |
Sometimes there is a need to skip build on Continuous Integration (CI) server (GitHub Actions in this case), e.g. to avoid many releases after several merges to master/main branch. This is standard functionality well known in other CI systems, but missed in GitHub Actions. That’s why this is needed.
If the commit message (or a merge message) contains [ci skip] (in subject of body) the action will stop.
The simplest use case is to fail job fast after evaluating action.
on: [push]
jobs:
hello_world_job:
runs-on: ubuntu-latest
name: Build
steps:
- uses: actions/checkout@v2
with:
# The git history is needed for good evaluation of Pull Request commit messages.
# By default this action checkout only last commit.
# For PR it's temporary merge commit to current master and orginal commit message is missing.
# For big projects can be set to 1000 for performance reasons.
fetch-depth: '0'
- uses: mstachniuk/ci-skip@v1
with:
fail-fast: true
- name: Verification
run: |
echo "The previous step should exiting with 42 code and this code should not run"The action will immediately exit before Validation step returning exit code 42.
You can customize this exit code:
[...]
- uses: mstachniuk/ci-skip@v1
with:
fail-fast: true
exit-code: 22
[...]Now step will immediately exit with exit code 22. If you don’t like it, try fail-safe.
This is default behaviour.
Remember to check in each next step the env.CI_SKIP or env.CI_SKIP_NOT value in if.
on: [push]
jobs:
hello_world_job:
runs-on: ubuntu-latest
name: Should success
steps:
- uses: actions/checkout@v2
with:
fetch-depth: '0'
- uses: mstachniuk/ci-skip@v1
- name: Check if expression CI_SKIP
# Remember to check condition in each step
if: ${{ env.CI_SKIP == 'false' }}
run: |
echo "This step should not be executed when commit message contains [ci skip]"
- name: Check if expression CI_SKIP_NOT
# Remember to check condition in each step
if: ${{ env.CI_SKIP_NOT == 'true' }}
run: |
echo "This step should not be executed when commit message contains [ci skip]"In this approach the build will success when commit message contains [ci skip].
If you like to use another marker than [ci skip] for skipping CI build then use commit-filter input.
[...]
- uses: mstachniuk/ci-skip@v1
with:
commit-filter: 'banana banana'
[...]In this case when commit message contains banana banana then action will be skipped.
If you want to use multiple filters at once, it’s possible to separate them with the commit-filter-separator input.
[...]
- uses: mstachniuk/ci-skip@v1
with:
commit-filter: 'banana;orange'
commit-filter-separator: ';'
[...]It’s also possible to create a job dedicated to check skip messages.
[...]
jobs:
init:
runs-on: ubuntu-latest
outputs:
skip: ${{ steps.ci-skip-step.outputs.ci-skip }}
skip-not: ${{ steps.ci-skip-step.outputs.ci-skip-not }}
steps:
- uses: actions/checkout@v2
with:
fetch-depth: 0
- id: ci-skip-step
uses: mstachniuk/ci-skip@master
main_job:
needs: init
if: ${{ needs.init.outputs.skip == 'false' }}
[...]In this example, main_job will be skipped depending on the result of check_skip.
If you would decide on merge to skip or not an action the shipkit-chrome-extension can be helpful.
-
Just use YAML: It doesn’t work for merge commits.
-
Skip based on commit message: It’s a nice solution, but doesn’t work on merge commits and it’s not maintained anymore.
-
Cancel Workflow Action: It can cancel jobs with a status of
queuedorin_progress.