1
0
mirror of https://github.com/Unleash/unleash.git synced 2024-12-22 19:07:54 +01:00
unleash.unleash/website/docs/user_guide/control-rollout.md
2021-12-14 14:03:28 +01:00

3.0 KiB
Raw Blame History

id title
control_rollout Control rollout

It is powerful to be able to turn a feature on and off instantaneously, without redeploying the application. The next level of control comes when you are able to enable a feature for specific users or enable it for a small subset of users.

In this guide you will learn how to control the roll-out (expose it to real users) of a new feature with the help of activation strategies.

Built in activation strategies

Unleash comes with a few common activation strategies. Some of them require the client to provide the unleash-context, which gives the necessary context for Unleash.

The built-in activation strategies:

  • Standard
  • UserIDs
  • Gradual Rollout
  • IPs
  • Hostnames

The standard activation strategy

When you create a new feature toggle you will get the standard activation strategy, if you dont configure any specific strategies. The standard activation strategy will always evaluate to true, given that the feature toggle is enabled.

A UI element describing the \"standard\" strategy. It says \"The standard strategy is strictly on / off for your entire userbase\".

The UserIDs strategy

When we have deployed some new code to production it would be nice to enable the new feature for ourselves before we enable it to everyone else. To achieve this with Unleash, you can use the UserIDs activation strategy. This strategy allows you to specify a list of user IDs that you want to expose the new feature for.

A userId is how you identify users in your system (email, UUID, etc) and is provided as part of the Unleash Context to the client SDK.

A UI element showing the user ID strategy. It has an active list of two user IDs: \"productlead@mycompany.com\" and \"me@mycompany.com\".

Multiple activation strategies

In order to increase the exposure of the feature which is protected with the feature toggle you can configure multiple activation strategies on the same feature toggle.

A feature toggle with two active strategies: a user ID strategy and a gradual rollout strategy.

In the example above we have to configure two activation strategies, userWithId and flexibleRollout. If one of them evaluates to true the feature toggle is considered enabled. In the example we have enabled the feature toggle for usersWithId (productlead@mycompany.com and me@mycompany.com) in addition to 75% of the traffic.

Summary

You use activation strategies to control who the feature toggle will be enabled for. You can configure multiple strategies for a feature toggle, and they are considered in an OR fashion, meaning if one of them evaluates to true the toggle will be enabled.

If you need to limit the exposure (AND) you should look in to strategy constraints, which is the building block for that.