# Activation de la synchronisation GitLab
### Prise en main
Dans l’espace que vous souhaitez synchroniser avec votre dépôt GitLab, accédez au menu de l’espace en haut à droite, puis sélectionnez **Synchroniser avec Git**. Dans la liste des fournisseurs, sélectionnez **Synchronisation GitLab**, puis cliquez sur **Configurer**.
Options de configuration de la synchronisation GitLab.
### Générez et saisissez votre jeton d’accès API
Vous pouvez générer un jeton d’accès API dans les paramètres utilisateur de votre GitLab.
{% hint style="info" %}
Il existe deux types de jetons d’accès dans GitLab : Projet et Personnel. Notez que, pour que l’intégration fonctionne, vous devrez utiliser un jeton Personnel, que vous pouvez générer depuis le menu des préférences utilisateur de GitLab.
{% endhint %}
Assurez-vous d’activer l’accès suivant pour votre jeton :
* `api`
* `read_repository`
* `write_repository`
Si les jetons que vous créez sont également associés à un rôle spécifique, assurez-vous aussi qu’il dispose du rôle `Mainteneur` ou `Administrateur` .
Vous pouvez ensuite coller le jeton dans le champ du jeton d’accès API lors de la configuration de votre intégration GitLab.
### Sélectionnez un dépôt et une branche
Sélectionnez le dépôt que vous souhaitez garder synchronisé avec votre contenu GitBook.
{% hint style="info" %}
**Vous ne voyez pas votre dépôt ?** Assurez-vous d’avoir défini les autorisations correctes lors de la création de votre jeton API.
{% endhint %}
Une fois le dépôt correct sélectionné, choisissez la branche vers laquelle vous souhaitez envoyer les commits et depuis laquelle vous souhaitez synchroniser.
{% hint style="warning" %}
Pour de nombreux dépôts GitLab, la `main` branche peut être automatiquement définie comme protégée. Si c’est le cas, nous vous recommandons d’ajouter une branche spécifique entre lesquelles synchroniser votre contenu. Vous pourrez ensuite la fusionner dans `main` et conserver la protection en place.
{% endhint %}
### Effectuer une synchronisation initiale
Lors de la première synchronisation, vous aurez la possibilité de synchroniser dans l’une des deux directions suivantes :
1. GitBook -> GitLab synchronisera le contenu de votre espace **vers** la branche sélectionnée. C’est idéal si vous partez d’un dépôt vide et souhaitez importer rapidement votre contenu GitBook.
2. GitLab -> GitBook synchronisera le contenu de votre espace **depuis** la branche sélectionnée. C’est idéal si vous avez déjà du contenu Markdown dans un dépôt et souhaitez l’importer dans GitBook.
### Écrire et valider
Vous êtes prêt. Vous remarquerez que si votre espace était en [édition en direct](/docs/documentation/fr/collaboration/live-edits.md) , les modifications en direct sont désormais verrouillées. Cela permet à GitBook de synchroniser de manière fiable le contenu vers votre dépôt lorsqu’une personne de votre équipe fusionne une[ demande de changement](/docs/documentation/fr/collaboration/change-requests.md) dans GitBook.
Lorsque vous modifiez dans GitBook, chaque fusion de demande de changement donnera lieu à un commit sur la branche GitLab sélectionnée.
Lorsque vous effectuez un commit dans GitLab, chaque commit sera synchronisé avec votre espace GitBook sous forme de commit d’historique.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://gitbook.com/docs/documentation/fr/getting-started/git-sync/enabling-gitlab-sync.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.