Események létrehozása és közzététele

A következőkre vonatkozik: ✔️ Windows rendszerű virtuális ✔️ gépek Linux ✔️ rendszerű virtuális gépek helyszíni környezete ✔️ Azure Arc-kompatibilis kiszolgálók Azure-beli virtuális gépek ✔️.

Az elő- és utóesemények lehetővé teszik a felhasználó által meghatározott műveletek végrehajtását az ütemezett karbantartási konfiguráció előtt és után. További információkért tekintse át az elő- és közzétételi események működését az Azure Update Managerben.

Ez a cikk bemutatja, hogyan hozhat létre elő- és közzétételi eseményeket az Azure Update Managerben.

Event Grid ütemezési karbantartási konfigurációkban

Az Azure Update Manager az Event Gridet használja az események előtti és utáni események létrehozásához és kezeléséhez. További információkért tekintse át az Event Grid áttekintését. Egy esemény ütemezési karbantartási időszak előtt vagy után történő aktiválásához a következőkre van szükség:

1. Karbantartási konfiguráció ütemezése – Elő- és utórendezvényeket hozhat létre egy ütemezési karbantartási konfigurációhoz az Azure Update Managerben. További információ: frissítések ütemezése karbantartási konfigurációkkal.
2. Az esemény előtti vagy utáni eseményben végrehajtandó művelet – Az Event Grid által támogatott eseménykezelők (végpontok) segítségével definiálhat műveleteket vagy feladatokat. Az alábbiakban példákat talál arra, hogyan hozhat létre Azure Automation-runbookokat a Webhooks és az Azure Functions használatával. Ezeken az eseménykezelőkön/végpontokon belül meg kell határoznia azokat a műveleteket, amelyeket az események előtti és utáni események részeként kell végrehajtani.
   1. Webhook - Hozzon létre egy PowerShell 7.2-runbookot, és csatolja a Runbookot egy webhookhoz.
   2. Azure-függvény - – Azure-függvény létrehozása.
3. Esemény előtti és utáni – Az alábbi szakaszban ismertetett lépéseket követve elő- és utóeseményt hozhat létre az ütemezési karbantartási konfigurációhoz. Az Event Grid Alapjai lapján használt kifejezésekről további információt az Event Grid feltételeiben talál.

Elő- és közzétételi esemény létrehozása

Események létrehozása elő- és utórendezvények létrehozása új ütemezési karbantartási konfiguráció létrehozásakor

Az Azure Portal használata

1. Jelentkezzen be az Azure Portalra , és lépjen az Azure Update Managerbe.

2. A Kezelés csoportban válassza a Gépek lehetőséget.

3. Válassza a frissítések ütemezése lehetőséget a menüszalag tetején.

4. A Karbantartási konfiguráció létrehozása lapon válassza az Események lapot.

5. Válassza az +Esemény-előfizetés lehetőséget az esemény előtti/utáni esemény létrehozásához.

6. Az Esemény-előfizetés hozzáadása lapon adja meg a következő adatokat: Az Esemény-előfizetés részletei szakaszban adja meg a megfelelő nevet.

   • Tartsa a sémát Event Grid-sémaként.
   • Adja meg az ebben a karbantartási konfigurációban létrehozott első esemény rendszertémakör-nevét . A rendszer automatikusan kitölti ugyanazt a rendszertémakör-nevet a következményes eseményekhez.
   • Az Eseménytípusok szakaszban válassza ki azokat az eseménytípusokat, amelyeket le szeretne küldeni a végpontra vagy a célhelyre. Választhatja a karbantartás előtti vagy a karbantartási esemény utáni eseményt , vagy mindkettőt. A karbantartási konfigurációk ütemezéséhez kapcsolódó eseménytípusokról az Azure-eseménytípusok című témakörben olvashat bővebben.
   • A Végpont részletei szakaszban válassza ki azt a végpontot, ahonnan a választ meg szeretné kapni.

