クイックスタート: Azure App Configuration を使用して Azure Functions アプリを作成する

2025-07-22

このクイックスタートでは、Azure App Configuration を使用して、コードの外部で Azure Functions アプリケーション設定を一元化および管理する方法について説明します。 .NET 構成プロバイダーの統合により、いくつかの簡単なコード変更だけで、追加の構成ソースとして App Configuration を追加できます。

前提条件

アクティブなサブスクリプションが含まれる Azure アカウント。無料で作成できます。
"App Configuration ストアは、ストアを作成するためのチュートリアルに示されているように設置されています。"
Visual Studio と Azure 開発ワークロード。
Azure Functions ツール。

キーと値を追加する

App Configuration ストアに次のキーと値を追加し、[ラベル] と [コンテンツのタイプ] を既定値のままにします。 Azure portal または CLI を使用してストアにキーと値を追加する方法の詳細については、キーと値の作成に関する記事を参照してください。

Key	値
TestApp:Settings:Message	Azure App Configuration からのデータ

関数アプリを作成する

Azure Functions (C#) テンプレートを選択して、Visual Studio を使用して Azure Functions アプリを作成します。このテンプレートでは、プロジェクトの重要な設定を構成する手順について説明します。詳細な手順については、 Visual Studio を使用した Azure Functions の開発に関するページを参照してください。

関数アプリを作成するときに、キーパラメーターの参照として次の表を使用します。

設定	値
関数作業者	.NET 8.0 分離
機能	HTTP トリガー
承認レベル	アノニマス

注

Azure App Configuration は、分離されたワーカーモデルまたはインプロセスモデルのいずれかで Azure Functions と共に使用できます。このクイックスタートでは、分離されたワーカーモデルを例として使用します。両方のモデルの完全なコード例は、 Azure App Configuration GitHub リポジトリにあります。

App Configuration ストアに接続する

Microsoft Entra ID (推奨) または接続文字列を使用して App Configuration ストアに接続できます。

プロジェクトを右クリックし、[NuGet パッケージの管理] を選択します。 [ 参照 ] タブで、次の NuGet パッケージの最新の安定バージョンを検索してプロジェクトに追加します。
- Microsoft Entra ID (推奨)
- 接続文字列
- Microsoft.Azure.AppConfiguration.Functions.Worker
- Azure.Identity
- Microsoft.Azure.AppConfiguration.Functions.Worker

Program.csを開き、次のようにコードを更新します。 AddAzureAppConfiguration メソッドを呼び出して、追加の構成ソースとして Azure App Configuration を追加します。

Microsoft Entra ID (推奨)
接続文字列

DefaultAzureCredential を使って、App Configuration ストアに対する認証を行います。手順に従い、あなたの資格情報にApp Configuration データリーダー役割を割り当ててください。アプリケーションを実行する前に、アクセス許可が伝わるのに十分な時間をおいてください。

using Azure.Identity;
using Microsoft.Azure.Functions.Worker.Builder;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Hosting;

var builder = FunctionsApplication.CreateBuilder(args);

// Connect to Azure App Configuration
builder.Configuration.AddAzureAppConfiguration(options =>
{
    Uri endpoint = new(Environment.GetEnvironmentVariable("AZURE_APPCONFIG_ENDPOINT") ?? 
        throw new InvalidOperationException("The environment variable 'AZURE_APPCONFIG_ENDPOINT' is not set or is empty."));
    options.Connect(endpoint, new DefaultAzureCredential())
           // Load all keys that start with `TestApp:` and have no label
           .Select("TestApp:*");
});

using Microsoft.Azure.Functions.Worker.Builder;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Hosting;

var builder = FunctionsApplication.CreateBuilder(args);

// Connect to Azure App Configuration
builder.Configuration.AddAzureAppConfiguration(options =>
{
    string connectionString = Environment.GetEnvironmentVariable("AZURE_APPCONFIG_CONNECTION_STRING") ?? 
        throw new InvalidOperationException("The environment variable 'AZURE_APPCONFIG_CONNECTION_STRING' is not set or is empty.");
    options.Connect(connectionString)
           // Load all keys that start with `TestApp:` and have no label
           .Select("TestApp:*");
});

Function1.csを開き、次の名前空間を追加します。

using Microsoft.Extensions.Configuration;

依存関係の挿入を通じて IConfiguration のインスタンスを取得するようにコンストラクターを更新します。

private readonly IConfiguration _configuration;
private readonly ILogger<Function1> _logger;

public Function1(IConfiguration configuration, ILogger<Function1> logger)
{
    _configuration = configuration;
    _logger = logger;
}

構成から値を読み取るように Run メソッドを更新します。

[Function("Function1")]
public IActionResult Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequest req)
{
    _logger.LogInformation("C# HTTP trigger function processed a request.");

    // Read configuration data
    string key = "TestApp:Settings:Message";
    string? message = _configuration[key];

    return new OkObjectResult(message ?? $"Please create a key-value with the key '{key}' in Azure App Configuration.");
}

関数をローカルでテストする

環境変数を設定します。
- Microsoft Entra ID (推奨)
- 接続文字列
AZURE_APPCONFIG_ENDPOINTという名前の環境変数を、Azure portal のストアの概要にある App Configuration ストアのエンドポイントに設定します。

