Azure Container Registry webhooks gebruiken
Een Azure-containerregister slaat persoonlijke Docker-containerinstallatiekopieën op en beheert ze, vergelijkbaar met de manier waarop Docker Hub openbare Docker-installatiekopieën opslaat. Het kan ook opslagplaatsen hosten voor Helm-grafieken (preview), een verpakkingsindeling voor het implementeren van toepassingen in Kubernetes. U kunt webhooks gebruiken om gebeurtenissen te activeren wanneer bepaalde acties worden uitgevoerd in een van uw registeropslagplaatsen. Webhooks kunnen reageren op gebeurtenissen op registerniveau, of ze kunnen worden beperkt tot een specifieke opslagplaatstag. Met een geo-gerepliceerd register configureert u elke webhook om te reageren op gebeurtenissen in een specifieke regionale replica.
Het eindpunt voor een webhook moet openbaar toegankelijk zijn vanuit het register. U kunt registerwebhookaanvragen configureren om te verifiëren bij een beveiligd eindpunt.
Vereisten
- Azure-containerregister: maak een containerregister in uw Azure-abonnement. Gebruik bijvoorbeeld de Azure Portal of de Azure CLI. De Azure Container Registry-servicelagen hebben verschillende webhooksquota.
- Docker-CLI: installeer de Docker-engine om uw lokale computer als een Docker-host in te stellen en de Docker-CLI-opdrachten te gebruiken.
Webhook maken - Azure Portal
- Meld u aan bij de Azure-portal.
- Navigeer naar het containerregister waarin u een webhook wilt maken.
- Selecteer onder Servicesde optie Webhooks.
- Selecteer Toevoegen op de webhookwerkbalk.
- Vul het formulier Webhook maken in met de volgende gegevens:
| Waarde | Beschrijving |
|---|---|
| Naam van webhook | De naam die u aan de webhook wilt geven. Het mag alleen letters en cijfers bevatten en moet 5 tot 50 tekens lang zijn. |
| Locatie | Geef voor een geo-gerepliceerd register de Azure-regio van de registerreplica op. |
| Service-URI | De URI waarnaar de webhook POST-meldingen moet verzenden. |
| Aangepaste headers | Headers die u wilt doorgeven met de POST-aanvraag. Ze moeten de indeling sleutelwaarde hebben. |
| Acties activeren | Acties die de webhook activeren. Acties zijn onder andere het pushen van afbeeldingen, het verwijderen van afbeeldingen, het pushen van helmgrafiek, het verwijderen van helmgrafiek en het in quarantaine plaatsen van afbeeldingen. U kunt een of meer acties kiezen om de webhook te activeren. |
| Status | De status voor de webhook nadat deze is gemaakt. Deze functie is standaard ingeschakeld. |
| Bereik | Het bereik waarin de webhook werkt. Als dit niet is opgegeven, is het bereik voor alle gebeurtenissen in het register. Deze kan worden opgegeven voor een opslagplaats of een tag met behulp van de indeling 'repository:tag' of 'repository:*' voor alle tags onder een opslagplaats. |
Voorbeeld van webhookformulier:
Webhook maken - Azure CLI
Als u een webhook wilt maken met behulp van de Azure CLI, gebruikt u de opdracht az acr webhook create . Met de volgende opdracht maakt u een webhook voor alle gebeurtenissen voor het verwijderen van installatiekopieën in het register mycontainerregistry:
az acr webhook create --registry mycontainerregistry --name myacrwebhook01 --actions delete --uri http://webhookuri.com
Webhook testen
Azure Portal
Voordat u de webhook gebruikt, kunt u deze testen met de knop Ping . Ping verzendt een algemene POST-aanvraag naar het opgegeven eindpunt en registreert het antwoord. Met behulp van de pingfunctie kunt u controleren of u de webhook correct hebt geconfigureerd.
- Selecteer de webhook die u wilt testen.
- Selecteer pingen in de bovenste werkbalk.
- Controleer het antwoord van het eindpunt in de kolom HTTP-STATUS .
Azure CLI
Als u een ACR-webhook wilt testen met de Azure CLI, gebruikt u de opdracht az acr webhook ping .
az acr webhook ping --registry mycontainerregistry --name myacrwebhook01
Gebruik de opdracht az acr webhook list-events om de resultaten te bekijken.
az acr webhook list-events --registry mycontainerregistry08 --name myacrwebhook01
Webhook verwijderen
Azure Portal
Elke webhook kan worden verwijderd door de webhook te selecteren en vervolgens de knop Verwijderen in de Azure Portal.
Azure CLI
az acr webhook delete --registry mycontainerregistry --name myacrwebhook01
Volgende stappen
Naslaginformatie over webhookschema's
Zie de naslaginformatie over het webhookschema voor meer informatie over de indeling en eigenschappen van de nettoladingen van de JSON-gebeurtenis die door Azure Container Registry worden verzonden:
Azure Container Registry webhookschemareferentie
Event Grid-gebeurtenissen
Naast de systeemeigen registerwebhookgebeurtenissen die in dit artikel worden besproken, kunt Azure Container Registry gebeurtenissen verzenden naar Event Grid:
Quickstart: Container Registry-gebeurtenissen verzenden naar Event Grid