You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

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. 

Continua currently support tagging for Git, Mercurial and Subversion repositories.  Continua attempts to provide a consistant interface for tagging across all of these repositories, although the implementation varies significantly.

 

 

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.

Repository

You 

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.

When To Run

You can specfy when the build event handler runs by linking it to a Build Event on the When To Run tab

 

 

Build Event

Select the event which triggers the tag action. You can choose one of the following Build Events:

 

  • On Build Created
  • On Before Build Queued
  • On Before Build Start
  • On After Build Started
  • On Before Stage Start
  • On Sending Stage To Agent
  • On Stage Completed
  • On Build Pending Promotion
  • On Before Build Continue
  • On After Build Continued
  • On Build Stopping
  • On Build Completed

Stage

For stage events, select the stage this applies to, or "(all stages)" to trigger the tagging action for all stages

Build Status

For "On Stage Completed" and "On Build Completed", you can choose to trigger the tagging action when the build is Successful or has Failed. 

Options

Allow Tagging of Existing Tag Changeset

 Some repositories (Mercurial and Subversion) record 

  • No labels