Импорт с GitLab

Функционал доступен в Enterprise и On-premise версиях


Импорт проекта позволит вам перенести ваш проект из GitLab в GitFlic с сохранением всех задач, запросов на слияние, коммитов, веток, тегах, релизах (только архивы исходного кода). Также будут перенесены все участники проекта и созданы аналогичные учетные записи в локальной базе данных, с почтой профиля указанной в проекте и стандартным паролем qwerty123. Также сохранятся роли участников в проекте.

Базовый импорт доступен для веб-версии приложения. Подробнее.

Подготовка

Для выполнения импорта из GitLab, необходимо подготовить проект. Перейдите в настройки проекта, в раздел Основные. На странице раскройте блок Расширенные, далее прокрутите страницу вниз до блока “Экспорт проекта”, нажмите кнопку Экспорт проекта.

Страница настроек обновится и вы получите сообщение: “Project export started. A download link will be sent by email and made available on this page.”, необходимо подождать некоторое время (зависит от размера вашего проекта и как долго будет происходить подготовка) и повторно обновить страницу. Вновь пройдите к разделу “Экспорт проекта” и нажмите Download export. Если у вас отсутствует данная кнопка, то необходимо повторно обновить страницу через некоторое время.

После загрузки архива с данными проекта, он будет готов для импорта в GitFlic.

Импорт проекта в GitFlic

После того как вы загрузили архив с проектом в формате .tar.gz, перейдите на страницу создания проектов и переключите владку на “Импорт с GitLab”.

Заполните все поля как для создания нового проекта и в поле добавления архива прикрепите требуемый.

После заполнения всех обязательных полей нажмите “Создать проект”.

Возможные проблемы и варианты их решений

Одна из существующих на данных момент проблем связана с используемой версией GitLab, начиная с версии GitLab 14+ изменилась структура архива экспортируемого проекта. GitFlic принимает именно новую структуру архива для импорта. Визуально новая структура архива отличается наличием папок с данными проекта, когда в старой структуре содержится только файл project.bundle и несколько вспомогательных файлов.

Если попытаться загрузить архив со старой структурой, то приложение GitFlic отдаст в логах ошибку java.nio.file.NoSuchFileException:. Для решения данной проблемы требуется обновить версию GitLab и повторно выполнить экспорт, чтобы сформировать архив со структурой, которую может обработать GitFlic.