Drupal 8 - Writing dynamic migrations

Transcript

1. 1 axelerant.com How to write dynamic migrations Mohit Aghera, Nikunj Kotecha
2. 2 axelerant.com About Us Mohit Aghera - Does development nowadays in Drupal 8 and at times Behat - Known on drupal.org as mohit_aghera - Known on twitter.com as @mohit_rocks Nikunj Kotecha - Does development nowadays in Drupal 8 and at times in Magento 2 - Known on drupal.org as nikunjkotecha - Known on twitter.com as @nikunjhk
3. 3 axelerant.com Migrations: A brief introduction What Migrate API Provides: • Migrate Data from source to destination • Keeps track of record of migrated data • Provides framework for writing migrations
4. 4 axelerant.com Possible approaches for migration • Migration templates • Config Entities
5. 5 axelerant.com Migration as Configuration entities • Similar to any configurations • Resides in [module]/config directory • Typically names are given like “migrate.migration.node_page.yml”
6. 6 axelerant.com Migration as Configuration entities Advantages: • Easy to write and run • No need to write specific logic to run unlike migration templates Disadvantages: • Not much flexible • Hard to change runtime • Dynamic migration generation is not possible • Can’t generate based on user inputs
7. 7 axelerant.com Migration as templates • Resides in [module]/migration_templates directory • Names could match the migration id • Typically names are given like “node_page.yml”
8. 8 axelerant.com Migration as templates Advantages: • Much more flexible than configuration entities for each variation • Easy to change runtime • Ability to generate dynamic migration using reusable templates
9. 9 axelerant.com Dynamic Migrations • Drupal 8 core uses templates to generate migration • When we use Drupal 7 to Drupal 8 migration upgrader it will generate migrations dynamically and import content
10. 10 axelerant.com Deriver plugins • Works as a derivative for new migrations • Helps to create migrations dynamically • Extends DeriverBase class.
11. 11 axelerant.com Writing Derivers • Implement getDerivativeDefinitions() and write your logic.
12. 12 axelerant.com Using Derivers Specify in migration template file.
13. 13 axelerant.com Running migration
14. 14 axelerant.com Use cases • Migrating large amount of sites with similar architecture but different languages in each site (our use case, https://github.com/mohit-rocks/drupalcamp-goa) • Core: Migrating D7 to D8 • Core: Migrating Workbench Moderation to Content Moderation (https://www.drupal.org/project/wbm2cm) • Migrating sites from Magento for instance with different attributes for each site • And many more...
15. 15 axelerant.com Thank you … for being here and allowing us to contribute and share our knowledge To summarise… • We discussed how to make migrations more dynamic and less painful • We saw an example of how to write derivers • We saw advantages of doing it, it is done in Core and many contrib modules already
16. 16 axelerant.com References Migration API : https://www.drupal.org/docs/8/api/migrate-api/migrate-api-overview Reference module : https://github.com/mohit-rocks/drupalcamp-goa