kontent-migration-cli

Kontent Migration CLI

This package is a migration runner for Kentico Kontent CMS. It allows the following instructions:

• Tracking migrations in the project
• Creating new content types
• Migrating content types and content changes across types
• Rolling back any changinges

Gettings started

yarn

Migration spaces

For each Kentico space you should create a different migrations folder. You can set which migrations folder you will be using with the MIGRATION_FOLDER environment variable.

Commands

Command	Action
yarn migrate init	Initiate the migrations in Kontent
yarn migrate make	Make new Kontent migrations
yarn migrate run	Run new migrations
yarn migrate rollback	Roll back existing migrations

Environment Variables

To run this project you will need a number of environment variables

Variable	Description
API_KEY	Kontent management API key
PROJECT_ID	Kontent project ID
ENVIRONMENT	Kontent environment
MIGRATION_FOLDER	The name of the migrations folder
PREVIEW_KEY	Kontent preview API key

Implementation

This project uses Kontent Migrate all the commands used are abstractions from this library.

Use Cases

Making a new migration

Convention for migration description

• Should start with a capital letter
• Should start with an imperative mood verb

Examples:

• "Create Micro Copy content-type"
• "Add title field to Page content-type"
• "Remove description from all content-types"