Použití Azure Container Registry webhooků
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ž v některém z úložišť registru proběhnou určité akce. Webhooky můžou reagovat na události na úrovni registru nebo se dají omezit na konkrétní značku úložiště. V případě 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 Azure Container Registry schématu webhooku.
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ů.
- Rozhraní příkazového řádku Dockeru – Chcete-li nastavit místní počítač jako hostitele Dockeru a získat přístup k příkazům rozhraní příkazového řádku Dockeru, nainstalujte si modul runtime Docker Engine.
Vytvoření webhooku – Azure Portal
- Přihlaste se k webu Azure Portal.
- 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 webhooku pojmenovat. Může obsahovat pouze písmena a číslice a musí mít délku 5 až 50 znaků. |
Umístění | V případě geograficky replikovaného registru zadejte oblast Azure repliky registru. |
Identifikátor URI služby | Identifikátor URI, kam má 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. |
Aktivační akce | Akce, které aktivují webhook. Mezi akce patří vložení obrázku, odstranění obrázku, nasdílení chartu Helm, odstranění grafu Helm a karanténa obrázku. Můžete zvolit jednu nebo více akcí, které webhook aktivují. |
Stav | Stav webhooku po jeho vytvoření Ve výchozím nastavení je povolená. |
Obor | Obor, ve kterém webhook funguje. Pokud není zadaný, je obor určen pro všechny události v registru. Je možné ji zadat pro úložiště nebo značku ve 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
Než webhook použijete, můžete ho otestovat pomocí tlačítka Ping . Příkaz Ping odešle do zadaného koncového bodu obecný požadavek POST a zaprokoluje odpověď. Pomocí funkce ping můžete ověřit, že jste webhook nakonfigurovali správně.
- Vyberte webhook, který chcete otestovat.
- Na horním panelu nástrojů vyberte Ping.
- Zkontrolujte odpověď koncového bodu ve sloupci STAV HTTP .
Azure CLI
Pokud chcete otestovat webhook ACR pomocí Azure CLI, použijte příkaz az acr webhook ping .
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 můžete odstranit tak, že vyberete webhook a pak na Azure Portal tlačítko Odstranit.
Azure CLI
az acr webhook delete --registry mycontainerregistry --name myacrwebhook01
Další kroky
Referenční informace ke schématu webhooku
Podrobnosti o formátu a vlastnostech datových částí událostí JSON vygenerovaných Azure Container Registry najdete v referenčních informacích ke schématu webhooků:
Referenční informace ke schématu Azure Container Registry webhooků
Události Event Gridu
Kromě událostí webhooku nativního registru popsaných v tomto článku mohou Azure Container Registry generovat události do Event Gridu:
Rychlý start: Odesílání událostí registru kontejneru do Event Gridu
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro