チュートリアル: イベントサブスクリプションを使用して BLOB コンテナーで Azure Functions をトリガーする

[アーティクル]
02/27/2024

Azure Functions で以前のバージョンの Blob Storage トリガーを使用していると、そのトリガーによって更新プログラム用の BLOB コンテナーがポーリングされるため、多くの場合は実行が遅延します。同じコンテナーへのイベントサブスクリプションを使用して関数をトリガーすることにより待機時間を削減できます。イベントサブスクリプションは、Event Grid インフラストラクチャを使って、コンテナー内の変更が発生したときにそれを転送します。この機能は、最新の Azure Functions 拡張機能を使って実装できます。

この記事では、BLOB がコンテナーに追加されたときに発生するイベントに基づいて実行される関数を作成する方法について説明します。 Visual Studio Code は、ローカル開発のためと、Azure にプロジェクトをデプロイする前にその関数がローカルで機能することを確認するために使用します。

Azure Storage で汎用ストレージ v2 アカウントを作成します。
BLOB ストレージ内にコンテナーを作成します。
イベントドリブン Blob Storage によってトリガーされる関数を作成します。
BLOB コンテナーへのイベントサブスクリプションを作成します。
ファイルをアップロードして、ngrok を使用してローカルでデバッグします。
Azure にデプロイし、フィルター処理されたイベントサブスクリプションを作成します。

重要

この記事では、タブを使用して、Node.js プログラミングモデルの複数のバージョンに対応しています。 v4 モデルは一般提供されており、JavaScript と TypeScript の開発者にとって、より柔軟で直感的なエクスペリエンスが得られるように設計されています。 v4 モデルの動作の詳細については、Azure Functions Node.js 開発者ガイドを参照してください。 v3 と v4 の違いの詳細については、移行ガイドを参照してください。

前提条件

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
.NET 7.0 をターゲットにする場合は、.NET 6.0 SDK、および必要に応じて .NET 7.0 SDK。
サポートされているプラットフォームのいずれかにインストールされた Visual Studio Code。
Visual Studio Code 用の C# 拡張機能。
Visual Studio Code 用 Azure Functions 拡張機能。

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
Node.js 14.x 以降。 node --version コマンドを使用して、現在のバージョンを確認してください。
サポートされているプラットフォームのいずれかにインストールされた Visual Studio Code。
Visual Studio Code 用 Azure Functions 拡張機能。この拡張機能では、初めてローカルで関数を実行するときに、Azure Functions Core Tools がインストールされます。

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
PowerShell 7.2
.NET 6.0 ランタイム
サポートされているプラットフォームのいずれかにインストールされた Visual Studio Code。
Visual Studio Code 用 PowerShell 拡張機能。
Visual Studio Code 用 Azure Functions 拡張機能。

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
Azure Functions でサポートされているバージョンの Python。詳細については、「Python のインストール方法」を参照してください。
サポートされているプラットフォームのいずれかにインストールされた Visual Studio Code。
Visual Studio Code 用の Python 拡張機能。
Visual Studio Code 用 Azure Functions 拡張機能。

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
Java 開発キット、バージョン 8、11、17、または 21 (Linux)。
Apache Maven バージョン 3.0 以降。
サポートされているプラットフォームのいずれかにインストールされた Visual Studio Code。
Java Extension Pack
Visual Studio Code 用 Azure Functions 拡張機能。

ローカルで実行されている関数を Azure が呼び出す方法を提供する ngrok ユーティリティ。
Visual Studio Code 用の Azure Storage 拡張機能 (少なくともバージョン 5.x)。

注意

Visual Studio Code 用の Azure Storage 拡張機能は、現在プレビュー段階です。

ストレージアカウントの作成

Azure Storage でイベントサブスクリプションを使用するには、汎用 v2 ストレージアカウントが必要になります。既定では、このストレージアカウントは、Azure Storage 拡張機能をインストールするときに Visual Studio Code プロジェクトから作成できます。

Visual Studio Code で、コマンドパレットを開き (F1 キーを押し)、「Azure Storage: Create Storage Account...」と入力します。プロンプトで、次の情報を指定します。

Prompt	アクション
新しいストレージアカウントの名前を入力してください	グローバルに一意な名前を付けます。ストレージアカウント名は、3 - 24 文字の長さで、小文字と数字のみが含まれている必要があります。簡単に識別できるように、リソースグループ名と関数アプリ名に同じ名前を使用します。
Select a location for new resources (新しいリソースの場所を選択してください)	パフォーマンスを向上させるために、最寄りのリージョンを選択してください。

この拡張機能により、指定された名前を持つ汎用 v2 ストレージアカウントが作成されます。このストレージアカウントを含むリソースグループにも同じ名前が使用されます。

