Quickstart: Gebeurtenissen verzenden van een privécontainerregister naar Event Grid

  • Artikel
  • 7 minuten om te lezen

Azure Event Grid is een volledig beheerde service voor gebeurtenisroutering die uniform gebeurtenisverbruik biedt met behulp van een model voor publiceren/abonneren. In deze quickstart gebruikt u de Azure CLI om een containerregister te maken, u te abonneren op registergebeurtenissen en vervolgens een voorbeeldwebtoepassing te implementeren om de gebeurtenissen te ontvangen. Ten slotte activeert u push containerafbeeldingen en gebeurtenissen en delete bekijkt u de nettolading van de gebeurtenis in de voorbeeldtoepassing.

Nadat u de stappen in dit artikel hebt voltooid, worden gebeurtenissen die vanuit uw containerregister naar Event Grid weergegeven in de voorbeeld-web-app:

Webbrowser met drie ontvangen gebeurtenissen voor het weergeven van de voorbeeldwebtoepassing

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Vereisten

  • Gebruik de bash-omgeving in Azure Cloud shell.

    Cloud Shell starten in een nieuw venster

  • Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren.

    • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht AZ login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij de Azure CLI voor aanvullende aanmeldingsopties.

    • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.

    • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

  • De Azure CLI-opdrachten in dit artikel zijn opgemaakt voor de Bash-shell. Als u een andere shell gebruikt, zoals PowerShell of de opdrachtprompt, moet u mogelijk regelcontanttekens of variabele toewijzingsregels dienovereenkomstig aanpassen. In dit artikel worden variabelen gebruikt om het aantal vereiste bewerkingen van opdrachten te minimaliseren.

Een resourcegroep maken

Een Azure-resourcegroep is een logische container waarin u uw Azure-resources implementeert en beheert. Met de volgende opdracht az group create maakt u een resourcegroep met de naam myResourceGroup in de regio eastus. Als u een andere naam voor uw resourcegroep wilt gebruiken, stelt u in RESOURCE_GROUP_NAME op een andere waarde.

RESOURCE_GROUP_NAME=myResourceGroup

az group create --name $RESOURCE_GROUP_NAME --location eastus

Een containerregister maken

Implementeer vervolgens een containerregister in de resourcegroep met de volgende opdrachten. Voordat u de opdracht az acr create gaat uitvoeren, stelt u in op een naam voor het ACR_NAME register. De naam moet uniek zijn binnen Azure en mag niet meer dan 5 tot 50 alfanumerieke tekens bevatten.

ACR_NAME=<acrName>

az acr create --resource-group $RESOURCE_GROUP_NAME --name $ACR_NAME --sku Basic

Zodra het register is gemaakt, retourneert de Azure CLI uitvoer die vergelijkbaar is met de volgende:

{
  "adminUserEnabled": false,
  "creationDate": "2018-08-16T20:02:46.569509+00:00",
  "id": "/subscriptions/<Subscription ID>/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myregistry",
  "location": "eastus",
  "loginServer": "myregistry.azurecr.io",
  "name": "myregistry",
  "provisioningState": "Succeeded",
  "resourceGroup": "myResourceGroup",
  "sku": {
    "name": "Basic",
    "tier": "Basic"
  },
  "status": null,
  "storageAccount": null,
  "tags": {},
  "type": "Microsoft.ContainerRegistry/registries"
}

Een gebeurtenis-eindpunt maken

In deze sectie gebruikt u een Resource Manager-sjabloon in een GitHub-opslagplaats om een vooraf gebouwde voorbeeldwebtoepassing te implementeren voor Azure App Service. Later abonneert u zich op de Event Grid van uw register en geeft u deze app op als het eindpunt waarop de gebeurtenissen worden verzonden.

Als u de voorbeeld-app wilt implementeren, stelt SITE_NAME u in op een unieke naam voor uw web-app en voert u de volgende opdrachten uit. De sitenaam moet uniek zijn binnen Azure omdat deze deel uitmaakt van de FQDN (Fully Qualified Domain Name) van de web-app. In een latere sectie gaat u naar de FQDN van de app in een webbrowser om de gebeurtenissen van uw register weer te geven.

SITE_NAME=<your-site-name>

