Spravované aplikace Azure s oznámeními

Článek
11/09/2021
4 min ke čtení

Oznámení spravovaných aplikací Azure umožňují vydavatelům automatizovat akce na základě událostí životního cyklu instancí spravovaných aplikací. Vydavatelé mohou určit vlastní koncové body webhooku oznámení pro příjem oznámení událostí o nových a existujících instancích spravovaných aplikací. Vydavatelé mohou nastavit vlastní pracovní postupy v době zřizování, aktualizací a odstraňování aplikací.

Začínáme

Pokud chcete začít přijímat spravované aplikace, spusťte veřejný koncový bod HTTPS a zadejte ho při publikování definice aplikace katalogu služeb nebo Azure Marketplace nabídky.

Tady je doporučený postup, jak rychle začít:

Zrušte veřejný koncový bod HTTPS, který zachytá příchozí požadavky POST a vrátí 200 OK .
Přidejte koncový bod do definice aplikace katalogu služeb nebo Azure Marketplace, jak je vysvětleno dále v tomto článku.
Vytvořte instanci spravované aplikace, která odkazuje na definici aplikace nebo Azure Marketplace nabídku.
Ověřte, že se oznámení přijímá.
Povolte autorizaci, jak je vysvětleno v části Ověřování koncového bodu tohoto článku.
Postupujte podle pokynů v části Schéma oznámení tohoto článku a parsujte požadavky na oznámení a implementujte obchodní logiku na základě oznámení.

Přidání oznámení o definicích aplikací katalogu služeb

portál Azure

Pokud chcete začít, podívejte se na stránku Publikování aplikace katalogu služeb Azure Portal.

Oznámení o definicích aplikací katalogu služeb v Azure Portal

REST API

Poznámka

V současné době můžete ve vlastnostech definice aplikace zadat pouze jeden notificationEndpoints koncový bod.

    {
      "properties": {
        "isEnabled": true,
        "lockLevel": "ReadOnly",
        "displayName": "Sample Application Definition",
        "description": "Notification-enabled application definition.",
        "notificationPolicy": {
            "notificationEndpoints": [
                {
                    "uri": "https://isv.azurewebsites.net:1214?sig=unique_token"
                }
            ]
        },
        "authorizations": [
          {
            "principalId": "d6b7fbd3-4d99-43fe-8a7a-f13aef11dc18",
            "roleDefinitionId": "8e3af657-a8ff-443c-a75c-2fe8c4bcb635"
          },
        ...

Přidání Azure Marketplace spravovaných aplikací

Další informace najdete v tématu Vytvoření nabídky aplikací Azure.

Azure Marketplace oznámení spravovaných aplikací v Azure Portal

Aktivační události

Následující tabulka popisuje všechny možné kombinace EventType a ProvisioningState a jejich aktivačních událostí:

Typ události	ProvisioningState (Stav zřizování)	Trigger pro oznámení
PUT	Přijato	Spravovaná skupina prostředků se vytvořila a úspěšně promítla po put aplikace (před zahájením nasazení ve spravované skupině prostředků).
PUT	Úspěšný	Úplné zřízení spravované aplikace bylo po put úspěšné.
PUT	Neúspěšný	Selhání PUT zřizování instance aplikace v jakémkoli bodě.
OPRAVA	Úspěšný	Po úspěšném provedení opravy PATCH v instanci spravované aplikace aktualizujte značky, zásady přístupu JIT nebo spravovanou identitu.
DELETE	odstraňování	Jakmile uživatel zahájí odstranění instance spravované aplikace.
DELETE	Odstraněné	Po úplném a úspěšném odstranění spravované aplikace.
DELETE	Neúspěšný	Po jakékoli chybě během procesu zrušení zřizování, která odstranění blokuje.

Schéma oznámení

Když zřídíte koncový bod webhooku pro zpracování oznámení, budete muset datovou část parsovat, abyste měli důležité vlastnosti a pak s oznámením zacházet. Oznámení katalogu služeb a Azure Marketplace spravovaných aplikací poskytují mnoho stejných vlastností. V tabulce, která následuje po ukázkách, jsou uvedené dva malé rozdíly.

Schéma oznámení aplikace katalogu služeb

Tady je ukázkové oznámení katalogu služeb po úspěšném zřízení instance spravované aplikace:

POST https://{your_endpoint_URI}/resource?{optional_parameter}={optional_parameter_value} HTTP/1.1

{
    "eventType": "PUT",
    "applicationId": "/subscriptions/<subId>/resourceGroups/<rgName>/providers/Microsoft.Solutions/applications/<applicationName>",
    "eventTime": "2019-08-14T19:20:08.1707163Z",
    "provisioningState": "Succeeded",
    "applicationDefinitionId": "/subscriptions/<subId>/resourceGroups/<rgName>/providers/Microsoft.Solutions/applicationDefinitions/<appDefName>"    
}

Pokud zřizování selže, do zadaného koncového bodu se zobrazí oznámení s podrobnostmi o chybě.

POST https://{your_endpoint_URI}/resource?{optional_parameter}={optional_parameter_value} HTTP/1.1

{
    "eventType": "PUT",
    "applicationId": "subscriptions/<subId>/resourceGroups/<rgName>/providers/Microsoft.Solutions/applications/<applicationName>",
    "eventTime": "2019-08-14T19:20:08.1707163Z",
    "provisioningState": "Failed",
    "applicationDefinitionId": "/subscriptions/<subId>/resourceGroups/<rgName>/providers/Microsoft.Solutions/applicationDefinitions/<appDefName>",
    "error": {
        "code": "ErrorCode",
        "message": "error message",
        "details": [
            {
                "code": "DetailedErrorCode",
                "message": "error message"
            }
        ]
    }
}

Azure Marketplace schématu oznámení aplikace