Azure Serverless ワークショップ Deep Dive : モジュール 1 - 2
ハロウィーン楽しんでますか？
今回は Serverless Conf 開催記念ということで、GitHub 上にある Azure Serverless ワークショップの Deep Dive をやります。各モジュール事に、まずワークショップをやってからこちらをご覧ください。
GitHub: Azure Serverless Workshop 日本語版
ワークショップの概要
このワークショップはボットをフロントエンドに使い、バックエンドに各種 Azure Serverless テクノロジーを使っています。各モジュールごとにボットが強化されていく様は、なかなか面白いです。ユーザーがボットにタスク(コマンド)を送ると、ボットが必要なことを聞いてくるので、すべて返信すると結果が返される仕組みです。
前提条件
Windows でも Mac でも動作するように作られています。必要なものはワークショップの手順にあるのでそちらを参照。このブログでは、Windows ベースでの検証をします。
モジュール 1
ワークショップの紹介と事前準備だけのため、Deep Dive 不要。Visual Studio 2017 など各種ツールは最新にすることを推奨します。
モジュール 2 モジュール 2 では Azure ファンクションの作成が学べます。
Azure Functions Core Tools (@core)
Azure Function Core Tools は .NET Core で動作する Azure Function を作成したり実行できるツールです。実はこのツールバージョン 2 であり、Windows 環境用にバージョン 1 もあります。挙動が違いますがコマンドが同じため間違えると面倒です。必ず以下コマンドでモジュールをインストールしてください。
npm install -g azure-functions-core-tools@core
以下、簡単な見分け方です。
- func new とした時の言語選択 : 今日時点でバージョン 2 は選択肢が C# と JavaScript のみだが、バージョン 1 は豊富。
- application.json と local.settings.json : バージョン 1 は構成ファイルとして application.json を作成するが、バージョン 2 は local.settings.json
ここさえ間違えなければほぼ大丈夫です。
デバッグ方法
ワークショップでは紹介していないものとして、VSCode でのデバッグがあります。
1. 以下のコマンドで Azure ファンクションを起動。
func host start --debug vscode
2. VSCode を起動して、デバッグメニューを開く。Attach to Azure Functions があるので、そのまま F5 押下。
3. ブレークポイントを張って、Postman 等でアクセス。ブレークポイントにヒットするか確認。
C# での Azure ファンクション
ワークショップの最後に C# もやってみてくださいとあるので、Visual Studio 2017 と C# で同じ Azure ファンクションを作成します。
1. 新しいプロジェクトより、”Azure Funcitons" を選択。名前を任意で作成。ここでは ”MyFunctions” にして作成。
2. プロジェクト右クリック | 追加 | 新しい項目 より、”Azure 関数” を “LanceFetcher.cs” として追加。
3. Azure ファンクションは様々な方法で呼び出しが可能。ここでは Http trigger を選択。また権限はだれでも実行できるように Anonymous を選択。
3. 作成されたテンプレートにはサンプルコードがあるため、内容を確認。やり方が分かった所で以下のコードに差し替え。
using System.Linq;
using System.Net;
using System.Net.Http;
using System.Threading.Tasks;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.Azure.WebJobs.Host;
using System.Net.Http.Formatting;
using Newtonsoft.Json.Linq;
namespace MyFunctions
{
public static class LanceFetcher
{
[FunctionName("LanceFetcher")]
public static async Task<HttpResponseMessage> Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)]HttpRequestMessage req, TraceWriter log)
{
log.Info("C# HTTP trigger function processed a request.");
dynamic data = await req.Content.ReadAsAsync<object>();
// Body を確認。
if (data != null)
{
const string long_lance = @"
TTT
TTTTTTTTT
TTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTT
TTTTTTTTT
TTT";
const string short_lance = @"
TTT
TTTTTTTTTTTT
TTT";
var material = data?.lance_material == "wood" ? "w" : "m";
var lance = data?.lance_length == "short" ? short_lance.Replace("T", material) : long_lance.Replace("T", material);
JObject resData = new JObject();
resData["message"] = $"Here's your lance! {lance}";
return req.CreateResponse(HttpStatusCode.OK, resData, JsonMediaTypeFormatter.DefaultMediaType);
}
else
{
return req.CreateResponse(HttpStatusCode.BadRequest, "I couldn't figure out how to do that...");
}
}
}
}
4. F5 を押下してデバッグ。起動するとコンソールで以下の表示。Azure 関数が起動した URI を確認。
5. Postman で POST を実行。結果を確認。
6. デバッグはいつも通りなので割愛。
まとめ
今回はモジュール 2 までの内容を深堀してみました。次回はモジュール 3 の紹介と Deep Dive を紹介します。
中村 憲一郎