Partilhar via


Utilizar webhooks do Azure Container Registry

Os registos de contentores do Azure armazenam e gerem imagens de contentores do Docker privadas, de forma semelhante a como o Docker Hub armazena imagens do Docker públicas. Ele também pode hospedar repositórios para gráficos Helm (visualização), um formato de empacotamento para implantar aplicativos no Kubernetes. Você pode usar webhooks para acionar eventos quando determinadas ações ocorrem em um de seus repositórios de registro. Os webhooks podem responder a eventos ao nível do registo ou podem ser limitados a uma etiqueta de repositório específica. Com um registro replicado geograficamente , você configura cada webhook para responder a eventos em uma réplica regional específica.

O ponto final de um webhook tem de estar acessível publicamente a partir do registo. Pode configurar pedidos de webhook de registo para autenticar num ponto final seguro.

Para obter detalhes sobre solicitações de webhook, consulte Referência de esquema de webhook do Registro de Contêiner do Azure.

Pré-requisitos

Criar webhook - Portal do Azure

  1. Inicie sessão no portal do Azure.
  2. Navegue até o registro de contêiner no qual você deseja criar um webhook.
  3. Em Serviços, selecione Webhooks.
  4. Selecione Adicionar na barra de ferramentas do webhook.
  5. Preencha o formulário Criar webhook com as seguintes informações:
valor Description
Nome do Webhook O nome que você deseja dar ao webhook. Pode conter apenas letras e números, e deve ter de 5 a 50 caracteres.
Location Para um registro replicado geograficamente , especifique a região do Azure da réplica do Registro.
URI de serviço O URI para onde o webhook deve enviar notificações POST.
Custom headers Cabeçalhos que você deseja passar junto com a solicitação POST. Eles devem estar no formato "chave: valor".
Ações de desencadeamento Ações que acionam o webhook. As ações incluem envio de imagem, exclusão de imagem, envio de gráfico de leme, exclusão de gráfico de leme e quarentena de imagem. Você pode escolher uma ou mais ações para acionar o webhook.
Status O status do webhook após sua criação. Está ativada por predefinição.
Âmbito O escopo no qual o webhook funciona. Se não for especificado, o escopo será para todos os eventos no Registro. Ele pode ser especificado para um repositório ou uma tag usando o formato "repository:tag" ou "repository:*" para todas as tags em um repositório.

Exemplo de formulário webhook:

Captura de tela que mostra a criação do webhook ACR U I no portal do Azure.

Criar webhook - CLI do Azure

Para criar um webhook usando a CLI do Azure, use o comando az acr webhook create . O comando a seguir cria um webhook para todos os eventos de exclusão de imagem no registro mycontainerregistry:

az acr webhook create --registry mycontainerregistry --name myacrwebhook01 --actions delete --uri http://webhookuri.com

Webhook de teste

Portal do Azure

Antes de usar o webhook, você pode testá-lo com o botão Ping . O ping envia uma solicitação POST genérica para o ponto de extremidade especificado e registra a resposta. Usar o recurso de ping pode ajudá-lo a verificar se configurou corretamente o webhook.

  1. Selecione o webhook que deseja testar.
  2. Na barra de ferramentas superior, selecione Ping.
  3. Verifique a resposta do ponto de extremidade na coluna HTTP STATUS .

Interface do usuário de criação de webhook do ACR no portal do Azure

CLI do Azure

Para testar um webhook ACR com a CLI do Azure, use o comando az acr webhook ping .

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

Para ver os resultados, use o comando az acr webhook list-events .

az acr webhook list-events --registry mycontainerregistry08 --name myacrwebhook01

Excluir webhook

Portal do Azure

Cada webhook pode ser excluído selecionando o webhook e, em seguida, o botão Excluir no portal do Azure.

CLI do Azure

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

Próximos passos

Referência do esquema Webhook

Para obter detalhes sobre o formato e as propriedades das cargas úteis do evento JSON emitidas pelo Registro de Contêiner do Azure, consulte a referência do esquema do webhook:

Referência de esquema webhook do Registro de Contêiner do Azure

Eventos da Grade de Eventos

Além dos eventos de webhook do Registro nativo discutidos neste artigo, o Registro de Contêiner do Azure pode emitir eventos para a Grade de Eventos:

Guia de início rápido: enviar eventos do Registro de contêiner para a Grade de Eventos