Azure関数コアツールを使用したローカル開発のためのアプリケーション設定の取得


更新:あなたが読書にビデオを見て好むならば、私はこの内容をカバーする私のビデオを作りました
Azure関数を展開する前に、期待通りに動作するように、ローカルの関数をデバッグするのが良いです.ローカル関数をローカルで実行する必要があります.設定.JSONファイルは、アプリケーションの設定を格納します.
最初にVisual Studioでローカル関数を作成します.設定.JSONファイルが生成されます.しかし、我々はリポジトリから関数のアプリをクローンする場合は、このファイルはクローンされません!(うまくいけば、それはクローンされません.それはアプリケーション秘密を持っているので、あなたのレポにこのファイルをコミットするのは良い習慣です)!
ありがたいことに、Azure関数のコアツールを使用してローカルを作成できます.設定.JSONファイルと私たちの関数設定をそのファイルにインポートするので、ローカルの機能を実行することができます.

なぜ、我々はこれをしますか?


複数の環境( dev , test , uatなど)を持っていて、環境設定を使って関数をローカルでデバッグしたい場合は、azure function core toolsを使って設定を簡単にすることができます.特に多くの設定を持っている機能のために.我々は、コピーして、すべてのそれらのセッティングをペーストする我々の時間を浪費したくありません!

始める前に


あなたはそれを確認する必要がありますAzure Function Core Tools あなたのマシンにインストールされている.Azure関数のコアツールは、私たちのマシン上で実行できるAzure関数ランタイムに対して同じ実行時のバージョンを含みます.
我々はちょうど我々のアプリケーションの設定を取得することに焦点を当てているが、関数のコアツールは、私たちの機能を作成することができますコマンドが付属して、私たちの機能を展開し、もっと!
ツールをまだインストールしていない場合は、チェックアウトthis documentation 始める.

始めましょう


このチュートリアルでは、Githubから既存のプロジェクトの1つをクローンしました.私はすでにAzureと私のこの機能を展開しました.gitignoreファイルはローカルを除外します.設定.プロジェクトを作成したときに生成されたJSONファイル.
ローカルデバッグを手伝うために、私はAzureから私のアプリセッティングを取り出すのを助けるために、機能芯ツールを使用するつもりです.ローカル設定ファイルがマイプロジェクトディレクトリにないことを確認するには、次のようにします.

我々のアプリケーションの設定を書くためにJSONファイルを作成する必要があります.これを行うには、関数プロジェクトを右クリックし、新しいファイルを作成します.JavaScriptのJSON設定ファイルを作成し、ローカルの名前を付けます.設定.JSON

ステップ1:当社のazureサブスクリプションを設定します


複数のAzureサブスクリプションで動作する場合は、AZ CLIを使用して関数コアツールを実行すると、適切な場所を確認する必要があります.
マシン上のコマンドラインまたはpowershellを開き、次のコマンドを実行してazureアカウントにログインします.
az login
ログインしたら、あなたがアクセスするサブスクリプションのリストを見るべきです.関数がホストされているサブスクリプションを設定するには、次のコマンドを実行します.
az account set -s "<subscription-name-or-id>"
- sサブスクリプションの短縮パラメータです.

ステップ2:アプリの設定を取得


今、我々はAzureの我々の機能アプリから我々のアプリの設定を取得することができます.プロジェクトのディレクトリにあることを確認し、次のコマンドを端末で実行します.
func azure functionapp fetch-app-settings '<function-name>' --output-file local.settings.json
端末の出力は次のようになります.

Visual Studioのプロジェクトに戻って、ローカルチェックアウトしてください.設定.JSONファイル.我々の機能の設定を取得し、ローカル設定ファイルに書き込まれていることがわかります!
しかし、1つだけ問題があります.

我々の設定は暗号化されます!それは私たちの機能をローカルに実行するときに役立つつもりはない!関数のアプリケーションの設定は、保存時に暗号化され、あなたの関数のプロセスメモリに注入される前にのみ復号化されます.
Azure関数のアプリケーション設定については、こちらをご覧くださいarticle .

ステップ3:設定を復号化します。


ありがたいことに、我々は設定Azure機能コアツールを使用して設定を復号化することができます!端末で次のコマンドを実行します.
func settings decrypt
Visual Studioに頭を戻すし、設定を復号化されているし、ローカルデバッグのニーズに使用する準備ができて表示されます!
(もちろん、私はあなたのスクリーンショットを与えるつもりはない!😂😉).
我々は現在、我々は我々のazure環境に対してそれを実行していたかのようにローカルで機能を起動することができます!
ここで注意する1つのもの!キーVaultにあなたのアプリケーション設定のいくつかを格納しているなら、それから、あなたがセッティングを取り戻すとき、あなたは秘密が格納されるキーVault URLを得るかもしれません.実際の値を使用するには、キーVaultからこれを取得する必要があります.

ラッピング


ご覧のように、Azure関数コアツールを使用すると、すぐに私たちの関数のアプリケーションの設定を取得できるようにすることによって、我々の開発プロセスをスピードアップすることができます.
もっと知りたい場合は、次のリソースをチェックしてください.
  • Work with Azure Functions Core Tools
  • Azure Functions Core Tools GitHub
  • 何か質問があれば、私に連絡したり、コメントを聞いてください!
    ハッピーコーディング!👨‍💻👩‍💻💻