servizio Azure Kubernetes Communication Manager (anteprima)

Gestione comunicazioni del servizio Azure Kubernetes semplifica le notifiche per tutte le attività di manutenzione del servizio Azure Kubernetes usando le notifiche delle risorse di Azure e i framework di Azure Resource Graph. Questo strumento consente di monitorare attentamente gli aggiornamenti fornendo avvisi tempestivi sui trigger e sui risultati degli eventi. Se la manutenzione ha esito negativo, informa l'utente con i motivi dell'errore, riducendo i problemi operativi correlati all'osservabilità e ai follow-up. Attualmente in anteprima, è possibile configurare le notifiche per tutti i tipi di aggiornamenti automatici che utilizzano finestre di manutenzione seguendo questa procedura.

Prerequisiti

• Configurare il cluster per il canale di aggiornamento automatico o per il canale di aggiornamento automatico del nodo.

• Creare la finestra Manutenzione pianificata come indicato qui per la configurazione dell'aggiornamento automatico.

Come configurare la gestione delle comunicazioni

1. Creare una risorsa "App per la logica" di Azure. Viene usato per inviare notifiche sugli eventi di aggiornamento automatico al messaggio di posta elettronica.

2. Aprire l'app per la logica creata e fare clic su "Progettazione app per la logica", quindi fare clic sul pulsante "Aggiungi un trigger".

3. Nella casella "Aggiungi un trigger" aperto digitare "http" nella casella di ricerca e quindi selezionare il trigger "Quando viene ricevuta una richiesta HTTP".

4. Nell'oggetto aperto "Quando viene ricevuta una richiesta HTTP", fare clic su "Usa payload di esempio per generare lo schema".

5. Nella casella "Enter or paste a sample JSON payload" (Immettere o incollare un payload JSON di esempio) incollare i dati JSON seguenti e fare clic sul pulsante "Fine".

 {
   "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"
 }
]

6. Fare clic sul pulsante "+" e su "Aggiungi un'azione". Accedere quindi all'account di posta elettronica preferito in outlook.com con password.

   

7. Nella casella di ricerca aperta "Aggiungi un'azione" digitare "outlook" e quindi selezionare l'azione "Invia un messaggio di posta elettronica (V2)".

8. Personalizzare fornendo un messaggio di posta elettronica del destinatario. Fare clic sui campi Oggetto e Corpo e c'è un'icona di illuminazione minuscola che fornisce campi dati incapsulati dal messaggio, per facilitare l'orchestrazione del contenuto della posta elettronica.

9. Fare clic sul pulsante "Save" (Salva).

10. Fare clic sul pulsante "Quando viene ricevuta una richiesta HTTP" e copiare l'URL nel campo "HTTP POST URL". Questo URL viene usato a breve per configurare l'hook Web della sottoscrizione di eventi.

Creare un argomento di sistema ARN e una sottoscrizione di eventi.

Fare clic su "Sottoscrizione eventi" per creare una sottoscrizione di eventi dell'argomento di sistema.

Compilare quindi le informazioni sulla sottoscrizione di eventi, in "Tipo endpoint", scegliere "Web hook" e configurarlo usando l'URL quando si configura il trigger "Quando viene ricevuta una richiesta HTTP".

È anche possibile farlo tramite l'interfaccia della riga di comando, come illustrato qui

    az eventgrid system-topic create --name arnSystemTopic --resource-group testrg --source /subscriptions/TestSub --topic-type microsoft.resourcenotifications.containerserviceeventresources --location global 

Configurare le notifiche di ricezione per le risorse in un gruppo di risorse, abilitare il filtro dell'oggetto con l'URI del gruppo di risorse.

Verifica

Attendere l'avvio dell'aggiornamento automatico del cluster. Verificare quindi se si ricevono avvisi tempestivamente sul messaggio di posta elettronica configurato per ricevere queste comunicazioni.

Controllare il database di Azure Resource Graph per il record di notifica pianificato. Ogni notifica di evento pianificata deve essere elencata come un record nella tabella "containerserviceeventresources". !

Passaggi successivi

Scopri come configurare una finestra di manutenzione pianificata per gli aggiornamenti. Scopri come ottimizzare gli aggiornamenti.