Azure Kubernetes Service 通信マネージャー (プレビュー)
AKS 通信マネージャーは、Azure リソース通知と Azure Resource Graph のフレームワークを使用して、すべての AKS メンテナンス タスクの通知を効率化します。 このツールを使用すると、イベント トリガーと結果に関するタイムリーなアラートを提供することで、アップグレードを注意深く監視できます。 メンテナンスが失敗した場合、失敗の理由を通知して、監視とフォローアップに関連する運用上の手間を軽減します。 現在プレビュー段階であり、次の手順に従って、メンテナンス期間を利用するすべての種類の自動アップグレードの通知を設定できます。
前提条件
自動アップグレード チャネルまたはノード自動アップグレード チャネル用にクラスターを構成します。
自動アップグレード構成についてここで説明れているように計画メンテナンス期間を作成します。
通信マネージャーの設定方法
- Azure "Logic App" リソースを作成します。 自動アップグレード イベント通知をメールに送信するために使用されます。
![Azure portal で Azure Logic Apps 用に作成されたブレードのスクリーンショット。[プランの種類] フィールドでは、[従量課金] が選択されています。](media/auto-upgrade-cluster/logic-apps.jpg)
- 作成したロジック アプリを開き、[ロジック アプリ デザイナー] をクリックし、[トリガーの追加] ボタンをクリックします。
- 開いた [トリガーの追加] ボックスで、検索ボックスに「http」と入力し、[HTTP 要求の受信時] トリガーを選択します。
![[HTTP 要求の受信時] を示すスクリーンショット。](media/auto-upgrade-cluster/trigger-1.jpeg)
- [HTTP 要求の受信時] が開いたら、[サンプルのペイロードを使用してスキーマを生成する] をクリックします。
- 開いた [サンプルの JSON ペイロードを入力するか、貼り付けます] ボックスに、次の JSON データを貼り付けて、[完了] ボタンをクリックします。
{
"id": "11112222-bbbb-3333-cccc-4444dddd5555",
"topic": "/subscriptions/66667777-aaaa-8888-bbbb-9999cccc0000",
"subject": "/subscriptions/66667777-aaaa-8888-bbbb-9999cccc0000/resourcegroups/comms-test/providers/Microsoft.ContainerService/managedClusters/comms-sp/scheduledEvents/55556666-ffff-7777-aaaa-8888bbbb9999",
"data": {
"resourceInfo": {
"id": "/subscriptions/66667777-aaaa-8888-bbbb-9999cccc0000/resourcegroups/comms-test/providers/Microsoft.ContainerService/managedClusters/comms-sp/scheduledEvents/55556666-ffff-7777-aaaa-8888bbbb9999",
"name": "55556666-ffff-7777-aaaa-8888bbbb9999",
"type": "Microsoft.ContainerService/managedClusters/scheduledEvents",
"location": "westus2",
"properties": {
"description": "ScheduledEvents",
"eventId": "22223333-cccc-4444-dddd-5555eeee6666",
"eventSource": "AutoUprader",
"eventStatus": "Started",
"eventDetails": "Start to upgrade security vhd",
"scheduledTime": "2024-04-16T22:17:12.103268606Z",
"startTime": "0001-01-01T00:00:00.0000000Z",
"lastUpdateTime": "0001-01-01T00:00:00.0000000Z",
"resources": [
"/subscriptions/66667777-aaaa-8888-bbbb-9999cccc0000/resourcegroups/comms-test/providers/Microsoft.ContainerService/managedClusters/comms-sp"
],
"resourceType": "ManagedCluster"
}
},
"operationalInfo": {
"resourceEventTime": "2024-04-16T22:17:12.1032748"
},
"apiVersion": "2023-11-02-preview"
},
"eventType": "Microsoft.ResourceNotifications.MaintenanceResources.ScheduledEventEmitted",
"dataVersion": "1",
"metadataVersion": "1",
"eventTime": "2024-04-16T22:17:12.1032748Z",
"EventProcessedUtcTime": "2024-04-16T22:36:09.9073134Z",
"PartitionId": 0,
"EventEnqueuedUtcTime": "2024-04-16T22:17:13.1700000Z"
}
]
"+" ボタンをクリックし、[アクションの追加] を選択します。 その後、パスワードを使用して、outlook.com で適切な電子メール アカウントにサインインします。
開いている [アクションの追加] ボックスで、検索ボックスに「outlook」と入力し、[メールの送信 (V2)] アクションを選択します。
- 受信者電子メールを指定してカスタマイズします。 [件名] フィールドと [本文] フィールドをクリックすると、電子メール コンテンツのオーケストレーションを容易にするために、メッセージからカプセル化されたデータ フィールドを提供する小さな照明アイコンが表示されます。
- [Save]\(保存\) ボタンをクリックします。
- [HTTP 要求の受信時] ボタンをクリックし、[HTTP POST URL] フィールドに URL をコピーします。 この URL は、イベント サブスクリプション Web hook の構成にすぐに使用されます。
ARN システム トピックとイベント サブスクリプションを作成します。
[イベント サブスクリプション] をクリックして、システム トピックのイベント サブスクリプションを作成します。
次に、イベント サブスクリプション情報を入力し、[エンドポイントの種類] で [Web hook] を選択し、"HTTP 要求の受信時" トリガーを構成するときに URL を使用して構成します。
次に示すように、CLI を使用して行うこともできます
az eventgrid system-topic create --name arnSystemTopic --resource-group testrg --source /subscriptions/TestSub --topic-type microsoft.resourcenotifications.containerserviceeventresources --location global
リソース グループ内のリソースの受信通知を構成し、リソース グループ URI で件名のフィルター処理を有効にします。
検証
自動アップグレードがクラスターのアップグレードを開始するまで待ちます。 次に、これらの通知を受信するように構成された電子メールで通知をすぐに受信するかどうかを確認します。
Azure Resource Graph データベースで、スケジュールされた通知レコードを確認します。 スケジュールされた各イベント通知は、"containerserviceeventresources" テーブルに 1 つのレコードとして一覧表示されます。 !
次のステップ
アップグレードの計画メンテナンス期間を設定する方法について説明します。 アップグレードを最適化する方法について説明します。
Azure Kubernetes Service