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 legacysitectl 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.
review, align
| Flag | Default | Description |
|---|---|---|
-c, --component | Component to reconcile, e.g. isle/fcrepo. Defaults to all components. | |
--drupal-rootfs | Path to the Drupal web root, relative to --path. | |
--format | Output format (default: table). | |
--path | Path to the project directory. Defaults to the active context project directory. | |
--report | false | Preview changes without applying them. |
--verbose | false | Show additional details for each component. |
Workflow
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 aredisabled or superceded are skipped unless explicitly targeted with --component.
See also
sitectl validate— check for drift without repairingsitectl set— change a component’s enabled/disabled state

