Skip to main content
Use converge when component files have drifted from what sitectl expects — for example after pulling new upstream changes or toggling a component with sitectl set. It reads each component’s desired state and applies any missing changes.

​
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 
sitectl converge [flags]

​
Workflow

# Preview what would change without applying it
sitectl converge --report

# Apply all changes interactively
sitectl converge

# Converge a single component
sitectl converge --component fcrepo

​
Relationship to validate

sitectl validate tells you whether something has drifted. sitectl converge fixes it. Run validate first to understand what needs to change, then converge to apply it.

​
Plugin flags

All flags are forwarded to the plugin’s converge handler. For the ISLE plugin the following flags are available:
FlagDescription
--reportPreview changes without applying them
--componentConverge a single component (e.g. fcrepo)
--verboseShow additional detail for each component
--formatOutput format for --report (table, json, yaml)
--drupal-rootfsDrupal rootfs path relative to the project directory