Megosztás:


Az Azure Container Registry webhookok használata

Az Azure-tárolóregisztrációs adatbázis tárolja és kezeli a privát Docker-tárolólemezképeket, hasonlóan ahhoz, ahogyan a Docker Hub nyilvános Docker-lemezké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 valamelyik regisztrációs adattárban. A webhookok válaszolhatnak az eseményekre a regiszter szintjén, vagy kiterjedhetnek egy adott tároló címkére is. Egy 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. A rendszerleíró adatbázis webhook-kéréseit úgy konfigurálhatja, hogy egy biztonságos végponton hitelesítve legyenek.

A webhook-kérelmekkel kapcsolatos részletekért tekintse meg az Azure Container Registry webhook-sémareferenciáját.

Prerequisites

Webhook létrehozása – Azure Portal

  1. Jelentkezzen be a Azure portalra.
  2. Lépjen arra a tárolóregisztrációs adatbázisra, amelyben webhookot szeretne létrehozni.
  3. A Szolgáltatások területen válassza a Webhookok lehetőséget.
  4. Válassza a Hozzáadás lehetőséget a webhook eszköztárán.
  5. Töltse ki a Webhook létrehozása űrlapot a következő információkkal:
Value Description
Webhook neve A webhooknak adni kívánt név. Csak betűket és számokat tartalmazhat, és 5-50 karakter hosszúságúnak kell lennie.
Location 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. "Kulcs: érték" formátumban kell lenniük.
Triggerműveletek A webhookot aktiváló műveletek. A műveletek közé tartozik a kép feltöltése, a kép törlése, a Helm chart feltöltése, a Helm chart 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.
Status A webhook állapota a létrehozás után. Alapértelmezés szerint engedélyezve van.
Scope A webhook működésének hatóköre. Ha nincs megadva, a hatókör a beállításjegyzék összes eseményére kiterjed. Egy adattárra vagy címkére a "repository:tag" formátumot, vagy egy adattárban lévő összes címkére a "repository:*" formátumot lehet megadni.

Példa egy webhook űrlapra:

Képernyőkép az ACR webhook létrehozási U I-ről az Azure Portalon.

Webhook létrehozása – Azure CLI

Ha webhookot szeretne létrehozni az Azure CLI használatával, használja az az acr webhook create parancsot. A következő parancs létrehoz egy webhookot a regisztrációs adatbázis mycontainerregistry rendszerkép-törlési eseményeihez:

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 pingelési funkció használatával ellenőrizheti, hogy megfelelően konfigurálta-e a webhookot.

  1. Válassza ki a tesztelni kívánt webhookot.
  2. A felső eszköztáron válassza a Ping lehetőséget.
  3. Ellenőrizze a végpont válaszát a HTTP STATUS oszlopban.

Az ACR webhook létrehozási felhasználói felülete az Azure Portalon

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 kiválasztásával, majd a Delete (Törlés) gombra kattintva az Azure portálon.

Azure CLI

az acr webhook delete --registry mycontainerregistry --name myacrwebhook01

Következő lépések

Webhook sémahivatkozás

Az Azure Container Registry által kibocsátott JSON eseményhasznos terhek formátumáról és tulajdonságairól szóló részletekért lásd a webhook séma referenciát.

Az Azure Container Registry webhook struktúrájának referenciája

Event Grid-események

A cikkben tárgyalt natív beállításjegyzék-webhookesemények mellett az Azure Container Registry eseményeket is képes kibocsátani az Event Gridbe:

Rövid útmutató: Tárolóregisztrációs események küldése az Event Gridbe