先日開催されたde:code 2018の初日、牛尾さんのワタシハ Azure Functions チョットデキルというセッションに参加しました。
スライドはこちら
www.slideshare.net
Run-From-Zip Deploymentとは
Azure Functionsを従量課金プラン(Consumption Plan)で利用する場合、しばらく実行されていない関数に対してリソース節約のために「寝る」状態になります。
これを「Cold Start」という言葉で表現され、関数が実行するまでに待ち時間が発生します。
Azure Functionsを従量課金プランで利用する場合に考慮すべきアーキテクチャのポイントでもあります。
github.com
このCold Start状態の関数のパフォーマンスを改善する仕組みとして「Run-From-Zip Deployment」を使いましょうと牛尾さんの紹介がありました。
デプロイ方法
その名の通り、Zipファイルを使ってデプロイします。
しかし従来のやり方である、App ServiceのKuduにアクセスしZipをアップロードする方法ではありません。
- 関数ファイルを含んだZipファイルを作成する。
- HTTP(s)経由でアクセス可能な場所にZipファイルをアップロードする。(Azure Blob Storageなど)
- Azure Functionsの環境変数に
WEBSITE_RUN_FROM_ZIP={ZipファイルのURL}
を指定する。
この3つの手順でRun-From-Zip Deploymentを行うことができます。
というところまでは簡単ですが、Zipファイルの構成をどうやるんだろうと疑問に思ったのでde:codeもくもく会で実際に試してみました。
牛尾さんからもアドバイスを頂きました。
C#スクリプトとNode.jsの関数でのRun-From-Zip Deployment
Azure FunctionsでC#スクリプトとNode.jsの関数を作成し、コンテンツをダウンロードすると、下記の構成のZipファイルがダウンロードされます。
$ tree
/path/to/yutadfmokumoku
|--bin
| |--de
| | |--Microsoft.Data.Edm.resources.dll
| | |--Microsoft.Data.OData.resources.dll
| | |--System.Spatial.resources.dll
| |--es
| | |--Microsoft.Data.Edm.resources.dll
| | |--Microsoft.Data.OData.resources.dll
| | |--System.Spatial.resources.dll
| |--fr
| | |--Microsoft.Data.Edm.resources.dll
| | |--Microsoft.Data.OData.resources.dll
| | |--System.Spatial.resources.dll
| |--it
| | |--Microsoft.Data.Edm.resources.dll
| | |--Microsoft.Data.OData.resources.dll
| | |--System.Spatial.resources.dll
| |--ja
| | |--Microsoft.Data.Edm.resources.dll
| | |--Microsoft.Data.OData.resources.dll
| | |--System.Spatial.resources.dll
| |--ko
| | |--Microsoft.Data.Edm.resources.dll
| | |--Microsoft.Data.OData.resources.dll
| | |--System.Spatial.resources.dll
| |--Microsoft.AspNetCore.Authentication.Abstractions.dll
| |--Microsoft.AspNetCore.Authentication.Core.dll
| |--Microsoft.AspNetCore.Authorization.dll
| |--Microsoft.AspNetCore.Authorization.Policy.dll
| |--Microsoft.AspNetCore.Hosting.Abstractions.dll
| |--Microsoft.AspNetCore.Hosting.Server.Abstractions.dll
| |--Microsoft.AspNetCore.Http.Abstractions.dll
| |--Microsoft.AspNetCore.Http.dll
| |--Microsoft.AspNetCore.Http.Extensions.dll
| |--Microsoft.AspNetCore.Http.Features.dll
| |--Microsoft.AspNetCore.JsonPatch.dll
| |--Microsoft.AspNetCore.Mvc.Abstractions.dll
| |--Microsoft.AspNetCore.Mvc.Core.dll
| |--Microsoft.AspNetCore.Mvc.Formatters.Json.dll
| |--Microsoft.AspNetCore.Mvc.WebApiCompatShim.dll
| |--Microsoft.AspNetCore.ResponseCaching.Abstractions.dll
| |--Microsoft.AspNetCore.Routing.Abstractions.dll
| |--Microsoft.AspNetCore.Routing.dll
| |--Microsoft.AspNetCore.WebUtilities.dll
| |--Microsoft.Azure.WebJobs.dll
| |--Microsoft.Azure.WebJobs.Extensions.dll
| |--Microsoft.Azure.WebJobs.Extensions.Http.dll
| |--Microsoft.Azure.WebJobs.Host.dll
| |--Microsoft.CSharp.dll
| |--Microsoft.Data.Edm.dll
| |--Microsoft.Data.OData.dll
| |--Microsoft.DotNet.PlatformAbstractions.dll
| |--Microsoft.Extensions.Configuration.Abstractions.dll
| |--Microsoft.Extensions.Configuration.dll
| |--Microsoft.Extensions.Configuration.EnvironmentVariables.dll
| |--Microsoft.Extensions.Configuration.FileExtensions.dll
| |--Microsoft.Extensions.Configuration.Json.dll
| |--Microsoft.Extensions.DependencyInjection.Abstractions.dll
| |--Microsoft.Extensions.DependencyModel.dll
| |--Microsoft.Extensions.FileProviders.Abstractions.dll
| |--Microsoft.Extensions.FileProviders.Physical.dll
| |--Microsoft.Extensions.FileSystemGlobbing.dll
| |--Microsoft.Extensions.Hosting.Abstractions.dll
| |--Microsoft.Extensions.Logging.Abstractions.dll
| |--Microsoft.Extensions.Logging.dll
| |--Microsoft.Extensions.ObjectPool.dll
| |--Microsoft.Extensions.Options.dll
| |--Microsoft.Extensions.Primitives.dll
| |--Microsoft.Net.Http.Headers.dll
| |--Microsoft.WindowsAzure.Storage.dll
| |--mokumoku.dll
| |--mokumoku.pdb
| |--NCrontab.dll
| |--Newtonsoft.Json.Bson.dll
| |--Newtonsoft.Json.dll
| |--ru
| | |--Microsoft.Data.Edm.resources.dll
| | |--Microsoft.Data.OData.resources.dll
| | |--System.Spatial.resources.dll
| |--runtimes
| | |--unix
| | | |--lib
| | | | |--netstandard1.1
| | | | | |--System.Runtime.InteropServices.RuntimeInformation.dll
| | | | |--netstandard1.3
| | | | | |--System.Diagnostics.TraceSource.dll
| | | | | |--System.Globalization.Extensions.dll
| | |--win
| | | |--lib
| | | | |--netstandard1.1
| | | | | |--System.Runtime.InteropServices.RuntimeInformation.dll
| | | | |--netstandard1.3
| | | | | |--System.Diagnostics.TraceSource.dll
| | | | | |--System.Globalization.Extensions.dll
| |--System.AppContext.dll
| |--System.Buffers.dll
| |--System.Collections.NonGeneric.dll
| |--System.Collections.Specialized.dll
| |--System.ComponentModel.Annotations.dll
| |--System.ComponentModel.dll
| |--System.ComponentModel.Primitives.dll
| |--System.ComponentModel.TypeConverter.dll
| |--System.Diagnostics.DiagnosticSource.dll
| |--System.Dynamic.Runtime.dll
| |--System.IO.FileSystem.Primitives.dll
| |--System.Linq.dll
| |--System.Linq.Expressions.dll
| |--System.Net.Http.Formatting.dll
| |--System.ObjectModel.dll
| |--System.Reflection.Emit.dll
| |--System.Reflection.Emit.ILGeneration.dll
| |--System.Reflection.Emit.Lightweight.dll
| |--System.Reflection.TypeExtensions.dll
| |--System.Runtime.CompilerServices.Unsafe.dll
| |--System.Runtime.Serialization.Formatters.dll
| |--System.Runtime.Serialization.Primitives.dll
| |--System.Spatial.dll
| |--System.Text.Encodings.Web.dll
| |--System.Text.RegularExpressions.dll
| |--System.Threading.dll
| |--System.Threading.Tasks.Dataflow.dll
| |--System.Threading.Tasks.Extensions.dll
| |--System.Xml.ReaderWriter.dll
| |--System.Xml.XmlDocument.dll
| |--zh-Hans
| | |--Microsoft.Data.Edm.resources.dll
| | |--Microsoft.Data.OData.resources.dll
| | |--System.Spatial.resources.dll
| |--zh-Hant
| | |--Microsoft.Data.Edm.resources.dll
| | |--Microsoft.Data.OData.resources.dll
| | |--System.Spatial.resources.dll
|--echo_csx
| |--function.json
| |--run.csx
|--echo_js
| |--function.json
| |--index.js
|--host.json
|--mokumoku.deps.json
これと全く同じ構成でZipファイルを作成することで、Run-From-Zip Deploymentとして使用することができます。
C#クラスライブラリの関数でのRun-From-Zip Deployment
やり方に悩んだのはC#クラスライブラリでの関数ファイルですが、無事デプロイすることができたので方法を共有します。
ただしC#クラスライブラリの関数はまだプレビューなので、今後仕様が変更となる可能性に注意してください。
docs.microsoft.com
- Visual Studio 2017でAzure Functionsプロジェクトを作成する。このとき「v2 (.NET Standard)」を選択すること。
- 適当な関数を追加する。
- プロジェクトを右クリック→「発行」をクリックする。
- フォルダーに発行するプロファイルを作成する。
- 発行したフォルダーに含まれるファイルをZip化する。
これでRun-From-Zip Deploymentを行うためのZipファイルを作成することができます。
あとはこれまでと同様に、Blobストレージなどにアップロードして、Azure Functionsの環境変数に指定すればデプロイが実行されます。
C#クラスライブラリの関数は「.NET Standard」がベースになっているので dotnet
コマンドで扱うことができます。
dotnet restore
dotnet publish -c Release
上記のコマンドラインで発行されたファイルをZip化すれば、Run-From-Zip Deploymentとして使用することができます。
最後に
牛尾さんのセッションで紹介されるまで、Run-From-Zip Deploymentを知りませんでしたが、とても素晴らしい機能だと思います。
仕組みや利点についてはもう少し調べてから記事にしたいと思います。