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

# Синхронізація з GitLab

> Прив'яжіть обліковий запис GitLab, імпортуйте чи експортуйте проєкт, синхронізуйте зміни в обидва боки та відв'яжіть.

Під'єднайте проєкт до репозиторію GitLab. Зміни передаються в обидва боки і лише тоді, коли ви натискаєте **Sync**: нічого не синхронізується саме собою.

> [!NOTE]
>
> Спочатку адміністратор має увімкнути [синхронізацію з GitLab](https://ayakaleaf-pro.mintlify.site/uk/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md).

## Прив'язка облікового запису GitLab

Це робиться один раз.

**1. Відкрийте налаштування облікового запису**

Натисніть **Account**, потім **Account settings**. У розділі **Project synchronisation** знайдіть **GitLab** і натисніть **Link**.

![Розділ GitLab у налаштуваннях облікового запису з кнопкою Link](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=cd34b300ea3566a7083df441f465a163)

GitLab у налаштуваннях облікового запису

**2. Авторизуйтеся на GitLab**

Відкриється GitLab. Увійдіть, якщо буде потрібно, потім авторизуйте застосунок.

**3. Перевірте прив'язку**

Ви повернетеся до налаштувань облікового запису. Зелене повідомлення повідомить, що ваш обліковий запис GitLab прив'язано, а на кнопці тепер написано **Unlink**.

![Розділ GitLab у налаштуваннях облікового запису з кнопкою Unlink](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f187b1d6ba770789495f03ecac75c7f7)

Ваш обліковий запис GitLab прив'язано

Якщо ваш обліковий запис ще не прив'язано, **Import from GitLab** і картка **GitLab** у редакторі спершу попросять його прив'язати. Натисніть **Link to your GitLab account**. Ви також опинитеся в налаштуваннях облікового запису, у новій вкладці, якщо почали в редакторі. Потім поверніться й почніть знову.

![Діалогове вікно Import from GitLab з кнопкою Link to your GitLab account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=50ded943f918001121d5a00ef345d008)

Підказка, якщо обліковий запис не прив'язано

## Імпорт репозиторію

Так створюється новий проєкт із репозиторію GitLab, уже прив'язаний до нього.

**1. Відкрийте діалог імпорту**

На сторінці проєктів натисніть **New project**, потім **Import from GitLab**.

![Меню New project з пунктом Import from GitLab](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-new-project-menu.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=4065d1b3b3e2fc5542272e38e2d01f61)

Меню New project

**2. Виберіть репозиторій**

Натисніть **Import to Overleaf** поруч із репозиторієм. У списку є ваші репозиторії та репозиторії ваших груп.

![Діалогове вікно Import from GitLab зі списком із чотирьох репозиторіїв](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=cb0ba36bfa954e101ec1ccd8dac0bca3)

Ваші репозиторії GitLab

**3. Перевірте проєкт**

Новий проєкт відкриється з файлами репозиторію.

![Редактор з імпортованим проєктом, його файлами та скомпільованим PDF](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=a467df37fd623dffe523b5a92ebc47c1)

Імпортований проєкт

## Експорт проєкту в новий репозиторій

Так із проєкту створюється репозиторій, і вони прив'язуються. Проєкт можна прив'язати лише цим способом або імпортом: прив'язати його до вже наявного репозиторію не можна.

**1. Відкрийте GitLab у редакторі**

Відкрийте проєкт. На лівій панелі натисніть **Integrations**, потім **GitLab**.

![Панель Integrations з карткою GitLab](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=df24d11afeb5bbec55a8a745fd58f47a)

Панель Integrations

**2. Заповніть дані репозиторію**

Виберіть **Owner**: це можете бути ви або одна з ваших груп. Якщо ви вибираєте групу, це поле називається **Organization**. **Repository Name** спочатку збігається з назвою проєкту. Опис необов'язковий, а **Private** вибрано за замовчуванням. Натисніть **Create a GitLab repository**.

![Заповнена форма Export Project to GitLab](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-export.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=ba5191a105be584e994ad663565ee511)

Export Project to GitLab

Якщо назву вже зайнято, у діалоговому вікні з'явиться **Please check that the repository name is valid, and that you have permission to create the repository.** Змініть назву й знову натисніть кнопку.

**3. Перевірте прив'язку**

У діалоговому вікні тепер написано **This project is linked to** і вказано репозиторій.

![Діалогове вікно Sync with GitLab після експорту](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=6e18dc3c00fb9a29b3bb2f1a76cec08e)

Проєкт прив'язано

## Синхронізація

**1. Відкрийте діалог синхронізації**

Відкрийте прив'язаний проєкт. На лівій панелі натисніть **Integrations**, потім **GitLab**.

**Recent commits in GitLab** перелічує те, що потрапить у проєкт.

![Діалогове вікно Sync with GitLab з одним новим комітом](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-new-commits.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e67529c0cad7a0cb7eafaa5f8d134b0a)

Новий коміт очікує в GitLab

**2. Опишіть свої зміни**

Якщо ви щось змінили в проєкті, з'явиться поле для повідомлення коміту. Воно необов'язкове: якщо залишити його порожнім, коміт називатиметься `Updates from Overleaf`.

![Діалогове вікно Sync with GitLab із заповненим повідомленням коміту](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=45677a6ea3a96235bcde72e1cdaa436a)

Повідомлення коміту для ваших змін

**3. Натисніть Sync**

Натисніть **Sync**. Нові коміти з GitLab потрапляють у проєкт, а ваші зміни надсилаються до гілки репозиторію за замовчуванням. Якщо обидві сторони змінили різні місця, зміни об'єднуються автоматично.

**4. Перевірте результат**

У діалоговому вікні з'явиться **No new commits in GitLab since last merge.**, а поле повідомлення коміту зникне. Файли в редакторі та коміти на GitLab актуальні.

![Діалогове вікно Sync with GitLab після синхронізації, без нових комітів](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=74dd7ceacb36ac0289d76504e95e7ba7)

Усе синхронізовано

### Якщо ті самі рядки змінилися з обох боків

Діалогове вікно повідомляє, що зміни не вдалося об'єднати, і називає нову гілку `overleaf-YYYY-MM-DD-HHMMSS`, у якій містяться ваші зміни. Overleaf також відкриває на GitLab merge request із цієї гілки.

![Діалогове вікно Sync with GitLab з попередженням про конфлікт злиття](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=da33555666132affd667ce24b61221c9)

Конфлікт

1. Об'єднайте цю гілку з гілкою за замовчуванням на GitLab або за допомогою Git. Тим часом діалог можна закрити: під час повторного відкриття він покаже те саме повідомлення.
2. Натисніть **I have manually merged. Continue**. Об'єднаний результат потрапить у проєкт. Якщо натиснути кнопку до злиття гілки, діалог залишиться без змін.
3. Гілка залишається на GitLab, якщо ви не видалили її під час злиття. Видаліть її, коли вона стане непотрібною.

Те саме діалогове вікно з'являється, коли правила злиття репозиторію затримують merge request, наприклад якщо потрібне схвалення, навіть якщо конфліктних рядків немає. Щойно правило дозволить, виконайте злиття merge request на GitLab і натисніть **I have manually merged. Continue**. Див. [Як працює синхронізація з GitLab](https://ayakaleaf-pro.mintlify.site/uk/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md#how-syncing-works-with-gitlab).

## Відв'язування проєкту

Зробіть це, якщо більше не хочете синхронізувати проєкт.

**1. Натисніть Unlink**

У діалозі синхронізації натисніть **Unlink**.

**2. Підтвердьте**

Натисніть **Confirm**. Це лише видаляє прив'язку: під'єднання до репозиторію, власником якого ви є, згадане в попередженні, залишається можливістю на майбутнє, а не відбувається зараз.

![Діалогове вікно Sync with GitLab із запитом підтвердити відв'язування](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8d7469fda58abd012ed1364f9f54005d)

Підтвердження відв'язування

**3. Перевірте результат**

Тепер у діалоговому вікні відображається **Export Project to GitLab**. І проєкт, і репозиторій зберігають свій вміст. Щоб знову синхронізувати, експортуйте проєкт у новий репозиторій або імпортуйте репозиторій у новий проєкт.

## Відв'язування облікового запису GitLab

В **Account settings**, у розділі **GitLab**, натисніть **Unlink**, потім ще раз **Unlink** у діалоговому вікні.

![Діалогове вікно Unlink GitLab Account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-unlink-account.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=478ab26a1f13d3a9cb08ffc15ad64bc1)

Відв'язування облікового запису

Ваші проєкти залишаються прив'язаними до своїх репозиторіїв. Синхронізувати їх не можна, доки ви знову не прив'яжете обліковий запис.

> [!NOTE]
>
> Про те, хто що може робити в спільному проєкті, див. [Хто може прив'язувати й синхронізувати](https://ayakaleaf-pro.mintlify.site/uk/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md#who-can-link-and-sync).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.