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.
Ö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'yı kullanın. Azure Container Registry hizmet katmanlarının farklı web kancası 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
- Azure Portal’ında oturum açın.
- Web kancası oluşturmak istediğiniz kapsayıcı kayıt defterine gidin.
- Hizmetler'in altında Web kancaları'yı seçin.
- Web kancası araç çubuğunda Ekle'yi seçin.
- 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:
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.
- Test etmek istediğiniz web kancasını seçin.
- Üst araç çubuğunda Ping'i seçin.
- HTTP STATUS sütununda uç noktanın yanıtını denetleyin.
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