ストレージアカウントを作成したら、コマンドパレットを開き (F1 キーを押し)、「Azure Storage: Create Blob Container...」と入力します。プロンプトで、次の情報を指定します。

Prompt	アクション
リソースの選択	作成したストレージアカウントを選択します。
新しい BLOB コンテナーの名前を入力してください	「`samples-workitems`」と入力します。これは、コードプロジェクトで参照されるコンテナー名です。

これで BLOB コンテナーが作成されたので、このコンテナーでトリガーする関数と、その関数にイベントを配信するイベントサブスクリプションの両方を作成できます。

BLOB によってトリガーされる関数を作成する

Visual Studio Code を使用して、BLOB Storage によってトリガーされる関数を作成する場合は、新しいプロジェクトも作成します。通常のポーリングされたコンテナーを使用するのではなく、ソースとしてイベントサブスクリプションを使用するように関数を編集する必要があります。

Visual Studio Code で、関数アプリを開きます。
コマンドパレットを開き (F1 キーを押し)、「Azure Functions: Create Function...」と入力して [新しいプロジェクトの作成] を選択します。
プロジェクトワークスペースで、ディレクトリの場所を選択します。新しいフォルダーを作成するか、またはプロジェクトワークスペースの空のフォルダーを選択するようにしてください。

既にワークスペースの一部になっているプロジェクトフォルダーは選択しないでください。

プロンプトで、次の情報を指定します。

Prompt	アクション
言語を選択する	[`C#`] を選択します。
Select a .NET runtime (.NET ランタイムを選択してください)	分離されたワーカープロセスで実行する場合は `.NET 6.0 Isolated LTS` を、インプロセスで実行する場合は `.NET 6.0 LTS` を選択します。
Select a template for your project's first function (プロジェクトの最初の関数のテンプレートを選択してください)	[`Azure Blob Storage trigger`] を選択します。
Provide a function name (関数名を指定してください)	「`BlobTriggerEventGrid`」と入力します。
Provide a namespace (名前空間を指定してください)	「`My.Functions`」と入力します。
Select setting from "local.settings.json" ("local.settings.json" から設定を選択する)	[`Create new local app setting`] を選択します。
ストレージアカウントを選んでください	一覧から、作成したストレージアカウントを選択します。
これは、トリガーが監視するストレージアカウント内のパスです	既定値 `samples-workitems` を受け入れます。
Select how you would like to open your project (プロジェクトを開く方法を選択してください)	[`Open in current window`] を選択します。

Prompt	アクション
言語を選択する	[`Python`] を選択します。
仮想環境を作成する Python インタープリターを選択する	好みの Python インタープリターを選択します。オプションが表示されない場合は、Python バイナリへの完全なパスを入力します。
Select a template for your project's first function (プロジェクトの最初の関数のテンプレートを選択してください)	[`Azure Blob Storage trigger`] を選択します。
Provide a function name (関数名を指定してください)	「`BlobTriggerEventGrid`」と入力します。
Select setting from "local.settings.json" ("local.settings.json" から設定を選択する)	[`Create new local app setting`] を選択します。
ストレージアカウントを選んでください	一覧から、作成したストレージアカウントを選択します。
これは、トリガーが監視するストレージアカウント内のパスです	既定値 `samples-workitems` を受け入れます。
Select how you would like to open your project (プロジェクトを開く方法を選択してください)	[`Open in current window`] を選択します。

Prompt	アクション
言語を選択する	[`Java`] を選択します。
Select a version of Java (Java のバージョンを選択してください)	`Java 11` または `Java 8` (Azure で関数が実行される、ローカルで確認した Java のバージョン) を選択します。
Provide a group ID (グループ ID を指定してください)	[`com.function`] を選択します。
Provide an artifact ID (成果物 ID を指定してください)	[`BlobTriggerEventGrid`] を選択します。
Provide a version (バージョンを指定してください)	[`1.0-SNAPSHOT`] を選択します。
Provide a package name (パッケージ名を指定してください)	[`com.function`] を選択します。
Provide an app name (アプリ名を指定してください)	`BlobTriggerEventGrid` で始まる生成された名前を受け入れます。
Select the build tool for Java project (Java プロジェクトのビルドツールを選択してください)	[`Maven`] を選択します。
Select how you would like to open your project (プロジェクトを開く方法を選択してください)	[`Open in current window`] を選択します。

