Azure Functions の公式ドキュメントでは、C#スクリプトで開発する方法について多く記述されている。
Macで開発する場合、Windows のVisual StudioのようなAzure Function Toolsのようなツールが無い。Visual Studio for MacやVisual Studio Codeだと、C#スクリプトのシンタックスハイライトやコードジャンプのサポートが乏しいので、Azure Functions の開発が難しい。
幸いなことに、Azure Funtions はビルドしたC#のプロジェクトを実行することも可能。
そこで、ここではそのC# ソリューション、およびプロジェクトの作成手順について解説する。
前提条件
この記事は、下記のものが事前にインストール済みであることを前提に書いています。
- Azure Function
- デプロイ時に
funcコマンドでアプリケーション名を指定するため、予めプロビジョニングしておきます。 -
ランタイムバージョンは2.0
- デプロイ時に
- dotnet
- azure-function-core-tools
- Visual Studio Code
ソリューションの作成
まずは、ソリューションを作成する。
mkdir myFunctions
cd myFunctions
dotnet new sln
ソリューションはここまでで、肝心なFunctionのプロジェクトを作ります。
プロジェクトの作成
実際のFunctionを開発するためのプロジェクトを作成する。
ここではプロジェクト名をFunctionsとします。
dotnet new classlib -o Functions -n Function
dotnet sln ./myFunctions.sln add ./Functions/Function.csproj
Nuget Microsoft.Net.Sdk.Functions をFunctionsプロジェクトに追加します。
dotnet add Functions package Microsoft.Net.Sdk.Functions
この段階で使えるトリガーの種類は、リポジトリを見ると、
- BlobTrigger
- QueueTrigger
の2つが提供されているようです。
更に追加するには、
を追加することで出来そうです（未検証）。
Function の設定
ローカルで実行できるようにするため、func init で設定ファイルを生成します。
$ cd myFunctions/Function
$ func init
BlobトリガーのFunctionを作る
ここではとても簡単なFunctionを1つ作ります。
Blobストレージへアップロードされたファイル名とサイズをログに表示するだけのFunctionです。
using System;
using System.IO;
using Microsoft.WindowsAzure.Storage;
using Microsoft.Azure.WebJobs; // (1)
using Microsoft.Azure.WebJobs.Host; //
namespace Function
{
public class BlobTriggerFunction
{
[StorageAccount("MyBlobStorage")] // (2)
[FunctionName("BlobTriggerFunction")] // (3)
public static void Run(
[BlobTrigger("updated/{name}")] Stream myBlob, // (4)
string name, TraceWriter log)
{
log.Info($"Blob Trigger function processed: {name} ({myBlob.Length} KB)");
}
}
}
- アトリビュートを使えるようにするために、
Microsoft.Azure.WebJobsとMicrosoft.Azure.WebJobs.Hostを読み込み、 - Blobストレージへ接続するための接続文字列を持つ環境変数を指定して、
- ビルド時に生成されるFunction名を指定します。
ビルド
ビルドの前にlocal.settings.json の中に必要な環境変数が記述されていることを確認しましょう。
ここでは少なくともBlobトリガーを動かすために
MyBlobStorageAzureWebJobsStorageAzureWebJobsDashboard
が必要です。
ビルド後の修正
今の段階では、ビルドにより作成されたfunction.jsonはそのままでは使えず、2ヶ所修正が必要です。
{
"generatedBy": "Microsoft.NET.Sdk.Functions.Console-1.0.5",
"configurationSource": "attributes",
"bindings": [
{
"type": "blobTrigger",
"connection": "AzureWebJobsStorage",
"direction": "in", # (1)
"path": "uploaded/{name}",
"name": "myBlob"
}
],
"disabled": false,
"scriptFile": "../bin/Functions.dll", # (2)
"entryPoint": "Function.BlobTriggerFunction.Run"
}
1つめが、bindings.direction の追加です。Functionの入力なのか出力なのかを指定します。トリガーの場合は、入力なのでinを設定します。
2つめが、scriptFile。
ビルド時は、相対パスになっていないので、デプロイの前に相対パスに修正する必要がある。
修正しないままデプロイすると、Azure Portalの画面では認識されません。
ビルドする度に必要なので、面倒くさい… 
ローカルで実行する
func コマンドを使って起動できるか確認してみましょう。
$ cd bin/Debug/netstandard2.0
$ func host start
%%%%%%
%%%%%%
@ %%%%%% @
@@ %%%%%% @@
@@@ %%%%%%%%%%% @@@
@@ %%%%%%%%%% @@
@@ %%%% @@
@@ %%% @@
@@ %% @@
%%
%
[11/4/17 2:40:09 AM] Reading host configuration file '/Users/****/Projects/private/myFunctions/Functions/bin/Debug/netstandard2.0/host.json'
[11/4/17 2:40:09 AM] Host configuration file read:
[11/4/17 2:40:09 AM] { }
[11/4/17 2:40:10 AM] Generating 1 job function(s)
[11/4/17 2:40:10 AM] Starting Host (HostId=p40902-1763669228, Version=2.0.11308.0, ProcessId=55029, Debug=False, Attempt=0)
Listening on http://localhost:7071/
Hit CTRL-C to exit...
[11/4/17 2:40:10 AM] Found the following functions:
[11/4/17 2:40:10 AM] Function.BlobTriggerFunction.Run
[11/4/17 2:40:10 AM]
[11/4/17 2:40:10 AM] Host lock lease acquired by instance ID '000000000000000000000000E0CC05CB'.
[11/4/17 2:40:11 AM] Job host started
デプロイ
デプロイもそのままfuncコマンドで実行できます。
bin/Debug/netstandard2.0 に移動し、下記のコマンドを実行します。
$ func azure functionapp
ということで、C#スクリプトだとVisual Studio Codeがコード補完とかサポートしてなかったり、パッケージのインストールに癖があったりとするのが、C#のコードとして扱えるようになりました。