ラボ 09: Event Grid イベントの発行とサブスクライブ

Microsoft Azure ユーザーインターフェイス

Microsoft クラウドツールの動的な性質を考慮すると、このトレーニングコンテンツの開発の後に発生する Azure UI の変更に気付くかもしれません。その結果、ラボの指示とラボの手順が正しく整合しなくなる可能性があります。

Microsoft は、コミュニティから必要な変更の通知があったときに、このトレーニングコースを更新します。ただし、クラウドの更新は頻繁に発生するため、このトレーニングコンテンツの更新の前に UI の変更に気付く可能性があります。 これが発生した場合は、その変更に適応し、ラボでは必要に応じてそれらに対応してください。

Instructions

開始する前に

ラボ環境にサインインする

次の資格情報を使用して Windows 11 仮想マシン (VM) にサインインします。

ユーザー名: Admin
パスワード: Pa55w.rd

注: 仮想ラボ環境に接続するための手順は、インストラクターから提供されます。

インストールされているアプリケーションを確認する

Windows 11 デスクトップでタスクバーを探します。タスクバーには、このラボで使用する次のようなアプリケーションのアイコンが含まれています。

Microsoft Edge
Microsoft Visual Studio Code

課題シナリオ

このラボでは、コンテナーでホストされている概念実証 Web アプリから始めます。これは、Event Grid のサブスクライブに使用されます。このアプリを使用すると、イベントを送信し、そのイベントが成功したことを示す確認メッセージを受信できます。

アーキテクチャの図

ユーザーによる Event Grid イベントの発行とサブスクライブを示すアーキテクチャの図。

演習 1: Azure リソースを作成する

タスク 1: Azure portal を開く

