appconfiguration-go-sdk

IBM Cloud App Configuration Go server SDK

IBM Cloud App Configuration SDK is used to perform feature evaluation based on the configuration on IBM Cloud App Configuration service.

Table of Contents

• Overview
• Installation
• Import the SDK
• Initialize SDK
• License

Overview

IBM Cloud App Configuration is a centralized feature management and configuration service on IBM Cloud for use with web and mobile applications, microservices, and distributed environments.

Instrument your applications with App Configuration Go SDK, and use the App Configuration dashboard, API or CLI to define features flags, organized into collections and targeted to segments. Change feature flag states in the cloud to activate or deactivate features in your application or environment, often without re-starting.

Installation

Install using the command.

go get -u github.com/IBM/appconfiguration-go-sdk

Import the SDK

To import the module

import AppConfiguration "github.com/IBM/appconfiguration-go-sdk/lib"

Initialize SDK

Initialize the sdk to connect with your App Configuration service instance.

appConfiguration = AppConfiguration.GetInstance()
appConfiguration.Init("region", "guid", "apikey")

// Set the collection Id
appConfiguration.SetCollectionId("collectionId")

• region : Region name where the App Configuration service instance is created. Use AppConfiguration.REGION_US_SOUTH for Dallas and AppConfiguration.REGION_EU_GB for London.
• guid : Instance Id of the App Configuration service. Get it from the service credentials section of the dashboard.
• apikey : ApiKey of the App Configuration service. Get it from the service credentials section of the dashboard.

• collectionId: Id of the collection created in App Configuration service instance.

Here, by default live features update from the server is enabled. To turn off this mode see the below section

Work offline with local feature file

You can also work offline with local feature file and perform feature operations.

After setting the collection Id, follow the below steps

appConfiguration.FetchFromFeatureFile( "featureFilePath", "liveFeatureUpdateEnabled")

• featureFilePath: Path to the JSON file, which contains feature details and segment details.
• liveFeatureUpdateEnabled: Set this value to false if the new feature values shouldn't be fetched from the server. Make sure to provide a proper JSON file in the path. By default, this value is enabled.

Get single feature

feature := appConfiguration.GetFeature("featureId")



if(feature.IsEnabled()) {
        // enable feature
} else {
        // disable the feature
}
fmt.Println(feature);
fmt.Println("Feature Name %s", feature.GetFeatureName());
fmt.Println("Feature Id  %s", feature.GetFeatureId());
fmt.Println("Feature Type %s", feature.GetFeatureDataType());
fmt.Println("Feature is enabled %t ", feature.IsEnabled());

Get all features

features := appConfiguration.GetFeatures()

feature := features["featureId"];


fmt.Println("Feature Name %s", feature.GetFeatureName());
fmt.Println("Feature Id  %s", feature.GetFeatureId());
fmt.Println("Feature Type %s", feature.GetFeatureDataType());
fmt.Println("Feature is enabled %t ", feature.IsEnabled());

Listen to the feature changes

To listen to the data changes add the following code in your application

appConfiguration.RegisterFeaturesUpdateListener(func() {
    fmt.Println("Get your feature value now ")
})

Evaluate a feature

You can use the feature.GetCurrentValue(identityId, identityAttributes) method to evaluate the value of the feature flag. You should pass an unique identityId as the parameter to perform the feature flag evaluation. If the feature flag is configured with segments in the App Configuration service, you can set the attributes values as a map.

identityId := "identityId"
identityAttributes := make(map[string]interface{})
identityAttributes["email"] = "ibm.com"
identityAttributes["city"] = "Bengaluru"


featureVal := feature.GetCurrentValue(identityId, identityAttributes)

Fetch latest data

appConfiguration.FetchFeatureData()

Enable debugger

appConfiguration.EnableDebug(true)

License

This project is released under the Apache 2.0 license. The license's full text can be found in LICENSE