Progressive Rollouts
Rollout to some agents and wait before continuing to others
important
Progressive Rollouts are a BindPlane OP Enterprise Edition feature.
What are Progressive Rollouts?
A Progressive Rollout allows you to rollout a configuration to a pre-defined subset of agents and pause before continuing the rollout to other groups of agents.
![observIQ docs - Progressive Rollouts - image 1](/_next/image?url=%2Fimages%2Fdocs%2Fprogressive-rollout-bar-1.png&w=1920&q=100)
Defining Stages
To use a progressive rollout, go to the rollout options which are accessible in the configuration details section.
![observIQ docs - Progressive Rollouts - image 2](/_next/image?url=%2Fimages%2Fdocs%2Fprogressive-rollout-options.png&w=1920&q=100)
Each stage is given a name and a set of labels. The stage will include all agents whose labels include every label specified by the stage.
In Action
Once the stages are defined and the agents are added, Start Rollout will rollout to only the agents captured by the first stage.
![observIQ docs - Progressive Rollouts - image 3](/_next/image?url=%2Fimages%2Fdocs%2Fprogressive-rollout-bar-2.png&w=1920&q=100)
![observIQ docs - Progressive Rollouts - image 4](/_next/image?url=%2Fimages%2Fdocs%2Fprogressive-rollout-agents-1.png&w=1920&q=100)
The rollout will continue only when continue rollout is clicked.
Each stage can be hovered to see its name and how many agents have completed.
![observIQ docs - Progressive Rollouts - image 5](/_next/image?url=%2Fimages%2Fdocs%2Fprogressive-rollout-bar-3.png&w=1920&q=100)
![observIQ docs - Progressive Rollouts - image 6](/_next/image?url=%2Fimages%2Fdocs%2Fprogressive-rollout-agents-2.png&w=1920&q=100)
The third stage matches agents that have the env:prod
label. Agents that have already been counted are not added to this stage despite matching the label.
![observIQ docs - Progressive Rollouts - image 7](/_next/image?url=%2Fimages%2Fdocs%2Fprogressive-rollout-bar-4.png&w=1920&q=100)
![observIQ docs - Progressive Rollouts - image 8](/_next/image?url=%2Fimages%2Fdocs%2Fprogressive-rollout-agents-3.png&w=1920&q=100)
Unassigned
There are still some agents that have not been matched by any of the stages. There is always a final stage added to capture these agents.
![observIQ docs - Progressive Rollouts - image 9](/_next/image?url=%2Fimages%2Fdocs%2Fprogressive-rollout-bar-5.png&w=1920&q=100)
Empty stages
Sometimes a stage does not match any agents. The rollout can be continued through this stage, doing nothing.
![observIQ docs - Progressive Rollouts - image 10](/_next/image?url=%2Fimages%2Fdocs%2Fprogressive-rollout-bar-6.png&w=1920&q=100)