/migration-workshop-demo-site

Primary LanguagePHPMIT LicenseMIT

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
  • Proceed to the Initial setup for workshop section below

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:

Open in 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/gitpod-setup-ddev.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 acces 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: ./scripts/d7-data.setup.sh; ./scripts/d9-empty-install.sh

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

For local development the two sites are available at:

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

Whipe migrate_plus.* migrations from configuration

Useful if you want to whipe 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 🙏!