チュートリアル: Go Gin Web アプリケーションでバリアント機能フラグを使用する

このチュートリアルでは、バリアント機能フラグを使用して、アプリケーション例 の Quote of the Day でさまざまなユーザー セグメントのエクスペリエンスを管理します。 「バリアント機能フラグを使用する」で作成したバリアント機能フラグを利用します。 先に進む前に、App Configuration ストアで Greeting という名前のバリアント機能フラグを作成してください。

[前提条件]

• アクティブなサブスクリプションを持つ Azure アカウント。 無料で作成できます。
• "App Configuration ストアは、ストアを作成するためのチュートリアルに示されているように設置されています。"
• 1.21 以降に進む。 Go のインストールについては、 Go のダウンロード ページを参照してください。
• Azure App Configuration Go プロバイダー v1.1.0 以降。
• Feature Management Go ライブラリ v1.1.0 以降。
• 「バリアント機能フラグを使用する」チュートリアルに従って、Greeting という名前のバリアント機能フラグを作成します。

Go Gin Web アプリケーションを設定する

1. Go プロジェクトの新しいディレクトリを作成し、そこに移動します。

   mkdir quote-of-the-day
   cd quote-of-the-day
   

2. 新しい Go モジュールを初期化します。

   go mod init quote-of-the-day
   

3. 必要な Go パッケージをインストールします。

   go get github.com/gin-gonic/gin
   go get github.com/gin-contrib/sessions
   go get github.com/gin-contrib/sessions/cookie
   go get github.com/microsoft/Featuremanagement-Go/featuremanagement
   go get github.com/microsoft/Featuremanagement-Go/featuremanagement/providers/azappconfig
   

4. HTML テンプレートのテンプレート ディレクトリを作成し、必要な HTML ファイルを追加します。

   mkdir templates
   

   GitHub リポジトリから次の HTML テンプレート ファイルを追加し、templates ディレクトリに配置します。

   • index.html - ホーム ページ テンプレート
   • login.html - ログイン ページ テンプレート

5. 次の内容を含む appconfig.go という名前のファイルを作成します。 Microsoft Entra ID (推奨) または接続文字列を使用して App Configuration ストアに接続できます。

   Microsoft Entra ID (推奨)

   package main
   
   import (
       "context"
       "log"
       "os"
   
       "github.com/Azure/AppConfiguration-GoProvider/azureappconfiguration"
       "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
   )
   
   func loadAzureAppConfiguration(ctx context.Context) (*azureappconfiguration.AzureAppConfiguration, error) {
       // Get the endpoint from environment variable
       endpoint := os.Getenv("AZURE_APPCONFIG_ENDPOINT")
       if endpoint == "" {
           log.Fatal("AZURE_APPCONFIG_ENDPOINT environment variable is not set")
       }
   
       // Create a credential using DefaultAzureCredential
       credential, err := azidentity.NewDefaultAzureCredential(nil)
       if err != nil {
           log.Fatalf("Failed to create credential: %v", err)
       }
   
       // Set up authentication options with endpoint and credential
       authOptions := azureappconfiguration.AuthenticationOptions{
           Endpoint:   endpoint,
           Credential: credential,
       }
   
       // Set up options to enable feature flags
       options := &azureappconfiguration.Options{
           FeatureFlagOptions: azureappconfiguration.FeatureFlagOptions{
               Enabled: true,
               RefreshOptions: azureappconfiguration.RefreshOptions{
                   Enabled: true,
               },
           },
       }
   
       // Load configuration from Azure App Configuration
       appConfig, err := azureappconfiguration.Load(ctx, authOptions, options)
       if err != nil {
           log.Fatalf("Failed to load configuration: %v", err)
       }
   
       return appConfig, nil
   }
   

   接続文字列

   package main
   
   import (
       "context"
       "log"
       "os"
   
       "github.com/Azure/AppConfiguration-GoProvider/azureappconfiguration"
   )
   
   func loadAzureAppConfiguration(ctx context.Context) (*azureappconfiguration.AzureAppConfiguration, error) {
       // Get the connection string from environment variable
       connectionString := os.Getenv("AZURE_APPCONFIG_CONNECTION_STRING")
       if connectionString == "" {
           log.Fatal("AZURE_APPCONFIG_CONNECTION_STRING environment variable is not set")
       }
   
       // Set up authentication options with connection string
       authOptions := azureappconfiguration.AuthenticationOptions{
           ConnectionString: connectionString,
       }
   
       // Set up options to enable feature flags
       options := &azureappconfiguration.Options{
           FeatureFlagOptions: azureappconfiguration.FeatureFlagOptions{
               Enabled: true,
               RefreshOptions: azureappconfiguration.RefreshOptions{
                   Enabled: true,
               },
           },
       }
   
       // Load configuration from Azure App Configuration
       appConfig, err := azureappconfiguration.Load(ctx, authOptions, options)
       if err != nil {
           log.Fatalf("Failed to load configuration: %v", err)
       }
   
       return appConfig, nil
   }
   

