Azure Container Registry web kancalarını kullanma

Azure kapsayıcısı kayıt defteri, Docker Hub’ın genel Docker görüntülerini depolama yöntemine benzer şekilde özel Docker kapsayıcı görüntülerini depolar ve yönetir. Uygulamaları Kubernetes'e dağıtmak için bir paketleme biçimi olan Helm grafikleri (önizleme) depolarını da barındırabilir. Kayıt defteri depolarınızdan birinde belirli eylemler gerçekleştiğinde olayları tetikleme amacıyla web kancalarını kullanabilirsiniz. Web kancaları olayları kayıt defteri düzeyinde yanıtlayabilir veya kapsamı belirli bir depo etiketine göre ayarlanabilir. Coğrafi olarak çoğaltılmış bir kayıt defteriyle, her web kancasını belirli bir bölgesel çoğaltmadaki olaylara yanıt verecek şekilde yapılandırabilirsiniz.

Web kancası uç noktasına kayıt defterinden genel olarak erişilebilir olmalıdır. Güvenli bir uç noktada kimlik doğrulaması yapmak için kayıt defteri web kancası isteklerini yapılandırabilirsiniz.

Web kancası istekleriyle ilgili ayrıntılar için bkz. web kancası şema başvurusu Azure Container Registry.

Ön koşullar

Web kancası oluşturma - Azure portal

  1. Azure Portal’ında oturum açın.
  2. Web kancası oluşturmak istediğiniz kapsayıcı kayıt defterine gidin.
  3. Hizmetler'in altında Web kancaları'yı seçin.
  4. Web kancası araç çubuğunda Ekle'yi seçin.
  5. Web kancası oluştur formunu aşağıdaki bilgilerle doldurun:
Değer Açıklama
Web kancası adı Web kancasına vermek istediğiniz ad. Yalnızca harf ve sayı içerebilir ve 5-50 karakter uzunluğunda olmalıdır.
Konum Coğrafi olarak çoğaltılmış bir kayıt defteri için kayıt defteri çoğaltmasının Azure bölgesini belirtin.
Hizmet URI'si Web kancasının POST bildirimleri göndermesi gereken URI.
Özel üst bilgiler POST isteğiyle birlikte geçirmek istediğiniz üst bilgiler. "anahtar: değer" biçiminde olmalıdır.
Tetikleyici eylemleri Web kancasını tetikleyen eylemler. Eylemler arasında görüntü gönderme, görüntü silme, Helm grafiği gönderme, Helm grafiği silme ve görüntü karantinası sayılabilir. Web kancasını tetikleyen bir veya daha fazla eylem seçebilirsiniz.
Durum Web kancası oluşturulduktan sonra durumu. Varsayılan olarak etkindir.
Kapsam Web kancasının çalıştığı kapsam. Belirtilmezse, kapsam kayıt defterindeki tüm olaylar içindir. Depo veya etiket için bir depo altındaki tüm etiketler için "repository:tag" veya "repository:*" biçimi kullanılarak belirtilebilir.

Örnek web kancası formu:

Azure portal ACR web kancası oluşturma U I'yi gösteren ekran görüntüsü.

Web kancası oluşturma - Azure CLI

Azure CLI kullanarak web kancası oluşturmak için az acr webhook create komutunu kullanın. Aşağıdaki komut , mycontainerregistry kayıt defterindeki tüm görüntü silme olayları için bir web kancası oluşturur:

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

Web kancasını test etme

Azure portal

Web kancasını kullanmadan önce Ping düğmesiyle test edebilirsiniz. Ping belirtilen uç noktaya genel bir POST isteği gönderir ve yanıtı günlüğe kaydeder. Ping özelliğini kullanmak, web kancasını doğru yapılandırdığınızdan emin olmanıza yardımcı olabilir.

  1. Test etmek istediğiniz web kancasını seçin.
  2. Üst araç çubuğunda Ping'i seçin.
  3. HTTP STATUS sütununda uç noktanın yanıtını denetleyin.

Azure portal ACR web kancası oluşturma kullanıcı arabirimi

Azure CLI

Azure CLI ile bir ACR web kancasını test etmek için az acr webhook ping komutunu kullanın.

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

Sonuçları görmek için az acr webhook list-events komutunu kullanın.

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

Web kancasını silme

Azure portal

Her web kancası, web kancası ve ardından Azure portal Sil düğmesi seçilerek silinebilir.

Azure CLI

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

Sonraki adımlar

Web kancası şema başvurusu

Azure Container Registry tarafından yayılan JSON olay yüklerinin biçimi ve özellikleri hakkında ayrıntılı bilgi için bkz. web kancası şema başvurusu:

Web kancası şema başvurusu Azure Container Registry

Event Grid olayları

Bu makalede açıklanan yerel kayıt defteri web kancası olaylarına ek olarak, Azure Container Registry olayları Event Grid'e yayabilir:

Hızlı Başlangıç: Kapsayıcı kayıt defteri olaylarını Event Grid'e gönderme