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"