Gitlab Integration - Outbound
=============================

This section describes the process of integrating a new Gitlab server (HUB) with the ARC Registry application for the outbound **Push** notification. The application leverages the Gitlab **System Hooks** feature to receive the push notification upon ARC updates with the repository.   

Creating User Profiles
----------------------

To create the admin and webhook user profiles, run the below script. Make sure all the individual containers of the application are already up and running.

#. Run the script **create_gateway_admin.sh** from the **install** directory.

.. note::
   | The default credentials of the admin account are:
   | keyID:         **2TrVTlijYsBR3W6Y5aPNgB**
   | keyPassword:   **6uR1TIHhGbrCRI602Mbuqg**   


Configure Gitlab System Hook
----------------------------

To enable Gitlab server send push notifications to the ARC Registry application, a Webhook (at repository level) or a System Hook (at the Gitlab instance level) need to be setup as follows. 

#. Login to the GitLab server as **admin**.

#. Goto the **Admin** tab and click **System Hooks** from the navigation on the left side.

#. Enter the URL **https://<Server-IP-Address>:4567/api/v0/webhook**

#. For the Secret Token, enter the combination of default keyID and keyPassword, separated by a colon (**<keyID>:<keyPassword>**).

#. Select only **Push events**.

#. Make sure the SSL verification is disabled.

#. Click **Add system hook** to create the webhook for outgoing push notifications.


Refer the Gitlab documentaion on `systemhook <https://docs.gitlab.com/ee/system_hooks/system_hooks.html#create-a-system-hook>`_ here.