Azure Container Registry는 Docker Hub에서 공개 Docker 이미지를 저장하는 것과 유사한 방식으로 프라이빗 Docker 컨테이너 이미지를 저장하고 관리합니다. 또한 애플리케이션을 Kubernetes로 배포하는 패키징 형식인 Helm 차트(미리 보기)에 대한 리포지토리를 호스팅할 수 있습니다. 레지스트리 리포지토리 중 하나에서 특정 작업이 수행되는 경우 웹후크를 사용하여 이벤트를 트리거할 수 있습니다. 웹후크는 레지스트리 수준에서 이벤트에 응답하거나 특정 리포지토리 태그로 범위를 줄일 수 있습니다. 지역 복제 레지스트리를 사용하여 각 웹후크가 특정 지역 복제본의 이벤트에 응답하도록 구성할 수 있습니다.
웹후크에 대한 엔드포인트는 레지스트리에서 공개적으로 액세스할 수 있어야 합니다. 보안 엔드포인트에 인증하도록 레지스트리 웹후크 요청을 구성할 수 있습니다.
Webhook 요청에 대한 세부 정보는 Azure Container Registry 웹후크 스키마 참조를 참조하세요.
필수 조건
- Azure Container Registry - Azure 구독 내에서 컨테이너 레지스트리를 만듭니다. 예를 들어 Azure Portal 또는 Azure CLI를 사용합니다. Azure Container Registry 서비스 계층에는 각기 다른 웹후크 할당량이 있습니다.
- Docker CLI - 로컬 컴퓨터를 Docker 호스트로 설정하고 Docker CLI 명령에 액세스하려면 Docker 엔진을 설치합니다.
웹후크 만들기 - Azure Portal
- Azure Portal에 로그인합니다.
- 웹후크를 만들려는 컨테이너 레지스트리로 이동합니다.
- 서비스에서 웹후크를 선택합니다.
- 웹후크 도구 모음에서 추가를 선택합니다.
- 다음 정보로 웹후크 만들기 양식을 완성합니다.
| 값 | 설명 |
|---|---|
| 웹후크 이름 | 웹후크에 지정하려는 이름입니다. 문자와 숫자만 포함할 수 있으며 길이는 5-50자여야 합니다. |
| 위치 | 지역 복제 레지스트리의 경우 지역 복제본의 Azure 지역을 지정합니다. |
| 서비스 URI | 웹후크가 POST 알림을 보내야 하는 URI입니다. |
| Custom headers | POST 요청과 함께 전달하려는 헤더입니다. "키: 값" 형식이어야 합니다. |
| 트리거 동작 | 웹후크를 트리거하는 동작입니다. 작업에는 이미지 푸시, 이미지 삭제, Helm 차트 푸시, Helm 차트 삭제, 이미지 격리 등이 있습니다. 하나 이상의 작업을 선택하여 웹후크를 트리거할 수 있습니다. |
| 상태 | 웹후크가 만들어진 후의 상태입니다. 기본적으로 사용하도록 설정되어 있습니다. |
| 범위 | 웹후크가 작동하는 범위입니다. 지정되지 않은 경우 이 범위는 레지스트리의 모든 이벤트입니다. 리포지토리의 모든 태그에 대해 "리포지토리:태그" 또는 "리포지토리:*" 형식을 사용하여 리포지토리 또는 태그에 대해 지정할 수 있습니다. |
웹후크 양식 예제:
웹후크 만들기 - Azure CLI
Azure CLI를 사용하여 웹후크를 만들려면 az acr webhook create 명령을 사용합니다. 다음 명령은 레지스트리 mycontainerregistry의 모든 이미지 삭제 이벤트에 대한 웹후크를 만듭니다.
az acr webhook create --registry mycontainerregistry --name myacrwebhook01 --actions delete --uri http://webhookuri.com
웹후크 테스트
Azure Portal
웹후크를 사용하기 전에 Ping 단추를 사용하여 테스트할 수 있습니다. Ping은 지정된 엔드포인트에 일반 POST 요청을 보내고 응답을 기록합니다. ping 기능을 사용하면 웹후크를 올바르게 구성했는지 확인하는 데 도움이 될 수 있습니다.
- 테스트하려는 웹후크를 선택합니다.
- 맨 위의 도구 모음에서 Ping을 선택합니다.
- HTTP 상태 열에서 엔드포인트의 응답을 확인합니다.
Azure CLI
Azure CLI를 사용하여 ACR 웹후크를 테스트하려면 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
웹후크 삭제
Azure Portal
각 웹후크는 Azure Portal에서 웹후크를 선택하고 삭제 단추를 선택하여 삭제할 수 있습니다.
Azure CLI
az acr webhook delete --registry mycontainerregistry --name myacrwebhook01
다음 단계
Webhook 스키마 참조
Azure Container Registry에서 내보낸 JSON 이벤트 페이로드의 형식 및 속성에 대한 내용은 webhook 스키마 참조를 참조하세요.
Azure Container Registry 웹후크 스키마 참조
Event Grid 이벤트
이 문서에서 설명한 기본 레지스트리 webhook 이벤트 외에도 Azure Container Registry는 Event Grid로 이벤트를 내보낼 수 있습니다.