Azure で Serverless 初心者向けタッチ&トライ

Azure で Serverless
初心者向けタッチ&トライ（公開版）
2019.5.29 @de:code 2019
Serverless Community

Durable Functions
• Azure Functions extension
• Enables long-running, stateful serverless operations
• Write complex function orchestrations in a single function
• Built on the open-source Durable Task Framework
• Only pay when your code is running
• Orchestrator replays itself to re-establish state every run

Durable Patterns
Function chaining Fan-out / fan-in
Event aggregation
Extended Status Monitoring
http
Async HTTP APIs
Human interaction / timeout

作成するもの
Orchestration Client
(HttpStart)
Orchestrator
(OrchestratorFunction)
Activity Function
(E1_SayHello)

流れ
1. Visual Studio Code にAzure Functions 拡張機能をインストール
2. Azure Functions プロジェクトを作成
3. Durable Functions npm パッケージをインストール
4. starter 関数を作成
5. オーケストレーター関数を作成する
6. アクティビティ関数を作成する
7. Azure へのサインイン
8. Azure にプロジェクトを発行
9. Azure で関数をテスト

1. Azure Functions 拡張機能をインストール
• Visual Studio Code で [拡張機能] を開き、azure functions を検索するか、Visual
Studio Code でこのリンクを開きます。
• [インストール] を選択して、Visual Studio Code に拡張機能をインストールします。

• Visual Studio Code を再起動し、アクティビティバーの Azure アイコンを選択しま
す。サイドバーに Azure Functions 領域が表示されます。
1. Azure Functions 拡張機能をインストール

• Visual Studio Code で、Azure ロゴを選択して [Azure:Functions] 領域を表示し、[新し
いプロジェクトの作成] アイコンを選択します。
• プロジェクトワークスペースの場所としてデスクトップの「 demo 」のフォルダを選択
し、[選択] をクリックします。

• 関数アプリプロジェクトの言語は「JavaScript」を選択します。
• 「V2」を選択します。
• 「Skip for now」を選択します。

• 「Open in current window」を選択します。

3. Durable Functions npm パッケージをインストール
• VS Codeでターミナルを開き、ワークスペース用のフォルダ「demo」で「npm install
durable-functions」を実行して、durable-functions npm パッケージをインストール
します。
※npmがインストールされていない場合は、事前にnpmをPCにインストールします

• [Azure:Functions] で [関数の作成] アイコンを選択します。
• 関数アプリプロジェクトが含まれたフォルダーを選択し、[HTTP trigger] 関数テンプレート
を選択します。
• 関数名として「HttpStart」と入力して Enter キーを押し、[Anonymous] 認証を選択します。

• index.js を以下の JavaScript に置き換えます。
const df = require("durable-functions");
module.exports = async function (context, req) {
const client = df.getClient(context);
const instanceId = await client.startNew(req.params.functionName, undefined, req.body);
context.log(`Started orchestration with ID = '${instanceId}'.`);
return client.createCheckStatusResponse(context.bindingData.req, instanceId);
};

• function.json を以下の JavaScript に置き換えます。
{
"bindings": [
{
"authLevel": "anonymous",
"name": "req",
"type": "httpTrigger",
"direction": "in",
"route": "orchestrators/{functionName}",
"methods": ["get", "post"]
},
{
"name": "starter",
"type": "orchestrationClient",
"direction": "in"
}
]
}

(HttpStart)
Orchestrator
Activity Function
(E1_SayHello)
{
"bindings": [
{
"name": "req",
"direction": "in",
},
{
"name": "starter",
"direction": ”in"
}
]
}
const instanceId = await client.startNew(req.params.functionName,
undefined, req.body);
return client.createCheckStatusResponse(context.bindingData.req,
instanceId);
};
index.js
function.json

5. オーケストレーター関数を作成
• 前の手順を繰り返し、HTTP Trigger Templateを使用して 2 つ目の関数を作成しま
す。今回は関数に「 OrchestratorFunction」と名前を付けます。
module.exports = df.orchestrator(function*(context){
context.log("Starting chain sample");
const output = [];
output.push(yield context.df.callActivity("E1_SayHello", "Tokyo"));
output.push(yield context.df.callActivity("E1_SayHello", "Seattle"));
output.push(yield context.df.callActivity("E1_SayHello", "London"));
return output;
});

5. オーケストレーター関数を作成
{
"bindings": [
{
"name": "context",
"type": "orchestrationTrigger",
"direction": "in"
}
]
}

(HttpStart)
Orchestrator
Activity Function
(E1_SayHello)
{
"bindings": [
{
"name": "req",
"direction": "in",
},
{
"name": "starter",
"direction": ”in"
}
]
}
instanceId);
};
const output = [];
return output;
});
{
"bindings": [
{
"name": "context",
"direction": "in"
}
]
}
index.js
function.json

6. アクティビティ関数を作成
• 前の手順を繰り返し、HTTP Trigger Templateを使用して 2 つ目の関数を作成しま
す。今回は関数に「 E1_SayHello 」と名前を付けます。
module.exports = async function(context) {
return `Hello ${context.bindings.name}!`;
};

