Event Grid kaynağı olarak Azure Container Registry

  • Makale

Bu makale, Container Registry olaylarının özelliklerini ve şemasını sağlar. Olay şemalarına giriş için bkz . Azure Event Grid olay şeması.

Kullanılabilir olay türleri

Azure Container Registry aşağıdaki olay türlerini yayar:

Olay türü Açıklama
Microsoft.ContainerRegistry.ImagePushed Görüntü gönderildiğinde yükseltilir.
Microsoft.ContainerRegistry.ImageDeleted Görüntü silindiğinde oluşturulur.
Microsoft.ContainerRegistry.ChartPushed Helm grafiği gönderildiğinde yükseltilir.
Microsoft.ContainerRegistry.ChartDeleted Helm grafiği silindiğinde oluşturulur.

Örnek olay

Aşağıdaki örnekte, gönderilen bir görüntünün şeması gösterilmektedir:

[{
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "source": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.ContainerRegistry/registries/<name>",
  "subject": "aci-helloworld:v1",
  "type": "Microsoft.ContainerRegistry.ImagePushed",
  "time": "2018-04-25T21:39:47.6549614Z",
  "data": {
    "id": "31c51664-e5bd-416a-a5df-e5206bc47ed0",
    "timestamp": "2018-04-25T21:39:47.276585742Z",
    "action": "push",
    "target": {
      "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
      "size": 3023,
      "digest": "sha256:213bbc182920ab41e18edc2001e06abcca6735d87782d9cef68abd83941cf0e5",
      "length": 3023,
      "repository": "aci-helloworld",
      "tag": "v1"
    },
    "request": {
      "id": "7c66f28b-de19-40a4-821c-6f5f6c0003a4",
      "host": "demo.azurecr.io",
      "method": "PUT",
      "useragent": "docker/18.03.0-ce go/go1.9.4 git-commit/0520e24 os/windows arch/amd64 UpstreamClient(Docker-Client/18.03.0-ce \\\\(windows\\\\))"
    }
  },
  "specversion": "1.0"
}]

Silinen görüntü olayının şeması benzerdir:

[{
  "id": "f06e3921-301f-42ec-b368-212f7d5354bd",
  "source": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.ContainerRegistry/registries/<name>",
  "subject": "aci-helloworld",
  "type": "Microsoft.ContainerRegistry.ImageDeleted",
  "time": "2018-04-26T17:56:01.8211268Z",
  "data": {
    "id": "f06e3921-301f-42ec-b368-212f7d5354bd",
    "timestamp": "2018-04-26T17:56:00.996603117Z",
    "action": "delete",
    "target": {
      "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
      "digest": "sha256:213bbc182920ab41e18edc2001e06abcca6735d87782d9cef68abd83941cf0e5",
      "repository": "aci-helloworld"
    },
    "request": {
      "id": "aeda5b99-4197-409f-b8a8-ff539edb7de2",
      "host": "demo.azurecr.io",
      "method": "DELETE",
      "useragent": "python-requests/2.18.4"
    }
  },
  "specversion": "1.0"
}]

Gönderilen bir grafik olayının şeması, görüntülenmiş bir gönderilen olayın şemasına benzer, ancak istek nesnesi içermez:

[{
  "id": "ea3a9c28-5b17-40f6-a500-3f02b6829277",
  "source": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.ContainerRegistry/registries/<name>",
  "subject": "mychart:1.0.0",
  "type": "Microsoft.ContainerRegistry.ChartPushed",
  "time": "2019-03-12T22:16:31.5164086Z",
  "data": {
    "id":"ea3a9c28-5b17-40f6-a500-3f02b682927",
    "timestamp":"2019-03-12T22:16:31.0087496+00:00",
    "action":"chart_push",
    "target":{
      "mediaType":"application/vnd.acr.helm.chart",
      "size":25265,
      "digest":"sha256:7f060075264b5ba7c14c23672698152ae6a3ebac1c47916e4efe19cd624d5fab",
      "repository":"repo",
      "tag":"mychart-1.0.0.tgz",
      "name":"mychart",
      "version":"1.0.0"
    }
  },
  "specversion": "1.0"
}]

