Azure Event Grid システムトピックを別のリージョンに再配置する

[アーティクル]
07/30/2024

この記事では、Event Grid システムトピックを別のリージョンに再配置する際に推奨されるアプローチ、ガイドライン、およびプラクティスについて説明します。

既存の Azure リソースを 1 つのリージョンから他のリージョンに移動する必要が生じる理由は多数存在します。以下を行うことができます。

新しい Azure リージョンの利点を活用する。
特定のリージョンでしか利用できない機能やサービスをデプロイする。
内部ポリシーやガバナンスの要件を満たす。
会社の合併と買収に合わせた調整を行う
容量計画の要件を満たす。

この記事で説明する手順の概要を次に示します。

Azure Storage アカウントとそれに関連付けられているシステムトピックを含むリソースグループを Resource Manager テンプレートにエクスポートします。また、システムトピックのみのテンプレートをエクスポートすることもできます。この方法を使用する場合は、システムトピックを移動する前に、Azure イベントソース (この例では Azure Storage アカウント) を他のリージョンに移動することを忘れないでください。その後、エクスポートされたシステムトピックのテンプレートで、ターゲットリージョンのストレージアカウントの外部 ID を更新します。
テンプレートを変更して、システムトピックをサブスクライブする webhook を指すように endpointUrl プロパティを追加します。システムトピックをエクスポートすると、そのサブスクリプション (この場合は webhook) もテンプレートにエクスポートされますが、endpointUrl プロパティは含められません。そのため、トピックをサブスクライブするエンドポイントを指すように更新する必要があります。また、location プロパティの値を新しい場所またはリージョンに更新します。その他の種類のイベントハンドラーの場合は、場所のみを更新する必要があります。
テンプレートを使用して、リソースをターゲットリージョンにデプロイします。ターゲットリージョンに作成されるストレージアカウントとシステムトピックの名前を指定します。
展開を確認する。ターゲットリージョンの BLOB ストレージにファイルをアップロードするときに、webhook が呼び出されることを確認します。
移動を完了するには、ソースリージョンからリソース (イベントソースとシステムトピック) を削除します。

前提条件

「Quickstart:Azure portal で Blob Storage のイベントを Web エンドポイントにルーティングする」をソースリージョンで実行します。この手順は省略可能です。この記事の手順をテストする場合に実行します。ストレージアカウントは、App Service および App Service プランとは別のリソースグループに保持します。
ターゲットリージョンで Event Grid サービスを使用できることを確認します。「リージョン別の利用可能な製品」を参照してください。

準備

開始するには、システムイベントのソース (Azure Storage アカウント) とそれに関連付けられているシステムトピックが含まれているリソースグループの Resource Manager テンプレートをエクスポートします。

Azure portal にサインインします。
左側のメニューの [リソースグループ] を選択します。次に、システムトピックが作成されたイベントソースが含まれているリソースグループを選択します。次の例では、Azure Storage アカウントです。リソースグループには、ストレージアカウントとそれに関連付けられているシステムトピックが含まれています。
左側のメニューで、 [設定] にある [テンプレートのエクスポート] を選択し、ツールバーの [ダウンロード] を選択します。
ポータルからダウンロードした .zip ファイルを見つけて、選択したフォルダーにそのファイルを解凍します。この ZIP ファイルには、テンプレートとパラメーターの JSON ファイルが含まれています。
任意のエディターで template.json を開きます。
Webhook の URL は、テンプレートにエクスポートされません。そのため、次の手順を実行します。
1. テンプレートファイルで、WebHook を探します。
2. Properties セクションで、最後の行の末尾にコンマ (,) 文字を追加します。この例では "preferredBatchSizeInKilobytes": 64 です。
3. 次の例に示すように、endpointUrl プロパティを追加し、値を Webhook の URL に設定します。
```
"destination": {
    "properties": {
        "maxEventsPerBatch": 1,
        "preferredBatchSizeInKilobytes": 64,
        "endpointUrl": "https://mysite.azurewebsites.net/api/updates"
    },
    "endpointType": "WebHook"
}
```
  Note
  
  その他の種類のイベントハンドラーの場合は、すべてのプロパティがテンプレートにエクスポートされます。次の手順で示すように、location プロパティをターゲットリージョンに更新する必要があるだけです。
