Azure Container Registry webhookok használata
Az Azure-beli tároló-beállításjegyzékek privát Docker-tárolórendszerképeket tárol és felügyel, hasonlóan ahhoz, ahogyan a Docker Hub nyilvános Docker-rendszerképeket tárol. A Helm-diagramok (előzetes verzió) adattárait is üzemeltetheti, amely egy csomagolási formátum, amely alkalmazásokat helyez üzembe a Kubernetesben. Webhookok használatával eseményeket aktiválhat, amikor bizonyos műveletek történnek az egyik beállításjegyzék-adattárban. A webhookok a beállításjegyzék szintjén válaszolhatnak az eseményekre, vagy egy adott adattárcímkére szűkíthetők. A georeplikált beállításjegyzékkel minden webhookot úgy konfigurálhat, hogy reagáljon egy adott regionális replika eseményeire.
A webhook végpontjának nyilvánosan elérhetőnek kell lennie a beállításjegyzékből. Konfigurálhatja a beállításjegyzék webhook-kéréseit a biztonságos végponton való hitelesítéshez.
A webhook-kérelmekkel kapcsolatos részletekért lásd: Azure Container Registry webhook sémareferenciája.
Előfeltételek
- Azure Container Registry – Létrehozhat egy tároló-beállításjegyzéket Azure-előfizetésében. Használja például a Azure Portal vagy az Azure CLI-t. A Azure Container Registry szolgáltatásszintek különböző webhookkvótával rendelkeznek.
- A Docker parancssori felülete – Ha szeretné helyi számítógépét Docker-gazdagépként beállítani és elérni a Docker parancssori felületének parancsait, telepítse a Docker Engine-t.
Webhook létrehozása – Azure Portal
- Jelentkezzen be az Azure Portal.
- Lépjen arra a tárolóregisztrációs adatbázisra, amelyben webhookot szeretne létrehozni.
- A Szolgáltatások területen válassza a Webhookok lehetőséget.
- A webhook eszköztárán válassza a Hozzáadás lehetőséget.
- Töltse ki a Webhook létrehozása űrlapot a következő információkkal:
Érték | Leírás |
---|---|
Webhook neve | A webhooknak adni kívánt név. Csak betűket és számokat tartalmazhat, és legfeljebb 5–50 karakter hosszúságú lehet. |
Hely | Georeplikált beállításjegyzék esetén adja meg a beállításjegyzék-replika Azure-régióját. |
Szolgáltatás URI-ja | Az URI, ahol a webhooknak POST-értesítéseket kell küldenie. |
Egyéni fejlécek | A POST kéréssel együtt átadni kívánt fejlécek. A kulcsok "kulcs: érték" formátumúaknak kell lenniük. |
Triggerműveletek | A webhookot aktiváló műveletek. A műveletek közé tartozik a kép leküldése, a kép törlése, a Helm-diagram leküldése, a Helm-diagram törlése és a kép karanténba helyezése. Választhat egy vagy több műveletet a webhook aktiválásához. |
Állapot | A webhook állapota a létrehozása után. Alapértelmezés szerint engedélyezve van. |
Hatókör | A hatókör, amelyen a webhook működik. Ha nincs megadva, a hatókör a beállításjegyzék összes eseményére kiterjed. Az adattárakhoz vagy címkékhez a "repository:tag" vagy a "repository:*" formátummal adhatók meg az adattárakban lévő összes címke esetében. |
Példa webhook űrlapra:
Webhook létrehozása – Azure CLI
Ha az Azure CLI-vel szeretne webhookot létrehozni, használja az az acr webhook create parancsot. A következő parancs létrehoz egy webhookot a mycontainerregistry beállításjegyzékben található összes képtörlési eseményhez:
az acr webhook create --registry mycontainerregistry --name myacrwebhook01 --actions delete --uri http://webhookuri.com
Webhook tesztelése
Azure Portal
A webhook használata előtt tesztelheti a Ping gombbal. Ping általános POST-kérést küld a megadott végpontnak, és naplózza a választ. A ping funkció használatával ellenőrizheti, hogy helyesen konfigurálta-e a webhookot.
- Válassza ki a tesztelni kívánt webhookot.
- A felső eszköztáron válassza a Ping lehetőséget.
- Ellenőrizze a végpont válaszát a HTTP STATUS oszlopban.
Azure CLI
Az ACR-webhook Azure CLI-vel való teszteléséhez használja az az acr webhook ping parancsot.
az acr webhook ping --registry mycontainerregistry --name myacrwebhook01
Az eredmények megtekintéséhez használja az az acr webhook list-events parancsot.
az acr webhook list-events --registry mycontainerregistry08 --name myacrwebhook01
Webhook törlése
Azure Portal
Minden webhook törölhető a webhook, majd a Törlés gomb kiválasztásával a Azure Portal.
Azure CLI
az acr webhook delete --registry mycontainerregistry --name myacrwebhook01
Következő lépések
Webhook-séma referenciája
Az Azure Container Registry által kibocsátott JSON-esemény hasznos adatainak formátumával és tulajdonságaival kapcsolatos részletekért tekintse meg a webhook sémareferenciáját:
webhook-sémahivatkozás Azure Container Registry
Event Grid-események
A cikkben tárgyalt natív beállításjegyzék-webhookesemények mellett Azure Container Registry eseményeket is kibocsáthat az Event Gridnek:
Rövid útmutató: Tárolóregisztrációs adatbázis eseményeinek küldése az Event Gridbe