For migrations to GitLab SaaS, there are three options for migration from today:
Congregate - used by GitLab Professional Services - this is GitLab's most mature migration pattern and supports many . Note, Migrations to SaaS require the involvement of GitLab PS due to access/privilege to GitLab SaaS (multi-tenant) data.
Important to note about Congregate:
To request an Admin PAT with full api or equivalent scope, you'll need to request one by getting in touch with our PS team either directly or via an issue in the Congregate project. Our PS Team has also supported partners in debugging/root-cause analysis on migration failures with Congregate on a case-by-case basis (billing hours from GitLab PS may need to be purchased by the partner requiring support). https://gitlab.com/gitlab-org/professional-services-automation/tools/migration/congregate/-/issues/
GitLab Migration via Direct Transfer (Beta) - This was just recently released, and is the direction our Product team is moving towards for migrating GitLab projects from instance to instance or to SaaS. Please review the following resources:
Migrated Group Items (Direct Transfer)
Migrated Project Items (Direct Transfer)
Items that are Exported via Project Import/Export
Items that are not Exported via Project Import/Export
API-driven Group + Project Import/Export https://docs.gitlab.com/ee/api/group_import_export.html https://docs.gitlab.com/ee/api/project_import_export.html
For GitLab Server Migrations, please refer to the following handbook page for more details.
Depending on the source Git provider, size/scope of the migration, the artifacts are important to the customer to be preserved, carefully consider each option given each option's limitations/benefits.
GitLab Channel Programs provides the following resources to our partners to construct your own Services Packages in our Partner Portal, including our Migration+ Services Offering.
GitLab Professional Services team has a full service catalog of offerings avaialable for direct to customers to utilize. Partners may want to review the offerings for inspiration towards delivering same or similar Professional (consultative) Service offerings.
The GitLab Professional Services Migration Package is one popular offering.
Our GitLab Partner Portal has Channel Service Packages that many partners choose to deliver as paid offerings. The link above includes Service Names, Data Sheets, Statement of Works (SOWs), Project Plans, Delivery Kits. The table also outlines GitLabs expectations for the certicications held by our partners under the
Aligned Partner Certification column.