ストレージアカウント リソースの location をターゲットリージョンまたは場所に更新します。場所コードを取得するには、Azure の場所に関するページを参照してください。リージョンのコードは、スペースを含まないリージョン名です (例えば、West US は westus と同じです)。
```
"type": "Microsoft.Storage/storageAccounts",
"apiVersion": "2019-06-01",
"name": "[parameters('storageAccounts_spegridstorage080420_name')]",
"location": "westus",
```

この手順を繰り返して、テンプレートのシステムトピック リソースの location を更新します。

"type": "Microsoft.EventGrid/systemTopics",
"apiVersion": "2020-04-01-preview",
"name": "[parameters('systemTopics_spegridsystopic080420_name')]",
"location": "westus",

テンプレートを [保存] します。

Redeploy

テンプレートをデプロイして、ターゲットリージョンにストレージアカウントとストレージアカウントのシステムトピックを作成します。

Azure Portal で、 [リソースの作成] を選択します。
[Marketplace を検索] で「template deployment」と入力し、Enter キーを押します。
[テンプレートのデプロイ] を選択します。
［作成］ を選択します
[Build your own template in the editor] (エディターで独自のテンプレートをビルド) を選択します。
[ファイルの読み込み] を選択し、手順に従って、前のセクションでダウンロードした template.json ファイルを読み込みます。
[保存] を選択してテンプレートを保存します。
[カスタムデプロイ] ページで、次の手順を行います。
1. Azure サブスクリプションを選択します。
2. ターゲットリージョンの既存のリソースグループを選択するか、新しく作成します。
3. [リージョン] で、ターゲットリージョンを選択します。既存のリソースグループを選択した場合、この設定は読み取り専用になります。
4. システムのトピック名で、ストレージアカウントに関連付けるシステムトピックの名前を入力します。
5. ストレージアカウント名 で、ターゲットリージョンに作成するストレージアカウントの名前を入力します。
6. ページ下部にある [確認と作成] を選択します。
7. [確認および作成] ページで、設定を確認し、 [作成] を選択します。

確認

デプロイが成功したら、 [リソースグループに移動] を選択します。
[リソースグループ] ページで、イベントソース (この例では Azure Storage アカウント) とシステムトピックが作成されていることを確認します。
Azure BLOB ストレージ内のコンテナーにファイルをアップロードし、webhook がイベントを受信したことを確認します。詳細については、「エンドポイントへのイベントの送信」を参照してください。

破棄またはクリーンアップ

移動を完了するには、ソースリージョンでストレージアカウントとそれに関連付けられているシステムトピックを含むリソースグループを削除します。

最初からやり直す場合は、ターゲットリージョンのリソースグループを削除し、この記事の「準備」と「再作成する」のセクションの手順を繰り返します。

Azure portal を使用してリソースグループ (ソースまたはターゲット) を削除するには、次の手順を実行します。

Azure portal の上部にある検索ウィンドウで「リソースグループ」と入力し、検索結果から [リソースグループ] を選択します。
削除するリソースグループを選択し、ツールバーの [削除] を選択します。
[確認] ページで、リソースグループの名前を入力し、 [削除] を選択します。

リージョン間でカスタムトピックを再配置する。
リージョン間でドメインを再配置する。
「リソースを新しいリソースグループまたはサブスクリプションに移動する」という記事を参照してください。

次の方法で共有

Azure Event Grid システムトピックを別のリージョンに再配置する

前提条件

準備

Redeploy

確認

破棄またはクリーンアップ

フィードバック

その他のリソース

次の方法で共有

Azure Event Grid システム トピックを別のリージョンに再配置する

前提条件

準備

Redeploy

確認

破棄またはクリーンアップ

関連するコンテンツ

フィードバック

その他のリソース

Azure Event Grid システムトピックを別のリージョンに再配置する