Configuring traceability from work items to Gerrit commits

Edit online

You can configure Gerrit to enable linking of Git commits to IBM® Engineering Workflow Management (EWM) work items.

Before you begin

Make sure that you have completed the tasks described in Configuring the basic integration with Gerrit.

A shared user base, such as a common LDAP, between EWM and Gerrit server is optional for linking Git commits or patchsets to work items through ref-updated script hook, patchset–created script hook, or webhook. It is recommended to add an EWM functional user ID to the webhook, ref-updated script hook, or patchset-created script hook if there is no shared user base between EWM and Gerrit server.

You must register every Git repository with EWM to enable linking of Git commits in that repository to EWM work items.

You must configure every Git repository with EWM-specific configuration variables or webhook configuration details if you are using ref-updated or patchset-created script hooks to link Git commits or patchsets to EWM work items.

Traceability from Gerrit patchsets, Git commits to work items Configuring the basic integration with Gerrit Integrate Gerrit with EWM Prerequisites for integrating with Gerrit Configuring ref-updated hooks to link Git commits to EWM work items Configuring patchset-created hooks to link patchsets to EWM work items Configuring web hooks to link patchsets to EWM work items Validating the link

About this task

You must use ref-updated script hooks to link Git commits to EWM work items. You can use either the patchset-created script hook or a webhook to link Gerrit patchsets to EWM work items.