Миграция из GitLab в Managed Service for GitLab

Существуют следующие способы перенести проекты в Managed Service for GitLab:

• Самостоятельная миграция — вы экспортируете по отдельности каждый проект из исходного GitLab и импортируете их в Managed Service for GitLab без участия технической поддержки. При этом переносятся основные сущности: репозитории, задачи (issues) с комментариями, мерж-реквесты, метки, вехи, wiki, CI/CD-пайплайны в архивном виде. Переменные CI/CD, вебхуки, триггеры пайплайнов, артефакты и логи заданий не переносятся.
• Миграция с помощью технической поддержки — поддержка восстанавливает инстанс Managed Service for GitLab из резервной копии вашей пользовательской инсталляции. Переносятся все данные и настройки, в том числе проекты, пользователи, группы, права доступа, пайплайны.

Самостоятельная миграцияСамостоятельная миграция

Этот способ подходит для переноса проектов из любого GitLab, в том числе из GitLab.com, выделенного инстанса GitLab.com и инсталляций, управляемых пользователем (self-managed).

1. Экспортируйте проект из исходного инстанса GitLab:
   1. Откройте проект в исходном GitLab.
   2. В левом меню выберите Settings → General.
   3. Раскройте раздел Advanced.
   4. Нажмите Export project.
   5. Дождитесь письма со ссылкой на архив экспорта или обновите страницу настроек и в разделе Export project нажмите Download export.
2. Создайте инстанс Managed Service for GitLab.
3. По умолчанию в инстансе Managed Service for GitLab импорт из внешних источников ограничен. Чтобы включить его:
   1. Откройте административную панель GitLab.
   2. Перейдите в Admin Area → Settings → General.
   3. Раскройте раздел Import and export settings.
   4. В разделе Allowed import sources убедитесь, что включен источник GitLab export. Если источник отсутствует, добавьте его вручную.
   5. Нажмите Save changes.
4. Импортируйте проект в инстанс Managed Service for GitLab:
   1. В правом верхнем углу нажмите Create new... и выберите New project/repository.
   2. Выберите Import project.
   3. В разделе Import project from выберите GitLab export.
   4. Введите название проекта и URL, затем выберите файл экспорта, полученный на предыдущем шаге.
   5. Нажмите Import project.
5. Последовательно перенесите каждый проект GitLab.

Подробности читайте в документации GitLab:

• Import and export settings
• Migrate GitLab data by using file exports

Миграция с помощью технической поддержкиМиграция с помощью технической поддержки

Перед началом работы ознакомьтесь с порядком предоставления услуги по миграции из пользовательской инсталляции GitLab в сервис Managed Service for GitLab.

Чтобы перенести данные в инстанс Managed Service for GitLab:

1. Создайте инстанс Managed Service for GitLab.

2. Добавьте в инстанс Managed Service for GitLab те же настройки, что есть в пользовательской инсталляции. Например, OmniAuth или ограничения прав доступа для групп, если вы их использовали. Такие сущности, как пользователи, группы, пайплайны, будут перенесены позднее во время работы с резервной копией пользовательской инсталляции.

3. Узнайте версию GitLab в пользовательской инсталляции. Для корректной миграции версия пользовательской инсталляции должна совпадать с версией Managed Service for GitLab.

   1. Откройте пользовательскую инсталляцию GitLab.

   2. В меню слева нажмите Help.

      Во всплывающем окне отобразится версия GitLab.

4. Протестируйте миграцию:

   1. Создайте резервную копию пользовательской инсталляции и конфигурационных файлов.

   2. Передайте технической поддержке полученную резервную копию и версию GitLab в пользовательской инсталляции. Техническая поддержка восстановит инстанс из резервной копии в Managed Service for GitLab.

   3. После того как поддержка сообщит, что инстанс восстановлен, откройте его и убедитесь, что в Managed Service for GitLab:

      • присутствуют все нужные настройки, данные и проекты;
      • вы можете отправлять коммиты и обновлять ветки.

5. Выполните промышленную миграцию:

   1. Сообщите технической поддержке дату, когда вы планируете провести миграцию.
   2. Накануне дня миграции переведите пользовательскую инсталляцию GitLab в режим Read only.
   3. Создайте резервную копию пользовательской инсталляции и конфигурационных файлов.
   4. Передайте эту копию технической поддержке.
   5. В назначенный день миграции техническая поддержка восстанавливает инстанс из резервной копии в Managed Service for GitLab.

6. (Опционально) Настройте доменное имя инстанса:

   1. Если для пользовательской инсталляции вы использовали кастомизированное доменное имя и хотите его сохранить, сообщите это доменное имя технической поддержке. Она настроит его для инстанса Managed Service for GitLab.
   2. В пользовательской инсталляции настройте DNS-запись CNAME, чтобы перенаправлять пользователей с домена инстанса Managed Service for GitLab на ваш кастомизированный домен.

См. такжеСм. также

• Порядок предоставления услуги по миграции из GitLab в Managed Service for GitLab
• Взаимосвязь ресурсов в Managed Service for GitLab
• Создание и активация инстанса Yandex Managed Service for GitLab
• Получение информации об инстансах Yandex Managed Service for GitLab

Документация GitLabДокументация GitLab

• Import and export settings
• Migrate GitLab data by using file exports
• Groups
• OmniAuth
• Group access and permissions
• Back up GitLab
• Place GitLab into a read-only state
• GitLab Dedicated network access and security
• DNS settings