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

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

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

Примечание

Сейчас поддерживаются только репозитории, которые размещены на GitHub.

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

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

Важно

Пул-реквесты, задачи, комментарии и теги переносятся только при первой синхронизации и далее не обновляются. Зеркалируются только определенные ветки исходного репозитория.

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

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

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

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

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

    • В поле URL укажите ссылку на репозиторий, размещенный в другой системе управления IT-проектами.
    • Выберите способ аутентификации в исходном репозитории:
      • Личный токен доступа — если для доступа к репозиторию используется персональный токен доступа (PAT). Для GitHub подробности см. на странице Managing your personal access tokens.
      • Имя пользователя и пароль — если для доступа к репозиторию используются имя пользователя и пароль.
    • Введите данные для аутентификации в зависимости от выбранного способа.
  5. В блоке Сведения о новом репозитории:

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

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

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

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

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

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

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

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

См. также