Prompt	アクション
Select a language for your function project (関数プロジェクトの言語を選択してください)	[`TypeScript`] を選択します。
TypeScript プログラミングモデルを選択する	[`Model V4`] を選択します。
Select a template for your project's first function (プロジェクトの最初の関数のテンプレートを選択してください)	[`Azure Blob Storage trigger`] を選択します。
Provide a function name (関数名を指定してください)	「`BlobTriggerEventGrid`」と入力します。
Select setting from "local.settings.json" ("local.settings.json" から設定を選択する)	[`Create new local app setting`] を選択します。
ストレージアカウントを選んでください	作成したストレージアカウントを選択します。
これは、トリガーが監視するストレージアカウント内のパスです	既定値 `samples-workitems` を受け入れます。
Select how you would like to open your project (プロジェクトを開く方法を選択してください)	[`Open in current window`] を選択します。

Prompt	アクション
Select a language for your function project (関数プロジェクトの言語を選択してください)	[`JavaScript`] を選択します。
JavaScript プログラミングモデルを選択する	[`Model V4`] を選択します。
Select a template for your project's first function (プロジェクトの最初の関数のテンプレートを選択してください)	[`Azure Blob Storage trigger`] を選択します。
Provide a function name (関数名を指定してください)	「`BlobTriggerEventGrid`」と入力します。
Select setting from "local.settings.json" ("local.settings.json" から設定を選択する)	[`Create new local app setting`] を選択します。
ストレージアカウントを選んでください	作成したストレージアカウントを選択します。
これは、トリガーが監視するストレージアカウント内のパスです	既定値 `samples-workitems` を受け入れます。
Select how you would like to open your project (プロジェクトを開く方法を選択してください)	[`Open in current window`] を選択します。

Prompt	アクション
Select a language for your function project (関数プロジェクトの言語を選択してください)	[`PowerShell`] を選択します。
Select a template for your project's first function (プロジェクトの最初の関数のテンプレートを選択してください)	[`Azure Blob Storage trigger`] を選択します。
Provide a function name (関数名を指定してください)	「`BlobTriggerEventGrid`」と入力します。
Select setting from "local.settings.json" ("local.settings.json" から設定を選択する)	[`Create new local app setting`] を選択します。
ストレージアカウントを選んでください	作成したストレージアカウントを選択します。
これは、トリガーが監視するストレージアカウント内のパスです	既定値 `samples-workitems` を受け入れます。
Select how you would like to open your project (プロジェクトを開く方法を選択してください)	[`Open in current window`] を選択します。

プロンプトが表示されたら、[ストレージアカウントの選択]>[ワークスペースに追加] の順に選択します。

簡単のために、このチュートリアルでは、関数アプリで同じストレージアカウントを再利用します。ただし、運用環境では、関数アプリで別のストレージアカウントを使用することが必要になる場合があります。詳細については、「Azure Functions のストレージに関する考慮事項」を参照してください。

Storage 拡張機能をアップグレードする

Event Grid ベースの Blob Storage トリガーを使用するには、関数に Storage 拡張機能の少なくともバージョン 5.x が必要です。

プロジェクトを必要な拡張機能バージョンでアップグレードするには、ターミナルウィンドウで、コマンド dotnet add package を実行します。

分離プロセス
インプロセス

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs --version 6.1.0

dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage --version 5.1.3

host.json プロジェクトファイルを開き、extensionBundle 要素を検査します。
extensionBundle.version が 3.3.0 以上でない場合は、extensionBundle を次のバージョンに置き換えます。
```
"extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.0.0, 5.0.0)"
}
```

イベントを使用するように関数を更新する

BlobTriggerEventGrid.cs ファイルで、BLOB トリガー属性のパラメーターに Source = BlobTriggerSource.EventGrid を追加します。次に例を示します。

分離プロセス
インプロセス

[Function("BlobTriggerCSharp")]
public async Task Run([BlobTrigger("samples-workitems/{name}", Source = BlobTriggerSource.EventGrid, Connection = "<NAMED_STORAGE_CONNECTION>")] Stream myBlob, string name, FunctionContext executionContext)
{
    var logger = executionContext.GetLogger("BlobTriggerCSharp");
    logger.LogInformation($"C# Blob trigger function Processed blob\n Name: {name} \n Size: {myBlob.Length} Bytes");
}

[FunctionName("BlobTriggerCSharp")]
public static void Run([BlobTrigger("samples-workitems/{name}", Source = BlobTriggerSource.EventGrid, Connection = "<NAMED_STORAGE_CONNECTION>")]Stream myBlob, string name, ILogger log)
{
    log.LogInformation($"C# Blob trigger function Processed blob\n Name:{name} \n Size: {myBlob.Length} Bytes");
}

関数を作成したら、function.json 構成ファイルで、myBlob バインドに "source": "EventGrid" を追加します。次に例を示します。

