Configuring webhooks for Merge Request traceability

About this task

You can configure a webhook to link work items to GitLab Merge Requests.

Procedure

  1. In the web client, log on to Change and Configuration Management. For example, go to https://host_name:9443/ccm/web.
  2. On the CCM project page, click Source Control > Work with Git.
  3. Click Browse Registered Git Repositories.
  4. Select the repository that you registered.
  5. Expand the Hosting Server Configuration section.
  6. In the Hosting Server field, select GitLab.
  7. In the Secret Key Authorization field, add a secret. The secret is provided when you configure the webhook in GitLab.
  8. Click Copy next to the webhook URL.
  9. Click Save to persist the changes to the Git Repository Registration page in IBM® Engineering Workflow Management (EWM).
  10. Optional: If GitLab and EWM do not share a user base, add a functional user ID for the webhook URL.
    1. Click Insert Functional User.
    2. Select the user and click OK. Click the Copy button next to the webhook URL.
    3. Click Save to persist the changes to the Git Repository Registration page in IBM® Engineering Workflow Management (EWM).
  11. To add the webhook URL to the GitLab repository, follow the instructions in Webhooks.
    1. Add the webhook URL.
    2. Under the Trigger section, select the Merge Request event.
    3. In the Secret Token field, enter the value that you entered in the Secret Key Authorization field in step 7.
    4. Click Save to the webhook configuration in GitLab.