Running migration from GitLab to Managed Service for GitLab

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

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

How migration worksHow migration works

Migration consists of two stages: test and production. At the test stage, the system verifies whether the data are correctly transferred to the cloud. Once the test stage is complete, the production migration is scheduled to finalize the data transfer to the cloud.

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

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

The GitLab version in your custom installation must match the GitLab version in the Managed Service for GitLab instance. To select the correct version, contact our support immediately before migration, as GitLab regularly releases new versions.

Migration service packagesMigration service packages

There are two packages available for migrating to Managed Service for GitLab:

• Basic package: During the migration, you configure your Managed Service for GitLab instance yourself. If issues arise, you can open separate support tickets. Generally, the one ticket per issue rule applies.

  To use the basic package, at least one of the following conditions must be met:

  • Your GitLab instance type which determines the number of vCPUs and RAM amount is s2.small or higher.
  • Your Yandex Cloud service plan is either Business or Premium.

• Extended package: You provide support with info on the instance configuration you need and how you prefer to run your migration. The support team help you perform the migration and give you instance setup advice within a single support ticket. The support can also help configure approval rules and resolve related issues. This allows you to migrate your data to the cloud and set up the instance more quickly compared with the basic package.

  To use the extended package, at least one of the following conditions must be met:

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