converge when component files have drifted from the state represented by the project, for example after pulling upstream changes or editing component-owned files by hand. sitectl set applies its change immediately and does not require a follow-up converge.
Reference
Inspect each component registered by the active context’s plugin 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.
This command dispatches to the plugin associated with the active context.
All flags and arguments are forwarded to the plugin’s converge handler.
Examples:
sitectl converge
sitectl converge --report
sitectl converge --component fcrepo
Workflow
Relationship to validate
sitectl validate tells you whether something has drifted. sitectl converge repairs drifted components while preserving components that are already in a valid enabled or disabled state. Run validate first to understand what needs to change.