Change record status: 
Project: 
Introduced in branch: 
9.1.x
Introduced in version: 
9.1.0-beta8
Description: 

The Drush command available to date for updating all existing pattern blocks to use the latest pattern versions does not perform well on sites with a large amount of layout-enabled content. To address this and allow for better scaling to larger databases, the drush patternkit:libUpdate or drush pklu command has been deprecated in favor of the new drush patternkit:batch-update or drush pkbu command.

The new drush pkbu command uses batch processing to discover and process all available layouts and apply pattern updates according to provided options.

The Old Way

drush patternkit:libUpdate

The New Way

drush patternkit:batch-update

Available Options

drush help patternkit:batch-update
Run Patternkit block updates using batch operations.

Examples:
 drush pkbu                                                   Update layouts for all default revisions.                                                                       
 drush pkbu --revisions=all                                   Update layouts for all available revisions.                                                                     
 drush pkbu --revisions=latest --filter=node.page             Update layouts for the latest revision of all nodes of the page bundle.                                         
 drush pkbu --pattern='@patternkit/atoms/example/src/example' Update all example pattern blocks on layouts for all default revisions.                                         
 drush pkbu --no-run-queue                                    Discover all layouts for updates, but leave them in the 'patternkit_layout_updates' queue for later processing. 

Arguments:
 [library_name] The name of a library to limit updates to. 

Options:
 --filter=FILTER         A string concatenation of entity type, bundle, and display mode for updates to be limited to. Example: 'node.article.default'. Fewer items may also be provided to filter. For example, only an entity and a    
                         bundle may be provided ('node.article') or just an entity type ('node').                                                                                                                                        
 --pattern=PATTERN       A specific pattern name to be updated. When using this option, only one pattern name may be specified per execution. Example: '@patternkit/atoms/example/src/example'.                                          
 --revisions[=REVISIONS] The selection mode for entity revisions to update. Options are: - default: The current default revision is loaded. - latest: The latest entity revision is loaded. This is usually the current default revision 
                         unless a newer unpublished revision exists. - all: Selection should include all discovered entity revisions. [default: default]                                                                                 
 --no-run-queue          Prevent execution of discovered layout updates and leave them in the queue for later processing instead. 
Impacts: 
Site builders, administrators, editors
Module developers
Themers
Site templates, recipes and distribution developers