{
  "scriptFile": "__init__.py",
  "bindings": [
    {
      "name": "myblob",
      "type": "blobTrigger",
      "direction": "in",
      "path": "samples-workitems/{name}",
      "source": "EventGrid",
      "connection": "<NAMED_STORAGE_CONNECTION>"
    }
  ]
}

生成された Function.java ファイルの内容を次のコードに置き換え、ファイルの名前を BlobTriggerEventGrid.java に変更します。

package com.function;

import com.microsoft.azure.functions.annotation.*;
import com.microsoft.azure.functions.*;

/**
* Azure Functions with Azure Blob trigger.
*/
public class BlobTriggerEventGrid {
    /**
    * This function will be invoked when a new or updated blob is detected at the specified path. The blob contents are provided as input to this function.
    */
    @FunctionName("BlobTriggerEventGrid")
    @StorageAccount("glengatesteventgridblob_STORAGE")
    public void run(
        @BlobTrigger(name = "content", path = "samples-workitems/{name}", dataType = "binary", source = "EventGrid" ) byte[] content,
        @BindingName("name") String name,
        final ExecutionContext context
    ) {
          context.getLogger().info("Java Blob trigger function processed a blob. Name: " + name + "\n  Size: " + content.length + " Bytes");
      }
}

新しいトリガーの種類には適用されなくなった、関連付けられている単体テストファイルを削除します。

モデル v4
モデル v3

関数を作成したら、TypeScript ファイルの options オブジェクトに source: "EventGrid" を追加します。以下に例を示します。

import { app, InvocationContext } from '@azure/functions';

export async function storageBlobTrigger1(blob: Buffer, context: InvocationContext): Promise<void> {
    context.log(
        `Storage blob function processed blob "${context.triggerMetadata.name}" with size ${blob.length} bytes`
    );
}

app.storageBlob('storageBlobTrigger1', {
    path: 'samples-workitems/{name}',
    connection: 'MyStorageAccountAppSetting',
    source: 'EventGrid',
    handler: storageBlobTrigger1,
});

関数を作成したら、function.json 構成ファイルで、myBlob バインドに "source": "EventGrid" を追加します。次に例を示します。

{
    "bindings": [
        {
            "name": "myblob",
            "type": "blobTrigger",
            "direction": "in",
            "path": "samples-workitems/{name}",
            "source": "EventGrid",
            "connection": "<NAMED_STORAGE_CONNECTION>"
        }
    ]
}

モデル v4
モデル v3

関数を作成したら、JavaScript ファイルの options オブジェクトに source: "EventGrid" を追加します。以下に例を示します。

const { app } = require('@azure/functions');

app.storageBlob('storageBlobTrigger1', {
    path: 'samples-workitems/{name}',
    connection: 'MyStorageAccountAppSetting',
    source: 'EventGrid',
    handler: (blob, context) => {
        context.log(
            `Storage blob function processed blob "${context.triggerMetadata.name}" with size ${blob.length} bytes`
        );
    },
});

関数を作成したら、function.json 構成ファイルで、myBlob バインドに "source": "EventGrid" を追加します。次に例を示します。

{
    "bindings": [
        {
            "name": "myblob",
            "type": "blobTrigger",
            "direction": "in",
            "path": "samples-workitems/{name}",
            "source": "EventGrid",
            "connection": "<NAMED_STORAGE_CONNECTION>"
        }
    ]
}

関数を作成したら、function.json 構成ファイルで、myBlob バインドに "source": "EventGrid" を追加します。次に例を示します。

{
    "bindings": [
        {
            "name": "myblob",
            "type": "blobTrigger",
            "direction": "in",
            "path": "samples-workitems/{name}",
            "source": "EventGrid",
            "connection": "<NAMED_STORAGE_CONNECTION>"
        }
    ]
}

ローカルデバッグを開始する

Azure portal でイベントサブスクリプションを作成すると、Event Grid によりエンドポイント URL が検証されます。この検証は、ローカルデバッグ用のイベントサブスクリプションを作成する前に、ngrok ユーティリティでリモートアクセスを有効にして関数をローカルで実行する必要があることを意味します。ローカル関数コードが実行されておらず、Azure にアクセスできない場合、イベントサブスクリプションを作成できません。

BLOB トリガーエンドポイントを決定する

関数がローカルで実行されている場合、イベントドリブン BLOB ストレージトリガーに使用される既定のエンドポイントは、次の URL のようになります。

分離プロセス
インプロセス

http://localhost:7071/runtime/webhooks/blobs?functionName=Host.Functions.BlobTriggerEventGrid

http://localhost:7071/runtime/webhooks/blobs?functionName=BlobTriggerEventGrid

http://localhost:7071/runtime/webhooks/blobs?functionName=Host.Functions.BlobTriggerEventGrid

