What is a Smart Commit?

Smart commits allow your team to perform actions on Jira issues from a single commit.  Users can enter the issue key and the desired action such as time tracking or closing an issue. The VAEC Git Integration process supports smart commit by adding a simple syntax to a commit message.

You can:

• comment on issues
• record time tracking information against issues
• transition issues to any status defined in the Jira Software project's workflow.

A Smart Commit command must not span more than one line (i.e. you cannot use carriage returns in the command), but you can add multiple commands to the same line.

We are looking to integrate the LGY Projects with the VA GitHub Enterprise to have Commits, PRs, and other build information be automatically reflected in our Jira Issues.

Step-by-step guide

Follow these steps to begin using Smart Commits:

*Jira Project Admin: Prepare your Jira project by adding "VAjira Service" as a developer to your project.

1. Create the webhook in your repo.
   1. Navigate to your repo and go to Settings -> Hooks and click "Add webhook"
2. Copy this URL into the "Payload URL" textbox:
   1. https://devops.va.gov/jenkins/generic-webhook-trigger/invoke?token=d@wer#wrdfOKMwer43sd
   2. Change "Content type" to "application/json"
3. Click the radio button "Let me select individual events."
4. Only check the "Pushes" event, and nothing else.
5. Click "Add webhook"
6. Test the connection with a commit:    

(Your commit messages must have your Jira ticket ID in the following syntax: [#TICKETID] )

1. Example commit message:        

 git commit -m '[#ABC-123] This is an example commit message, I am done!'

Related articles

An Atlassian Guide on how to use Smart Commits, along with examples, is linked HERE.