Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Registr kontejnerů Azure ukládá a spravuje privátní image kontejnerů Dockeru, podobně jako Docker Hub ukládá 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 můžou být omezené 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. Můžete nakonfigurovat požadavky na webhook registru pro autentizaci u zabezpečeného koncového bodu.
Podrobnosti o požadavcích webhooku najdete v referenčních informacích ke schématu webhooku služby Azure Container Registry.
Prerequisites
- Registr kontejnerů Azure – Vytvořte v předplatném Azure registr kontejneru. 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 přístup k příkazům Docker CLI, nainstalujte Docker Engine.
Vytvoření webhooku – Azure Portal
- Přihlaste se do Azure Portalu.
- 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:
| Value | Description |
|---|---|
| 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ů. |
| Location | Pro geograficky replikovaný registr zadejte oblast Azure repliky registru. |
| URI služby | Identifikátor URI, do kterého by měl webhook odesílat oznámení POST. |
| Vlastní hlavičky | 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. |
| Status | Stav webhooku po jeho vytvoření Ve výchozím nastavení je povolená. |
| Scope | Obor, ve kterém webhook funguje. Pokud není specifikován, rozsah platí 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
Azure Portal
Před použitím webhooku ho můžete otestovat pomocí tlačítka Ping . Příkaz Ping odešle generický požadavek POST na zadaný koncový bod a zaznamená 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 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
Azure Portal
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
Přehled 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