このパスを保存します。これは後でイベントサブスクリプションのエンドポイント URL を作成するために使用します。 Blob Storage によってトリガーされる関数に別の名前を使用した場合は、クエリ文字列の functionName 値を変更する必要があります。

Note

エンドポイントでは Blob Storage トリガーのイベントが処理されるため、エンドポイントパスには blobs が含まれます。 Event Grid トリガーのエンドポイント URL では、代わりに eventgrid がパスに含まれます。

ngrok を実行する

マシン上でデバッグ中の関数を中断するには、Azure Event Grid がローカルコンピューターで実行されている関数と通信する方法を提供する必要があります。

ngrok ユーティリティは、ランダムに生成されたプロキシサーバーアドレスへの外部要求を、ローカルコンピューターの特定のアドレスとポートに転送します。お使いのマシンで実行されている関数の Webhook エンドポイントを呼び出します。

次のコマンドを使用して ngrok を起動します。
```
ngrok.exe http http://localhost:7071
```
ユーティリティを起動すると、次のスクリーンショットのようなコマンドウィンドウが表示されます。
ngrok が実行されたときに生成される HTTPS URL をコピーします。この値は、ngrok を使用して公開されるお使いのコンピューター上の Webhook エンドポイントを決定するために使用されます。

重要

この時点で、ngrok を停止しないでください。 ngrok を起動するたびに、HTTPS URL が異なる値で再生成されます。イベントサブスクリプションのエンドポイントは変更できないため、ngrok を実行するたびに新しいイベントサブスクリプションを作成する必要があります。

ngrok アカウントを作成しない限り、ngrok セッションの最大時間は 2 時間に制限されます。

エンドポイント URL を作成する

イベントサブスクリプションで使用されるエンドポイントは、3 つの異なる部分 (プレフィックス付きサーバー名、パス、クエリ文字列) で構成されます。次の表に、これらの部分を説明します。

URL の部分	説明
プレフィックスとサーバー名	関数がローカルで実行される場合、`https://` プレフィックスが付いたサーバー名は、ngrok によって生成された転送 URL から取得されます。 localhost URL では、`http://localhost:7071` が ngrok URL に置き換えられます。 Azure で実行する場合は、代わりに公開された関数アプリサーバーを使用します。これは通常、`https://<FUNCTION_APP_NAME>.azurewebsites.net` の形式です。
Path	エンドポイント URL のパス部分は、前にコピーした localhost URL から取得され、Blob Storage トリガーの `/runtime/webhooks/blobs` のようになります。 Event Grid トリガーのパスは、`/runtime/webhooks/EventGrid` のようになります
クエリ文字列	.NET Isolated を含むすべての言語で、クエリ文字列の `functionName=Host.Functions.BlobTriggerEventGrid` パラメーター (.NET インプロセスを除く。その場合は `functionName=BlobTriggerEventGrid`) により、イベントを処理する関数の名前が設定されます。関数に別の名前を使用した場合は、この値を変更する必要があります。ローカルで実行する場合、関数キーは必要ありません。 Azure で実行する場合は、ポータルから取得できるキーを含む `code=` パラメーターを URL に含める必要もあります。

次のスクリーンショットは、BlobTriggerEventGrid という名前の Blob Storage トリガーを使用した場合の最終的なエンドポイント URL の例を示しています。

分離プロセス
インプロセス

Endpoint selection

デバッグを開始する

ngrok が既に実行されている状態で、次のようにローカルプロジェクトを開始します。

ログを処理する行の関数にブレークポイントを設定します。
デバッグセッションを開始します。
新しいターミナルを開き、次の mvn コマンドを実行してデバッグセッションを開始します。
```
mvn azure-functions:run -DenableDebug
```
F5 キーを押してデバッグセッションを開始します。

コードを実行し、ngrok によって要求が転送されたら、BLOB コンテナーへのイベントサブスクリプションを作成します。

イベントサブスクリプションを作成する

Azure Event Grid を利用したイベントサブスクリプションにより、リンクされた BLOB コンテナーの変更に基づいてイベントが発生します。このイベントは、その後、関数のトリガーで Webhook エンドポイントに送信されます。イベントサブスクリプションを作成した後は、エンドポイント URL を変更することはできません。つまり、ローカルデバッグが完了した後 (または ngrok を再起動した場合) は、イベントサブスクリプションを削除して再作成する必要があります。

Visual Studio Code のアクティビティバーで Azure アイコンを選択します。 [リソース] でサブスクリプションを展開し、[ストレージアカウント] を展開して、前に作成したストレージアカウントを右クリックし、[ポータルで開く] を選びます。
Azure portal にサインインし、ご自分のストレージアカウントのリソースグループを書き留めておきます。同じグループ内に他のリソースを作成して、完了時にリソースを簡単にクリーンアップできるようにします。
左側のメニューから [イベント] オプションを選びます。

