GitLab has the ability to send a Json payload to a webservice endpoint upon a developer commit push. In this document we will configure a temporary webhook to test network connectivity to Continuum.
GitLab will need outbound access to push events to Continuum on the default port of 8080. Contnuum will need inbound access on the same port.
Test GitLab Webhook Connectivity
Setup Temporary Test Webhook
Login to your GitLab application and select a project to setup the webhook on. Click the
Settings link on the left (the icon looks like a set of gears). Click
Web Hooks on the left.
URL you will want to enter the Continuum address as in the example that follows:
Push events is selected. Click the
ADD WEB HOOK button.
Test the Webhook Push
Below you should see the new webhook. Click the
TEST button. Click on the new webhook to see how GitLab's test POST did.
If the test is successful you should see
Hook successfully executed in blue at the top.
If the test errors you will see "Hook execution failed. Ensure hook URL is correct and service is up." in red.
Errors typically will be related to server address, port or networking issues that will need to be resolved (e.g. if a timeout occurs). If you need to make changes to the webhook url, delete the failing webhook and repeat the process of adding a new webhook and testing the webhook.
Note: You may also see a message that says shows a 401 UNAUTHORIZED error, this means that you are able to connect to Continuum and can move on.
Common problems to look for:
- Wrong Continuum server address and port
- Network access from GitLab server to VersionOne Continuum server
- Local firewall on Continuum server needs to allow port 8080
- GitLab webhook not enabled for repository
- Commit was not pushed to GitLab
If you continue to have problems with getting the changes posted from GitLab to Continuum, contact email@example.com.
Delete the Temporary Webhook
We we return to create a more permanent webhook later. For now return to the Web Hooks page and delete the temporary webhook.
Return to Connecting to Tools.