バリアント機能フラグを使用する

1. 次の内容を含む main.go という名前のファイルを作成します。

   package main
   
   import (
       "context"
       "fmt"
       "log"
       "net/http"
       "strings"
   
       "github.com/Azure/AppConfiguration-GoProvider/azureappconfiguration"
       "github.com/gin-contrib/sessions"
       "github.com/gin-contrib/sessions/cookie"
       "github.com/gin-gonic/gin"
       "github.com/microsoft/Featuremanagement-Go/featuremanagement"
       "github.com/microsoft/Featuremanagement-Go/featuremanagement/providers/azappconfig"
   )
   
   type Quote struct {
       Message string `json:"message"`
       Author  string `json:"author"`
   }
   
   type WebApp struct {
       featureManager *featuremanagement.FeatureManager
       appConfig      *azureappconfiguration.AzureAppConfiguration
       quotes         []Quote
   }
   
   func main() {
       // Load Azure App Configuration
       appConfig, err := loadAzureAppConfiguration(context.Background())
       if err != nil {
           log.Fatalf("Error loading Azure App Configuration: %v", err)
       }
   
       // Create feature flag provider
       featureFlagProvider, err := azappconfig.NewFeatureFlagProvider(appConfig)
       if err != nil {
           log.Fatalf("Error creating feature flag provider: %v", err)
       }
   
       // Create feature manager
       featureManager, err := featuremanagement.NewFeatureManager(featureFlagProvider, nil)
       if err != nil {
           log.Fatalf("Error creating feature manager: %v", err)
       }
   
       // Initialize quotes
       quotes := []Quote{
           {
               Message: "You cannot change what you are, only what you do.",
               Author:  "Philip Pullman",
           },
       }
   
       // Create web app
       app := &WebApp{
           featureManager: featureManager,
           appConfig:      appConfig,
           quotes:         quotes,
       }
   
       // Setup Gin with default middleware (Logger and Recovery)
       r := gin.Default()
   
       // Start server
       if err := r.Run(":8080"); err != nil {
           log.Fatalf("Failed to start server: %v", err)
       }
   
       fmt.Println("Starting Quote of the Day server on http://localhost:8080")
       fmt.Println("Open http://localhost:8080 in your browser")
       fmt.Println()
   }
   

2. ミドルウェアを使用して Azure App Configuration から構成と機能フラグの更新を有効にします。

   // Existing code
   // ... ...
   
   func (app *WebApp) refreshMiddleware() gin.HandlerFunc {
       return func(c *gin.Context) {
           go func() {
               if err := app.appConfig.Refresh(context.Background()); err != nil {
                   log.Printf("Error refreshing configuration: %v", err)
               }
           }()
           c.Next()
       }
   }
   // The rest of existing code
   //... ...
   

