The Tag Repository Changeset build event handler can be used to tag or label changesets in the respository when certain build events occur. You may, for example, wish to label changesets which were successfully deployed with the build version number.
Tag Name
Enter the name of the tag. You can use expressions here but ensure that the character are restricted to those allowed by the selected repository type.
Tag Comment
A comment to be stored in the repository against the tag (for Git) or tag changeset (for Mercurial and Subversion). You can use expressions in the field.
Tagging Action
This is one of the following:
- Create new tag: A new tag will be created on the specified changeset. This will raise an error if the tag already exists in the repository.
- Create new or move existing tag: (Git and Mercurial only) Any existing tag will be moved to the specified changeset, otherwise a new tag will be created.
- Delete existing tag: Delete any existing tag. This will raise an error if the tag does not exist.
Changeset to Tag
You can choose to apply the tagging action to the First or Last changeset associated with the build. This is only relevant if the build is run with the "Associate all changesets since last successful build" option selected.