Running migration from GitLab to Managed Service for GitLab

During migration from a GitLab custom installation to Managed Service for GitLab, you can migrate such entities as projects, users, user groups, configured access rights, and pipelines. You can also reconfigure your custom domain name to a new GitLab instance. As a result, all the data and settings you need will be migrated to the cloud.

Migration is only available for a custom installation where GitLab is installed on a server or local computer (self-managed GitLab). You cannot migrate data from GitLab.com.

How to run migrationHow to run migration

The migration process consists of two stages: test and production. At the test stage, the system verifies whether the data are correctly transferred to the cloud. Then, the production migration date is set during which the data is again migrated to the cloud.

At each migration stage, it is assumed that data is migrated using a backup of your GitLab custom installation. You provide this backup to the Yandex Cloud technical support, and they use it to deploy a Managed Service for GitLab instance.

For more information on how to run migration, read this guide.

The GitLab version in the custom installation must match the GitLab version in the Managed Service for GitLab instance. To learn which cloud version to use, consult our technical support during migration, as GitLab regularly releases new versions.

Migration service packagesMigration service packages

There are two packages available for migration in Managed Service for GitLab:

• Basic package: During the migration you configure your Managed Service for GitLab instance yourself; if issues occur, you can submit a separate support request. Generally, the one request per issue rule applies.

  To use the basic package, you must meet at least one of these conditions:

  • Your GitLab instance type determining the number of cores (vCPU) and amount of memory (RAM) is s2.small or higher.
  • Your Yandex Cloud service plan is either Business or Premium.

• Extended package: You tell our technical support which instance settings you need and how you prefer to run your migration. Next, they help you to perform the migration and give you instance setup advice within a single request. The support also helps you to set the approval rules and resolve the related issues. As a result, you can move your data to the cloud and customize your instance faster compared to the basic package.

  To use the extended package, you must meet one of these conditions:

  • Your service plan is Premium.
  • Your service plan is Business and your instance type is s2.small or higher.