SXL Studio
Git

Настройка GitLab

Пошаговая инструкция подключения SXL Studio к GitLab: создание токена, настройка проекта и первая синхронизация.

Пошаговая настройка GitLab

Шаг 1 — Создайте Personal Access Token

  1. Перейдите в GitLab → User Settings → Access Tokens (или /‑/profile/personal_access_tokens)
  2. Нажмите Add new token
  3. Задайте имя: SXL Studio
  4. Установите срок действия в соответствии с вашей политикой безопасности
  5. Установите scopes:
    • api — нужен для полноценного Git Sync в SXL Studio (Pull, Push, список/создание веток)
    • В read-only сценариях можно использовать read_api / read_repository, но Push и операции с ветками могут быть недоступны
  6. Нажмите Create personal access token
  7. Скопируйте токен — он показывается только один раз

SXL Studio работает через GitLab REST API, а не через Git-over-HTTPS команды. Для обычной полноценной работы используйте api.

Формат токенов и альтернативы

  • Стандартные personal access token обычно имеют префикс glpat-.
  • Если в компании используются сервисные токены, SXL Studio также может работать с project/group access token при условии, что у них есть API-доступ к нужному проекту.
Создание Personal Access Token в GitLab

Шаг 2 — Определите путь проекта

В GitLab репозиторий идентифицируется путём проекта или числовым Project ID:

  • Путь: namespace/project-name (например design-team/tokens)
  • Project ID: число со страницы Settings → General (например 12345)

Оба варианта работают в поле Repository.

Шаг 3 — Создайте подключение

  1. Откройте SXL Studio → панель Sync
  2. Нажмите New Sync
  3. Заполните форму:
ПолеЗначение
ProviderGitLab
NameMy Design System
Repositorydesign-team/tokens или 12345
Branchmain
Access TokenВставьте токен из шага 1
Data Pathdata
Tokens Pathtokens
  1. Нажмите Save

Шаг 4 — Первая синхронизация

  1. Нажмите Pull — плагин загрузит файлы
  2. Проверьте данные в плагине
  3. Попробуйте Push для проверки записи
  4. (Опционально) Проверьте сценарий с ветками:
    • Create Branch (от текущей ветки)
    • Create Branch From... (от другой ветки), затем Pull
Полная настройка подключения к GitLab

Self-hosted GitLab

Для собственного сервера GitLab:

  1. В поле Enterprise URL укажите базовый URL: https://gitlab.company.com
  2. Плагин автоматически добавит /api/v4 для REST API
  3. Токен создаётся на вашем сервере аналогично
  4. Если на сервере обязательна ротация/срок действия PAT, обновляйте токен в Sync до истечения срока

Устранение проблем

«Not Found»

  • Проверьте путь проекта или Project ID
  • Убедитесь, что у токена есть доступ к проекту

«Unauthorized» или «Forbidden»

  • Проверьте scope токена: для полноценной синхронизации нужен api
  • Для self-hosted: убедитесь, что Enterprise URL корректен

Проект в подгруппе

  • Указывайте полный путь: group/subgroup/project

Pull работает, а Push не проходит

  • Чаще всего токен только для чтения (read_api / read_repository)
  • Пересоздайте токен со scope api и обновите подключение

Связанные разделы