Custom Content Migrations to Drupal 8 Getting your stuff into - - PowerPoint PPT Presentation

custom content migrations to drupal 8
SMART_READER_LITE
LIVE PREVIEW

Custom Content Migrations to Drupal 8 Getting your stuff into - - PowerPoint PPT Presentation

Custom Content Migrations to Drupal 8 Getting your stuff into Drupal 8 Michael Anello DrupalEasy/Anello Consulting, Inc. drupaleasy.com ultimike on drupal.org (drupal.org/u/ultimike) @ultimike Drupal 8 core contributor -


slide-1
SLIDE 1

Custom Content Migrations to Drupal 8

Getting your stuff into Drupal 8

slide-2
SLIDE 2

Michael Anello

  • DrupalEasy/Anello Consulting, Inc.
  • drupaleasy.com
  • ultimike on drupal.org (drupal.org/u/ultimike)
  • @ultimike
  • Drupal 8 core contributor - migration system
  • Lead instructor - Drupal Career Online
slide-3
SLIDE 3

Migration Basics 101

slide-4
SLIDE 4

Migration Basics 101

Source Getting Mapping Processing Setting Destination

slide-5
SLIDE 5

Migration Basics 101

Source Getting Mapping Processing Setting Destination Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting

slide-6
SLIDE 6

Migration Basics 101

Source

Getting Mapping Processing Setting

Destination

Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting

slide-7
SLIDE 7

Migration Basics 101

Source

Getting Mapping Processing Setting

Destination

Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting

60+ migrations! For simple core D6 to D8 upgrade.

slide-8
SLIDE 8

Migration Basics 101

Source Getting Mapping Processing Setting Destination

slide-9
SLIDE 9

Migration, Drupal Style

slide-10
SLIDE 10

Content + Configuration

slide-11
SLIDE 11

Migration, Drupal Style

  • House of Pain
  • The Whole Enchilada
  • Migration by Subtraction
  • Migration Satisfaction
slide-12
SLIDE 12

Migration, Drupal Style - House of Pain

  • Manually migrate content (copy/paste)
  • Pros

○ Allows for real-time content auditing

  • Cons

○ Uhhh - it's manual.

slide-13
SLIDE 13

Migration, Drupal Style - The Whole Enchilada

  • Drupal 8 core upgrade path
  • Pros

○ Easiest

  • Cons

○ Doesn't allow for refactoring, only modules with migration classes supported.

slide-14
SLIDE 14

Migration, Drupal Style - Migration by Subtraction

  • Modified Drupal 8 core upgrade
  • Pros

○ Relatively easy, allows for limited customization

  • Cons

○ Dependencies, normally doesn't allow full refactoring

slide-15
SLIDE 15

Migration, Drupal Style - Migration Satisfaction

  • Custom migration
  • Pros

○ Get what you need, modified as you need it, allows for full refactoring

  • Cons

○ Requires learning things you should probably know anyway.

slide-16
SLIDE 16

Migration, Drupal Style

  • House of Pain
  • The Whole Enchilada
  • Migration by Subtraction
  • Migration Satisfaction
slide-17
SLIDE 17

Migration, Drupal Style - Details and Demos

slide-18
SLIDE 18

Details and Demos - House of Pain

  • Create content inventory
  • Train authors/writers/editors
  • Back away slowly
slide-19
SLIDE 19

Details and Demos - The Whole Enchilada

  • Start with an empty Drupal 8.1+ site.
  • Enable Migrate, Migrate Drupal, Migrate Drupal

UI (core) modules.

  • Go to /upgrade, enter source site information
  • Click buttons
slide-20
SLIDE 20
slide-21
SLIDE 21

Migration Basics 101

Source

Getting Mapping Processing Setting

Destination

Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting

slide-22
SLIDE 22

Details and Demos - Addition by Subtraction

  • Start with an empty Drupal 8.1+ site.
  • Enable Migrate, Migrate Drupal (core), Migrate Upgrade,

and Migrate Plus (contrib) modules.

  • Run drush migrate-upgrade --configure-only

to create configurations

  • Export/package configurations in custom module.
  • Remove/modify configurations.
  • Run migration.
slide-23
SLIDE 23

Migration Basics 101

Source Destination

Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting Getting Mapping Processing Setting

slide-24
SLIDE 24

Details and Demos - Migration Satisfaction

  • Start with an empty Drupal 8.1+ site.
  • Enable Migrate, Migrate Drupal (core), Migrate Tools, and

Migrate Plus (contrib) modules.

  • Build Drupal 8 site.
  • Figure out how Drupal 6/7 content maps to new site.
  • Build custom migrations.
  • Run custom migrations.
slide-25
SLIDE 25

Migration Basics 101

Source

Getting Mapping Processing Setting

Destination

Getting Mapping Processing Setting Getting Mapping Processing Setting

slide-26
SLIDE 26

Migration Satisfaction - Live Demo!

slide-27
SLIDE 27

Live Demo - Overview

  • Move only content (no config) from a real Drupal 6 site into

Drupal 8, with some tweaks. ○ Change content type ("audio" to "podcast") ○ Change field names ("field_embed" to "field_audio_urls") ○ Keep existing text format (Markdown)

  • "Build" Drupal 8 site and configure.
  • Create custom migration.
  • Run custom migration.
slide-28
SLIDE 28

Live Demo Setup Notes

  • Fresh Drupal 8.2.x site
  • Standard installation profile
  • Contrib modules: Admin Toolbar, Markdown, Libraries,

Migrate Tools, Migrate Plus

  • Configure new text format
  • Create new content type
slide-29
SLIDE 29

Migration Basics 101

Source Getting Mapping Processing Setting Destination

slide-30
SLIDE 30

Custom module code available at: https://github.com/ultimike/drupal8migrate

slide-31
SLIDE 31

Blog post with full details for this demo: https://www.drupaleasy.com/d8migrate