Problem/Motivation

#2302307: Support shared configuration between migrate groups is introducing full-featured migration groups to the migrate module - entities that hold shared configuration among related migrations and provide a canonical grouping of migrations for use by contrib migration tools. There is currently a "migration_groups" key in the migrate schema which serves a slightly different purpose - the migrate module itself implements no semantics around this, and migrate_drupal currently uses it like a tag to indicate which Drupal version(s) a given migration is applicable to. The name of this key is confusing already, and will be all the more so when proper groups are committed.

Proposed resolution

Rename the key to something that does not contain the word "group".

Remaining tasks

  1. Decide what the semantics of what is now called "migration_groups" should really be. General-purpose tagging like views tags? Or perhaps a migrate_drupal-specific field, probably on the source plugin, indicating the source Drupal version?
  2. Based on how it will be used, name it. "tags" or "migration_tags"? "drupal_version"? ...?
  3. Alter the schema and the migrate_drupal configuration to reflect the new name (and potentially a move to migrate_drupal's source plugins).

User interface changes

N/A

API changes

Is a configuration schema change considered an API change?

CommentFileSizeAuthor
#1 rename_migration_groups-2466797-1.patch50.42 KBmikeryan

Comments

mikeryan’s picture

Status: Active » Needs review
StatusFileSize
new50.42 KB

Renaming migration_groups to migration_tags.

Status: Needs review » Needs work

The last submitted patch, 1: rename_migration_groups-2466797-1.patch, failed testing.

Status: Needs work » Needs review
mikeryan’s picture

Bump... Any feedback on the key name? I'm not wedded to migration_tags, if someone else prefers just 'tags' or has another thought... Or, should we take this out of migrate and give migrate_drupal a specific 'drupal_version' setting?

Should we try to commit this before (or at the same time as) #2429085: Track current state of migrations, to avoid an interim where there are both 'migration_group' and 'migration_groups' keys?

benjy’s picture

Status: Needs review » Reviewed & tested by the community

I like migration tags, maybe lets do this first to avoid any naming confusion.

alexpott’s picture

Status: Reviewed & tested by the community » Needs review

The problem I have with this is that as this code shows we're not using them for anything. Given that why even have them?

benjy’s picture

They're used by the UI for running all D6/D7 migrations, I think the Drush runner will also need these tags. The may also be handy for custom migrations as a way to associate migrations together, although Groups might be solving most of that use case.

mikeryan’s picture

Right, the way drush or the UI will use this is to determine the Drupal version, then load and run the migrations with e.g. migration_tags='Drupal 6'. This is implemented now using the migration_groups key in the migrate_upgrade module (to be added to core).

benjy’s picture

Status: Needs review » Reviewed & tested by the community
alexpott’s picture

I'm still not convinced by the usage of tags to contain the information about what the source of the migration applies to. Because using the word tags and thinking about a migrate UI to me it implies that you could remove this tag but that is not the case.

mikeryan’s picture

You could remove the tag, though - a quick-and-easy way to omit particular migrations from your D6 upgrade would be to remove the Drupal 6 tag.

xjm’s picture

Assigned: Unassigned » alexpott

Assigning to @alexpott for his followup per his request.

Status: Reviewed & tested by the community » Needs work

The last submitted patch, 1: rename_migration_groups-2466797-1.patch, failed testing.

Status: Needs work » Needs review

Status: Needs review » Needs work

The last submitted patch, 1: rename_migration_groups-2466797-1.patch, failed testing.

mikeryan’s picture

Status: Needs work » Needs review

Testbot seems flaky, at least #2357997: Add test coverage for tablesort header link titles seems to have the same problem. Let's try again...

mikeryan’s picture

Status: Needs review » Reviewed & tested by the community

testbot seems to be over its little meltdown, restoring status.

xjm’s picture

Just a note, when retesting patches, it's a good idea to document what the specific test failures were on the issue. This information is lost when retest is clicked, and that means we lose some indication of whether a patch might be introducing random fails or whether there is a bug in HEAD.

alexpott’s picture

Status: Reviewed & tested by the community » Fixed

Migrate is not frozen in beta. Committed 9e11c08 and pushed to 8.0.x. Thanks!

We agreed in a recent meeting that migration's should also have an additional key in the source data about about the source is. This is because tags will be editable in a UI but the fact that the source plugin works for Drupal 6, or Wordpress 3, or whatever is not.

  • alexpott committed 9e11c08 on 8.0.x
    Issue #2466797 by mikeryan, benjy: Rename migration_groups key to avoid...

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.