> ## 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/ru/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/ru/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/ru/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.