Použití webhooků Azure Container Registry
Registr kontejnerů Azure uchovává a spravuje privátní image kontejnerů Dockeru podobným způsobem, jakým Docker Hub uchovává veřejné image Dockeru. Může také hostovat úložiště pro charty Helm (Preview), formát balení pro nasazení aplikací do Kubernetes. Webhooky můžete použít k aktivaci událostí, když se určité akce provádějí v jednom z úložišť registru. Webhooky můžou reagovat na události na úrovni registru nebo se dají omezit na konkrétní značku úložiště. U geograficky replikovaného registru nakonfigurujete každý webhook tak, aby reagoval na události v konkrétní regionální replice.
Koncový bod webhooku musí být veřejně přístupný z registru. Požadavky webhooku registru můžete nakonfigurovat tak, aby se ověřily v zabezpečeném koncovém bodu.
Podrobnosti o požadavcích webhooku najdete v referenčních informacích ke schématu webhooku služby Azure Container Registry.
Požadavky
- Registr kontejnerů Azure – Vytvořte registr kontejnerů ve svém předplatném Azure. Použijte například Azure Portal nebo Azure CLI. Úrovně služby Azure Container Registry mají různé kvóty webhooků.
- Docker CLI – Pokud chcete nastavit místní počítač jako hostitele Dockeru a získat přístup k příkazům Rozhraní příkazového řádku Dockeru, nainstalujte Modul Dockeru.
Vytvoření webhooku – Azure Portal
- Přihlaste se k portálu Azure.
- Přejděte do registru kontejneru, ve kterém chcete vytvořit webhook.
- V části Služby vyberte Webhooky.
- Na panelu nástrojů webhooku vyberte Přidat .
- Vyplňte formulář Vytvořit webhook s následujícími informacemi:
| Hodnota | Popis |
|---|---|
| Název webhooku | Název, který chcete dát webhooku. Může obsahovat pouze písmena a číslice a musí mít délku 5 až 50 znaků. |
| Umístění | Pro geograficky replikovaný registr zadejte oblast Azure repliky registru. |
| Identifikátor URI služby | Identifikátor URI, do kterého by měl webhook odesílat oznámení POST. |
| Custom headers | Hlavičky, které chcete předat spolu s požadavkem POST. Měly by být ve formátu klíč: hodnota. |
| Akce triggeru | Akce, které aktivují webhook Mezi akce patří vložení obrázku, odstranění obrázku, vložení grafu Helm, odstranění grafu Helm a karanténa obrázků. Můžete zvolit jednu nebo více akcí pro aktivaci webhooku. |
| Stav | Stav webhooku po jeho vytvoření Ve výchozím nastavení je zapnuté. |
| Obor | Obor, ve kterém webhook funguje. Pokud není zadaný, obor je určen pro všechny události v registru. Dá se zadat pro úložiště nebo značku pomocí formátu "repository:tag" nebo "repository:*" pro všechny značky v úložišti. |
Příklad formuláře webhooku:
Vytvoření webhooku – Azure CLI
Pokud chcete vytvořit webhook pomocí Azure CLI, použijte příkaz az acr webhook create . Následující příkaz vytvoří webhook pro všechny události odstranění image v registru mycontainerregistry:
az acr webhook create --registry mycontainerregistry --name myacrwebhook01 --actions delete --uri http://webhookuri.com
Test webhooku
portál Azure
Před použitím webhooku ho můžete otestovat pomocí tlačítka Ping . Příkaz Ping odešle obecný požadavek POST do zadaného koncového bodu a zaprokoluje odpověď. Pomocí funkce ping můžete ověřit, že jste webhook správně nakonfigurovali.
- Vyberte webhook, který chcete otestovat.
- Na horním panelu nástrojů vyberte Příkaz Ping.
- Zkontrolujte odpověď koncového bodu ve sloupci HTTP STATUS .
Azure CLI
K otestování webhooku ACR pomocí Azure CLI použijte příkaz ping az acr webhook.
az acr webhook ping --registry mycontainerregistry --name myacrwebhook01
Pokud chcete zobrazit výsledky, použijte příkaz az acr webhook list-events .
az acr webhook list-events --registry mycontainerregistry08 --name myacrwebhook01
Odstranění webhooku
portál Azure
Každý webhook lze odstranit výběrem webhooku a následným tlačítkem Odstranit na webu Azure Portal.
Azure CLI
az acr webhook delete --registry mycontainerregistry --name myacrwebhook01
Další kroky
Referenční dokumentace schématu Webhooku
Podrobnosti o formátu a vlastnostech datových částí událostí JSON vygenerovaných službou Azure Container Registry najdete v referenčních informacích ke schématu webhooku:
Referenční informace ke schématu webhooku služby Azure Container Registry
Události Event Gridu
Kromě událostí webhooku nativního registru, které jsou popsány v tomto článku, může služba Azure Container Registry generovat události do event Gridu:
Rychlý start: Odesílání událostí registru kontejneru do Event Gridu