Windows コマンドプロンプトを使用する場合は、次のコマンドを実行してコマンドプロンプトを再起動し、変更が反映されるようにします。
```
setx AZURE_APPCONFIG_ENDPOINT "<endpoint-of-your-app-configuration-store>"
```
PowerShell を使用する場合は、次のコマンドを実行します。
```
$Env:AZURE_APPCONFIG_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
```
macOS または Linux を使用する場合は、次のコマンドを実行します。
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
AZURE_APPCONFIG_CONNECTION_STRINGという名前の環境変数を、Azure portal のストアの [アクセス設定] の下にある App Configuration ストアの読み取り専用接続文字列に設定します。

Windows コマンドプロンプトを使用する場合は、次のコマンドを実行してコマンドプロンプトを再起動し、変更が反映されるようにします。
```
setx AZURE_APPCONFIG_CONNECTION_STRING "<connection-string-of-your-app-configuration-store>"
```
PowerShell を使用する場合は、次のコマンドを実行します。
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING = "<connection-string-of-your-app-configuration-store>"
```
macOS または Linux を使用する場合は、次のコマンドを実行します。
```
export AZURE_APPCONFIG_CONNECTION_STRING='<connection-string-of-your-app-configuration-store>'
```
F5 キーを押して関数をテストします。メッセージが表示されたら、Visual Studio からの要求に同意し、Azure Functions Core (CLI) ツールをダウンロードしてインストールします。また、ツールで HTTP 要求を処理できるように、ファイアウォールの例外を有効にすることが必要になる場合もあります。
Azure Functions のランタイムの出力から、関数の URL をコピーします。
HTTP 要求の URL をブラウザーのアドレスバーに貼り付けます。関数によって返されたローカルの GET 要求に対するブラウザーでの応答を次の図に示します。

App Configuration 参照を使用してトリガーパラメーターを管理する

Azure Functions トリガーは、関数の呼び出し方法を定義します。キュー名やデータベース名などのトリガー属性は、ホストの起動時に読み込まれ、Azure App Configuration から値を直接取得することはできません。これらのパラメーターを管理するには、Azure Functions と App Service で使用できる App Configuration リファレンス機能を使用できます。

App Configuration リファレンス機能を使用すると、Azure App Configuration に格納されているキー値をアプリケーション設定から直接参照できます。 Azure Functions は起動時にこれらの参照を解決し、トリガーパラメーターを一元的かつ安全に管理できるようにします。

たとえば、キューによってトリガーされる関数アプリについて考えてみましょう。トリガー属性でキュー名を直接指定する代わりに、Azure App Configuration に格納されているキー値を参照できます。

Azure App Configuration ストアで、キュー名のキー値を追加します。

Key 値

TestApp:Storage:QueueName <ストレージアカウント内のキュー名>
関数アプリで、Azure portal で [設定] ->[Environment 変数] ->[App settings] を選択し、App Configuration キーを参照するアプリケーション設定を作成します。

名前値

MyQueueName @Microsoft.AppConfiguration(Endpoint=<your-store-endpoint>; Key=TestApp:Storage:QueueName)

ヒント

Azure App Configuration に複数のキー値がある場合は、Azure portal または CLI を使用して、それらを Azure Functions への App Configuration 参照としてバッチでエクスポートできます。
Azure Functions アプリのマネージド ID を有効にし、App Configuration ストアの App Configuration データ閲覧者 ロールを割り当てます。 App Configuration 参照を設定する方法の詳細については、「 App Service と Azure Functions で App Configuration 参照を使用する」を参照してください。
アプリケーション設定を使用するように、キューによってトリガーされる関数を更新します。
```
[Function("QueueTriggeredFunction")]
public void Run([QueueTrigger(queueName: "%MyQueueName%")] QueueMessage message)
{
    _logger.LogInformation($"C# Queue trigger function processed: {message.MessageText}");
}
```
実行時に、Azure Functions は、 %MyQueueName% プレースホルダーを Azure App Configuration に格納されている値に解決します。これにより、トリガーパラメーターを関数コードにハードコーディングすることなく一元的に管理できます。

Key	値
TestApp:Storage:QueueName	<ストレージアカウント内のキュー名>

名前	値
MyQueueName	`@Microsoft.AppConfiguration(Endpoint=<your-store-endpoint>; Key=TestApp:Storage:QueueName)`

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

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

重要

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

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

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

次のステップ

このクイックスタートでは、Azure App Configuration と Azure Functions アプリを統合しました。関数アプリで構成設定を動的に更新できるようにする方法については、次のチュートリアルに進んでください。

Azure Functions で動的な構成を有効にする

Azure Functions アプリ内で Azure App Configuration の機能フラグを使用する方法については、次のチュートリアルに進んでください。

Azure Functions で機能フラグを使用する

Azure マネージド ID を使用して App Configuration へのアクセスを効率化する方法については、次のチュートリアルに進んでください。

マネージド ID を使用して App Configuration にアクセスする

次の方法で共有

クイック スタート: Azure App Configuration を使用して Azure Functions アプリを作成する