7. A Hozzáadás gombra kattintva létrehozhatja az ütemezéshez tartozó elő- és közzétételi eseményeket a létrehozáskor.

   

Feljegyzés

A fenti folyamat során a Webhook és az Azure Functions a két eseménykezelő/végpont, amelyek közül választhat. Amikor a Hozzáadás lehetőséget választja, az esemény-előfizetés nem jön létre, hanem hozzáadódik a karbantartási konfigurációhoz. Az esemény-előfizetés az ütemezési karbantartási konfigurációval együtt jön létre.

A PowerShell használata

1. Hozzon létre egy karbantartási konfigurációt az itt felsorolt lépések végrehajtásával.

2.  # Obtain the Maintenance Configuration ID from Step 1 and assign it to MaintenanceConfigurationResourceId variable  
   
    $MaintenanceConfigurationResourceId = "/subscriptions/<subId>/resourceGroups/<Resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<Maintenance configuration Name>"
   
    # Use the same Resource Group that you used to create maintenance configuration in Step 1
   
    $ResourceGroupForSystemTopic = "<Resource Group for System Topic>"
   
    $SystemTopicName = "<System topic name>"
   
    $TopicType = "Microsoft.Maintenance.MaintenanceConfigurations"
   
    $SystemTopicLocation = "<System topic location>"
   
    # System topic creation
   
    New-AzEventGridSystemTopic -ResourceGroupName $ResourceGroupForSystemTopic -Name $SystemTopicName -Source $MaintenanceConfigurationResourceId -TopicType $TopicType -Location $SystemTopicLocation
   
    # Event subscription creation
   
    $IncludedEventTypes = @("Microsoft.Maintenance.PreMaintenanceEvent")
   
    # Webhook
   
    $EventSubscriptionName = "PreEventWebhook"
   
    $PreEventWebhookEndpoint = "<Webhook URL>"
   
    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Endpoint $PreEventWebhookEndpoint -IncludedEventType $IncludedEventTypes
   
    # Azure Function
   
    $dest = New-AzEventGridAzureFunctionEventSubscriptionDestinationObject -ResourceId "<Azure Function Resource Id>"
   
    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Destination $dest -IncludedEventType $IncludedEventTypes
   
   

A parancssori felület használata

1. Hozzon létre egy karbantartási konfigurációt az itt felsorolt lépések végrehajtásával.

2. 
    SystemTopicName="<System topic name> 
   
    # Use the same Resource Group that you used to create maintenance configuration in Step 1
   
    ResourceGroupName="<Resource Group mentioned in Step 1>"
   
    # Obtain the Maintenance Configuration ID from Step 1 and assign it to Source variable
   
    Source="/subscriptions/<subId>/resourceGroups/<Resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<Maintenance configuration Name>"
   
    TopicType="Microsoft.Maintenance.MaintenanceConfigurations"
   
    Location="<System topic location> "
   
    # System topic creation
   
    az eventgrid system-topic create --name $SystemTopicName --resource-group $ResourceGroupName --source $Source --topic-type $TopicType --location $Location
   
    # Event subscription creation
   
    IncludedEventTypes='("Microsoft.Maintenance.PreMaintenanceEvent")'
   
    # Webhook
   
    az eventgrid system-topic event-subscription create --name "<Event subscription name>" --resource-group $ResourceGroupName --system-topic-name $SystemTopicName --endpoint-type webhook --endpoint "<webhook URL>" --included-event-types IncludedEventTypes
   
    # Azure Function
   
    az eventgrid system-topic event-subscription create –name "<Event subscription name>" --resource-group $ResourceGroupName --system-topic-name $SystemTopicName --endpoint-type azurefunction --endpoint "<Azure Function ResourceId>" --included-event-types IncludedEventTypes
   
   

AZ API használata

1. Hozzon létre egy karbantartási konfigurációt az itt felsorolt lépések végrehajtásával.

