クイックスタート: Spring Boot アプリに機能フラグを追加する

このクイックスタートでは、Azure App Configurationで機能フラグを作成し、それを使用して Spring Boot アプリを動的に制御し、機能管理のエンドツーエンドの実装を作成します。

Spring Boot Feature Management ライブラリは、Azure ライブラリに依存<>しません。また、Spring Boot 構成プロバイダーを介して、App Configuration とシームレスに統合されます。

前提条件

アクティブなサブスクリプションが含まれる Azure アカウント。無料で作成できます。
"App Configuration ストアは、ストアを作成するためのチュートリアルに示されているように設置されています。"
バージョン 17 でサポートされている Java Development Kit SDK 。
Apache Maven バージョン 3.0 以降。

機能フラグを追加する

Beta という機能フラグを App Configuration ストアに追加し、[ラベル] と [説明] を既定値のままにします。 Azure portal または CLI を使用してストアに機能フラグを追加する方法の詳細については、「機能フラグを作成する」を参照してください。この段階で、[機能フラグを有効にする] チェックボックスをオフにする必要があります。

コンソールアプリを作成する

新しい Spring Boot プロジェクトを作成します。
1. Spring Initializr に移動します。
2. 次のオプションを指定します。
  - Java で Maven プロジェクトを生成します。
  - 3.0 以上の Spring Boot バージョンを指定します。
  - アプリケーションのグループ (Group) と成果物 (Artifact) の名前を指定します。この記事では、com.example と demo を使用します。
3. 前の各オプションを指定してから、[プロジェクトの生成] を選択します。ローカルコンピューターにプロジェクトをダウンロードして展開します。
アプリのルートディレクトリで pom.xml を見つけて、テキストエディターで開きます。

<dependencies>の一覧に次を追加します。

<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-appconfiguration-config</artifactId>
</dependency>
<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-feature-management</artifactId>
</dependency>

Spring Cloud Azure ライブラリのバージョンを管理するには、次の <dependencyManagement> セクションを追加します。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.azure.spring</groupId>
            <artifactId>spring-cloud-azure-dependencies</artifactId>
            <version>7.2.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

アプリの resources ディレクトリに移動し、application.properties または application.yaml ファイルを開きます。

DefaultAzureCredential を使って、App Configuration ストアに対する認証を行います。承認を機能させるには、アプリが使用する資格情報に アプリ構成データ閲覧者 ロールを付与する必要があります。手順については、「トークン資格情報を使用した認証」を参照してください。アプリケーションを実行する前に、アクセス許可が反映されるまでの十分な時間を確保してください。
- プロパティ
- YAML
```
spring.config.import=azureAppConfiguration
spring.cloud.azure.appconfiguration.stores[0].endpoint= ${AZURE_APPCONFIG_ENDPOINT}
spring.cloud.azure.appconfiguration.stores[0].feature-flags.enabled=true
```
```
spring:
  config:
    import: azureAppConfiguration
  cloud:
    azure:
      appconfiguration:
        stores:
          - endpoint: ${AZURE_APPCONFIG_ENDPOINT}
            feature-flags:
              enabled: true
```

次のコードを使用して、アプリのパッケージディレクトリ内の DemoApplication.java ファイルを更新します。

import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;

import com.azure.spring.cloud.feature.management.FeatureManager;

@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

    @Bean
    public CommandLineRunner runner(FeatureManager featureManager) {
        return args -> {
            System.out.println("Beta is enabled: " + featureManager.isEnabled("Beta"));
        };
    }
}

AZURE_APPCONFIG_ENDPOINTという名前の環境変数を設定し、App Configuration ストアのエンドポイントに設定します。コマンドラインで次のコマンドを実行してコマンドプロンプトを再起動し、変更が反映されるようにします。
```
setx AZURE_APPCONFIG_ENDPOINT "<endpoint-of-your-app-configuration-store>"
```
変更を有効にするために、コマンドプロンプトを再起動します。この環境変数の値を出力して、正しく設定されていることを確認します。
```
$Env:AZURE_APPCONFIG_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
```
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
変更を有効にするために、コマンドプロンプトを再起動します。この環境変数の値を出力して、正しく設定されていることを確認します。
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
変更を有効にするために、コマンドプロンプトを再起動します。この環境変数の値を出力して、正しく設定されていることを確認します。
Maven を使用して Spring Boot アプリケーションをビルドして実行します。
```
mvn clean package
mvn spring-boot:run
```
App Configuration ポータルで [機能マネージャー] を選択し、[有効化] 列のトグルを使用して、Beta 機能フラグの状態をオンに変更します。

鍵状態

ベータ On
アプリケーションを再起動しますアプリケーションによって次の内容が出力されます。
```
Beta is enabled: true
```

鍵	状態
ベータ	On

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

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

重要

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

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

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

次のステップ

このクイックスタートでは、新しい App Configuration ストアを作成し、それを使用して機能管理ライブラリを使用して Spring Boot アプリの機能を管理しました。

機能管理の詳細を確認します。
機能フラグを管理します。

フィードバック

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

Last updated on 2026-05-07