Azure Container Registry 웹후크 참조

컨테이너 레지스트리에 대해 특정 작업이 수행되면 이벤트를 생성하는 웹후크를 구성할 수 있습니다. 예를 들어 컨테이너 이미지나 Helm 차트가 레지스트리에 푸시된 경우 또는 삭제된 경우 트리거되는 웹후크를 사용하도록 설정합니다. 웹후크가 트리거되면 Azure Container Registry에서 사용자가 지정하는 엔드포인트로 이벤트에 대한 정보가 포함된 HTTP 또는 HTTPS 요청을 보냅니다. 그러면 해당 엔드포인트에서 웹후크를 처리하고 적절하게 작업을 수행할 수 있습니다.

다음 섹션에서는 지원되는 이벤트에서 생성하는 웹후크 요청 스키마에 대해 자세히 설명합니다. 이벤트 섹션에는 이벤트 유형에 대한 페이로드 스키마, 요청 페이로드 예, 웹후크를 트리거하는 하나 이상 명령 예가 포함되어 있습니다.

Azure Container Registry에 대한 웹후크를 구성하는 방법에 대한 자세한 내용은 Azure Container Registry 웹후크 사용을 참조하세요.

웹후크 요청

HTTP 요청

트리거된 웹후크는 웹후크를 구성할 때 사용자가 지정한 URL 엔드포인트에 대해 HTTP POST 요청을 수행합니다.

HTTP 헤더

웹후크에 대한 Content-Type 사용자 지정 헤더를 지정하지 않은 경우 웹후크 요청에는 application/json의 Content-Type이 포함됩니다.

웹후크에 대해 지정했을 수도 있는 이러한 사용자 지정 헤더 외의 다른 헤더는 요청에 추가되지 않습니다.

푸시 이벤트

컨테이너 이미지가 리포지토리에 푸시될 때 트리거된 웹후크입니다.

푸시 이벤트 페이로드

target

요청

페이로드 예: 이미지 푸시 이벤트

{
  "id": "cb8c3971-9adc-488b-xxxx-43cbb4974ff5",
  "timestamp": "2017-11-17T16:52:01.343145347Z",
  "action": "push",
  "target": {
    "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
    "size": 524,
    "digest": "sha256:xxxxd5c8786bb9e621a45ece0dbxxxx1cdc624ad20da9fe62e9d25490f33xxxx",
    "length": 524,
    "repository": "hello-world",
    "tag": "v1"
  },
  "request": {
    "id": "3cbb6949-7549-4fa1-xxxx-a6d5451dffc7",
    "host": "myregistry.azurecr.io",
    "method": "PUT",
    "useragent": "docker/17.09.0-ce go/go1.8.3 git-commit/afdb6d4 kernel/4.10.0-27-generic os/linux arch/amd64 UpstreamClient(Docker-Client/17.09.0-ce \\(linux\\))"
  }
}

이미지 푸시 이벤트 웹후크를 트리거하는 Docker CLI 명령의 예:

docker push myregistry.azurecr.io/hello-world:v1

차트 푸시 이벤트

Helm 차트가 리포지토리로 푸시될 때 웹후크가 트리거됩니다.

차트 푸시 이벤트 페이로드

target

페이로드 예: 차트 푸시 이벤트

{
  "id": "6356e9e0-627f-4fed-xxxx-d9059b5143ac",
  "timestamp": "2019-03-05T23:45:31.2614267Z",
  "action": "chart_push",
  "target": {
    "mediaType": "application/vnd.acr.helm.chart",
    "size": 25265,
    "digest": "sha256:xxxx8075264b5ba7c14c23672xxxx52ae6a3ebac1c47916e4efe19cd624dxxxx",
    "repository": "repo",
    "tag": "wordpress-5.4.0.tgz",
    "name": "wordpress",
    "version": "5.4.0.tgz"
  }
}

chart_push 이벤트 웹후크를 트리거하는 Azure CLI 명령의 예:

az acr helm push wordpress-5.4.0.tgz --name MyRegistry

이벤트 삭제

이미지 리포지토리 또는 매니페스트를 삭제할 때 트리거되는 웹후크입니다. 태그가 삭제될 때는 트리거되지 않습니다.

삭제 이벤트 페이로드

target

요청

페이로드 예: 이미지 삭제 이벤트

{
    "id": "afc359ce-df7f-4e32-xxxx-1ff8aa80927b",
    "timestamp": "2017-11-17T16:54:53.657764628Z",
    "action": "delete",
    "target": {
      "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
      "digest": "sha256:xxxxd5c8786bb9e621a45ece0dbxxxx1cdc624ad20da9fe62e9d25490f33xxxx",
      "repository": "hello-world"
    },
    "request": {
      "id": "3d78b540-ab61-4f75-xxxx-7ca9ecf559b3",
      "host": "myregistry.azurecr.io",
      "method": "DELETE",
      "useragent": "python-requests/2.18.4"
    }
  }

delete 이벤트 웹후크를 트리거하는 예제 Azure CLI 명령:

# Delete repository
az acr repository delete --name MyRegistry --repository MyRepository

# Delete image
az acr repository delete --name MyRegistry --image MyRepository:MyTag

차트 삭제 이벤트

Helm 차트 또는 리포지토리가 삭제될 때 트리거되는 웹후크입니다.

차트 삭제 이벤트 페이로드

target

페이로드 예: 차트 삭제 이벤트

{
  "id": "338a3ef7-ad68-4128-xxxx-fdd3af8e8f67",
  "timestamp": "2019-03-06T00:10:48.1270754Z",
  "action": "chart_delete",
  "target": {
    "mediaType": "application/vnd.acr.helm.chart",
    "size": 25265,
    "digest": "sha256:xxxx8075264b5ba7c14c23672xxxx52ae6a3ebac1c47916e4efe19cd624dxxxx",
    "repository": "repo",
    "tag": "wordpress-5.4.0.tgz",
    "name": "wordpress",
    "version": "5.4.0.tgz"
  }
}

chart_delete 이벤트 웹후크를 트리거하는 Azure CLI 명령의 예:

az acr helm delete wordpress --version 5.4.0 --name MyRegistry

다음 단계

Azure Container Registry 웹후크 사용