az deployment group create \
    --resource-group $RESOURCE_GROUP_NAME \
    --template-uri "https://raw.githubusercontent.com/Azure-Samples/azure-event-grid-viewer/master/azuredeploy.json" \
    --parameters siteName=$SITE_NAME hostingPlanName=$SITE_NAME-plan

Zodra de implementatie is geslaagd (dit kan enkele minuten duren), opent u een browser en navigeert u naar uw web-app om te zien of deze wordt uitgevoerd:

http://<your-site-name>.azurewebsites.net

Als het goed is, wordt de voorbeeld-app weergegeven zonder dat er gebeurtenisberichten worden weergegeven:

Webbrowser met voorbeeldweb-app zonder weergegeven gebeurtenissen

De Event Grid-resourceprovider inschakelen

Als u Event Grid in uw Azure-abonnement nog niet eerder hebt gebruikt, moet u mogelijk de Event Grid-resourceprovider registreren. Voer de volgende opdracht uit om de provider te registreren:

az provider register --namespace Microsoft.EventGrid

Het kan even duren voordat de registratie is voltooid. Voer de volgende opdracht uit om de status te controleren:

az provider show --namespace Microsoft.EventGrid --query "registrationState"

Wanneer registrationState``Registered is, bent u klaar om door te gaan.

Abonneren op registergebeurtenissen

In Event Grid u zich op een onderwerp om aan te geven welke gebeurtenissen u wilt bijhouden en waar u ze wilt verzenden. Met de volgende opdracht az eventgrid event-subscription create abonneert u zich op het containerregister dat u hebt gemaakt en geeft u de URL van uw web-app op als het eindpunt waarop gebeurtenissen moeten worden verzenden. De omgevingsvariabelen die u in eerdere secties hebt ingevuld, worden hier opnieuw gebruikt, dus er zijn geen bewerkingen vereist.

ACR_REGISTRY_ID=$(az acr show --name $ACR_NAME --query id --output tsv)
APP_ENDPOINT=https://$SITE_NAME.azurewebsites.net/api/updates

az eventgrid event-subscription create \
    --name event-sub-acr \
    --source-resource-id $ACR_REGISTRY_ID \
    --endpoint $APP_ENDPOINT

Wanneer het abonnement is voltooid, ziet u uitvoer die er ongeveer als volgt uit ziet:

{
  "destination": {
    "endpointBaseUrl": "https://eventgridviewer.azurewebsites.net/api/updates",
    "endpointType": "WebHook",
    "endpointUrl": null
  },
  "filter": {
    "includedEventTypes": [
      "All"
    ],
    "isSubjectCaseSensitive": null,
    "subjectBeginsWith": "",
    "subjectEndsWith": ""
  },
  "id": "/subscriptions/<Subscription ID>/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myregistry/providers/Microsoft.EventGrid/eventSubscriptions/event-sub-acr",
  "labels": null,
  "name": "event-sub-acr",
  "provisioningState": "Succeeded",
  "resourceGroup": "myResourceGroup",
  "topic": "/subscriptions/<Subscription ID>/resourceGroups/myresourcegroup/providers/microsoft.containerregistry/registries/myregistry",
  "type": "Microsoft.EventGrid/eventSubscriptions"
}

Registergebeurtenissen activeren

Nu de voorbeeld-app actief is en u zich hebt geabonneerd op uw register met Event Grid, bent u klaar om een aantal gebeurtenissen te genereren. In deze sectie gebruikt u ACR-taken om een containerafbeelding te bouwen en naar uw register te pushen. ACR-taken is een functie van Azure Container Registry waarmee u containerafbeeldingen kunt bouwen in de cloud, zonder dat de Docker-engine op uw lokale computer hoeft te zijn geïnstalleerd.

Build- en push-afbeelding

Voer de volgende Azure CLI-opdracht uit om een containerafbeelding te maken op de inhoud van een GitHub opslagplaats. Standaard pusht ACR-taken automatisch een met succes gebouwde afbeelding naar uw register, waardoor de gebeurtenis wordt ImagePushed gegenereerd.

Notitie

Het Dockerfile dat in het volgende voorbeeld wordt gebruikt, is afhankelijk van een openbare basiscontainer-afbeelding van Docker Hub. Als u de betrouwbaarheid wilt verbeteren bij het gebruik van openbare inhoud, importeert en beheert u de afbeelding in een persoonlijk Azure-containerregister en werk u uw Dockerfile bij voor het gebruik van uw persoonlijk beheerde basisbestand. Meer informatie over het werken met openbare afbeeldingen.

