クイックスタート: Go コンソールアプリに機能フラグを追加する

このクイックスタートでは、Azure App Configuration で機能フラグを作成し、それを使用して Go コンソールアプリの機能の可用性を動的に制御します。

機能管理のサポートにより、App Configuration の動的構成機能が拡張されます。この例では、リアルタイム監視機能を使用して機能フラグを Go コンソールアプリケーションに統合する方法を示します。

[前提条件]

アクティブなサブスクリプションを持つ Azure アカウント。無料で作成できます。
アプリ設定ストア。ストアを作成する。
1.21 以降に進む。 Go のインストールについては、 Go のダウンロードページを参照してください。
Azure App Configuration Go プロバイダー v1.1.0 以降。

機能フラグを作成する

App Configuration ストアに Beta という機能フラグを追加し、 ラベル と説明を既定値のままにします。 Azure portal または CLI を使用してストアに機能フラグを追加する方法の詳細については、「機能フラグの作成」を参照してください。

機能フラグを使用する

Go プロジェクトの新しいディレクトリを作成し、そこに移動します。
```
mkdir go-feature-flag-quickstart
cd go-feature-flag-quickstart
```
新しい Go モジュールを初期化します。
```
go mod init go-feature-flag-quickstart
```

Azure App Configuration と機能管理に必要な Go パッケージをインストールします。

go get github.com/microsoft/Featuremanagement-Go/featuremanagement
go get github.com/microsoft/Featuremanagement-Go/featuremanagement/providers/azappconfig

次の内容を含む 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,
    }

    // 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
}

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,
    }

    // 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でセレクターが指定されていない場合は、App Configuration ストアにラベルのないすべての機能フラグが読み込まれます。機能フラグの既定の更新間隔は 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,
    },
}

メインアプリケーションファイルを作成 main.go。

package main

import (
	"context"
	"fmt"
	"log"
	"os"
	"time"

	"github.com/microsoft/Featuremanagement-Go/featuremanagement"
	"github.com/microsoft/Featuremanagement-Go/featuremanagement/providers/azappconfig"
)

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)
    }

    // Monitor the Beta feature flag
    fmt.Println("Monitoring 'Beta' feature flag (press Ctrl+C to exit):")
    fmt.Println("Toggle the Beta feature flag in Azure portal to see real-time updates...")
    fmt.Println()

    ticker := time.NewTicker(5 * time.Second)
    defer ticker.Stop()

    for {
        select {
        case <-ticker.C:
            // Refresh configuration to get latest feature flag settings
            if err := appConfig.Refresh(ctx); err != nil {
                log.Printf("Error refreshing configuration: %v", err)
                continue
            }

            // Evaluate the Beta feature flag
            isEnabled, err := featureManager.IsEnabled("Beta")
            if err != nil {
                log.Printf("Error checking if Beta feature is enabled: %v", err)
                continue
            }

            // Print timestamp and feature status
            timestamp := time.Now().Format("15:04:05")
            fmt.Printf("[%s] Beta is enabled: %t\n", timestamp, isEnabled)

        case <-ctx.Done():
            fmt.Println("\nShutting down...")
            return
        }
    }
}

アプリケーションを実行する

アプリケーションを実行します。
```
go mod tidy
go run .
```

アプリケーションは ベータ 機能フラグの監視を開始し、5 秒ごとに現在の状態を表示します。

Monitoring 'Beta' feature flag (press Ctrl+C to exit):
Toggle the Beta feature flag in Azure portal to see real-time updates...

[14:30:15] Beta is enabled: false
[14:30:20] Beta is enabled: false
[14:30:25] Beta is enabled: false

Azure portal にサインインします。 [すべてのリソース] を選択し、前に作成した App Configuration ストアを選択します。
機能マネージャーを選択し、ベータ機能フラグを見つけます。 [有効] の下にあるチェックボックスをオンにして、フラグを 有効にします。
コンソールアプリケーションに戻ります。数秒後に、機能フラグの状態が変化します。
```
[14:30:30] Beta is enabled: false
[14:30:35] Beta is enabled: true
[14:30:40] Beta is enabled: true
```
Azure portal で機能フラグのオンとオフを切り替えて、コンソールアプリケーションで再起動せずにリアルタイムの更新プログラムを表示できます。
Ctrl キーを押しながら C キーを押してアプリケーションを停止します。

リソースをクリーンアップする

この記事で作成したリソースを継続して使用しない場合は、ここで作成したリソースグループを削除して課金されないようにしてください。

Von Bedeutung

リソースグループを削除すると、元に戻すことができません。リソースグループとそのすべてのリソースは完全に削除されます。間違ったリソースグループやリソースをうっかり削除しないようにしてください。この記事のリソースを、保持したい他のリソースを含むリソースグループ内に作成した場合は、リソースグループを削除する代わりに、各リソースをそれぞれのペインから個別に削除します。

Azure portal にサインインし、 [リソースグループ] を選択します。
[名前でフィルター] ボックスにリソースグループの名前を入力します。
結果一覧でリソースグループ名を選択し、概要を表示します。
[リソースグループの削除] を選択します。
リソースグループの削除の確認を求めるメッセージが表示されます。確認のためにリソースグループの名前を入力し、 [削除] を選択します。

しばらくすると、リソースグループとそのすべてのリソースが削除されます。

次のステップ

このクイックスタートでは、Azure App Configuration で機能フラグを作成し、Go コンソールアプリケーションで使用しました。 Feature Management Go ライブラリには、Azure App Configuration とシームレスに統合される豊富な機能フラグ機能が用意されています。その他の機能については、次のドキュメントに進んでください。

Go Feature 管理リファレンス

機能フラグを使用すると、アプリの機能をアクティブ化または非アクティブ化できますが、アプリのロジックに基づいて機能フラグをカスタマイズすることも必要になる場合があります。機能フィルターを使用すると、機能フラグを条件に応じて有効にできます。詳細については、次のチュートリアルに進んでください。

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

Azure App Configuration には、特定の期間またはアプリの特定の対象ユーザーに対してのみ機能フラグをアクティブ化できる組み込みの機能フィルターが用意されています。詳細については、次のチュートリアルに進んでください。

機能をスケジュールに従って有効にする

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

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-07-22