مشاركة عبر

تسجيل حاويات Azure كمصدر شبكة أحداث

  • مقالة

توفر هذه المقالة خصائص ومخطط أحداث "تسجيل الحاوية". للحصول على مقدمة لمخططات الأحداث، راجع مخطط حدث Azure Event Grid.

أنواع الأحداث المتاحة

تخرج من تسجيل حاويات Azure أنواع الأحداث التالية:

نوع الحدث ‏‏الوصف
Microsoft.ContainerRegistry.ImagePushed مرفوع عند دفع صورة.
Microsoft.ContainerRegistry.ImageDeleted مرفوع عند حذف صورة.
Microsoft.ContainerRegistry.ChartPushed مرفوع عند دفع مخطط Helm.
Microsoft.ContainerRegistry.ChartDeleted مرفوع عند حذف مخطط Helm.

مثال حدث

يوضح المثال التالي مخطط حدث دفع صورة:

[{
  "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"
}]

مخطط مشابه لحدث حذف صورة:

[{
  "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"
}]

يشبه مخطط الحدث المدفوع بمخطط بياني، مخطط حدث مدفوع بالصور، ولكنه لا يتضمن عنصر طلب:

[{
  "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"
}]

يشبه مخطط الحدث المحذوف بمخطط بياني، مخطط حدث محذوف بالصور، ولكنه لا يتضمن عنصر طلب:

[{
  "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"
}]

خصائص الحدث

ويحتوي الحدث على بيانات المستوى الأعلى التالية:

الخاصية نوع الوصف
source سلسلة مسار المورد الكامل إلى مصدر الحدث. هذا الحقل غير قابل للكتابة. توفر شبكة الأحداث هذه القيمة.
subject سلسلة مسار يحدده الناشر لموضوع الحدث.
type سلسلة أحد أنواع الأحداث المسجلة لمصدر الحدث الماثل.
time سلسلة الوقت الذي يتم إنشاء الحدث استناداً إلى وقت UTC الموفر.
id سلسلة المعرف الفريد للحدث.
data كائن بيانات حدث تخزين البيانات الثنائية الكبيرة.
specversion سلسلة إصدار مواصفات مخطط CloudEvents.

كائن البيانات له الخصائص التالية:

الخاصية نوع الوصف
id سلسلة معرف الحدث.
timestamp سلسلة الوقت الذي حدث فيه الحدث.
action سلسلة الإجراء الذي يشمل الحدث المقدم.
target كائن الهدف من الحدث.
request كائن الطلب الذي أنشأ الحدث.

العنصر الهدف له الخصائص التالية:

الخاصية نوع الوصف
mediaType سلسلة نوع MIME للعنصر المشار إليه.
size integer عدد وحدات البايت من المحتوى. نفس طول الحقل.
digest سلسلة ملخص المحتوى، كما هو محدد بواسطة مواصفات Registry V2 HTTP API.
length integer عدد وحدات البايت من المحتوى. نفس حجم الحقل.
repository سلسلة اسم المستودع.
tag سلسلة اسم العلامة.
name سلسلة اسم المخطط.
version سلسلة إصدار المخطط.

عنصر الطلب له الخصائص التالية:

الخاصية نوع الوصف
id سلسلة معرف الطلب الذي بدأ الحدث.
addr سلسلة IP أو اسم المضيف ومن المحتمل منفذ اتصال العميل الذي بدأ الحدث. هذه القيمة هي RemoteAddr من طلب http القياسي.
host سلسلة اسم المضيف الوصول الخارجي لمثيل التسجيل، كما هو محدد بواسطة رأس مضيف http على الطلبات الواردة.
method سلسلة أسلوب الطلب الذي قام بإنشاء الحدث.
useragent سلسلة عنوان عامل المستخدم للطلب.

يحتوي كائن السجل المتصل على الخصائص التالية:

الخاصية نوع الوصف
name سلسلة اسم السجل المتصل الذي أنشأ هذا الحدث.

البرامج التعليمية والدروس المعرفية

المسمى الوظيفي ‏‏الوصف
التشغيل السريع: إرسال أحداث تسجيل الحاوية يوضح كيفية استخدام Azure CLI لإرسال أحداث تسجيل حاوية.

الخطوات التالية