Bulk migrate pipelines in Pipeline Builder

Use bulk migrations in Pipeline Builder to create and run migrations at the pipeline, project, or enrollment level. By migrating multiple pipelines in a single workflow, you can reduce repetitive manual work, simplify maintenance, and keep pipeline configurations consistent.

A bulk migration does not change pipelines directly. Instead, it creates a proposal for each eligible pipeline. Review and merge each proposal to apply the changes to the pipeline's main branch.

Pipeline Builder supports the following bulk migrations:

Required permissions

You need the following permissions for the migration scope you select:

  • Projects: Edit permission on each selected project.
  • Pipelines: Edit permission on each selected pipeline.
  • All in enrollment: Permission to run enrollment-wide migrations, which enrollment administrators have by default.

Configure a bulk migration

To configure a bulk migration in Pipeline Builder, follow the steps below:

  1. From the Pipeline Builder landing page, select the Migrate tab in the top bar.

    The Migrate tab is highlighted in Pipeline Builder above a list of pipeline migrations and their statuses.

  2. On the Migrate pipelines page, select Create migration. Migration names are visible to all users in the enrollment, but users can only view resources they have permission to access.

    The Create migration button is highlighted on the Migrate tab in Pipeline Builder.

  3. In the migration configuration menu, enter a Name for the migration or keep the default name.

    The migration configuration menu shows the migration name, migration types, and options to select projects or individual pipelines.

Next, select a migration Type and complete the steps for that type:

Migrate to faster pipelines

Before you create a migration, review the known limitations of faster pipelines. Unlike converting a single pipeline, a bulk migration creates a proposal for each compatible pipeline and skips pipelines that are not compatible.

  1. In the migration configuration menu, select Convert to Faster.

    The Convert to Faster migration type is highlighted in the migration configuration menu, with one project selected.

  2. Under Select pipelines, choose a migration scope:

    • Projects: Include all pipelines in one or more projects, including pipelines in their folders.
    • Pipelines: Select individual pipelines to include.
    • All in enrollment: Include all pipelines in your enrollment.

    For this example, select Projects and add the projects containing the pipelines you want to migrate.

    The Projects option, the plus icon for adding a project, and the selected project are highlighted in the migration configuration menu.

  3. Select Create migration at the bottom right of the menu to open the migration details. To filter pipelines by status, use the Show all pipelines dropdown menu to the right of the search bar. For definitions of each pipeline status and reasons pipelines may be skipped, see Pipeline statuses.

    The migration details view shows three pipelines with successful proposal generation, one skipped pipeline, and links to view the generated proposals.

  4. When a proposal is available, select View proposal beside the pipeline. You can review proposals while the migration continues processing other pipelines.

    The View proposal links are highlighted beside pipelines with successful proposal generation in the migration details view.

    Learn how to review and approve pipeline changes.

Replace models

  1. In the migration configuration menu, select Replace model.

    The Replace model migration type is highlighted in the migration configuration menu, with model mapping fields displayed below it.

  2. Select the current model in the left dropdown menu and its replacement in the right dropdown menu. To replace additional models in the same migration, select Add mapping.

    The model mapping fields are highlighted, showing the current model on the left and its replacement on the right.

  3. Follow steps 2–4 in Migrate to faster pipelines to select a scope, create the migration, and review its proposals.

Cancel a migration

If you need to cancel a running migration, for example because you created it with the wrong configuration, select the stop icon beside the progress indicator. Processing winds down after cancellation, and proposals already created remain available for review.

Pipeline statuses

The migration details view shows a status for each pipeline that indicates whether its proposal was created.

StatusDescription
Not startedProcessing has not started for this pipeline.
In progressProcessing is underway, and a final outcome has not been recorded.
SuccessA migration proposal was created. Review and merge the proposal to apply the changes.
FailedAn error occurred while checking the pipeline or preparing its proposal.
SkippedThe migration does not apply to this pipeline. See the conditions below for each migration type.
CanceledProcessing was canceled before a final outcome was recorded.

The conditions for skipping a pipeline depend on the migration type:

  • Convert to Faster: The pipeline is skipped if it is not a standard batch pipeline, such as a pipeline that already uses faster pipelines, or if it does not pass the faster conversion compatibility checks.
  • Replace model: The pipeline is skipped if it does not use any of the source models in the mapping, such as when those models have already been replaced.

Support for additional migration types is planned for future releases.