Drupalize.Me Migrations Workshop Environment

This repository contains scaffolding for a demo environment to use during the Drupalize.Me Drupal-to-Drupal migration workshop. And some dummy data (database and files) that replicate a production Drupal 7 site to serve as the migration source data.

It contains configuration to run Drupal locally in DDEV or in the cloud on Gitpod.

DDEV - localhost setup

Assuming you have Docker installed, and DDEV-Local installed.

• Clone this repo
• Run ddev start in the root directory of the project
• Run the following two scripts, ./scripts/d7-data-setup.sh; ./scripts/d9-empty-install.sh
• Proceed to the Initial setup for workshop section below for more info and debugging

Once set up locally you can use whatever IDE or editor you want.

GitPod - Cloud setup

Click the button below to start a new development environment on GitPod:

After the workspace is set up you can use VS Code in the cloud to edit your project and execute terminal commands.

Once the workspace has started you'll need to run the setup script to launch DDEV.

Run ./.gitpod/ddev-in-gitpod-setup.sh from the VS Code terminal in the GitPod workspace.

Tip: Sometimes when restarting the project you may need to run the above script again. For example if the host IP address changes. If DDEV starts, but you can't access your Drupal site in the preview browser try running the script again.

Initial setup for workshop

Once DDEV is up and running on GitPod there are a few additional things you'll need to do to prepare for the workshop:

Copy, paste, and execute the following command in the GitPod workspace terminal: ./scripts/d7-data.setup.sh; ./scripts/d9-empty-install.sh

This will run two scripts that install Drupal 9, and Drupal 7 with some dummy data.

Or do it manually:

• Install Drupal and dependencies ddev composer install
• Import the D7 source site database into ddev with ddev import-db --src=d7data/d7site.sql.gz --target-db=d7
• Unzip the D7 source site codebase with ddev exec tar xzf d7data/d7web.tar.gz --directory=/var/www/html
• Unzip the D7 source site files archive ddev exec tar xvzf d7data/d7files.tar.gz --directory=d7data/
• Install Drupal

The username/password for the Drupal 9 site should appear in the terminal output. Or you can use drush to obtain a one time login link:

ddev drush uli

The username/password for the Drupal 7 site is admin/admin.

For local development the two sites are available at:

• Drupal 9 - https://migrate-workshop.ddev.site/
• Drupal 7 source site - https://migrate-workshop-d7.ddev.site/

Actual URLs will vary on GitPod.

• Drupal 9 - Look for the GitPod URL that starts with 8080-

  You can access the Drupal 9 site by running the command preview in the workspace terminal.

• Drupal 7 - Drupal 7 will be in a subdirectory of the D9 site. Look for the GitPod URL that starts with 8080-, and then add /_d7web/ to the end of the URL.

  You can access the Drupal 7 site by running the command preview7 in the workspace terminal.

Helper Scripts

Drupal 7 source data setup

./scripts/d7-data-setup.sh

(re)Install Drupal core and contributed modules

./scripts/d9-empty-install.sh

Wipe migrate_plus.* migrations from configuration

Useful if you want to wipe the results of drush migrate:upgrade --configure-only and try again.

./scripts/reset.sh

Special thanks

Thanks to Ofer Shaal for his work on DrupalPod which inspired this setup - Thank you 🙏!