Эта интеграция относится к режиму [**Создатель**](/docs/builder/overview) — конструктору, который генерирует веб-проект по вашему описанию. С GitLab она умеет ровно одно: забрать существующий репозиторий gitlab.com и создать из него **новый** проект Создателя. Обратной выгрузки нет — в отличие от [интеграции с GitHub](/docs/integrations/github), у GitLab пока нет ни синхронизации, ни привязки проекта к репозиторию, ни листинга веток и merge request'ов.

Если вам нужна выгрузка готового проекта в репозиторий, а не только импорт — такое сейчас есть только для GitHub, см. [страницу про GitHub](/docs/integrations/github).

Поддерживается только **gitlab.com**. Self-hosted инсталляции GitLab не подключаются.

## Как подключить

1. В открытом проекте Создателя откройте меню **«Ещё»** и выберите **«Из GitLab»** (в компактной раскладке — **«Импортировать из GitLab»**).
2. WorkAI откроет страницу авторизации на gitlab.com. Подтвердите доступ приложению WorkAI под своим аккаунтом.
3. После подтверждения GitLab вернёт вас обратно, откроется список ваших проектов GitLab для выбора.
4. Выберите репозиторий — WorkAI скачает его архивом и создаст из него новый проект Создателя. Текущий открытый проект (если он был) не меняется.

Приложение запрашивает доступ на чтение (`read_api`, `read_repository`) — запись и правки в GitLab оно не делает.

Подключение и импорт доступны только владельцу проекта.

## Что происходит при импорте

Импорт берёт исходники и осознанно отбрасывает остальное — те же правила, что и для импорта из GitHub:

| Что пропускается | Почему |
| --- | --- |
| `.env`, ключи, учётные данные | Секретам не место в платформе |
| `node_modules`, `dist`, `build`, `.git` и подобные каталоги | Это не исходники, а результат сборки и зависимости |
| Картинки, шрифты, архивы и другие двоичные файлы | Импорт работает с текстовыми файлами |
| Файлы больше 256 КБ | Ограничение на отдельный файл |

Действуют те же потолки, что и у GitHub-импорта: не более 800 файлов и 8 МБ исходников суммарно (превышение не отменяет импорт — лишние файлы просто не приезжают и попадают в список пропущенных), а скачиваемый архив репозитория ограничен 12 МБ в сжатом виде (превышение — уже отказ, импорт не начнётся).

После импорта картинки и шрифты придётся загрузить в проект заново. В проект добавляются служебные файлы платформы — `Dockerfile`, `nginx-default.conf`, `workai-template.json` — по ним собирается публикация; одноимённые файлы из репозитория заменяются ими.

Подробный разбор предупреждений на экране результата импорта (превью может не подняться, инструмент сборки не распознан и так далее) — в [статье про GitHub](/docs/integrations/github#что-означают-предупреждения-на-экране-результата-импорта): экран результата и правила одинаковые для обоих источников импорта.

## Чего пока нет

- Выгрузки проекта Создателя обратно в GitLab-репозиторий.
- Привязки проекта к репозиторию после импорта — повторного «синхронизировать» не будет, для новой версии нужен новый импорт.
- Листинга веток и создания merge request'ов.

## Как отключить

В настройках подключённых сервисов отзовите доступ WorkAI к своему аккаунту GitLab — новые импорты станут недоступны. Уже импортированные проекты не удаляются и не привязаны к репозиторию, отключение на них не влияет.

## Похожие темы

- [GitHub](/docs/integrations/github) — тот же импорт плюс полноценная выгрузка проекта обратно в репозиторий.
- [Создатель](/docs/builder/overview) — как устроен режим, в который импортируется репозиторий.
- [Быстрый старт](/docs/get-started/quickstart) — установка десктоп-клиента и первая правка кода.