Create or modify rules of a configuration/feature flag

To add, delete, or update rules associated with a configuration or feature flag in the RelFast portal, follow the step-by-step instructions below. Please ensure that you have the necessary "Update Configuration" permissions, which are environment-specific, to perform this operation.

Instructions:

1. Open your web browser and go to the portal: https://relfast.convolute.ai

2. Log in to the portal using your credentials to access your account.

3. After logging in, find and click on the "Configurations/Flags" tab in the left navigation bar. This will take you to the section where configurations and feature flags are managed.

4. Select the appropriate Project, Environment, and Application from the dropdown menus. If defaults are set, they will be pre-populated for convenience.

5. Existing configurations and feature flags will be displayed on this page.

6. To modify a configuration or feature flag, click on the name of the configuration or feature flag that you want to edit. This will navigate you to the specific configuration or feature flag page.

7. Once on the edit page, navigate to the "Rules" tab. This tab is environment-specific and tied to the Environments dropdown selection.

8. If no rules exist for the selected configuration, click on the "Add rule" button to create a new rule.

9. RelFast supports several types of rules, including Conditional, Conditional percentage (Bucketed), and Default percentage (Bucketed). Choose the appropriate rule type for your use case.

10. For a Conditional Rule example, consider serving a database timeout of 50 milliseconds for specific tenants and defaults for others.

11. Enter the key as "tenant id" (This is the key sent in the SDK as part of request metadata).

12. Select the operator. The various operators supported are mentioned in the UI.

13. For this example, select the operator as "In."

14. Add the actual tenant identifier values in the "values" text box. (This is the value sent in the SDK as part of request metadata).

15. Click on the edit icon on the "values" box to add a new value or remove an existing value.

16. Select the alternative in the dropdown box that should be served when the condition is met.

17. Click on the "Save" button to save the conditional rule.

18. For multiple conditions, you can add sub-conditions using the "Add condition" button. These sub-conditions are evaluated as "AND" conditions.

19. For example, you can add a condition to serve the 50 milliseconds timeout only for tenants in specific countries (not in China and Philippines).

20. Click on the "Add condition" button, enter the key as "country," select the operator as "Not In," and add values as "China" and "Philippines."

21. Additional AND conditions can be added using the "+" and "-" buttons.

22. Click on the "Save" button to save the rule with multiple conditions.

23. The execution of rules is ordered top to down. Rule evaluation takes higher priority compared to default alternatives configured. You can modify the order of a rule using the drag button or the "Reorder" button provided in the UI.

24. Use the drag button to move a rule above another rule. Simply click and hold the mouse button and move the rule up or down to modify the evaluation order.

25. Alternatively, use the "Reorder" button to manually reorder the rules. Click and hold the left mouse button and drag the rule id up or down to adjust the order, then click the "Save" button to persist the changes.

26. Remember to click the "Save" button after making any changes to rules to apply the modifications.

27. Feature flags are modified similarly to configurations.

28. It is important to have a minimum of two alternatives for default alternatives.

29. The "Save" button performs client and server-side validations. Any violations in the form will be highlighted in the portal, prompting user action to correct the input.

30. The "Is Secured" switch can be used to store the alternatives at rest in an encrypted vault for added security.

By following these instructions, you can easily manage the rules associated with configurations and feature flags in the RelFast portal, ensuring that your application's settings and feature options are efficiently controlled based on different conditions and environments.