2. # Rendszertémakör létrehozása További információ

   PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>?api-version=2022-06-15
   

   Kérés szövegtörzse:

   {
     "properties": {
       "source": "/subscriptions/<subscription Id>/resourceGroups/<resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<maintenance configuration name> ",
       "topicType": "Microsoft.Maintenance.MaintenanceConfigurations"
     },
     "location": "<location>"
   }
   

   # Esemény-előfizetés létrehozása További információ

   Engedélyezett eseménytípusok – Microsoft.Maintenance.PreMaintenanceEvent, Microsoft.Maintenance.PostMaintenanceEvent

   Webhook

   PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15
   

   Kérés szövegtörzse:

   {
     "properties": {
       "destination": {
         "endpointType": "WebHook",
         "properties": {
           "endpointUrl": "<Webhook URL>"
         }
       },
       "filter": {
         "includedEventTypes": [
           "Microsoft.Maintenance.PreMaintenanceEvent"
         ]
       }
     }
   }
   

   Azure-függvény

   PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15
   

   Kérelem törzse

   {
       "properties": {
           "destination": {
               "endpointType": "AzureFunction",
               "properties": {
                   "resourceId": "<Azure Function Resource Id>"
               }
           }
       },
       "filter": {
           "includedEventTypes": [
               "Microsoft.Maintenance.PostMaintenanceEvent"
           ]
       }
   }
   

   ---

Elő- és utórendezvények létrehozása meglévő ütemezési karbantartási konfigurációban

Az Azure Portal használata

1. Jelentkezzen be az Azure Portalra , és lépjen az Azure Update Managerbe.

2. A Kezelés csoportban válassza a Gépek és karbantartási konfigurációk lehetőséget.

3. A Karbantartási konfiguráció lapon válassza ki azt a karbantartási konfigurációt, amelyhez elő- és utóeseményt szeretne hozzáadni.

4. A kiválasztott Karbantartási konfiguráció lap Beállítások területén válassza az Események lehetőséget. Másik lehetőségként az Áttekintés területen válassza a kártya Létrehozása karbantartási eseményt.

   

5. Válassza a +Esemény-előfizetés lehetőséget a karbantartás előtti/utáni esemény létrehozásához.

   

6. Az Esemény-előfizetés létrehozása lapon adja meg a következő adatokat:

   • Az Esemény-előfizetés részletei szakaszban adja meg a megfelelő nevet.

   • Tartsa a sémát Event Grid-sémaként.

   • A Témakör részletei szakaszban adjon meg egy megfelelő nevet a rendszertémakör nevének.

   • Az Eseménytípusok szakaszban válassza ki azokat az eseménytípusokat, amelyeket le szeretne küldeni a végpontra vagy a célhelyre. Választhat a karbantartás előtti esemény és a karbantartás utáni esemény között. A karbantartási konfigurációk ütemezéséhez kapcsolódó eseménytípusokról az Azure-eseménytípusok című témakörben olvashat bővebben.

   • A Végpont részletei szakaszban válassza ki azt a végpontot, ahonnan a választ meg szeretné kapni.

     

7. A Létrehozás lehetőséget választva konfigurálhatja az elő- és közzétételi eseményeket egy meglévő ütemezésben.

