# Progressive Rollouts

{% hint style="warning" %}
**IMPORTANT**

Progressive Rollouts are a [Bindplane Enterprise Edition](https://bindplane.com/solutions/) feature.
{% endhint %}

### What are Progressive Rollouts?

A Progressive Rollout allows you to rollout a configuration to a pre-defined subset of collectors and pause before continuing the rollout to other groups of collectors.

<figure><img src="/files/iF5wjLyHwSvDsaaWzFhO" alt="Bindplane docs - Progressive Rollouts - image 1"><figcaption></figcaption></figure>

### Defining Stages

To use a progressive rollout, go to the rollout options which are accessible in the configuration details section.

<figure><img src="/files/yQX7611WquGo5c3MorVs" alt="Bindplane docs - Progressive Rollouts - image 2"><figcaption></figcaption></figure>

Each stage is given a name and a set of labels. The stage will include all collectors whose labels include every label specified by the stage.

### In Action

Once the stages are defined and the collectors are added, Start Rollout will rollout to *only* the collectors captured by the first stage.

<figure><img src="/files/SfGijXb0Jj9iSop76W44" alt="Bindplane docs - Progressive Rollouts - image 3"><figcaption></figcaption></figure>

<figure><img src="/files/gWQU6vOZYSSbku4MyWMd" alt="Bindplane docs - Progressive Rollouts - image 4"><figcaption></figcaption></figure>

The rollout will continue only when continue rollout is clicked.

Each stage can be hovered to see its name and how many collectors have completed.

<figure><img src="/files/BqAEQqCTFxF9aGyriNKk" alt="Bindplane docs - Progressive Rollouts - Image 9"><figcaption></figcaption></figure>

<figure><img src="/files/XaCtk6E6NTTMMEsUoDht" alt="Bindplane docs - Progressive Rollouts - Image 10"><figcaption></figcaption></figure>

The third stage matches collectors that have the `env:prod` label. Collectors that have already been counted are not added to this stage despite matching the label.

<figure><img src="/files/8DqiyMimFvuobIGKaDGm" alt="Bindplane docs - Progressive Rollouts - image 5"><figcaption></figcaption></figure>

<figure><img src="/files/kHib3f4JPXaeLRiRFPyR" alt="Bindplane docs - Progressive Rollouts - image 6"><figcaption></figcaption></figure>

### Unassigned

There are still some collectors that have not been matched by any of the stages. There is always a final stage added to capture these collectors.

<figure><img src="/files/vaguvqmTfSaGx5tyI4P0" alt="Bindplane docs - Progressive Rollouts - image 7"><figcaption></figcaption></figure>

### Empty stages

Sometimes a stage does not match any collectors. The rollout can be continued through this stage, doing nothing.

<figure><img src="/files/3Vz2tIynCiZdM3QXEto8" alt="Bindplane docs - Progressive Rollouts - image 8"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bindplane.com/feature-guides/deployment-and-management/progressive-rollouts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
