SXL Studio
Git

Настройка GitHub

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

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

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

  1. Перейдите в GitHub Settings → Developer Settings → Personal Access Tokens
  2. Выберите Fine-grained tokens (рекомендуется) или Tokens (classic) (legacy-вариант)

SXL Studio работает через GitHub REST API (ветки, git refs, trees, commits, contents), поэтому токен должен разрешать чтение и запись содержимого репозитория.

Fine-grained token (рекомендуется)

  1. Нажмите Generate new token
  2. Задайте имя: SXL Studio
  3. Укажите Resource owner (ваш пользователь или организация)
  4. В Repository access выберите:
    • Рекомендуется: Only select repositories и отметьте нужный репозиторий
    • Либо All repositories, если это требуется вашим процессом
  5. В Repository permissions установите:
    • Contents: Read and write
    • Metadata: Read-only
  6. Опционально: если в scope синка попадают .github/workflows, добавьте Workflows: Read and write
  7. Нажмите Generate token
  8. Скопируйте токен — он показывается только один раз
  9. Если в организации включён approval, дождитесь, пока статус токена перестанет быть pending

Classic token (legacy)

  1. Нажмите Generate new token (classic)
  2. Задайте имя: SXL Studio
  3. Выберите scope: repo (полный доступ к репозиторию)
  4. Нажмите Generate token
  5. Скопируйте токен

GitHub рекомендует fine-grained токены. В некоторых организациях classic-токены полностью запрещены политикой.

Создание Personal Access Token в GitHub

Шаг 2 — Подготовьте репозиторий

Убедитесь, что в репозитории есть папки для данных и токенов (или они будут созданы при первом Push):

your-repo/
├── data/           ← Data Path
│   ├── users.json
│   └── products.csv
├── tokens/         ← Tokens Path
│   ├── colors.json
│   ├── spacing.json
│   └── config.json
└── README.md

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

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

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

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

GitHub Enterprise Server

Для self-hosted GitHub Enterprise:

  1. В поле Enterprise URL укажите базовый URL вашего сервера: https://github.company.com
  2. Плагин автоматически добавит /api/v3 для REST API
  3. Токен создаётся на вашем Enterprise-сервере аналогично
  4. Если в enterprise используется SAML SSO, авторизуйте токен для вашей организации до Pull/Push

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

«Not Found» при Pull/Push

  • Проверьте правильность owner/repo (регистр важен)
  • Убедитесь, что токен имеет доступ к этому репозиторию

«Unauthorized»

  • Токен истёк или не имеет нужных permissions
  • Для fine-grained: проверьте Contents: Read and write
  • Для classic-токена в SSO-организации: выполните SSO-авторизацию токена

«Conflict» при Push

  • Кто-то уже обновил файл на remote
  • Сделайте Pull → затем Push

Токен валиден, но ветка не создаётся

  • Проверьте права fine-grained токена для нужного репозитория
  • Убедитесь, что вам разрешено создавать ветки (правила branch protection могут блокировать)

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