使用 Azure Container Registry Webhook
Azure Container Registry 會儲存和管理私人 Docker 容器映像，其方式類似於 Docker 中樞儲存公用 Docker 映像。 也可以裝載 Helm 圖表 (預覽) 的存放庫，這是將應用程式部署至 Kubernetes 的封裝格式。 在其中一個登錄存放庫發生特定動作時，您可以使用 Webhook 來觸發事件。 Webhook 可以回應登錄層級的事件，或可將範圍縮小至特定的存放庫標記。 異地複寫登錄可讓您設定每個 Webhook 來回應特定區域複本中的事件。
Webhook 的端點必須可從登錄公開存取。 您可以設定登錄 Webhook 要求，以向受保護的端點進行驗證。
如需 Webhook 要求的詳細資訊，請參閱 Azure Container Registry Webhook 結構描述參考。
必要條件
- Azure 容器登錄庫 - 在 Azure 訂用帳戶中建立容器登錄庫。 例如，使用 Azure 入口網站或 Azure CLI。 Azure Container Registry 服務層具有不同的 Webhook 配額。
- Docker CLI - 若要將您的本機電腦設定為 Docker 主機並存取 Docker CLI 命令，請安裝 Docker 引擎。
建立 Webhook - Azure 入口網站
- 登入 Azure 入口網站。
- 瀏覽至您要在其中建立 Webhook 的容器登錄。
- 在 [服務] 下選取 [Webhook]。
- 選取 [Webhook] 工具列中的 [新增]。
- 填入下列資訊以完成 [建立 Webhook] 表單：
| 值 | Description |
|---|---|
| Webhook 名稱 | 您想要提供給 Webhook 的名稱。 只能包含字母和數字，且長度必須為 5-50 個字元。 |
| Location | 針對異地複寫登錄，請指定登錄複本的 Azure 區域。 |
| 服務 URI | Webhook 需在當中傳送 POST 通知的 URI。 |
| Custom headers | 您想要與 POST 要求一起傳遞的標頭。 它們應該為「金鑰：值」的格式。 |
| 觸發程序動作 | 觸發 Webhook 的動作。 動作包括映像推送、映像刪除、Helm 圖表推送、Helm 圖表刪除和映像隔離。 您可以選擇一或多個動作來觸發 Webhook。 |
| 狀態 | Webhook 建立之後的狀態。 此項目預設為啟用。 |
| 範圍 | Webhook 的運作範圍。 如果未指定，則以登錄中的所有事件為範圍。 您可以針對一個存放庫或標記來指定範圍，格式為 "repository:tag"，或 "repository:*"，代表存放庫下的所有標記。 |
範例 Webhook 表單：
建立 Webhook - Azure CLI
若要使用 Azure CLI 建立 Webhook，請使用 az acr webhook create 命令。 下列命令針對登錄 mycontainerregistry 中的所有映像刪除事件，建立 Webhook：
az acr webhook create --registry mycontainerregistry --name myacrwebhook01 --actions delete --uri http://webhookuri.com
測試 Webhook
Azure 入口網站
使用 Webhook 之前，您可以使用 [Ping] 按鈕進行測試。 Ping 會將泛型 POST 要求傳送至指定的端點，並記錄回應。 使用 Ping 功能可協助您確認您已正確設定 Webhook。
- 選取您想要測試的 Webhook。
- 在頂端工具列中，選取 [Ping]。
- 檢查 HTTP STATUS 資料行中的端點回應。
Azure CLI
若要使用 Azure CLI 測試 ACR Webhook，請使用 az acr webhook ping 命令。
az acr webhook ping --registry mycontainerregistry --name myacrwebhook01
若要查看結果，請使用 az acr webhook list-events 命令。
az acr webhook list-events --registry mycontainerregistry08 --name myacrwebhook01
刪除 Webhook
Azure 入口網站
依序選取 Azure 入口網站上的 [Webhook] 和 [刪除] 按鈕，就可以將每個 Webhook 刪除。
Azure CLI
az acr webhook delete --registry mycontainerregistry --name myacrwebhook01
下一步
Webhook 結構描述參考
若要深入了解 Azure Container Registry 所發出的 JSON 事件裝載格式與內容，請參閱 Webhook 結構描述參考：
Azure Container Registry Webhook 結構描述參考
事件方格的事件
除了本文所討論的原生登錄 Webhook 事件，Azure Container Registry 可將事件發送至事件方格：