az acr build --registry $ACR_NAME --image myimage:v1 -f Dockerfile https://github.com/Azure-Samples/acr-build-helloworld-node.git#main

De uitvoer moet er ongeveer als volgt uit zien terwijl ACR-taken builds en vervolgens uw afbeelding pusht. De volgende voorbeelduitvoer is ingekort.

Sending build context to ACR...
Queued a build with build ID: aa2
Waiting for build agent...
2018/08/16 22:19:38 Using acb_vol_27a2afa6-27dc-4ae4-9e52-6d6c8b7455b2 as the home volume
2018/08/16 22:19:38 Setting up Docker configuration...
2018/08/16 22:19:39 Successfully set up Docker configuration
2018/08/16 22:19:39 Logging in to registry: myregistry.azurecr.io
2018/08/16 22:19:55 Successfully logged in
Sending build context to Docker daemon  94.72kB
Step 1/5 : FROM node:9-alpine
...

Voer de volgende opdracht uit om de tags in de opslagplaats 'myimage' weer te geven om te controleren of de gebouwde afbeelding zich in uw register staat:

az acr repository show-tags --name $ACR_NAME --repository myimage

De tag 'v1' van de afbeelding die u hebt gemaakt, moet worden weergegeven in de uitvoer, vergelijkbaar met de volgende:

[
  "v1"
]

De afbeelding verwijderen

Genereer nu een gebeurtenis door de afbeelding te verwijderen met de ImageDeleted opdracht az acr repository delete:

az acr repository delete --name $ACR_NAME --image myimage:v1

De uitvoer moet er ongeveer als volgt uit zien, met de vraag om bevestiging om het manifest en de bijbehorende afbeeldingen te verwijderen:

This operation will delete the manifest 'sha256:f15fa9d0a69081ba93eee308b0e475a54fac9c682196721e294b2bc20ab23a1b' and all the following images: 'myimage:v1'.
Are you sure you want to continue? (y/n):

Registergebeurtenissen weergeven

U hebt nu een -afbeelding naar het register ge pusht en deze vervolgens verwijderd. Navigeer naar Event Grid viewer-web-app en u ziet nu ImageDeleted zowel - als ImagePushed -gebeurtenissen. Mogelijk ziet u ook een validatiegebeurtenis voor het abonnement die wordt gegenereerd door de opdracht uit te voeren in de sectie Abonneren op registergebeurtenissen.

In de volgende schermopname ziet u de voorbeeld-app met de drie gebeurtenissen en wordt de gebeurtenis ImageDeleted uitgebreid om de details ervan weer te geven.

Webbrowser met de voorbeeld-app met ImagePushed- en ImageDeleted-gebeurtenissen

Gefeliciteerd Als u de gebeurtenissen en ziet, stuurt uw register gebeurtenissen naar Event Grid en Event Grid deze gebeurtenissen doorsturen naar het eindpunt van ImagePushed ImageDeleted uw web-app.

Resources opschonen

Wanneer u klaar bent met de resources die u in deze quickstart hebt gemaakt, kunt u ze allemaal verwijderen met de volgende Azure CLI-opdracht. Wanneer u een resourcegroep verwijdert, worden alle resources die deze bevat definitief verwijderd.

WAARSCHUWING: deze bewerking kan niet ongedaan worden uitgevoerd. Zorg ervoor dat u de resources in de groep niet meer nodig hebt voordat u de opdracht gaat uitvoeren.

az group delete --name $RESOURCE_GROUP_NAME

Event Grid-gebeurtenisschema

U vindt de naslag voor Azure Container Registry gebeurtenisberichtschema in de Event Grid documentatie:

Azure Event Grid gebeurtenisschema voor Container Registry

Volgende stappen

In deze quickstart hebt u een containerregister geïmplementeerd, een installatielijst gemaakt met ACR-taken, deze verwijderd en de gebeurtenissen van uw register uit Event Grid gebruikt met een voorbeeldtoepassing. Ga vervolgens verder met de zelfstudie ACR-taken over het bouwen van containerafbeeldingen in de cloud, waaronder geautomatiseerde builds op basis van update van basisafbeeldingen:

Containerafbeeldingen bouwen in de cloud met ACR-taken