gittfstfsbuildreleasems-release-management

Tagging a TFS Git repository during a release


I am setting our build/release environment using TFS 2017.

I set up the Build to run automatically after each commit, and when we are ready to release a version of our application, a Release is manually created, and then deployed to various environments.

We would like to tag released versions in our git repository in order to easily know which git revision correspond to a binary. The "Label Source" setting in the Build definition allows to tag a git revision at build time, but since we build on every commit that would generate a lot of tags which we don't care about (as they are not deployed anywhere until a release is made).

How can TFS be setup so that when a Release is created (or possibly, deployed to an environment), a tag is created on the corresponding commit in our Git repository?


Solution

  • You can add tags by using REST API:

    POST https://{instance}/DefaultCollection/_apis/git/repositories/{repository}/refs?api-version={version}
    
    [
      {
        "name": {string},
        "oldObjectId": {string}, (The current commit id the ref is at. 0000000000000000000000000000000000000000 when creating a new ref.)
        "newObjectId": {string}
      }
    ]
    

    Calling Rest API through PowerShell:

    $result = Invoke-RestMethod -Uri $uri -Method Get -ContentType "application/json" -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)}
    

    More information, you can refer to Calling VSTS APIs with PowerShell (apply to tfs 2017)