表題の件に関して、以下の想定で記載しています。

• Azure Functions Runtime v2.x 以降
• .NET Core 3.1

アプリケーション設定 とはAzure Functionsを動かす際に参照する各種設定値です。 その値はAzure PortalでAzure Functionsの構成ページを開くと確認できます。 下図はその一例です。

Azure Functionsのプロジェクトには開発環境でのアプリケーション設定を示す local.settings.json ファイルが登場します。 このファイルには例えばAzure Functionsが接続するAzure Storageを示す AzureWebJobsStorage などの項目があります。

例えばその AzureWebJobsStorage は以下のように記述すると接続先がAzure Storageエミュレーターになります。

1
2
3
4
5
6
7

{
  "IsEncrypted": false,
  "Values": {
	"AzureWebJobsStorage": "UseDevelopmentStorage=true",
	"FUNCTIONS_WORKER_RUNTIME": "dotnet"
  }
}

開発方法によってはエミュレーターではなく実際にAzure Storageに接続することもあるでしょう。その場合は下記のように記載します。¹

1
2
3
4
5
6
7

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=xxxxx;AccountKey=xxxxxxx;EndpointSuffix=core.windows.net",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet"
  }
}

その他については下記ををご参照ください。

• ローカル設定ファイル - Azure Functions Core Tools の操作 | Microsoft Docs

host.json の値は local.settings.json で上書きが可能です。

以下はApplication Insightsの設定を開発環境では無効にするMSのリファレンスから引用した例です。

1
2
3
4
5
6
7
8

{
    "IsEncrypted": false,
    "Values": {
        "AzureWebJobsStorage": "{storage-account-connection-string}",
        "FUNCTIONS_WORKER_RUNTIME": "{language-runtime}",
        "AzureFunctionsJobHost__logging__applicationInsights__samplingSettings__isEnabled":"false"
    }
}

詳しくは下記をご参照ください。

• host.json 値をオーバーライドする - Azure Functions 2.x の host.json のリファレンス | Microsoft Docs

AzureでホスティングしているAzure Functionsのアプリケーション設定は以下のツールでローカルにコピーできます。

• Azure Functions Core Toolsが提供する fetch-app-settings コマンド

コマンドの説明は以下の通りです。

1
2
3
4
5
6
7

$ func azure functionapp

Usage: func azure functionapp <action> [-/--options]

Actions: 
fetch-app-settings  Retrieve App Settings from your Azure-hosted Function App and store locally Aliases: fetch-app-settings, fetch
    <FunctionAppName> Function App name

1
2
3
4
5
6
7
8

# Azureにログインしていないと ~fetch-app-settings~ は使えない。既にインストール済みなら不要です。
brew install azure-cli 

# Azure Functions Core ToolsはHomebrewのメインストリーム？には含まれていないので追加します。
brew tap azure/functions

# Azure Functions Core Toolsのインストール。
brew install azure-functions-core-tools@3

1

npm i -g azure-functions-cli

1
2
3
4
5
6
7
8

# Azure Functionsのhost.jsonが存在するディレクトリに移動します。
cd your-project 

# azure-cliを使ってログイン。もちろんログイン済みなら不要です。
az login 

# Azureからアプリケーション設定を取得してlocal.settings.jsonに保存します。
func azure functionapp fetch-app-settings example-hiroakit-com-api

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

{
  "IsEncrypted": true,
  "Values": {
    "APPINSIGHTS_INSTRUMENTATIONKEY": "ZeonZumDeikun==",
    "APPLICATIONINSIGHTS_CONNECTION_STRING": "ZeonZumDeikun==",
    "AzureWebJobsStorage": "ZeonZumDeikun==",
    "FUNCTIONS_EXTENSION_VERSION": "ZeonZumDeikun==",
    "FUNCTIONS_WORKER_RUNTIME": "ZeonZumDeikun==",
    "WEBSITE_CONTENTAZUREFILECONNECTIONSTRING": "ZeonZumDeikun==",
    "WEBSITE_CONTENTSHARE": "ZeonZumDeikun==",
    "SecretSetting": "CharAznable=="
  },
  "ConnectionStrings": {}
}

前述のlocal.settings.jsonを復号すると以下になったとします。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "IsEncrypted": false,
  "Values": {
    :
    <中略>
    :  
    "SecretSetting": "@Microsoft.KeyVault(SecretUri=シークレット識別子)"
  },
  "ConnectionStrings": {}
}

例として、C#で AzureWebJobsStorage の値を取得する場合を考えます。

• local.settings.json でAzureWebJobsStorageを上書きしている場合はこのファイルから読み取ります。
• host.json にしかAzureWebJobsStorageが存在しない場合はこのファイルから読み取ります。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

string value = string.Empty;

try
{
    value = Environment.GetEnvironmentVariable("AzureWebJobsStorage", EnvironmentVariableTarget.Process);
}
catch
{
    throw;
}

return value;

Environment.GetEnvironmentVariableで以下の例外が発生する可能性があるため、上記の例ではTry & Catchを入れています。

• ArgumentNullException
• ArgumentException
• SecurityException

同メソッドの第2引数で指定しているEnvironmentVariableTarget.Processに関しては例です。

以下を参考資料として活用しています。

1. ローカル設定ファイル - Azure Functions Core Tools の操作 | Microsoft Docs
2. host.json 値をオーバーライドする - Azure Functions 2.x の host.json のリファレンス | Microsoft Docs
3. Azure Functions のアプリケーション設定のリファレンス | Microsoft Docs
4. Environment.GetEnvironmentVariable Method (System) | Microsoft Docs
5. Install the Azure CLI for macOS | Microsoft Docs
6. Work with Azure Functions Core Tools | Microsoft Docs