Umzug Contentful

Umzug custom storage provider that stores migration data in Contentful.

Umzug is the migration tool that powers sequelize. Umzug Contentful provides a Storage provider for umzug that allows your migration metadata to be stored in Contentful so that you can easily run stateful migrations on your Contentful data, probably using contentful-migration.

Installation

npm install -D umzug umzug-contentful

Usage

import { Umzug } from "umzug";
import { ContentfulStorage } from "umzug-contentful";

const umzug = new Umzug({
  // ... other options
  storage: new ContentfulStorage({
    spaceId: "abc123",
    environmentId: "master",
    contentfulManagementToken: "my-secret-token",
  }),
});

Refer to the umzug documentation for information on how to use umzug.

Options

The ContentfulStorage constructor takes one parameter, of type UmzugContentfulOptions.

option | type | required | default | description --- |--- |--- |--- |--- spaceId | string | true | | Contentful Space ID environmentId | string | true | | Contentful Environment ID (use master if you're not sure what this means) contentfulManagementToken | string | true | | Access token for Contentful's Management API locale | string | false |en-US | Locale to store data against, must be one you've configured migrationEntryId | string | false | umzugMigrationDataEntry | ID of the entry migration data will be stored in migrationContentTypeId | string | false | umzugMigrationData | ID of the content type migration data will be stored against

Use with contentful-migration

You'll likely want to avoid boilerplate in your individual migration scripts. You can do this by passing a runMigration function to contentful-migration via the umzug context:

import { Umzug } from "umzug";
import { ContentfulStorage } from "umzug-contentful";
import { runMigration, MigrationFunction } from "contentful-migration";
import * as fs from "fs";

async function migrate(migrationFunction: MigrationFunction): Promise<void> {
  await runMigration({
    migrationFunction,
    spaceId: "abc123",
    environmentId: "master",
    contentfulManagementToken: "my-secret-token",
  });
}

const umzug = new Umzug({
  // ... other options
  context: { migrate }, // do not pass a function as the context, because umzug will call it instead of passing it through
});

if (require.main === module) {
  void umzug.runAsCLI();
}

And then in your migration script:

export const up = async ({ context }) => {
  await context.migrate((migration) => {
    // write your migration
  });
}

License

MIT