Импорт с GitLab
Функционал доступен в Enterprise и On-premise версиях
Импорт проекта позволит вам перенести ваш проект из GitLab в GitFlic вместе со следующими элементами:
- запросы на слияние (вместе с лейблами, назначенными пользователями, рецензентами и утверждающими)
- CI/CD (стадии и задачи)
- проблемы (вместе с комментариями и лейблами)
- правила защиты веток и тегов
- релизы (вместе с архивами исходного кода)
- лейблы
- правила одобрения слияния
- правила push-операций
- вики-проект
- коммиты
- ветки
- теги
Также будут перенесены все участники проекта и созданы аналогичные учетные записи в локальной базе данных, с почтой профиля указанной в проекте и стандартным паролем qwerty123. Также сохранятся роли участников в проекте.
При импорте проекта возможно отключить перенос любых элементов, кроме элементов git - коммиты, ветки и теги.
Базовый импорт доступен для веб-версии приложения. Подробнее.
Подготовка
Для выполнения импорта из 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, начиная с версии GitLab 14+ изменилась структура архива экспортируемого проекта. GitFlic принимает именно новую структуру архива для импорта. Визуально новая структура архива отличается наличием папок с данными проекта, когда в старой структуре содержится только файл project.bundle и несколько вспомогательных файлов.
Если попытаться загрузить архив со старой структурой, то приложение GitFlic отдаст в логах ошибку java.nio.file.NoSuchFileException:. Для решения данной проблемы требуется обновить версию GitLab и повторно выполнить экспорт, чтобы сформировать архив со структурой, которую может обработать GitFlic.