Silinen bir grafik olayının şeması, görüntülenmiş bir silinen olayın şemasına benzer, ancak bir istek nesnesi içermez:

[{
  "id": "39136b3a-1a7e-416f-a09e-5c85d5402fca",
  "source": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.ContainerRegistry/registries/<name>",
  "subject": "mychart:1.0.0",
  "type": "Microsoft.ContainerRegistry.ChartDeleted",
  "time": "019-03-12T22:42:08.7034064Z",
  "data": {
    "id":"ea3a9c28-5b17-40f6-a500-3f02b682927",
    "timestamp":"2019-03-12T22:42:08.3783775+00:00",
    "action":"chart_delete",
    "target":{
      "mediaType":"application/vnd.acr.helm.chart",
      "size":25265,
      "digest":"sha256:7f060075264b5ba7c14c23672698152ae6a3ebac1c47916e4efe19cd624d5fab",
      "repository":"repo",
      "tag":"mychart-1.0.0.tgz",
      "name":"mychart",
      "version":"1.0.0"
    }
  },
  "specversion": "1.0"
}]

Olay özellikleri

Bir olay aşağıdaki üst düzey verilere sahiptir:

Özellik Türü Veri Akışı Açıklaması
source Dize Olay kaynağının tam kaynak yolu. Bu alan yazılabilir değil. Event Grid bu değeri sağlar.
subject Dize Olay konusunun yayımcı tarafından tanımlanan yolu.
type Dize Bu olay kaynağı için kayıtlı olay türlerinden biri.
time Dize Sağlayıcının UTC saati temelinde olayın oluşturulduğu saat.
id Dize Olayın benzersiz tanımlayıcısı.
data nesne Blob depolama olay verileri.
specversion Dize CloudEvents şema belirtimi sürümü.

Veri nesnesi aşağıdaki özelliklere sahiptir:

Özellik Türü Veri Akışı Açıklaması
id Dize Olay kimliği.
timestamp Dize Olayın gerçekleştiği saat.
action Dize Sağlanan olayı kapsayan eylem.
target nesne Olayın hedefi.
request nesne Olayı oluşturan istek.

Hedef nesne aşağıdaki özelliklere sahiptir:

Özellik Türü Veri Akışı Açıklaması
mediaType Dize Başvuruda bulunılan nesnenin MIME türü.
size integer İçeriğin bayt sayısı. Uzunluk alanıyla aynı.
digest Dize Kayıt Defteri V2 HTTP API Belirtimi tarafından tanımlanan içeriğin özeti.
length integer İçeriğin bayt sayısı. Boyut alanıyla aynı.
repository Dize Depo adı.
tag Dize Etiket adı.
name Dize Grafik adı.
version Dize Grafik sürümü.

İstek nesnesi aşağıdaki özelliklere sahiptir:

Özellik Türü Veri Akışı Açıklaması
id Dize Olayı başlatan isteğin kimliği.
addr Dize Olayı başlatan istemci bağlantısının IP veya ana bilgisayar adı ve büyük olasılıkla bağlantı noktası. Bu değer, standart http isteğinden RemoteAddr değeridir.
host Dize Gelen isteklerde http ana bilgisayar üst bilgisi tarafından belirtildiği gibi kayıt defteri örneğinin dışarıdan erişilebilen ana bilgisayar adı.
method Dize Olayı oluşturan istek yöntemi.
useragent Dize İsteğin kullanıcı aracısı üst bilgisi.

ConnectedRegistry nesnesi aşağıdaki özelliklere sahiptir:

Özellik Türü Veri Akışı Açıklaması
name Dize Bu olayı oluşturan bağlı kayıt defterinin adı.

Öğreticiler ve nasıl yapılır kılavuzları

Ünvan Açıklama
Hızlı Başlangıç: Kapsayıcı kayıt defteri olaylarını gönderme Container Registry olaylarını göndermek için Azure CLI'nin nasıl kullanılacağını gösterir.

Sonraki adımlar