[イベント] ウィンドウで、[+ イベントサブスクリプション] ボタンを選び、次の表の値を [基本] タブに入力します。

設定	提案された値	Description
名前	myBlobLocalNgrokEventSub	イベントサブスクリプションを識別する名前。この名前を使用すると、イベントサブスクリプションをすばやく見つけることができます。
イベントスキーマ	イベントグリッドスキーマ	イベントには既定のスキーマを使用します。
[システムトピック名]	samples-workitems-blobs	コンテナーを表すトピックの名前。トピックは最初のサブスクリプションで作成され、今後のイベントサブスクリプションに使用します。
イベントの種類のフィルター	作成された BLOB
エンドポイントの種類	Web Hook	BLOB ストレージトリガーでは、Web hook エンドポイントが使用されます。 Event Grid トリガーには Azure Functions を使用します。
エンドポイント	ngrok ベースの URL エンドポイント	前に決定した ngrok ベースの URL エンドポイントを使用します。

[選択の確認] を選び、エンドポイント URL を検証します。
[作成] を選び、イベントサブスクリプションを作成します。

コンテナーにファイルをアップロードする

イベントサブスクリプションが配置され、コードプロジェクトと ngrok がまだ実行されている状態で、ファイルをストレージコンテナーにアップロードして関数をトリガーできるようになりました。 Visual Studio Code を使用して、お使いのコンピューターから BLOB ストレージコンテナーにファイルをアップロードできます。

Visual Studio Code で、コマンドパレットを開き (F1 キーを押す)、Azure Storage: Upload Files... と入力します。
[開く] ダイアログボックスでファイル (できれば大きすぎないバイナリイメージファイル) を選び、[アップロード] を選びます。

プロンプトで、次の情報を入力します。

設定	提案された値	説明
リソースの選択	ストレージアカウント名	前の手順で作成したストレージアカウントの名前を選びます。
リソースの種類を選択する	BLOB コンテナー	BLOB コンテナーにアップロードしています。
BLOB コンテナーを選択する	samples-workitems	この値は、前の手順で作成したコンテナーの名前です。
このアップロードの宛先ディレクトリを入力する	default	コンテナールートである `/` の既定値をそのまま使用します。

このコマンドは、お使いのコンピューターから Azure のストレージコンテナーにファイルをアップロードします。この時点で、実行中の ngrok インスタンスで、要求が転送されたことが報告されます。デバッグセッションの func.exe 出力にも、関数が開始されたことが表示されます。この時点で、ブレークポイントを設定した場所でデバッグセッションが待機していると便利です。

Azure にプロジェクトを発行する

関数コードをローカルで正常に検証したので、次は Azure の新しい関数アプリにプロジェクトを発行します。

Function App の作成

次の手順では、Azure で必要なリソースを作成し、プロジェクトファイルをデプロイします。

コマンドパレットに「Azure Functions: Create function app in Azure...(Advanced)」と入力します。

プロンプトに従って、次の情報を入力します。

Prompt	[選択]
関数アプリにグローバルで一意の名前を入力します。	新しい関数アプリを識別するグローバルに一意の名前を入力し、Enter キーを選択します。関数アプリ名の有効な文字は、`a-z`、`0-9`、`-` です。この名前を書き留めます。これは、後で新しいエンドポイント URL を作成するときに必要になります。
ランタイムスタックを選択します。	ローカルで実行している言語バージョンを選択してください。
OS を選択します。	Linux または Windows を選択してください。 Python アプリは Linux で実行する必要があります。
新しいリソース用のリソースグループの選択。	ストレージアカウントで作成したリソースグループの名前 (前にポータルで書き留めたもの) を選びます。
新しいリソースの場所の選択。	自分の近く、または関数がアクセスする他のサービスの近くのリージョン内の場所を選択します。
Select a hosting plan. (ホスティングプランを選択してください。)	サーバーレスの従量課金プランホスティングの場合は [Consumption] (従量課金プラン) を選択します。この場合、関数が実行されているときにのみ課金されます。
ストレージアカウントを選択します。	使用している既存のストレージアカウントの名前を選びます。
Select an Application Insights resource for your app. (アプリの Application Insights のリソースを選択してください。)	[Application Insights リソースの新規作成] を選択し、プロンプトで、関数の実行時データを格納するためのインスタンスの名前を入力します。

関数アプリが作成され、展開パッケージが適用されると、通知が表示されます。この通知の [View Output](出力の表示) を選択すると、作成済みの Azure リソースなど、作成とデプロイの結果が表示されます。

関数コードをデプロイする

重要

