> ## Documentation Index
> Fetch the complete documentation index at: https://omer-914cc1c6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab

> Synchronisez votre documentation avec un dépôt GitLab

Nous utilisons des jetons d’accès et des webhooks pour authentifier et synchroniser les modifications entre GitLab et Mintlify.

* Mintlify utilise des jetons d’accès pour extraire des informations depuis GitLab.
* GitLab utilise des webhooks pour informer Mintlify lorsque des modifications sont apportées, ce qui permet des déploiements de prévisualisation pour les demandes de fusion.

<div id="set-up-the-connection">
  ## Configurer la connexion
</div>

<Note>
  **Clonage HTTPS requis** : votre projet GitLab doit avoir le clonage HTTPS activé pour que Mintlify puisse accéder à votre référentiel. Vous pouvez le vérifier dans GitLab en allant dans **Settings** > **General** > **Visibility and access controls** de votre projet.
</Note>

<Steps>
  <Step title="Find your project ID">
    Dans votre projet GitLab, accédez à **Settings** > **General** et repérez votre **Project ID**.

    <Frame>
      <img src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/gitlab/gitlab-project-id.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=c7f0ef7996dc1e5813770046e9294802" alt="La page General Settings dans le tableau de bord GitLab. Le Project ID est mis en évidence." width="950" height="775" data-path="images/gitlab/gitlab-project-id.png" />
    </Frame>
  </Step>

  <Step title="Generate an access token">
    Accédez à **Settings** > **Access Tokens** et sélectionnez **Add new token**.

    Configurez le jeton avec ces paramètres :

    * **Name** : Mintlify
    * **Role** : Maintainer (requis pour les référentiels privés)
    * **Scopes** : `api` et `read_api`

    Cliquez sur **Create project access token** et copiez le jeton.

    <Note>
      Si les Project Access Tokens ne sont pas disponibles, vous pouvez utiliser un Personal Access Token à la place. Notez que les Personal Access Tokens expirent et doivent être mis à jour.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/gitlab/gitlab-project-access-token.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=529adadb960ed37e9c9f0b74b9c54773" alt="La page Access Tokens dans le tableau de bord GitLab. Les paramètres à configurer pour Mintlify sont mis en évidence." width="1166" height="904" data-path="images/gitlab/gitlab-project-access-token.png" />
    </Frame>
  </Step>

  <Step title="Set up the connection">
    Dans le [Tableau de bord Mintlify](https://dashboard.mintlify.com/settings/deployment/git-settings) :

    1. Saisissez votre Project ID et votre access token.
    2. Renseignez les autres paramètres requis.
    3. Cliquez sur **Enregistrer les modifications**.

    <Frame>
      <img src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/gitlab/gitlab-config.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=bdbbff80a9e9be5db9f67e8a5f3e9c4a" alt="La page Git Settings dans le tableau de bord Mintlify. Les paramètres de configuration GitLab sont mis en évidence." width="2994" height="1704" data-path="images/gitlab/gitlab-config.png" />
    </Frame>
  </Step>
</Steps>

<div id="create-the-webhook">
  ## Créer le webhook
</div>

Les webhooks nous permettent de recevoir des événements lorsque des modifications sont apportées afin de
déclencher automatiquement des déploiements.

<Steps>
  <Step title="Accédez à Settings > Webhooks et cliquez sur « Add new Webhook »">
    <Frame>
      <img src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/gitlab/gitlab-webhook.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=9dce33ced4471cb84008f9bb49903999" width="3014" height="1704" data-path="images/gitlab/gitlab-webhook.png" />
    </Frame>
  </Step>

  <Step title="Configurer l'URL et le webhook">
    Dans le champ « URL », saisissez l’endpoint `https://leaves.mintlify.com/gitlab-webhook` et nommez le webhook « Mintlify ».
  </Step>

  <Step title="Coller le jeton">
    Collez le jeton du webhook généré après la configuration de la connexion.

    <Frame>
      <img src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/gitlab/gitlab-show-webtoken.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=cb400eb4211409dcc24d2360e34fd042" width="555" height="527" data-path="images/gitlab/gitlab-show-webtoken.png" />
    </Frame>
  </Step>

  <Step title="Sélectionner les événements">
    Sélectionnez ces événements pour déclencher le webhook :

    * **Push events** (toutes les branches)
    * **Merge requests events**

    Une fois terminé, l’écran devrait ressembler à ceci :

    <Frame>
      <img src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/gitlab/gitlab-project-webtoken.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=e159b68e98377521ee4661548535cda5" alt="La page Webhook dans le Dashboard GitLab. Les paramètres à configurer pour Mintlify sont mis en évidence." width="1161" height="1740" data-path="images/gitlab/gitlab-project-webtoken.png" />
    </Frame>
  </Step>

  <Step title="Tester le webhook">
    Après avoir créé le webhook, cliquez sur le menu déroulant « Test » et sélectionnez « Push events » pour envoyer une charge utile d’exemple et vérifier la bonne configuration. Un message indiquera « Hook executed successfully: HTTP 200 » si tout est correct.

    Cela vous aidera à confirmer que tout fonctionne correctement et que votre documentation se synchronise correctement avec votre référentiel GitLab.

    <Frame>
      <img src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/gitlab/gitlab-project-webtoken-test.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=d3b84f35a286d0d32f7555de944da001" width="1161" height="724" data-path="images/gitlab/gitlab-project-webtoken-test.png" />
    </Frame>
  </Step>
</Steps>