3. 次の内容でルートを設定します。

   // Existing code
   // ... ...
   
   func (app *WebApp) setupRoutes(r *gin.Engine) {
       // Setup sessions
       store := cookie.NewStore([]byte("secret-key-change-in-production"))
       store.Options(sessions.Options{
           MaxAge:   3600, // 1 hour
           HttpOnly: true,
           Secure:   false, // Set to true in production with HTTPS
       })
       r.Use(sessions.Sessions("session", store))
   
       r.Use(app.refreshMiddleware())
   
       // Load HTML templates
       r.LoadHTMLGlob("templates/*.html")
       // Routes
       r.GET("/", app.homeHandler)
       r.GET("/login", app.loginPageHandler)
       r.POST("/login", app.loginHandler)
       r.GET("/logout", app.logoutHandler)
   }
   
   // Home page handler
   func (app *WebApp) homeHandler(c *gin.Context) {
       session := sessions.Default(c)
       username := session.Get("username")
       quote := app.quotes[0]
   
       var greetingMessage string
       var targetingContext featuremanagement.TargetingContext
       if username != nil {
           // Create targeting context for the user
           targetingContext = createTargetingContext(username.(string))
   
           // Get the Greeting variant for the current user
           if variant, err := app.featureManager.GetVariant("Greeting", targetingContext); err != nil {
               log.Printf("Error getting Greeting variant: %v", err)
           } else if variant != nil && variant.ConfigurationValue != nil {
               // Extract the greeting message from the variant configuration
               if configValue, ok := variant.ConfigurationValue.(string); ok {
                   greetingMessage = configValue
               }
           }
       }
   
       c.HTML(http.StatusOK, "index.html", gin.H{
           "title":           "Quote of the Day",
           "user":            username,
           "greetingMessage": greetingMessage,
           "quote":           quote,
       })
   }
   
   func (app *WebApp) loginPageHandler(c *gin.Context) {
       c.HTML(http.StatusOK, "login.html", gin.H{
           "title": "Login - Quote of the Day",
       })
   }
   
   func (app *WebApp) loginHandler(c *gin.Context) {
       email := strings.TrimSpace(c.PostForm("email"))
   
       // Basic validation
       if email == "" {
           c.HTML(http.StatusOK, "login.html", gin.H{
               "title": "Login - Quote of the Day",
               "error": "Email cannot be empty",
           })
           return
       }
   
       if !strings.Contains(email, "@") {
           c.HTML(http.StatusOK, "login.html", gin.H{
               "title": "Login - Quote of the Day",
               "error": "Please enter a valid email address",
           })
           return
       }
   
       // Store email in session
       session := sessions.Default(c)
       session.Set("username", email)
       if err := session.Save(); err != nil {
           log.Printf("Error saving session: %v", err)
       }
   
       c.Redirect(http.StatusFound, "/")
   }
   
   func (app *WebApp) logoutHandler(c *gin.Context) {
       session := sessions.Default(c)
       session.Clear()
       if err := session.Save(); err != nil {
           log.Printf("Error saving session: %v", err)
       }
       c.Redirect(http.StatusFound, "/")
   }
   
   // Helper function to create TargetingContext
   func createTargetingContext(userID string) featuremanagement.TargetingContext {
       targetingContext := featuremanagement.TargetingContext{
           UserID: userID,
           Groups: []string{},
       }
   
       if strings.Contains(userID, "@") {
           parts := strings.Split(userID, "@")
           if len(parts) == 2 {
               domain := parts[1]
               targetingContext.Groups = append(targetingContext.Groups, domain) // Add domain as group
           }
       }
   
       return targetingContext
   }
   // The rest of existing code
   //... ...
   

4. 次の内容で main.go を更新します。

   // Existing code
   // ... ...
    r := gin.Default()
   
    // Setup routes
    app.setupRoutes(r)
   
    // Start server
    if err := r.Run(":8080"); err != nil {
       log.Fatalf("Failed to start server: %v", err)
   }
   // The rest of existing code
   // ... ...
   

アプリをビルドして実行する

1. 認証用の環境変数を設定 し、アプリケーションを実行します。

   go mod tidy
   go run .
   

2. ブラウザーを開き、http://localhost:8080 に移動します。 右上にある [ログイン ] を選択して、 usera@contoso.comとしてサインインします。

   

3. ログインすると、 usera@contoso.comの長いあいさつメッセージが表示されます。

   

4. [ ログアウト ] をクリックし、 userb@contoso.comとしてログインすると、簡単なあいさつメッセージが表示されます。

   

   注

   このチュートリアルでは、これらの名前を正確に使用することが重要です。 機能が期待どおりに構成されている限り、2 人のユーザーには異なるバリエーションが表示されます。

次のステップ

Go での機能管理の詳細については、次のドキュメントに進んでください。

Go Feature 管理リファレンス

対象ユーザーに対して機能をロールアウトする

機能フィルターを使用して条件付き機能を有効にする