これまでのお話
前回の記事はこちら。
Azure Functionsを使ってサーバレスアーキテクチャのTwitter botサービスを作ろうとしたらPowerShellスクリプトの実行ポリシーでドはまりした。今回からはいよいよ開発に着手します、たぶん。
Azure Functionsのローカル・デバッグ実行でdotnet.exeが見つからない問題
前回の記事でAzure Functionsのローカル実行でできるようになったので試してみます。
dotnet.exeが見つからない
F5を押下してデバッグ実行したところ、次の表示がされました。よく読むとdotnet.exeが見つからないと言っています。
> Executing task: .venv\Scripts\python -m pip install -r requirements.txt <
Requirement already satisfied: azure-functions in simple-twitter-bot\.venv\lib\site-packages (from -r requirements.txt (line 5)) (1.7.0)
WARNING: You are using pip version 20.1.1; however, version 21.1.2 is available.
You should consider upgrading via the 'simple-twitter-bot\.venv\Scripts\python.exe -m pip install --upgrade pip' command.
Terminal will be reused by tasks, press any key to close it.
> Executing task: .venv\Scripts\activate ; func host start <
Found Python version 3.7.9 (python3).
Azure Functions Core Tools
Core Tools Version: 3.0.3477 Commit hash: 5fbb9a76fc00e4168f2cc90d6ff0afe5373afc6d (64-bit)
Function Runtime Version: 3.0.15584.0
[2021-06-15T15:10:42.877Z] File 'C:\Program Files\dotnet\dotnet.exe' is not found, 'dotnet' invocation will rely on the PATH environment variable.
[2021-06-15T15:10:43.460Z] File 'C:\Program Files\dotnet\dotnet.exe' is not found, 'dotnet' invocation will rely on the PATH environment variable.
[2021-06-15T15:10:43.721Z] File 'C:\Program Files\dotnet\dotnet.exe' is not found, 'dotnet' invocation will rely on the PATH environment variable.
Functions:
TimerTriggerTweet: timerTrigger
For detailed output, run func with --verbose flag.
[2021-06-15T15:10:46.530Z] Worker process started and initialized.
.Net Core 3系のインストール
MicrosoftのこのページによるとPythonを使う場合も.Netのruntimeが必要になるようです。当方のPythonは3.7だったので、最新の.Net Core 3系をインストールすることにしました。
インストールはこちらのページをご覧ください。当方は執筆時最新の.Net Core Runtime v3.1.16(x64)をインストールしました。
インストールして再び実行
再びVSCodeでF5を押下します。今回は無事Core Toolsが起動したようです。
> Executing task: .venv\Scripts\python -m pip install -r requirements.txt <
Requirement already satisfied: azure-functions in simple-twitter-bot\.venv\lib\site-packages (from -r requirements.txt (line 5)) (1.7.0)
WARNING: You are using pip version 20.1.1; however, version 21.1.2 is available.
You should consider upgrading via the '\simple-twitter-bot\.venv\Scripts\python.exe -m pip install --upgrade pip' command.
Terminal will be reused by tasks, press any key to close it.
> Executing task: .venv\Scripts\activate ; func host start <
Found Python version 3.7.9 (python3).
Azure Functions Core Tools
Core Tools Version: 3.0.3477 Commit hash: 5fbb9a76fc00e4168f2cc90d6ff0afe5373afc6d (64-bit)
Function Runtime Version: 3.0.15584.0
Functions:
TimerTriggerTweet: timerTrigger
For detailed output, run func with --verbose flag.
[2021-06-15T15:37:15.664Z] Worker process started and initialized.
Azure Functionsのローカル・デバッグ実行でStorage Accountに接続できない問題
F5を押下してCore Toolsを起動するたびに次のダイアログが表示されていました。これを解消するためにはAzure Storage Accountに接続するか、ローカルPCにストレージエミュレーターをインストールする必要があります。
余談ですが、このダイアログはTimerTriggerの場合に表示されるようです。
ストレージエミュレーターの構築
Learn moreボタンを押下すると次のページに遷移しました。こちらを参考にしてAzureのストレージエミュレーターを構築します。
具体的には上記のURLに「スタンドアロンのインストーラー」へのリンクが張ってあるので、それをクリックしてインストーラーをダウンロードしてインストールするだけです。そうするとMicrosoft Azure Storage Emulatorがインストールされるのでクリックしてください。
クリックするとコマンドプロンプトが立ち上がるのですが、エミュレーターの起動に失敗しました。どうやら初回仕様時にSQL Serverを指定してAzureStorageEmulator.exe initコマンドを実行しなければならないようです。Microsoft SQL ServerがローカルPCにインストールされている必要があり、Azure Storage EmulatorはそのSQLサーバーとAzure Core Toolsの接続を行ってくれるツールのようです。コマンドは以下のURLからご確認ください。
ローカルPCにSQL Serverを構築するのが面倒なのでこの手法はここで諦めました。どちらにしても最終的にAzureにFunctionsをデプロイするので、Azure Storage Accountを作成してそこに直接つなぐことにします。
Azure Storage Accountの作成
今回はこちらの記事を参考にVSCodeからAzure上にAzure Functionsリソースを作成します。Azure Functionsを作成するとAzure Storage Accountも同時に作成されます。
VSCodeからAzure Functionsサービスの作成
VSCodeでアジュールのマークを押下します。
続いて、FUNCTIONSと文字列があるところに5つアイコンが並んでいますが、真ん中の雲に上矢印（↑）のあるアイコンを押下します。そうすると、VSCodeでチュートリアルのようなものが始まるのでそれに従って入力します。まずはAzureへのサインインでした。（この辺はバージョンによって変わるので適宜対応してください。）
続いて、新しいFunctsionsを作成するか聞かれました。今回はCreate new Functions App in Azure...を選択しました。
Pythonのラインタイムが聞かれたのでローカルPCにインストールしているバージョンを記載するとよいと思います。
適宜対応してください。Azure Functionsリソースを作成すると、リソースグループと次のリソースが作成されます。
- App Service プラン
- Application Insights
- Azure Functions
- Azure Storage Account
VSCodeから作成するとAzure FunctionsがApp Serviceプランで作成されるようです。Azure Portalでの表示を抜粋します。App ServiceプランはVMを借りるのと同じだと考えるとよいと思います。コストを考えると従量課金プランが望ましいのでイマイチですね。従量課金プランがサーバーレス・アーキテクチャに近しいと思います。（すみません、ちゃんとわかってないです。）
Azure PortalからAzure Functionsを従量課金プランで作成する
VSCodeからAzure Functionsリソースを作成したところ、App Serviceプランで作成されたのでAzure Portalからリソースを作成することにします。先ほど作成したリソースはリソースグループごと削除しました。
なお、Create new Functions App in Azure...Adbancedを選択すると選べるのかもしれませんが、今回は調査しませんでした。
Azure PortalでAzure Functionsを作成
リソースグループを作成し、そこでAzure Functionsリソースを生成します。リソースの追加でAzure Functionsを選択してください。日本語名は関数アプリでした。
ホスティングで「プラン」→「プランの種類」→「消費量（サーバーレス）」を選択してください。
移行はデフォルトの設定で作成しました。
VSCodeからプロジェクトをデプロイする
VSCodeのAzureボタンを押下してDeploy to Function App...を押下します。先ほど作成したAzure Functionsリソースが選択できるようになります。（白色で塗りつぶしているところに表示されます。）それを押下してください。
ダイアログが表示され、デプロイされるか問われます。大丈夫だったらDeployボタンを押下します。
VSCodeの向かって右下に次の表示がなされます。デプロイ中のようです。
完了すると次の表示になります。
ローカル実行時にAzure Storage Accountに接続するための設定
Azure PortalからStorage Accountの接続文字列を取得します。ストレージアカウントのアクセスキー画面に遷移してください。キーの表示ボタンを押下して接続文字列を表示しコピーしてください。
local.settings.jsonにAzureWebJobsStorageというキーがあります。
{
"IsEncrypted": false,
"Values": {
"AzureWebJobsStorage": "UseDevelopmentStorage=true",
"FUNCTIONS_WORKER_RUNTIME": "python",
(以下略)
先ほどコピーした接続文字列を貼り付けてください。
{
"IsEncrypted": false,
"Values": {
"AzureWebJobsStorage": "<Azure Storage Accountの接続文字列>",
"FUNCTIONS_WORKER_RUNTIME": "python",
(以下略)
F5を押下してローカルデバッグ実行します。今度はダイアログが表示されることなく実行できました。
> Executing task: .venv\Scripts\python -m pip install -r requirements.txt <
Requirement already satisfied: azure-functions in \simple-twitter-bot\.venv\lib\site-packages (from -r requirements.txt (line 5)) (1.7.0)
WARNING: You are using pip version 20.1.1; however, version 21.1.2 is available.
You should consider upgrading via the '\simple-twitter-bot\.venv\Scripts\python.exe -m pip install --upgrade pip' command.
Terminal will be reused by tasks, press any key to close it.
> Executing task: .venv\Scripts\activate ; func host start <
Found Python version 3.7.9 (python3).
Azure Functions Core Tools
Core Tools Version: 3.0.3477 Commit hash: 5fbb9a76fc00e4168f2cc90d6ff0afe5373afc6d (64-bit)
Function Runtime Version: 3.0.15584.0
Functions:
TimerTriggerTweet: timerTrigger
For detailed output, run func with --verbose flag.
[2021-06-19T13:12:48.026Z] Worker process started and initialized.
[2021-06-19T13:12:50.482Z] Host lock lease acquired by instance ID '000000000000000000000000919C9F3E'.
関数のデバッグ実行
TimerTriggerの関数はF5でデバッグ実行してしばらく待つと実行されますが、意思を持って実行する方法を解説します。
Core Toolsを実行したまま、VSCodeのアジュールアイコンを押下し、Azure:Functions領域に移動し、実行したい関数を選んで（今回の場合はTimerTriggerTweet）右クリック、Execute Function Now...を押下します。
コンソールに次のようなログが表示されました。
[2021-06-21T14:49:53.294Z] Executing 'Functions.TimerTriggerTweet' (Reason='This function was programmatically called via the host APIs.', Id=121725c7-d3c2-4fea-9436-22095b5cb57b)
[2021-06-21T14:49:53.304Z] Python timer trigger function ran at 2021-06-21T14:49:53.301974+00:00
[2021-06-21T14:49:53.308Z] Executed 'Functions.TimerTriggerTweet' (Succeeded, Id=121725c7-d3c2-4fea-9436-22095b5cb57b, Duration=171ms)
まとめ
プロジェクトをAzureにFunctionsリソースを作成し、そこにプロジェクトをデプロイしました。Azure Storage Accountの接続文字列をローカル実行の設定に追加し、ローカル・デバッグ実行することができました。次回はいよいよコードを書きます。