既存の関数アプリにデプロイすると、Azure にあるそのアプリの内容が常に上書きされます。

Azure アクティビティの [リソース] 領域で、先ほど作成した関数アプリリソースを見つけて、リソースを右クリックし、[関数アプリにデプロイ] を選択します。
前のデプロイの上書きを求められたら、[デプロイ] を選択して、関数コードを新しい関数アプリリソースにデプロイします。
デプロイの完了後、[View Output] (出力の表示) を選択すると、作成済みの Azure リソースなど、作成とデプロイの結果が表示されます。通知を見逃した場合は、右下隅にあるベルアイコンを選択して、再度確認します。

アプリケーション設定を発行する

local.settings.json のローカル設定は自動的に発行されないため、関数が Azure で正しく実行されるように、それらを今すぐアップロードする必要があります。

コマンドパレットに「Azure Functions: ローカル設定のアップロード...」と入力し、リソースの選択 プロンプトで関数アプリの名前を選びます。

イベントサブスクリプションを再作成する

関数アプリが Azure で実行されるようになったので、新しいイベントサブスクリプションを作成する必要があります。この新しいイベントサブスクリプションでは、Azure の関数のエンドポイントが使用されます。また、イベントサブスクリプションにフィルターを追加して、コンテナーに JPEG (.jpg) ファイルが追加されたときにのみ関数がトリガーされるようにします。 Azure では、エンドポイント URL にもアクセスキーが含まれており、Event Grid 以外のアクターがエンドポイントにアクセスするのをブロックするのに役立ちます。

BLOB 拡張機能キーを取得する

Visual Studio Code のアクティビティバーで Azure アイコンを選択します。 [リソース] でサブスクリプションを展開し、[関数アプリ] を展開して、作成した関数アプリを右クリックし、[ポータルで開く] を選びます。
左側のメニューの [関数] で、[アプリキー] を選びます。
[システムキー] で、blobs_extension という名前のキーを選び、キーの値をコピーします。

この値は、新しいエンドポイント URL のクエリ文字列に含めます。

エンドポイント URL を作成する

次の例に基づいて、Blob Storage トリガーの新しいエンドポイント URL を作成します。

分離プロセス
インプロセス

https://<FUNCTION_APP_NAME>.azurewebsites.net/runtime/webhooks/blobs?functionName=Host.Functions.BlobTriggerEventGrid&code=<BLOB_EXTENSION_KEY>

https://<FUNCTION_APP_NAME>.azurewebsites.net/runtime/webhooks/blobs?functionName=BlobTriggerEventGrid&code=<BLOB_EXTENSION_KEY>

https://<FUNCTION_APP_NAME>.azurewebsites.net/runtime/webhooks/blobs?functionName=Host.Functions.BlobTriggerEventGrid&code=<BLOB_EXTENSION_KEY>

この例で、<FUNCTION_APP_NAME> を関数アプリの名前に置き換え、<BLOB_EXTENSION_KEY> をポータルから取得した値に置き換えます。関数に別の名前を使用した場合は、必要に応じて functionName クエリ文字列を変更する必要もあります。

フィルター処理されたイベントサブスクリプションを作成する

イベントサブスクリプションのエンドポイント URL は変更できないため、新しいイベントサブスクリプションを作成する必要があります。また、以前のイベントサブスクリプションは再利用できないため、この時点で削除する必要があります。

今回は、JPEG ファイル (*.jpg) のみが関数をトリガーするように、イベントサブスクリプションにフィルターを含めます。

Visual Studio Code のアクティビティバーで Azure アイコンを選択します。 [リソース] でサブスクリプションを展開し、[ストレージアカウント] を展開して、前に作成したストレージアカウントを右クリックし、[ポータルで開く] を選びます。
Azure portal で、左側のメニューから [イベント] オプションを選びます。
[イベント] ウィンドウで、以前の ngrok ベースのイベントサブスクリプションを選び、[削除]>[保存] を選びます。このアクションにより、以前のイベントサブスクリプションが削除されます。

[+ イベントサブスクリプション] ボタンを選び、次の表の値を [基本] タブに入力します。

設定	提案された値	Description
名前	myBlobAzureEventSub	イベントサブスクリプションを識別する名前。この名前を使用すると、イベントサブスクリプションをすばやく見つけることができます。
イベントスキーマ	イベントグリッドスキーマ	イベントには既定のスキーマを使用します。
イベントの種類のフィルター	作成された BLOB
エンドポイントの種類	Web Hook	BLOB ストレージトリガーでは、Web hook エンドポイントが使用されます。 Event Grid トリガーには Azure Functions を使用します。
エンドポイント	新しい Azure ベースの URL エンドポイント	作成した URL エンドポイント (キー値を含む) を使用します。

