Skip to content

BBM: How-it-works section update

Leonardo da Rosa requested to merge 388789-improve-the-batched-background-migration-documentation-how-to-follow-up into master

What does this MR do and why?

Follow-up from !122513 (merged)

Updates the `Execution mechanism` section to:

After being enqueued, batched background migrations are picked in parallel order by a Sidekiq worker. At this point, batched jobs are created - or retried and iterate over a range of records that are fetched based on the configuration defined inside the migration class. Each job instance receives a set of arguments based on this migration configuration. After each job execution, the optimization mechanism takes place to decide if the migration can be optimized.

GitLab.com is configured to run 4 parallel BBMs, while other instances uses a default value of 2 parallel migrations.

Soon as a worker is available, the BBM is processed by the runner.

MR acceptance checklist

This checklist encourages us to confirm any changes have been analyzed to reduce risks in quality, performance, reliability, security, and maintainability.

Related to #388789 (closed)

Edited by Leonardo da Rosa

Merge request reports