GitLab CI - avoid build when adding tag

问题

How do I prevent a gitlab ci pipeline being triggered when I add a git tag? I'm running this command locally (as opposed to within a gitlab-ci job)

git tag -a "xyz"

and then pushing the tag; and this triggers various pipelines. I want to exclude some of those pipelines from running.

I'm trying variations on ideas from questions such as this; that question is using only, I'm wanting to exclude, so I'm trying except. The answers there have two variants, one with refs one without.

build:  
  # ... my work here ...  
  except:
    - tags


build:  
  # ... my work here ...  
  except:
    refs:
      - tags

Neither seem to have any effect; I add a tag, the build still happens.

My understanding may be completely awry here as there seem to be three possible meanings of the word tags and when reading docs or examples I'm not always sure which meaning is applicable:

Git tags applied using git tag
Gitlab CI tags used to determine which runners pick a job
The ref identifier of a commit used to trigger a pipeline via the REST API. This is usually a branch name, but could be a git tag.

I'm interested in controlling what happens if the first case. It does seem clear from comments so far that "except: -tags" is not relevant to my case, so is there any approach that does work?

回答1:

Except tags is exactly what you should use if you want to skip build for tags.

You need to be sure to understand commit vs branches vs tags

To illustrate what happens when you push tagged commit to gitlab I did as follows:

Created .gitlab-ci.yml with following content:

tests_always_run:
    script:
      - echo I should always execute
tests_except_tags:
    script:
      - echo I skip tagged triggers
    except:
      - tags

Commited changes, tagged commit and pushed with --follow-tags to make sure tag is also propagated to server:

git add .gitlab-ci.yml
git commit -m 'my great yml with except tags'
git tag -a "abc" -m "Test tag"
git push --follow-tags

Ilustrated results:

If you want to skip CI for selected commit then you could use git push -o ci.skip, inspired by this article

回答2:

(note : this a formatted comment more than an answer)

In order to debug the conditions that trigger your pipeline :

gitlab's doc mentions several variables which are set when running a CI job, among which :

CI_COMMIT_REF_NAME : The branch or tag name for which project is built

CI_COMMIT_BRANCH : The commit branch name. Present only when building branches.

CI_COMMIT_TAG : The commit tag name. Present only when building tags.

Have your build job output some of these variables (e.g : echo "triggered by ref : " $CI_COMMIT_REF_NAME) to view what triggered your job.

来源：https://stackoverflow.com/questions/60351496/gitlab-ci-avoid-build-when-adding-tag

标签

git

gitlab

gitlab-ci