[選択の確認] を選び、エンドポイント URL を検証します。
[フィルター] タブを選び、[サブジェクトフィルター] で [サブジェクトフィルタリングを有効にする] チェックボックスをオンにして、[次で終わるサブジェクト] に .jpg を入力します。これにより、イベントが JPEG ファイルのみにフィルター処理されます。
[作成] を選び、イベントサブスクリプションを作成します。

Azure で関数を検証する

これでトポロジ全体で Azure が実行されるようになったので、次はすべてが正しく動作していることを確認します。既にポータルを開いているので、そこからファイルをアップロードするのが最も簡単です。

ポータルのストレージアカウントページで、[コンテナー] を選び、samples-workitems コンテナーを選びます。
[アップロード] ボタンを選んで右側のアップロードページを開き、ローカルファイルシステムを参照してアップロードする .jpg ファイルを見つけ、[アップロード] ボタンを選んで BLOB をアップロードします。これで、コンテナーのアップロードイベントに基づいて関数が実行されたことを確認できます。
ストレージアカウントで [イベント] ページに戻り、[イベントサブスクリプション] を選ぶと、イベントが配信されたことがわかります。
ポータルの関数アプリページに戻り、[関数] で [関数] を選び、関数を選択すると、少なくとも 1 つの合計実行回数が表示されます。
[開発者] で [監視] を選ぶと、正常に実行された関数から書き込まれたトレースが表示されます。イベントは Application Insights によって処理されるため、最大 5 分間の遅延が発生する可能性があります。

リソースをクリーンアップする

この後、次の手順に進んで Azure Storage キューバインドを関数に追加する場合、既存の作業をベースにするので、リソースはすべてそのままにしておく必要があります。

それ以外の場合は、追加コストの発生を避けるために、次の手順に従って関数アプリとその関連リソースを削除してください。

Visual Studio Code で、F1 キーを押してコマンドパレットを開きます。コマンドパレットで、Azure: Open in portal を検索して選択します。
関数アプリを選択し、Enter キーを押します。その関数アプリのページが Azure portal で開きます。
[概要] タブで、 [リソースグループ] の横にある名前付きリンクを選択します。
[リソースグループ] ページで、含まれているリソースの一覧を確認し、削除するものであることを確認します。
[リソースグループの削除] を選択し、指示に従います。

削除には数分かかることがあります。実行されると、通知が数秒間表示されます。ページの上部にあるベルのアイコンを選択して、通知を表示することもできます。

Functions のコストについて詳しくは、「従量課金プランのコストの見積もり」を参照してください。

チュートリアル: イベントサブスクリプションを使用して BLOB コンテナーで Azure Functions をトリガーする

前提条件

ストレージアカウントの作成

BLOB によってトリガーされる関数を作成する

Storage 拡張機能をアップグレードする

イベントを使用するように関数を更新する

ローカルデバッグを開始する

BLOB トリガーエンドポイントを決定する

ngrok を実行する

エンドポイント URL を作成する

デバッグを開始する

イベントサブスクリプションを作成する

コンテナーにファイルをアップロードする

Azure にプロジェクトを発行する

Function App の作成

関数コードをデプロイする

アプリケーション設定を発行する

イベントサブスクリプションを再作成する

BLOB 拡張機能キーを取得する

エンドポイント URL を作成する

フィルター処理されたイベントサブスクリプションを作成する

Azure で関数を検証する

リソースをクリーンアップする

次のステップ

その他のリソース

チュートリアル: イベント サブスクリプションを使用して BLOB コンテナーで Azure Functions をトリガーする

前提条件

ストレージ アカウントの作成

BLOB によってトリガーされる関数を作成する

Storage 拡張機能をアップグレードする

イベントを使用するように関数を更新する

ローカル デバッグを開始する

BLOB トリガー エンドポイントを決定する

ngrok を実行する

エンドポイント URL を作成する

デバッグを開始する

イベント サブスクリプションを作成する

コンテナーにファイルをアップロードする

Azure にプロジェクトを発行する

Function App の作成

関数コードをデプロイする

アプリケーション設定を発行する

イベント サブスクリプションを再作成する

BLOB 拡張機能キーを取得する

エンドポイント URL を作成する

フィルター処理されたイベント サブスクリプションを作成する

Azure で関数を検証する

リソースをクリーンアップする

次のステップ

その他のリソース

チュートリアル: イベントサブスクリプションを使用して BLOB コンテナーで Azure Functions をトリガーする

ストレージアカウントの作成

ローカルデバッグを開始する

BLOB トリガーエンドポイントを決定する

イベントサブスクリプションを作成する

イベントサブスクリプションを再作成する

フィルター処理されたイベントサブスクリプションを作成する