Migrate Pack

The goal of this project is to simply and streamline the Drupal 7 to 8 migration process. Migrate Pack provides Composer dependencies, patches along with configuration and plugins to assist with migration. The overall approach is to provide default settings that drive which migrations, fields, bundles and other configuration are skipped in an effort to minimize errors that otherwise halt migration. All settings can be overridden by overriding the migrate_pack.settings.yml file in your project configuration folder.

Configuration

By default all migration config provided with this module will assume the "migrate_drupal_7" migration group. Be sure to run the `drush migrate:upgrade` command prior to viewing the Migration config or you will see an error.

Dependencies

In an effort to make migration easier, Migrate Pack ships with several common contributed modules as dependencies. Any module not desired can be uninstalled in your project configuration.

• Migrate Tools
• Migrate Upgrade
• Metatag
• Paragraphs
• Pathauto
• Redirect
• Webform
• Webform Migrate

Usage

• Run Composer require to pull down the migration feature:
  $ composer require drupal/migrate_pack
• Enable the migration feature and it's dependencies:
  $ drush en -y migrate_pack
• Run migrate commands:
  $ drush migrate:upgrade(use --help for parameters)
  $ drush migrate:import --all to run all migrations
• Export your configuration to your sync directory:
  $ drush config-export -y
• Modify configuration as needed. It's recommended to remove or skip configuration migrate yml once you have it captured in the project sync directory. At that point, you will likely only want to run Content migrations.

Migrations included

• Aliases
• Comments
• Content types
• Field collections to Paragraphs (with patch)
• Fields (D8 Core)
• Files
• Nodes
• Menus
• Menu Items
• Per-entity meta tags from Metatag
• Pathauto configuration
• Redirects
• Taxonomy terms
• Users
• Vocabularies
• Webforms (7.x-4.x only)

Migrations currently not included

• Theme settings
• System settings
• User roles and permissions

Roadmap

• Admin UI to configure migration skip settings.
• Support for Drupal 9

Distributions tested

The following Drupal 7 distributions have been tested with migrate_pack and can execute a full migration without interruption. Rows that generate warnings (typically fields or entities that get skipped) will appear in the migration interface under "messages."

• OpenPublic
• Apigee (Pantheon upstream)
• OpenChurch