Použití Azure Container Registry webhooků

  • Článek

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

  1. Přihlaste se k webu Azure Portal.
  2. Přejděte do registru kontejneru, ve kterém chcete vytvořit webhook.
  3. V části Služby vyberte Webhooky.
  4. Na panelu nástrojů webhooku vyberte Přidat .
  5. 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:

Snímek obrazovky znázorňující uživatelské rozhraní pro vytvoření webhooku ACR v Azure Portal

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ě.

  1. Vyberte webhook, který chcete otestovat.
  2. Na horním panelu nástrojů vyberte Ping.
  3. Zkontrolujte odpověď koncového bodu ve sloupci STAV HTTP .

Uživatelské rozhraní pro vytvoření webhooku ACR v Azure Portal

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