The documentation for forge version bulk-upgrade states:
The
forge version bulk-upgradecommand lets you upgrade a maximum of 500 installations in 1 request
It looks like the limit is actually 1000 installations per request.
We ran a bulk upgrade today targeting approximately 1450 installs. We watched as the pending count decreased as the completed/failed counts increased (all the time totalling ~1450).
Once the completed + failed count reached exactly 1000, the pending count dropped to zero.
If we run forge version bulk-upgrade start again, we can see the remaining ~450 installations that can be upgraded.
We were expecting it to stop after 500 upgrades so that we could verify no issues before starting the next batch.
It’s not a huge problem (at least we hope it isn’t at this early stage) that it upgraded twice as many as expected in a single batch, but the documentation is clearly wrong and should be corrected.