Web Azure Container Registry 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. Ayrıca Uygulamaları Kubernetes'e dağıtmak için paketleme biçimi olan Helm grafikleri (önizleme) depolarını da barındırabilirsiniz. Kayıt defteri depolarından biri üzerinde belirli eylemler gerçekleştirilen olayları tetiklemek için web kancalarını kullanabilirsiniz. Web kancaları, olayları kayıt defteri düzeyinde yanıt olarak kullanabilir veya kapsamı belirli bir depo etiketine göre uzlaştırabilirsiniz. Coğrafi olarak çoğaltılmış bir kayıt defteriyle, her web kancasını belirli bir bölgesel çoğaltmada olaylara yanıt vermek üzere yapılandırmış oluruz.

Web kancası uç noktasının kayıt defterinden genel olarak erişilebilir olması gerekir. Güvenli bir uç noktada kimlik doğrulaması yapmak için kayıt defteri web kancası isteklerini yapılandırebilirsiniz.

Web kancası istekleri hakkında ayrıntılı bilgi için bkz. Azure Container Registry web kancası şema başvurusu.

Önkoşullar

  • Azure kapsayıcısı kayıt defteri -Azure aboneliğinizde bir kapsayıcı kayıt defteri oluşturun. Örneğin, Azure portal veya Azure CLI kullanın. Hizmet Azure Container Registry farklı web kancaları kotaları vardır.
  • Docker CLI - Yerel bilgisayarınızı bir Docker konağı olarak ayarlamak ve Docker CLI komutlarına erişmek için Docker Engine’i yükleyin.

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'inaltı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ı için 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ğaltmanın Azure bölgesini belirtin.
Hizmet URI'si Web kancası POST bildirimleri göndermesi gereken URI.
Özel üst bilgiler POST isteğiyle birlikte geçmek istediğiniz üst bilgiler. Bu değerlerin "anahtar: değer" biçiminde olması gerekir.
Tetikleyici eylemleri Web kancası tetikleyen eylemler. Eylemler arasında görüntü itme, görüntü silme, Helm grafiği anında itme, Helm grafiği silme ve görüntü karantinası yer alan eylemler yer aldı. Web kancası tetiklemek için bir veya daha fazla eylem seçebilirsiniz.
Durum Web kancası oluşturulduktan sonra durumu. Varsayılan olarak etkindir.
Kapsam Web kancası üzerinde çalışma kapsamı. Belirtilmezse, kapsam kayıt defterindeki tüm olaylara göredir. Deponun altındaki tüm etiketler için "repository:tag" veya "repository:*" biçimi kullanılarak bir depo veya etiket için belirtilebilir.

Örnek web kancası formu:

Uygulamanın içinde ACR web kancası oluşturma U I'sini gösteren Azure portal.

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, mycontainerregistrykayı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ı testi

Azure portal

Web kancası kullanmadan önce Ping düğmesiyle test edin. Ping belirtilen uç noktasına genel bir POST isteği gönderir ve yanıtı günlüğe kaydeder. Ping özelliğini kullanmak, web kancası için doğru yapılandırmış olduğunu doğrulamanıza yardımcı olabilir.

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

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

Azure CLI

ACR web kancasını Azure CLI ile 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ı silme

Azure portal

Her web kancası, web kancası seçerek ve ardından web kancası içinde Sil düğmesi Azure portal.

Azure CLI

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

Sonraki adımlar

Web kancası şema başvurusu

Uygulama tarafından yayılan JSON olay yüklerinin biçimi ve özellikleri hakkında ayrıntılar Azure Container Registry web kancası şema başvurusuna bakın:

Azure Container Registry kancası şema başvurusu

Event Grid olayları

Bu makalede ele alınan yerel kayıt defteri web kancası olaylarının yanı sıra, Azure Container Registry aşağıdakilere Event Grid:

Hızlı Başlangıç: Kapsayıcı kayıt defteri olaylarını Event Grid