快速入门：向 Go Gin Web 应用添加功能标志

在本快速入门中，你将在 Azure 应用配置中创建一个功能标志，并使用它在 Go Gin Web 应用中动态控制新网页的可用性，而无需重启或重新部署它。

功能管理支持扩展了应用程序配置中的动态配置功能。 此示例演示如何使用实时更新和条件页面呈现将功能标志集成到 Go Gin Web 应用程序中。

先决条件

• 拥有有效订阅的 Azure 帐户。 创建试用版订阅。
• 应用配置库。 创建商店。
• 转到 1.21 或更高版本。 有关安装 Go 的信息，请参阅 Go 下载页。
• Azure 应用配置 Go 提供程序 v1.1.0 或更高版本。

创建功能标志

将名为Beta的功能标志添加到应用配置存储中，并将Label和Description保留为默认值。 有关如何使用 Azure 门户或 CLI 将功能标志添加到商店的信息，请转到 创建功能标志。

创建 Go Web 应用程序

1. 为 Go 项目创建新目录并导航到它：

   mkdir gin-feature-flag-quickstart
   cd gin-feature-flag-quickstart
   

2. 初始化新的 Go 模块：

   go mod init gin-feature-flag-quickstart
   

3. 为 Azure 应用配置、Gin Web 框架和功能管理安装所需的 Go 包：

   go get github.com/gin-gonic/gin
   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 - 主页模板
   • beta.html - beta 页面模板

使用功能标志

1. 创建包含以下内容的名为 appconfig.go 的文件。 可以使用 Microsoft Entra ID（推荐）或连接字符串连接到应用程序配置存储。

   • 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,
       }
   
       // Configure feature flag options
       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
   }
   

   小窍门

   当在 FeatureFlagOptions 中未指定选择器时，它会加载应用配置存储库中所有无标签的功能开关。 功能标志的默认刷新间隔为 30 秒。 可以通过 RefreshOptions 参数自定义此行为。 例如，以下代码片段仅加载键名以“TestApp:”开头的，并具有标签“dev”的功能标志。 该代码还将刷新间隔时间更改为 5 分钟。 请注意，此刷新间隔时间与常规键值的刷新间隔时间不同。

   azureappconfiguration.FeatureFlagOptions{
       Enabled: true,
       Selectors: []azureappconfiguration.Selector{
           {
               KeyFilter:   "TestApp:*",
               LabelFilter: "dev",
           },
       },
       RefreshOptions: azureappconfiguration.RefreshOptions{
           Enabled: true,
           Interval: 5 * time.Minute,
       },
   }
   

2. 创建包含以下内容的文件 main.go ：

   package main
   
   import (
       "context"
       "fmt"
       "log"
       "net/http"
       "os"
   
       "github.com/Azure/AppConfiguration-GoProvider/azureappconfiguration"
       "github.com/gin-gonic/gin"
       "github.com/microsoft/Featuremanagement-Go/featuremanagement"
       "github.com/microsoft/Featuremanagement-Go/featuremanagement/providers/azappconfig"
   )
   
   type WebApp struct {
       featureManager *featuremanagement.FeatureManager
       appConfig      *azureappconfiguration.AzureAppConfiguration
   }
   
   func (app *WebApp) refreshMiddleware() gin.HandlerFunc {
       return func(c *gin.Context) {
           go func() {
               ctx := context.Background()
               if err := app.appConfig.Refresh(ctx); err != nil {
                   log.Printf("Error refreshing configuration: %v", err)
               }
           }()
           c.Next()
       }
   }
   
   func (app *WebApp) featureMiddleware() gin.HandlerFunc {
       return func(c *gin.Context) {
           // Check if Beta feature is enabled
           betaEnabled, err := app.featureManager.IsEnabled("Beta")
           if err != nil {
               log.Printf("Error checking Beta feature: %v", err)
               betaEnabled = false
           }
   
           // Store feature flag status for use in templates
           c.Set("betaEnabled", betaEnabled)
           c.Next()
       }
   }
   
   func (app *WebApp) setupRoutes(r *gin.Engine) {
       r.Use(app.refreshMiddleware())
       r.Use(app.featureMiddleware())
   
       // Load HTML templates
       r.LoadHTMLGlob("templates/*.html")
   
       // Routes
       r.GET("/", app.homeHandler)
       r.GET("/beta", app.betaHandler)
   }
   
   // Home page handler
   func (app *WebApp) homeHandler(c *gin.Context) {
       betaEnabled := c.GetBool("betaEnabled")
   
       c.HTML(http.StatusOK, "index.html", gin.H{
           "title":       "Feature Management Example App",
           "betaEnabled": betaEnabled,
       })
   }
   
   // Beta page handler
   func (app *WebApp) betaHandler(c *gin.Context) {
       betaEnabled := c.GetBool("betaEnabled")
   
       if !betaEnabled {
           return
       }
   
       c.HTML(http.StatusOK, "beta.html", gin.H{
           "title": "Beta Page",
       })
   }
   
   func main() {
       ctx := context.Background()
   
       // Load Azure App Configuration
       appConfig, err := loadAzureAppConfiguration(ctx)
       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)
       }
   
       // Create web app
       app := &WebApp{
           featureManager: featureManager,
           appConfig:      appConfig,
       }
   
       // Set up Gin with default middleware (Logger and Recovery)
       r := gin.Default()
   
       // Set up routes
       app.setupRoutes(r)
   
       // Start server
       fmt.Println("Starting server on http://localhost:8080")
       fmt.Println("Open http://localhost:8080 in your browser")
       fmt.Println("Toggle the 'Beta' feature flag in Azure portal to see changes")
       fmt.Println()
   
       if err := r.Run(":8080"); err != nil {
           log.Fatalf("Failed to start server: %v", err)
       }
   }
   

运行 Web 应用程序

1. 设置身份验证的环境变量并运行应用程序。

   go mod tidy
   go run .
   

2. 打开浏览器窗口，然后转到 http://localhost:8080。 浏览器应显示类似于下图的页面。

   

3. 登录到 Azure 门户。 选择“所有资源”，然后选择先前创建的应用程序配置存储。

4. 选择“功能管理器”并找到“Beta”功能标志。 通过选中“已启用”下的复选框来启用该标志。

5. 多次刷新浏览器。 刷新间隔时间窗口通过时，页面会显示更新的内容：

   

6. 请注意， Beta 菜单项现在显示在导航栏中。 单击它以访问 beta 页面：

   

清理资源

如果不想继续使用本文中创建的资源，请删除此处创建的资源组以避免产生费用。

1. 登录到 Azure 门户，然后选择“资源组”。
2. 在按名称筛选框中，输入资源组的名称。
3. 在结果列表中，选择资源组名称以查看概述。
4. 选择“删除资源组”。
5. 系统会要求确认是否删除资源组。 重新键入资源组的名称进行确认，然后选择“删除”。

片刻之后，将会删除该资源组及其所有资源。

后续步骤

在本快速入门中，你在 Azure 应用配置中创建一个功能标志，并在 Go Gin Web 应用程序中使用它。 功能管理 Go 库提供与 Azure 应用配置无缝集成的功能标志功能。有关更多功能，请继续阅读以下文档。

虽然使用功能标志可以在应用中激活或停用功能，但你可能希望根据应用的逻辑自定义功能标志。 使用功能筛选器可以按条件启用功能标志。 有关详细信息，请继续阅读以下教程。

Azure 应用程序配置提供了内置的功能筛选器，使你可以仅在特定的时段或者仅对应用的特定目标受众激活功能标志。 有关详细信息，请继续阅读以下教程。