Skip to main content

Documentation Index

Fetch the complete documentation index at: https://sitectl.libops.io/llms.txt

Use this file to discover all available pages before exploring further.

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

Reference

The Islandora 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 Islandora 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