> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-add-letter-a-quickstart-82277.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/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-project-id.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=2ed7a0ff7eb063389b1fcabe607ba3bc" 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/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-project-access-token.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=35f6f8699b4b0f5c53691c84aa375f24" 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/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-config.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=d9be34d1933139776a37072d757e1cff" 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/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-webhook.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=9937dc5ed02d4144f17f27addab70955" 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/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-show-webtoken.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=2e9040afc785c0d662b1d90836b72b32" 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/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-project-webtoken.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=b6b282420acbe4229e24dfa94fef89a9" 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/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-project-webtoken-test.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=4a45be0e7dcb17bdf9214e6faf000cf2" width="1161" height="724" data-path="images/gitlab/gitlab-project-webtoken-test.png" />
    </Frame>
  </Step>
</Steps>
