イベント ハブを経由してメッセージを送受信するアプリケーションを構成する
イベント ハブを作成して構成したので、ハブを介してイベント データ ストリームを送受信するように、アプリケーションを構成する必要があります。
たとえば、支払い処理ソリューションは、顧客のクレジット カード データを収集するための何らかの形式のセンダー アプリケーションと、そのクレジット カードが有効であることを検証するためのレシーバー アプリケーションを使用します。
.NET アプリケーションと比較すると、Java アプリケーションの構成方法には相違点があります。 ただし、アプリケーションがイベント ハブに接続し、メッセージを正常に送受信できるようにするための原則は同じです。
Event Hubs でアプリケーションを構成するための最少要件は何ですか?
イベント ハブにメッセージを送信できるようにアプリケーションを構成するには、次の情報を指定して、アプリケーションによって接続の資格証明が作成されるようにします。
- イベント ハブ名前空間の名前
- イベント ハブ名
- 共有アクセス ポリシー名
- プライマリ共有アクセス キー
イベント ハブからメッセージを受信できるようにアプリケーションを構成するには、次の情報を指定して、アプリケーションによって接続の資格証明が作成されるようにします。
- イベント ハブ名前空間の名前
- イベント ハブ名
- 共有アクセス ポリシー名
- プライマリ共有アクセス キー
- ストレージ アカウント名
- ストレージ アカウントの接続文字列
- ストレージ アカウント コンテナーの名前
Azure Blob Storage 内にメッセージを保存するレシーバー アプリケーションがある場合は、ストレージ アカウントも構成する必要があります。
汎用の標準ストレージ アカウントを作成する Azure CLI コマンド
Azure CLI によって、ストレージ アカウントの作成と管理に使用できるコマンドのセットが提供されます。 次のユニットではそれらを使用しますが、ここではコマンドの概要を以下に示します。
ヒント
モジュール「Azure Storage の概要」から始まる、ストレージ アカウントに対応する MS 学習モジュールがいくつかあります。
| コマンド | 説明 |
|---|---|
storage account create |
汎用 v2 ストレージ アカウントを作成します。 |
storage account key list |
ストレージ アカウント キーを取得します。 |
storage account show-connection-string |
Azure Storage アカウントへの接続文字列を取得します。 |
storage container create |
ストレージ アカウントに新しいコンテナーを作成します。 |
アプリケーションの GitHub リポジトリをクローンするシェル コマンド
Git は分散型バージョン管理モデルを使用するコラボレーション ツールであり、ソフトウェアおよびドキュメント プロジェクトでの共同作業向けに設計されています。 Windows を含む複数のプラットフォームで Git クライアントを利用することができ、Git コマンド ラインは Azure Bash Cloud Shell に含まれています。 GitHub は Git リポジトリに対する Web ベースのホスティング サービスです。
GitHub 内でプロジェクトとしてホストされているアプリケーションがある場合は、git clone コマンドを使用して、リポジトリをクローンすることにより、プロジェクトのローカル コピーを作成することができます。
Cloud Shell でファイルを編集する
Cloud Shell の組み込みエディターのいずれかを使用して、アプリケーションを構成するすべてのファイルを変更できます。 たとえば、組み込みのエディターを使用して、イベント ハブ名前空間、イベント ハブ名、共有アクセス ポリシー名、および主キーを追加できます。
Azure Cloud Shell では、nano、vim、emacs、および Cloud Shell エディター (コード) がサポートされています。 目的のエディターの名前を入力するだけで、それが環境内で起動します。 次のユニットでは、Cloud Shell エディター (code) を使用します。
まとめ
Event Hubs 環境に関する特定の情報を使用して、送信側アプリケーションと受信側アプリケーションを構成する必要があります。 受信側アプリケーションでメッセージを Blob Storage に格納する場合は、ストレージ アカウントを作成する必要があります。 アプリケーションが GitHub でホストされている場合は、それをローカル ディレクトリにクローンする必要があります。 nano などのテキスト エディターを使って、アプリケーションに名前空間を追加できます。