Skip to content

Progressive rollout

A progressive rollout allows you to increase the percentage of your flag over time.

You can select a release ramp where the percentage of your flag will increase progressively between the start date and the end date.

Example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
progressive-flag:
  true: "B"
  false: "A"
  default: "Default"
  rollout:
    progressive:
      percentage:
        initial: 0
        end: 100
      releaseRamp:
        start: 2021-03-20T00:00:00.10-05:00
        end: 2021-03-21T00:00:00.10-05:00
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
{
  "progressive-flag": {
    "true": "B",
    "false": "A",
    "default": "Default",
    "rollout": {
      "progressive": {
        "percentage": {
          "initial": 0,
          "end": 100
        },
        "releaseRamp": {
          "start": "2021-03-20T05:00:00.100Z",
          "end": "2021-03-21T05:00:00.100Z"
        }
      }
    }
  }
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
[progressive-flag]
true = "B"
false = "A"
default = "Default"

  [progressive-flag.rollout]

    [progressive-flag.rollout.progressive]

      [progressive-flag.rollout.progressive.percentage]
      initial = 0.0
      end = 100.0

      [progressive-flag.rollout.progressive.releaseRamp]
      start = 2021-03-20T05:00:00.100Z
      end = 2021-03-21T05:00:00.100Z

Configuration fields

Info

The dates are in the format supported natively by your flag file format.

Field Description
releaseRamp It contains the time slot where we will progressively increase the percentage of the flag.
  • Before the start date we will serve the percentage.initial percentage of the flag.
  • Between start and end we will serve a percentage of the flag corresponding of the actual time.
  • After the end date we will serve the percentage.end percentage of the flag.

If you have no date in your releaseRamp we will not do any progressive rollout and use the top level percentage you have configured (0% in our example).

percentage (optional)
It represents the ramp of progress, at which level the flag starts (initial) and at which level it ends (end).
Default: initial = 0 and end = 100