A PowerShell használata

    $MaintenanceConfigurationResourceId = "/subscriptions/<subId>/resourceGroups/<Resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<Maintenance configuration Name>"

    $ResourceGroupForSystemTopic = "<Resource Group for System Topic>"

    $SystemTopicName = "<System topic name>"

    $TopicType = "Microsoft.Maintenance.MaintenanceConfigurations"

    $SystemTopicLocation = "<System topic location>"

    # System topic creation

    New-AzEventGridSystemTopic -ResourceGroupName $ResourceGroupForSystemTopic -Name $SystemTopicName -Source $MaintenanceConfigurationResourceId -TopicType $TopicType -Location $SystemTopicLocation

    # Event subscription creation

    $IncludedEventTypes = @("Microsoft.Maintenance.PreMaintenanceEvent")

    # Webhook

    $EventSubscriptionName = "PreEventWebhook"

    $PreEventWebhookEndpoint = "<Webhook URL>"

    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Endpoint $PreEventWebhookEndpoint -IncludedEventType $IncludedEventTypes

    # Azure Function

    $dest = New-AzEventGridAzureFunctionEventSubscriptionDestinationObject -ResourceId "<Azure Function Resource Id>"

    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Destination $dest -IncludedEventType $IncludedEventTypes

A parancssori felület használata

   SystemTopicName="<System topic name> 

   ResourceGroupName="<Resource Group for System Topic>"

   Source="/subscriptions/<subId>/resourceGroups/<Resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<Maintenance configuration Name>"

    TopicType="Microsoft.Maintenance.MaintenanceConfigurations"

    Location="<System topic location> "

   # System topic creation

    az eventgrid system-topic create --name $SystemTopicName --resource-group $ResourceGroupName --source $Source --topic-type $TopicType --location $Location

   # Event subscription creation

    IncludedEventTypes='("Microsoft.Maintenance.PreMaintenanceEvent")'

   # Webhook

    az eventgrid system-topic event-subscription create --name "<Event subscription name>" --resource-group $ResourceGroupName --system-topic-name $SystemTopicName --endpoint-type webhook --endpoint "<webhook URL>" --included-event-types IncludedEventTypes

   # Azure Function

    az eventgrid system-topic event-subscription create –name "<Event subscription name>" --resource-group $ResourceGroupName --system-topic-name $SystemTopicName --endpoint-type azurefunction --endpoint "<Azure Function ResourceId>" --included-event-types IncludedEventTypes

AZ API használata

# Rendszertémakör létrehozása További információ

PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>?api-version=2022-06-15

Kérés szövegtörzse:

{
  "properties": {
    "source": "/subscriptions/<subscription Id>/resourceGroups/<resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<maintenance configuration name> ",
    "topicType": "Microsoft.Maintenance.MaintenanceConfigurations"
  },
  "location": "<location>"
}

# Esemény-előfizetés létrehozása További információ

Engedélyezett eseménytípusok – Microsoft.Maintenance.PreMaintenanceEvent, Microsoft.Maintenance.PostMaintenanceEvent

Webhook

PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15

Kérés szövegtörzse:

{
  "properties": {
    "destination": {
      "endpointType": "WebHook",
      "properties": {
        "endpointUrl": "<Webhook URL>"
      }
    },
    "filter": {
      "includedEventTypes": [
        "Microsoft.Maintenance.PreMaintenanceEvent"
      ]
    }
  }
}

Azure-függvény

PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15

Kérelem törzse

{
    "properties": {
        "destination": {
            "endpointType": "AzureFunction",
            "properties": {
                "resourceId": "<Azure Function Resource Id>"
            }
        }
    },
    "filter": {
        "includedEventTypes": [
            "Microsoft.Maintenance.PostMaintenanceEvent"
        ]
    }
}

Következő lépések

• Az Azure Update Manager előzetes és közzétételi eseményeinek áttekintését itt tekintheti meg.
• Az elő- és utórendezvények kezelésével vagy az ütemezési futtatás megszakításával kapcsolatos információkért tekintse meg a karbantartás előtti és utáni konfigurációs eseményeket.
• Ha tudni szeretné, hogyan kapcsolhatja be és kapcsolhatja ki a virtuális gépeket webhookok használatával, tekintse meg az esemény előtti és utáni eseményeket.
• Ha tudni szeretné, hogyan kapcsolhatja be és kapcsolhatja ki a virtuális gépeket az Azure Functions használatával elő- és utórendezvényekkel, tekintse meg itt.