Skip to main content
sitectl converge detects and repairs configuration drift across all ISLE components. It compares the current state of each component’s managed files against what sitectl expects and applies any missing changes.

Reference

The ISLE converge handler accepts the same flags as the legacy sitectl component reconcile command: Inspect each component and apply any changes needed to bring the project back into alignment. By default the command is interactive and asks before applying changes. Pass --report to preview what would change without applying it.
sitectl component reconcile
Aliases: review, align
FlagDefaultDescription
-c, --componentComponent to reconcile, e.g. isle/fcrepo. Defaults to all components.
--drupal-rootfsPath to the Drupal web root, relative to --path.
--formatOutput format (default: table).
--pathPath to the project directory. Defaults to the active context project directory.
--reportfalsePreview changes without applying them.
--verbosefalseShow additional details for each component.

Workflow

# Preview what would change
sitectl converge --report

# Apply all changes
sitectl converge

# Converge a single component
sitectl converge --component fcrepo

What gets checked

Each ISLE component manages a set of files (compose overrides, Traefik configs, environment entries). Converge compares the expected content against what is present on disk and reports or repairs any differences. Components that are disabled or superceded are skipped unless explicitly targeted with --component.

See also