Skip to main content

Set up a GitLab integration

  • Updated

An integration must be configured and linked to the project to start collecting data for the Technical Axis. However, you only need to add the integration once to connect it to multiple projects, allowing you to evaluate different teams.

 

Available integrations

 

To set up a GitLab integration

  1. Select the project for which you want to start collecting data.
    Psst! If you haven't added your project yet, do that first!
  2. Access the Technical Axis, and click on Link an integration.

    EN_-_Axe_processus_et_technique_-_New_integration.png


  3. In the window that opens, click Add an integration.

    EN_-_Choose_integration.png


  4. Select the GitLab option, then click Next.

    EN_-_Add_integration_-_GitLab.png

  5. A window will open. Complete the fields.
    • The Integration name helps you recognize this integration later. This name will only be displayed on the Settings page.
    • The Personal Access Token must be generated beforehand directly in GitLab settings. You can refer to this official GitLab help article for more information on this subject. This article is also available in the configuration window.
    • The API Key is a key created in the settings of the Gitlab user profile.
      To do this:
      • Go to GitLab
      • Access your user settings (your avatar in the upper right corner)
      • In the vertical menu on the left, select Access tokens
      • Name the new token and, if necessary, determine its expiration date
      • Select the scopes to include.
        Psst! The projects accessible through the integration are only those the token holder is a member of.
        read_user
        read_api
        read_repository
      • Enter the generated token in the API Key field.
        Psst! It is impossible to display an existing PAT. Therefore, if you have private internal documentation the PAT can be stored, it may make sense to add this data.
    • The URL is the base Gitlab site we want to connect to. So, for example, we could have https://gitlab.myserver.com. Note that in some cases, the server is simply the main GitLab URL, with no extension.

      Once the fields are completed, click on Add integration.

      EN_-_GitLab_-_Creds.png

 

That's it! Your GitLab integration is set up and ready to be linked to your project to start collecting data!

Psst! Depending on the volume of data, the synchronization of the Technical Axis can take several minutes or even several hours in the most extreme cases.

Related articles