Импортировать или зеркалировать репозиторий в SourceCraft

Вы можете импортировать или зеркалировать в SourceCraft репозиторий с исходным кодом, размещенный в другой системе управления IT-проектами для git.

Зеркалирование позволяет автоматически синхронизировать содержимое определенных веток исходного репозитория и репозитория в SourceCraft.

В составе репозитория с GitHub импортируются следующие компоненты:

• История коммитов.
• Все существующие ветки.
• Открытые и закрытые предложения изменений (pull requests).
• Задачи (issues).
• Комментарии.
• Теги.

Чтобы импортировать или зеркалировать репозиторий в SourceCraft:

1. Откройте главную страницу SourceCraft.

2. На панели слева нажмите Создать репозиторий.

3. В открывшемся окне перейдите на вкладку Перенести существующие.

4. В блоке Сведения об исходном репозитории:

   • В поле URL укажите ссылку на репозиторий, размещенный в другой системе управления IT-проектами.
   • Выберите способ аутентификации в исходном репозитории:

     • Личный токен доступа — если для доступа к репозиторию используется персональный токен доступа (PAT).

       Требования к токену для GitHub

       • Для переноса сущностей, помимо кода, токен должен быть выдан администратором репозитория.
       • При создании токена вида Personal access tokens (classic) в блоке Select scope выберите repo.
       • При создании токена вида Fine-grained token:
         • В блоке Repository access выберите All repositories или Only select repositories.
         • В блоке Permissions добавьте Contents (Access: read-only), Issues (Access: read-only) и Pull requests (Access: read-only).

     • Имя пользователя и пароль — если для доступа к репозиторию используются имя пользователя и пароль.

   • Введите данные для аутентификации в зависимости от выбранного способа.

5. В блоке Сведения о новом репозитории:

   • В поле Название укажите название репозитория, создаваемого в SourceCraft. Название репозитория может содержать следующие ASCII-символы: строчные и заглавные буквы латинского алфавита, цифры, запятые, дефисы и подчеркивания.
   • В поле Видимость выберите тип доступа к репозиторию:
     • Приватный — доступ к репозиторию будут иметь только пользователи, приглашенные вами.
     • Публичный — доступ к репозиторию будет иметь все пользователи.

6. (опционально) Если вы хотите зеркалировать репозиторий, в блоке Синхронизация включите синхронизацию и укажите ветки, которые вы хотите автоматически обновлять из исходного репозитория. Вы можете использовать шаблоны, например: main, feature/*, release/*.

   На зеркалируемые ветки в репозитории SourceCraft накладываются защитные правила политики веток. Их нельзя изменить в SourceCraft, они обновляются только при синхронизации с исходным репозиторием.

   Если политика веток будет отключена, или пользователь с ролью Администратор репозитория обойдет ее, то при очередной синхронизации репозиториев история коммитов в SourceCraft будет переписана (force push).

7. SourceCraft автоматически проверит доступность исходного репозитория и возможность создать в SourceCraft репозиторий с указанным вами именем.

   Если все проверки пройдены успешно, появится сообщение Всё готово к перемещению. Пристегните ремни безопасности и давайте взлетать!

   Нажмите кнопку Начать миграцию.

Откроется окно со списком ваших репозиториев в SourceCraft. Напротив репозитория, который вы импортируете, будет отображаться статус миграции. Чтобы посмотреть подробности, нажмите на статус.

После завершения миграции вы сможете работать с перенесенным репозиторием в SourceCraft.

См. также

• Как начать работать с SourceCraft