exp:expmigrationheal

Available since Exponential 6.0.15 (in development, not in a release yet).

Summary

Self-healing before a migration run: a stale run lock, missing migration folders, file modes, caches (what a deploy may fix on a remote)

Usage

./console exp:expmigrationheal [options]
php bin/php/expmigrationheal.php [options]
./console exp:migration:heal [options]

Aliases

exp:migration:heal

Help

The output of ./console help exp:expmigrationheal (the script run with --help), without the standard options:

Usage: bin/php/expmigrationheal.php [OPTION]...
Self-healing before a migration run
The fixes a deploy may make on a remote before it runs the migrations there ([RemoteSettings] SelfHeal[]
of the source), each only when named: stale-lock (a run lock whose process is gone and that is older than
--stale-lock-age, held on this host by this user), paths (the missing migration folders), modes (the
permissions of [FileSettings] on the migration folders and var/<site>/migration, only added), caches (ini
and template-override). What cannot be fixed safely is only reported. Without --apply it lists what it
would do.

./console exp:migration:heal --fix=stale-lock,paths,modes
./console exp:migration:heal --fix=stale-lock --stale-lock-age=3600 --apply --format=json


Options:
  --fix=VALUE...          The fixes: stale-lock, paths, modes, caches (a comma list or repeated)
  --stale-lock-age=VALUE  Seconds from which a held run lock whose process is gone counts as stale (default 7200)
  --apply                 Make the changes (the default is a dry run that lists them and changes nothing)
  --dry-run               The default, accepted for scripts that pass it: list what would change, change nothing
  --format=VALUE          text (default) or json (the machine output exp-migration/1)

Options

Standard options

Every script also takes the standard options of the script framework: --help, --quiet, --siteaccess, --debug, --colors, --no-colors, --logfiles, --no-logfiles, --verbose and --allow-root-user.

Source

bin/php/expmigrationheal.php, kernel/private/classes/commands/expmigrationheal.php

See also

Generated example: exp:expmigrationheal

Added to the reference for Exponential 6.0.15.