タスクバーで、Microsoft Edge アイコンを選択します。
開いたブラウザーウィンドウで、Azure portal (https://portal.azure.com) に移動してから、このラボで使用するアカウントでサインインします。

注:初めて Azure portal にサインインする場合は、このポータルのツアーが表示されます。 [はじめに] を選択してツアーをスキップし、ポータルの使用を開始します。

タスク 2: Azure Cloud Shell を開く

Azure portal で [Cloud Shell] アイコン Cloud Shell アイコンを選択して Cloud Shell を開きます。 Cloud Shell が既定で PowerShell セッションに設定されている場合は、[Cloud Shell] メニューの [Bash に切り替える] を選択し、[確認] を選択します。

注: Cloud Shell は、大なり記号 (>) とアンダースコア文字 (_) で表されます。

Cloud Shell を初めて起動した場合は、リソースを作成するための一連のプロンプトが表示されます。次の表に示すアクションを実行します。

プロンプト	アクション
ページで、	[Bash] を選択します。
はじめに	[ストレージアカウントのマウント] を選択し、ドロップダウンから自分の [ストレージアカウントサブスクリプション] を選択し、最後に [適用] を選択します。
ストレージアカウントのマウント	[ストレージアカウントを自動的に作成する] を選択し、[次へ] を選択します。

Azure portal の Cloud Shell コマンドプロンプトで次のコマンドを実行して、Azure コマンドラインインターフェイス (Azure CLI) ツールのバージョンを取得します。
```
 az --version
```

タスク 3: Microsoft EventGrid プロバイダーの登録を確認する

[Cloud Shell] ペインで次のコマンドを実行して、リソースプロバイダー “Microsoft.EventGrid” が登録されたかどうかを確認します。
```
 az provider show --namespace Microsoft.EventGrid --query "registrationState"
```
Microsoft.EventGrid プロバイダーが既に登録されていることに注意してください。
[Cloud Shell] ペインを閉じます。

タスク 4: カスタム Event Grid トピックを作成する

Azure portal のナビゲーションウィンドウで [リソースの作成] を選択します。
[リソースの作成] ブレードで、[サービスとマーケットプレースの検索] テキストボックスに「Event Grid トピック」と入力し、Enter キーを押します。
Marketplace 検索結果ブレードで “Event Grid トピック” という結果を選択し、 [作成] を選択します。

[トピックの作成] ブレードの [基本] タブで、次のアクションを実行してから、 [詳細] タブを選択します。

設定	アクション
[サブスクリプション] ドロップダウンリスト	既定値のままにします
[リソースグループ] ドロップダウンリスト	[新規作成] を選択し、「PubSubEvents」と入力して、 [OK] を選択します
[名前] テキストボックス	「hrtopic [ご自分の名前] 」と入力します
[リージョン] ドロップダウンリスト	[米国東部] を選択します。

次のスクリーンショットには、 [基本] タブに構成されている設定が示されています。

[トピックの作成] ブレードで構成された設定を示すスクリーンショット

[詳細] タブで、[イベントスキーマ] ドロップダウンリストから [イベントグリッドスキーマ] エントリが選択されていることを確認し、[確認および作成] を選択します。
[確認と作成] タブで、前の手順で選択したオプションを確認します。
[作成] を選択し、指定した構成を使用して Event Grid トピックを作成します。

注: ラボを続行する前に、Azure がトピックの作成を完了するまで待ってください。トピックが作成されると、通知が届きます。

タスク 5: Web アプリに Azure Event Grid ビューアーをデプロイする

Azure portal のナビゲーションウィンドウで [リソースの作成] を選択します。
[リソースの作成] ブレードで、[サービスとマーケットプレースの検索] テキストボックスに「Web アプリ」と入力し、Enter キーを押します。
Marketplace 検索結果ブレードで “Web アプリ” という結果を選択し、 [作成] を選択します。

[Web アプリの作成] ブレードの [基本] タブで、次のアクションを実行してから、[Docker] タブを選択します。

設定	アクション
[サブスクリプション] ドロップダウンリスト	既定値のままにします
[リソースグループ] ドロップダウンリスト	リストで [PubSubEvents] を選択します。
[名前] テキストボックス	「eventviewer [ご自分の名前] 」と入力します
[公開] セクション	[Docker コンテナー] を選択します
[オペレーティングシステム] セクション	[Linux] を選択します
[リージョン] ドロップダウンリスト	[米国東部] を選択します。
Linux Plan (East US) セクション	[新規作成] を選択し、 [名前] テキストボックスに「EventPlan」と入力して、 [OK] を選択します
[価格プラン] セクション	既定値のままにします

次のスクリーンショットは、 [Web アプリの作成] ブレードで構成されている設定を示しています。

[Web アプリの作成] ブレードで構成された設定を示すスクリーンショット

[Docker] タブで、次のアクションを実行し、 [確認と作成] を選択します。

設定	アクション
[オプション] ドロップダウンリスト	[単一コンテナー] を選択します
[イメージのソース] ドロップダウンリスト	[Docker Hub] を選択します
[アクセスの種類] ドロップダウンリスト	[Public] を選択します
[イメージとタグ] テキストボックス	「microsoftlearning/azure-event-grid-viewer:latest」と入力します

次のスクリーンショットには、 [Docker] タブに構成されている設定が示されています。

[Web アプリの作成] の [Docker] タブで構成された設定を示すスクリーンショット

[確認と作成] タブで、前の手順で選択したオプションを確認します。
[作成] を選択し、指定した構成を使用して Web アプリを作成します。

注: ラボを続行する前に、Azure が Web アプリの作成を完了するまで待ってください。アプリが作成されると、通知が届きます。

確認

この演習では、ラボの残りの部分で使用する、Event Grid トピックと Web アプリを作成しました。

演習 2: Event Grid サブスクリプションを作成する

タスク 1: Event Grid ビューアー Web アプリにアクセスする

Azure portal のナビゲーションウィンドウで [リソースグループ] を選択します。
[リソースグループ] ブレードで、PubSubEvents リソースグループを選択します。
[PubSubEvents] ブレードで、eventviewer [自分の名前] Web アプリを選択すると、 [概要] セクションが表示されます。
[概要] セクションで、[要点] ペインの [既定のドメイン] の値を記録します。この値は、ラボの後半で使用します。
引き続き [概要] セクションで、 [参照] ボタンをクリックします。
現在実行中の Azure Event Grid ビューアー Web アプリを確認します。ラボの残りの部分で、この Web アプリを実行したままにします。

注: この Web アプリは、イベントがエンドポイントに送信されるとリアルタイムで更新されます。このアプリを使用して、ラボ全体でイベントを監視します。
Azure portal を表示する、現在開いているブラウザーウィンドウに戻ります。

タスク 2: 新しいサブスクリプションを作成する

Azure portal のナビゲーションウィンドウで [リソースグループ] を選択します。
[リソースグループ] ブレードで、このラボで先ほど作成した PubSubEvents リソースグループを選択します。
[PubSubEvents] ブレードで、このラボで先ほど作成した hrtopic [自分の名前] Event Grid トピックを選択します。
[Event Grid トピック] ブレードで、 [+ イベントサブスクリプション] を選択します。

[イベントサブスクリプションの作成] ブレードで、次のアクションを実行し、 [作成] を選択します。

設定	アクション
[名前] テキストボックス	「basicsub」と入力します
[イベントスキーマ] ドロップダウンリスト	[Event Grid スキーマ] を選択します
[エンドポイントの種類] ドロップダウンリスト	[Web hook] を選択します
エンドポイント	[エンドポイントを構成する] を選択します。 [サブスクライバーエンドポイント] テキストボックスに、前に記録しておいた Web アプリ URL の値を入力し、https:// プレフィックスが使用されていることを確認し、サフィックス /api/updates を追加して、 [選択の確認] を選択します。たとえば、Web アプリ URL の値が `http://eventviewerstudent.azurewebsites.net/` の場合は、サブスクライバーエンドポイントは `https://eventviewerstudent.azurewebsites.net/api/updates` になります。

次のスクリーンショットには、 [イベントサブスクリプションの作成] ブレードに構成されている設定が示されています。

[イベントサブスクリプションの作成] ブレードで構成された設定を示すスクリーンショット

注: ラボを続行する前に、Azure がサブスクリプションの作成を完了するまで待ってください。サブスクリプションが作成されると、通知が届きます。

タスク 3: サブスクリプション検証イベントを確認する

Azure Event Grid ビューアー Web アプリを表示しているブラウザーウィンドウに戻ります。
サブスクリプション作成プロセスの一環で作成された、Microsoft.EventGrid.SubscriptionValidationEvent イベントを確認します。
イベントを選択し、その JSON コンテンツを確認します。
Azure portal がある、現在開いているブラウザーウィンドウに戻ります。

タスク 4: サブスクリプションの資格情報を記録する

Azure portal のナビゲーションウィンドウで [リソースグループ] を選択します。
[リソースグループ] ブレードで、このラボで先ほど作成した PubSubEvents リソースグループを選択します。
[PubSubEvents] ブレードで、このラボで先ほど作成した hrtopic [自分の名前] Event Grid トピックを選択します。
[Event Grid トピック] ブレードで、 [トピックエンドポイント] フィールドの値を記録します。この値は、ラボの後半で使用します。
[設定] カテゴリで、 [アクセスキー] リンクを選択します。
[アクセスキー] セクションで、 [キー 1] テキストボックスの値を記録します。この値は、ラボの後半で使用します。

確認

この演習では、新しいサブスクリプションを作成し、その登録を検証し、トピックに新しいイベントを発行するために必要な資格情報を記録しました。

演習 3: .NET から Event Grid イベントを発行する

タスク 1: .NET プロジェクトを作成する

[スタート] 画面で、 [Visual Studio Code] タイルを選択します。
[ファイル] メニューの [フォルダーを開く] を選択します。
開いたエクスプローラーのウィンドウで、”Allfiles (F):\Allfiles\Labs\09\Starter\EventPublisher” を参照し、 [フォルダーの選択] を選択します。
[Visual Studio Code] ウィンドウで、上部のメニューバーから [ターミナル] メニューに移動し、 [新しいターミナル] を選択します。
次のコマンドを実行して、現在のフォルダーに EventPublisher という名前の新しい .NET プロジェクトを作成します。
```
 dotnet new console --framework net8.0 --name EventPublisher --output . 
```
注: dotnet new コマンドは、プロジェクトと同じ名前のフォルダーに新しいコンソール プロジェクトを作成します。
次のコマンドを実行して、NuGet から Azure.Messaging.EventGrid のバージョン 4.11.0 をインポートします。
```
 dotnet add package Azure.Messaging.EventGrid --version 4.11.0
```
注: dotnet add package コマンドは、NuGet から Microsoft.Azure.EventGrid パッケージを追加します。詳細については、「Azure.Messaging.EventGrid」を参照してください。
次のコマンドを実行して、.NET Web アプリをビルドします。
```
 dotnet build
```
[ターミナルの強制終了] またはごみ箱 アイコンを選択して、現在開いているターミナルおよび関連プロセスを閉じます。

タスク 2: Event Grid に接続するように Program クラスを変更する

[Visual Studio Code] ウィンドウの [エクスプローラー] ペインで、Program.cs ファイルを開きます。
Program.cs ファイルのコードエディタータブで、既存のファイルのすべてのコードを削除します。

次のコードを追加します。

 using Azure;
 using Azure.Messaging.EventGrid;
 using System;
 using System.Threading.Tasks;    
 public class Program
 {
     private const string topicEndpoint = "<topic-endpoint>";
     /* Update the topicEndpoint string constant by setting its value to the Topic
        Endpoint of the Event Grid topic that you recorded previously in this lab. */
     private const string topicKey = "<topic-key>";
     /* Update the topicKey string constant by setting its value to the Key of the Event Grid topic that you recorded previously in this lab. */     
     public static async Task Main(string[] args)
     {
         //Add Main code here
     }
 }

7 行目で、<topic-endpoint> プレースホルダーを、このラボで前に記録しておいた Event Grid トピックエンドポイントの値に置き換えます。
10 行目で、<topic-key> プレースホルダーを、このラボで前に記録しておいた Event Grid トピックのアクセスキーの値に置き換えます。

タスク 3: 新しいイベントを発行する

Program.cs ファイルの Main メソッドを次のコードで置き換えます。

 public static async Task Main(string[] args)
 {   
     /* To create a new variable named "endpoint" of type "Uri", 
        using the "topicEndpoint" string constant as a constructor parameter */
     Uri endpoint = new Uri(topicEndpoint);

     /* To create a new variable named "credential" of type "AzureKeyCredential",
        use the "topicKey" string constant as a constructor parameter. */
     AzureKeyCredential credential = new AzureKeyCredential(topicKey);

     /* To create a new variable named "client" of type "EventGridPublisherClient", 
        using the "endpoint" and "credential" variables as constructor parameters */
     EventGridPublisherClient client = new EventGridPublisherClient(endpoint, credential);

     /* To create a new variable named "firstEvent" of type "EventGridEvent",
        and populate that variable with sample data */        
     EventGridEvent firstEvent = new EventGridEvent(
         subject: $"New Employee: Alba Sutton",
         eventType: "Employees.Registration.New",
         dataVersion: "1.0",
         data: new
         {
             FullName = "Alba Sutton",
             Address = "4567 Pine Avenue, Edison, WA 97202"
         }
     );

     /* To create a new variable named "secondEvent" of type "EventGridEvent",
        and populate that variable with sample data */
     EventGridEvent secondEvent = new EventGridEvent(
         subject: $"New Employee: Alexandre Doyon",
         eventType: "Employees.Registration.New",
         dataVersion: "1.0",
         data: new
         {
             FullName = "Alexandre Doyon",
             Address = "456 College Street, Bow, WA 98107"
         }
     );

     /* To asynchronously invoke the "EventGridPublisherClient.SendEventAsync"
        method using the "firstEvent" variable as a parameter */
     await client.SendEventAsync(firstEvent);
     Console.WriteLine("First event published");

     /* To asynchronously invoke the "EventGridPublisherClient.SendEventAsync"
        method using the "secondEvent" variable as a parameter */
     await client.SendEventAsync(secondEvent);
     Console.WriteLine("Second event published");
 }

注: 詳細については、「AzureKeyCredential」を参照してください

注: Event Grid の詳細については、以下のリンクをクリックしてください。

EventGridPublisherClient

EventGridEvent
EventGridPublisherClient.SendEventAsync

Program.cs ファイルを保存します。
Visual Studio Code ウィンドウのメニューバーで、 [ターミナル] を選択し、 [新しいターミナル] を選択します。
次のコマンドを実行して、.NET Web アプリを実行します。
```
 dotnet run
```
注: ビルドエラーが発生した場合は、Allfiles (F):\Allfiles\Labs\09\Solution\EventPublisher フォルダーにある Program.cs ファイルを確認してください。
現在実行中のコンソールアプリケーションからの成功メッセージの出力を確認します。
[ターミナルの強制終了] またはごみ箱 アイコンを選択して、現在開いているターミナルおよび関連プロセスを閉じます。

タスク 4: 発行されたイベントを確認する

Azure Event Grid ビューアー Web アプリがあるブラウザーウィンドウに戻ります。
コンソールアプリケーションによって作成された Employees.Registration.New イベントを確認します。
任意のイベントを選択し、その JSON コンテンツを確認します。
Azure Portal に戻ります。

確認

この演習では、.NET コンソールアプリケーションを使用して、Event Grid トピックに新しいイベントを発行しました。