6. アクティビティ関数を作成
{
"bindings": [
{
"name": "name",
"type": "activityTrigger",
"direction": "in"
}
]
}

(HttpStart)
Orchestrator
Activity Function
(E1_SayHello)
{
"bindings": [
{
"name": "req",
"direction": "in",
},
{
"name": "starter",
"direction": ”in"
}
]
}
instanceId);
};
const output = [];
return output;
});
{
"bindings": [
{
"name": "context",
"direction": "in"
}
]
}
module.exports = async function(context) {
return `Hello ${context.bindings.name}!`;
};
{
"bindings": [
{
"name": "name",
"type": "activityTrigger",
"direction": "in"
}
]
}
index.js
function.json

7. Azure へのサインイン
• [Azure: Functions] 領域で、[Sign in to Azure...](Azure にサインインする...) を選択し
ます。
※Azure アカウントがない場合は無償アカウントを作成して下さい
https://azure.microsoft.com/ja-jp/free/

• [Azure: Functions] 領域で、[Deploy to Function App](関数アプリにデプロイ) アイコ
ンを選択します。

• [サブスクリプションを選択] してから、 [+ Create New Function App in Azure](+
Azure で新しい Function App を作成) を選択します。

• 「Deploy」を選択します。

• ブラウザでオーケストラーの情報を確認します。
https://<function名>.azurewebsites.net/api/orchestrators/OrchestratorFunction
出力結果例：
{
"id": "a42bfdf91f9a49da9c9558e2ef5c7a65",
"statusQueryGetUri": "https://decode-
horike.azurewebsites.net/runtime/webhooks/durabletask/instances/a42bfdf91f9a49da9c9558e2ef5c7a65?taskHub
=DurableFunctionsHub&connection=Storage&code=BId08/uK/2jAhDKF3bNjgNPzJGdGfcalR3dlm6PJyate/aG/rtHZ
VA==",
"sendEventPostUri": "https://decode-
horike.azurewebsites.net/runtime/webhooks/durabletask/instances/a42bfdf91f9a49da9c9558e2ef5c7a65/raiseEve
nt/{eventName}?taskHub=DurableFunctionsHub&connection=Storage&code=BId08/uK/2jAhDKF3bNjgNPzJGdGfc
alR3dlm6PJyate/aG/rtHZVA==",
・・・・

• 前ページのstatusQueryGetUri をブラウザのURLにコピペし、オーケストラーの状態を
確認します。
出力結果例：
{
"instanceId": "6fa01dd927a245229cff60e9596d01ee",
"runtimeStatus": "Completed",
"input": null,
"customStatus": null,
"output": [
"Hello Tokyo!",
"Hello Seattle!",
"Hello London!"
],
"createdTime": "2019-05-28T14:10:02Z",
"lastUpdatedTime": "2019-05-28T14:10:02Z"
}

無償アカウントの作成
• https://azure.microsoft.com/ja-jp/free/

チュートリアル
• 今回のタッチアンドトライは公式のチュートリアルをベースにしています。
JavaScript で最初の Durable Functions を作成する
https://docs.microsoft.com/ja-jp/azure/azure-functions/durable/quickstart-js-vscode

Functions Appの前処理
• Durable Functions ExtensionをPortalからInstallします。
• 「Durable Functions HTTP starter」をクリックし「Install」を作成します。
• Installが終わり次第「Cancel」します。

ローカル開発環境
• ローカルでの開発、テストを行うにはセットアップが必要です
Azure Functions V2 を Mac+VSCode で動かすまでの手順
https://qiita.com/miyake/items/83aac5524be91e3811ee

Functionsがサポートするバインディング
Type 1.x 2.x1 トリガー入力 Output
Blob Storage ✔ ✔ ✔ ✔ ✔
Cosmos DB ✔ ✔ ✔ ✔ ✔
Event Grid ✔ ✔ ✔
Event Hubs ✔ ✔ ✔ ✔
HTTP と Webhooks ✔ ✔ ✔ ✔
Microsoft Graph Excel テーブル ✔ ✔ ✔
Microsoft Graph OneDrive ファイル ✔ ✔ ✔
Microsoft Graph Outlook メール ✔ ✔
Microsoft Graph Events ✔ ✔ ✔ ✔
Microsoft Graph Auth トークン ✔ ✔
Mobile Apps ✔ ✔ ✔
Notification Hubs ✔ ✔
Queue Storage ✔ ✔ ✔ ✔
SendGrid ✔ ✔ ✔
Service Bus ✔ ✔ ✔ ✔
SignalR ✔ ✔ ✔
Table Storage ✔ ✔ ✔ ✔
Timer ✔ ✔ ✔
Twilio ✔ ✔ ✔
https://docs.microsoft.com/ja-jp/azure/azure-functions/functions-triggers-bindings#supported-bindings

Azure で Serverless 初心者向けタッチ&トライ

More Related Content

What's hot (19)

Similar to Azure で Serverless 初心者向けタッチ&トライ (20)

Azure で Serverless 初心者向けタッチ&トライ