Миграция из GitLab в VK Dev Platform

VK Dev Platform поддерживает миграцию репозиториев (проектов) из GitLab через отправку API-запроса на импорт.

Для импорта GitLab-проекта нужно:

• Архив GitLab-проекта, экспортированный из внешней инсталляции GitLab. Подробнее — в официальной документации GitLab.
• Роль с правом доступа import для репозиториев VK Dev Platform (подробнее — в разделе Матрица прав доступа).
• Идентификатор проекта разработки, в который нужно импортировать GitLab-проект. Можете скопировать его в настройках проекта разработки в разделе Переменные CI.

Чтобы импортировать GitLab-проект в VK Dev Platform:

1. Отправьте API-запрос:

    
   POST https://<ИМЯ_ХОСТА_VK_DEV_PLATFORM>/api/v1/code-repositories/import

   В запросе:

   • Заголовок Content-Type должен принимать значение multipart/form-data.
   • Тело запроса должно содержать параметры, заполненные в соответствии с таблицей 1.
   Таблица 1 — Параметры запроса на импорт

   Параметр	Обязательный	Тип	Описание
   name		string	Имя репозитория, отображаемое в интерфейсе VK Dev Platform и GitLab
   slug		string	Путь к репозиторию относительно GitLab-группы
   devProjectId		uuid	Идентификатор проекта разработки VK Dev Platform, в который нужно импортировать GitLab-проект
   file		binary	Архив GitLab-проекта, который имеет MIME-тип application/gzip или application/x-gzip

   Подробнее о работе с API — в документе Руководство разработчика VK Dev Platform.

2. Дождитесь ответа об успешном выполнении запроса (код ответа 202). В случае возникновения ошибок, исправьте их и повторите отправку API-запроса.

3. На Портале управления разработкой выберите проект разработки, в который импортируется GitLab-проект.

4. Перейдите в раздел Репозитории.

5. Найдите в списке импортируемый репозиторий и проверьте его статус:

   • Preparing — импорт GitLab-проекта еще не завершен. Дождитесь появления статуса Ready или Failed.
   • Ready — GitLab-проект успешно импортирован в VK Dev Platform.
   • Failed — импорт GitLab-проекта завершился ошибкой.

6. Если статус импортированного репозитория — Failed:

   1. Уточните детали ошибки в логах VK Dev Platform и устраните ее причину.
   2. Удалите репозиторий.
   3. Повторите отправку API-запроса.