Getting Started with RelFast Configuration Management

Welcome to RelFast, a powerful configuration management platform designed to simplify the management of configurations, feature flags, and secrets for your applications. This guide will walk you through the initial setup and usage of RelFast to effectively control your application behavior and feature rollouts without requiring code changes or redeployments.

Step 1: Sign Up and Log In

1. Visit the RelFast portal at https://relfast.convolute.ai

2. Sign up for an account if you don't have one. Use your provided credentials to log in to the portal.

Step 2: Create a Project

1. Once logged in, click on the "Projects" tab on the left navigation bar.

2. Click on the "Add" button to create a new project.

3. Fill in the required details, such as the project name and description, and click "Add."

Step 3: Create an Environment

1. Click on the "Environments" tab on the left navigation bar.

2. Click on the "Add" button to create a new environment.

3. Fill in the required details, such as the environment name and description, and click "Add."

Step 4: Create an Application

1. Click on the "Applications" tab on the left navigation bar.

2. Click on the "Add" button to create a new application.

3. Fill in the required details, such as the application name and description, and click "Add."

Step 5: Create a Configuration or Feature Flag

1. Click on the "Configurations/Flags" tab on the left navigation bar.

2. Select the appropriate Project, Environment, and Application in the dropdown.

3. Click on the "ADD FLAGS" button.

4. Fill in the form fields for Name and Description and select the configuration type from the dropdown box.

5. Add values to the alternatives for the configuration. Use the "Add Alternatives" button to add additional alternatives.

6. Select the default alternatives to be served when the configuration is turned on and off.

7. Click on the "Add" button to submit the form.

Step 6: Integrate the RelFast C# SDK in Your Application

1. Add the RelFast.SDK and RelFast.SDK.OAuth SDK NuGet packages to your .NET application.

2. Create an extension method for the IServiceCollection to bootstrap the RelFast client.

3. BootStrap the service in the ConfigureServices method of your application.

Step 7: Retrieve Configurations or Feature Flags

1. Use the IRelFastClient instance to retrieve configurations or feature flags in your application code.

2. Define fallback values to handle any network/service disruptions on RelFast.

Step 8: Modify, Update, or Delete Configurations

1. To modify a configuration, navigate to the "Configurations/Flags" tab, click on the configuration name, and enter edit mode.

2. Update the necessary fields, such as Name and Description, and click "Save."

3. To delete a configuration, click on the configuration name, click the delete button, and confirm the deletion in the confirmation box.

Step 9: Restore Deleted Configurations

1. To restore a deleted configuration, navigate to the "Configurations" tab, and click on the "Recycle bin" button.

2. Use the search option to find the deleted configurations, and click on the "Restore" button associated with the configuration.

Step 10: Securely Rotate Secrets

1. Follow the JSON representation of secrets and identifier keys and values to store secrets securely.

2. Define configurations for secret identifier and actual secret, marking the latter as secured.

3. Use rules to associate the key identifier with the values and enable configurations.

4. Use the provided code sample to rotate secrets by adding new alternatives, deleting old ones, and defining conditional rules.

Congratulations! You are now ready to leverage the power of RelFast to manage configurations, feature flags, and secrets with ease. Enjoy the benefits of dynamic control over your application behavior without the need for code redeployment. Happy configuration management!