divekit plugin migrate

Migrate origin plugin state and layout from contract v1 to v2

Synopsis

Convert flat v1 plugin state and its materialized layout to plugin suites.

The command prints the full plan and changes nothing until ‘–apply’ is passed. An applied migration copies every file it overwrites into ‘.divekit/backup/plugin-migrate-<timestamp>/’, which ‘–rollback’ restores.

Before writing, apply verifies the published suite, resolves enabled plugins to release tags and image digests, and composes the resulting pipeline. If the suite is incomplete, the origin stays unchanged on contract v1.

Usage

divekit plugin migrate [flags]

Examples

# Show what a migration would change
divekit plugin migrate

# Execute the plan
divekit plugin migrate --apply

# Restore the origin from the most recent migration backup
divekit plugin migrate --rollback

Flags

--apply      Execute the printed migration plan instead of only showing it
      --rollback   Restore the origin from the most recent migration backup

Inherited Flags

-d, --distribution string   Target distribution override (default: project-level eval overrides and .divekit state)
  -l, --loglevel string       log level (debug, info, warn, error, fatal) (default "info")
      --no-index              skip project index update
      --non-interactive       run in non-interactive mode (fails if interactive input is required)
  -y, --yes                   assume yes/default for all prompts (non-interactive with automatic defaults)

Parent Command