الحاويات في بيئات غير متصلة (غير متصلة)

مقالة
05/23/2024

يتوفر دعم الحاويات حاليا مع إصدار 2022-08-31 (GA) Document Intelligence لجميع النماذج ولنماذج Read و 2023-07-31 (GA) Layout و Invoice و Receipt و ID Document:

✔️ راجع حاويات Document Intelligence v3.0 في بيئات غير متصلة للحصول على وثائق الحاوية المدعومة.

ينطبق هذا المحتوى على: v3.0 (GA) v3.1 (GA)

ما هي الحاويات غير المتصلة؟

تمنحك حاويات Azure الذكاء الاصطناعي المرونة لتشغيل بعض خدمات Document Intelligence محليا في حاويات. تعمل الحاويات المتصلة محليا في بيئتك وترسل معلومات الاستخدام إلى السحابة للفوترة. الحاويات غير المتصلة مخصصة للسيناريوهات التي لا يلزم فيها الاتصال بالسحابة لتشغيل الحاويات.

تسمح لك حاويات Azure الذكاء الاصطناعي Document Intelligence باستخدام واجهات برمجة تطبيقات Document Intelligence مع فوائد التعبئة في حاويات. يتم تقديم الحاويات غير المتصلة من خلال تسعير مستوى الالتزام المقدم بسعر مخفض مقارنة بتسعير الدفع أولا بأول. مع تسعير مستوى الالتزام، يمكنك الالتزام باستخدام ميزات Document Intelligence مقابل رسوم ثابتة، بتكلفة إجمالية يمكن التنبؤ بها، استنادا إلى احتياجات حمل العمل الخاص بك.

الشروع في العمل

قبل محاولة تشغيل حاوية Docker في بيئة غير متصلة، تأكد من أنك على دراية بالمتطلبات التالية لتنزيل الحاوية واستخدامها بنجاح:

متطلبات وتوصيات الكمبيوتر المضيف
الأمر Docker pull لتنزيل الحاوية.
كيفية التحقق من تشغيل الحاوية.
كيفية إرسال الاستعلامات إلى نقطة نهاية الحاوية، بمجرد تشغيلها.

طلب الوصول لاستخدام الحاويات في بيئات غير متصلة

قبل أن تتمكن من استخدام حاويات Document Intelligence في بيئات غير متصلة، يجب أولا ملء نموذج طلب وإرساله وشراء خطة التزام.

إنشاء مورد جديد في مدخل Microsoft Azure

ابدأ بتوفير مورد جديد في المدخل.

تأكد من Commitment tier disconnected containers DC0 تحديد خيار مستوى التسعير
حدد مستوى التسعير المناسب من مستوى واحد على الأقل من مستويات الالتزام المخصصة أو المقروءة أو المعدة مسبقا

الحاوية	الحد الأدنى	مستحسن	خطة الالتزام
`Read`	`8` الذاكرة الأساسية، ذاكرة 10 غيغابايت	`8` الذاكرة الأساسية، ذاكرة 24 غيغابايت	التعرف البصري على الحروف (قراءة)
`Layout`	`8` الذاكرة الأساسية، ذاكرة 16 غيغابايت	`8` الذاكرة الأساسية، ذاكرة 24 غيغابايت	منشأ مسبقًا
`Business Card`	`8` الذاكرة الأساسية، ذاكرة 16 غيغابايت	`8` الذاكرة الأساسية، ذاكرة 24 غيغابايت	منشأ مسبقًا
`General Document`	`8` الذاكرة الأساسية، ذاكرة 12 غيغابايت	`8` الذاكرة الأساسية، ذاكرة 24 غيغابايت	منشأ مسبقًا
`ID Document`	`8` الذاكرة الأساسية، ذاكرة 8 غيغابايت	`8` الذاكرة الأساسية، ذاكرة 24 غيغابايت	منشأ مسبقًا
`Invoice`	`8` الذاكرة الأساسية، ذاكرة 16 غيغابايت	`8` الذاكرة الأساسية، ذاكرة 24 غيغابايت	منشأ مسبقًا
`Receipt`	`8` الذاكرة الأساسية، ذاكرة 11 غيغابايت	`8` الذاكرة الأساسية، ذاكرة 24 غيغابايت	منشأ مسبقًا
`Custom Template`	`8` الذاكرة الأساسية، ذاكرة 16 غيغابايت	`8` الذاكرة الأساسية، ذاكرة 24 غيغابايت	واجهة API المخصصة

جمع المعلمات المطلوبة

هناك ثلاث معلمات مطلوبة لجميع حاويات خدمات azure الذكاء الاصطناعي:

يجب أن تكون اتفاقية ترخيص المستخدم النهائي (EULA) موجودة بالقيمة accept.
عنوان URL لنقطة النهاية للمورد الخاص بك من مدخل Microsoft Azure.
مفتاح API للمورد الخاص بك من مدخل Microsoft Azure.

مطلوب كل من عنوان URL لنقطة النهاية ومفتاح API عند تشغيل الحاوية لأول مرة لتكوينها للاستخدام غير المتصل. يمكنك العثور على المفتاح ونقطة النهاية في صفحة المفتاح ونقطة النهاية للمورد الخاص بك في مدخل Microsoft Azure:

لقطة شاشة لمفاتيح مدخل Azure وصفحة نقطة النهاية.

هام

ستستخدم المفتاح ونقطة النهاية فقط لتكوين الحاوية لتشغيلها في بيئة غير متصلة. بعد تكوين الحاوية، لن تحتاج إلى قيم المفتاح ونقطة النهاية لإرسال طلبات واجهة برمجة التطبيقات. قم بتخزينها بأمان - على سبيل المثال، باستخدام Azure Key Vault. مفتاح واحد فقط ضروري لهذه العملية.

تنزيل حاوية Docker باستخدام `docker pull`

قم بتنزيل حاوية Docker التي تمت الموافقة على تشغيلها في بيئة غير متصلة. على سبيل المثال:

أمر سحب Docker	القيمة‬	Format
● ● `docker pull [image]` `docker pull [image]latest`	أحدث صورة حاوية.	● ● `mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout-3.0:latest` `mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice-3.0:latest`

مثال على أمر سحب Docker

docker pull mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice:latest

تكوين الحاوية ليتم تشغيلها في بيئة غير متصلة

صور الحاوية غير المتصلة هي نفسها الحاويات المتصلة. الفرق الرئيسي هو أن الحاويات غير المتصلة تتطلب ملف ترخيص. يتم تنزيل ملف الترخيص هذا عن طريق بدء تشغيل الحاوية في وضع متصل مع تعيين المعلمة downloadLicense إلى true.

الآن بعد تنزيل الحاوية الخاصة بك، تحتاج إلى تنفيذ docker run الأمر باستخدام المعلمة التالية:

DownloadLicense=True. تقوم هذه المعلمة بتنزيل ملف ترخيص يمكن حاوية Docker من التشغيل عندما لا تكون متصلة بالإنترنت. كما يحتوي على تاريخ انتهاء صلاحية، وبعد ذلك يكون ملف الترخيص غير صالح لتشغيل الحاوية. يمكنك فقط استخدام ملف الترخيص في الحاوية الموافق عليها المقابلة.

هام

docker run سيقوم الأمر بإنشاء قالب يمكنك استخدامه لتشغيل الحاوية. يحتوي القالب على معلمات ستحتاجها للنماذج التي تم تنزيلها وملف التكوين. تأكد من حفظ هذا القالب.

يوضح المثال التالي تنسيق docker run الأمر لاستخدامه مع قيم العنصر النائب. استبدل قيم العناصر النائبة هذه بقيمك الخاصة.

Placeholder	القيمة‬	شكل أو مثال
`{IMAGE}`	صورة الحاوية التي تريد استخدامها.	`mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice`
`{LICENSE_MOUNT}`	المسار حيث يتم تنزيل الترخيص وتركيبه.	`/host/license:/path/to/license/directory`
`{ENDPOINT_URI}`	نقطة النهاية للمصادقة على طلب واجهة برمجة التطبيقات. يمكنك العثور عليه في صفحة المفتاح ونقطة النهاية الخاصة بموردك، على مدخل Microsoft Azure.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{API_KEY}`	مفتاح مورد Document Intelligence. يمكنك العثور عليه في صفحة المفتاح ونقطة النهاية الخاصة بموردك، على مدخل Microsoft Azure.	`{string}`
`{CONTAINER_LICENSE_DIRECTORY}`	موقع مجلد الترخيص على نظام الملفات المحلي للحاوية.	`/path/to/license/directory`

مثال على docker run الأمر


docker run --rm -it -p 5000:5050 \

-v {LICENSE_MOUNT} \

{IMAGE} \

eula=accept \

billing={ENDPOINT_URI} \

apikey={API_KEY} \

DownloadLicense=True \

Mounts:License={CONTAINER_LICENSE_DIRECTORY}

في الأمر التالي، استبدل العناصر النائبة لمسار المجلد ونقطة نهاية الفوترة ومفتاح API لتنزيل ملف ترخيص لحاوية التخطيط.

docker run -v {folder path}:/license --env Mounts:License=/license --env DownloadLicense=True --env Eula=accept --env Billing={billing endpoint} --env ApiKey={api key} mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout-3.0:latest

بعد تكوين الحاوية، استخدم القسم التالي لتشغيل الحاوية في البيئة الخاصة بك مع الترخيص، وتخصيصات الذاكرة وCPU المناسبة.

نماذج حاوية معلومات المستند وتكوينها

بعد تكوين الحاوية، سيتم إنشاء قيم نماذج Document Intelligence التي تم تنزيلها وتكوين الحاوية وعرضها في إخراج الحاوية.

تشغيل الحاوية في بيئات غير متصلة

بمجرد تنزيل ملف الترخيص، يمكنك تشغيل الحاوية في بيئة غير متصلة بالترخيص والذاكرة المناسبة وتخصيصات وحدة المعالجة المركزية المناسبة. يوضح المثال التالي تنسيق docker run الأمر مع قيم العنصر النائب. استبدل قيم العناصر النائبة هذه بالقيم الخاصة بك.

كلما تم تشغيل الحاوية، يجب تحميل ملف الترخيص إلى الحاوية ويجب تحديد موقع مجلد الترخيص على نظام الملفات المحلي للحاوية باستخدام Mounts:License=. بالإضافة إلى ذلك، يجب تحديد تحميل الإخراج بحيث يمكن كتابة سجلات استخدام الفوترة.

Placeholder	القيمة‬	شكل أو مثال
`{IMAGE}`	صورة الحاوية التي تريد استخدامها.	`mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice`
`{MEMORY_SIZE}`	الحجم المناسب للذاكرة لتخصيصها للحاوية الخاصة بك.	`4g`
`{NUMBER_CPUS}`	العدد المناسب من وحدات المعالجة المركزية لتخصيصها للحاوية الخاصة بك.	`4`
`{LICENSE_MOUNT}`	المسار حيث يوجد الترخيص ويتم تحميله.	`/host/license:/path/to/license/directory`
`{OUTPUT_PATH}`	مسار الإخراج لتسجيل سجلات الاستخدام.	`/host/output:/path/to/output/directory`
`{CONTAINER_LICENSE_DIRECTORY}`	موقع مجلد الترخيص على نظام الملفات المحلي للحاوية.	`/path/to/license/directory`
`{CONTAINER_OUTPUT_DIRECTORY}`	موقع مجلد الإخراج على نظام الملفات المحلي للحاوية.	`/path/to/output/directory`

مثال على docker run الأمر

docker run --rm -it -p 5000:5050 --memory {MEMORY_SIZE} --cpus {NUMBER_CPUS} \

-v {LICENSE_MOUNT} \

-v {OUTPUT_PATH} \

{IMAGE} \

eula=accept \

Mounts:License={CONTAINER_LICENSE_DIRECTORY}

Mounts:Output={CONTAINER_OUTPUT_DIRECTORY}

يشبه بدء تشغيل حاوية غير متصلة بدء حاوية متصلة. تتطلب الحاويات غير المتصلة معلمة ترخيص إضافية. فيما يلي نموذج لملف docker-compose.yml لبدء حاوية مخصصة في وضع قطع الاتصال. أضف متغير البيئة CUSTOM_LICENSE_MOUNT_PATH مع تعيين قيمة إلى المجلد الذي يحتوي على ملف الترخيص الذي تم تنزيله، ومتغير OUTPUT_MOUNT_PATH البيئة مع تعيين قيمة إلى المجلد الذي يحتوي على سجلات الاستخدام.

version: '3.3'
services:
 nginx:
  image: nginx:alpine
  container_name: reverseproxy
  volumes:
    - ${NGINX_CONF_FILE}:/etc/nginx/nginx.conf
  ports:
    - "5000:5050"
 layout:
  container_name: azure-cognitive-service-layout
  image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout-3.0:latest
  environment:
    eula: accept
    apikey: ${FORM_RECOGNIZER_KEY}
    billing: ${FORM_RECOGNIZER_ENDPOINT_URI}
    Logging:Console:LogLevel:Default: Information
    SharedRootFolder: /shared
    Mounts:Shared: /shared
    Mounts:Output: /logs
    Mounts:License: /license
  volumes:
    - type: bind
      source: ${SHARED_MOUNT_PATH}
      target: /shared
    - type: bind
      source: ${OUTPUT_MOUNT_PATH}
      target: /logs
    - type: bind
      source: ${LAYOUT_LICENSE_MOUNT_PATH}
      target: /license
  expose:
    - "5000"

 custom-template:
  container_name: azure-cognitive-service-custom-template
  image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/custom-template-3.0:latest
  restart: always
  depends_on:
    - layout
  environment:
    AzureCognitiveServiceLayoutHost: http://azure-cognitive-service-layout:5000
    eula: accept
    apikey: ${FORM_RECOGNIZER_KEY}
    billing: ${FORM_RECOGNIZER_ENDPOINT_URI}
    Logging:Console:LogLevel:Default: Information
    SharedRootFolder: /shared
    Mounts:Shared: /shared
    Mounts:Output: /logs
    Mounts:License: /license
  volumes:
    - type: bind
      source: ${SHARED_MOUNT_PATH}
      target: /shared
    - type: bind
      source: ${OUTPUT_MOUNT_PATH}
      target: /logs
    - type: bind
      source: ${CUSTOM_LICENSE_MOUNT_PATH}
      target: /license
  expose:
    - "5000"

 studio:
  container_name: form-recognizer-studio
  image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/studio:3.0
  environment:
    ONPREM_LOCALFILE_BASEPATH: /onprem_folder
    STORAGE_DATABASE_CONNECTION_STRING: /onprem_db/Application.db
  volumes:
    - type: bind
      source: ${FILE_MOUNT_PATH} # path to your local folder
      target: /onprem_folder
    - type: bind
      source: ${DB_MOUNT_PATH} # path to your local folder
      target: /onprem_db
  ports:
    - "5001:5001"
  user: "1000:1000" # echo $(id -u):$(id -g)

معلمات والأوامر الأخرى

فيما يلي عدد قليل من المعلمات والأوامر التي تحتاجها لتشغيل الحاوية.

سجلات الاستخدام

عند تشغيل حاويات Docker في بيئة غير متصلة، ستكتب الحاوية سجلات الاستخدام إلى وحدة تخزين حيث يتم تجميعها بمرور الوقت. يمكنك أيضا استدعاء نقطة نهاية REST API لإنشاء تقرير حول استخدام الخدمة.

وسيطات لتخزين السجلات

عند التشغيل في بيئة غير متصلة، يجب أن يكون تحميل الإخراج متوفرًا للحاوية لتخزين سجلات الاستخدام. على سبيل المثال، يمكنك تضمين -v /host/output:{OUTPUT_PATH} وفي Mounts:Output={OUTPUT_PATH} المثال التالي، استبدال {OUTPUT_PATH} بالمسار حيث يتم تخزين السجلات:

docker run -v /host/output:{OUTPUT_PATH} ... <image> ... Mounts:Output={OUTPUT_PATH}

الحصول على السجلات باستخدام نقاط نهاية الحاوية

توفر الحاوية نقطتي نهاية لإرجاع السجلات حول استخدامها.

الحصول على كافة السجلات

توفر نقطة النهاية التالية تقريرا يلخص جميع الاستخدام الذي تم جمعه في دليل سجل الفوترة المحمل.

https://<service>/records/usage-logs/

مثال نقطة نهاية HTTPS

http://localhost:5000/records/usage-logs

ترجع نقطة نهاية سجل الاستخدام استجابة JSON مشابهة للمثال التالي:

{
  "apiType": "string",
  "serviceName": "string",
  "meters": [
    {
      "name": "string",
      "quantity": 256345435
    }
  ]
}

الحصول على سجلات لشهر معين

توفر نقطة النهاية التالية تقريرا يلخص الاستخدام خلال شهر وعام محددين.

https://<service>/records/usage-logs/{MONTH}/{YEAR}

ترجع نقطة نهاية سجلات الاستخدام هذه استجابة JSON مشابهة للمثال التالي:

{
  "apiType": "string",
  "serviceName": "string",
  "meters": [
    {
      "name": "string",
      "quantity": 56097
    }
  ]
}

استكشاف الأخطاء وإصلاحها

قم بتشغيل الحاوية مع تمكين تحميل الإخراج والتسجيل. تمكن هذه الإعدادات الحاوية من إنشاء ملفات سجل مفيدة لاستكشاف المشكلات التي تحدث أثناء بدء تشغيل الحاوية أو تشغيلها.

تلميح

لمزيد من المعلومات والإرشادات حول استكشاف الأخطاء وإصلاحها، يرجى مراجعة الأسئلة المتداولة (FAQ) بخصوص حاويات الخدمات المعرفية.

مشاركة عبر

الحاويات في بيئات غير متصلة (غير متصلة)

ما هي الحاويات غير المتصلة؟

الشروع في العمل

طلب الوصول لاستخدام الحاويات في بيئات غير متصلة

إنشاء مورد جديد في مدخل Microsoft Azure

جمع المعلمات المطلوبة

تنزيل حاوية Docker باستخدام `docker pull`

تكوين الحاوية ليتم تشغيلها في بيئة غير متصلة

نماذج حاوية معلومات المستند وتكوينها

تشغيل الحاوية في بيئات غير متصلة

معلمات والأوامر الأخرى

سجلات الاستخدام

وسيطات لتخزين السجلات

الحصول على السجلات باستخدام نقاط نهاية الحاوية

الحصول على كافة السجلات

الحصول على سجلات لشهر معين

استكشاف الأخطاء وإصلاحها

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

الملاحظات

الملاحظات

الموارد الإضافية

مشاركة عبر

الحاويات في بيئات غير متصلة (غير متصلة)

ما هي الحاويات غير المتصلة؟

الشروع في العمل

طلب الوصول لاستخدام الحاويات في بيئات غير متصلة

إنشاء مورد جديد في مدخل Microsoft Azure

جمع المعلمات المطلوبة

تنزيل حاوية Docker باستخدام docker pull

تكوين الحاوية ليتم تشغيلها في بيئة غير متصلة

نماذج حاوية معلومات المستند وتكوينها

تشغيل الحاوية في بيئات غير متصلة

معلمات والأوامر الأخرى

سجلات الاستخدام

وسيطات لتخزين السجلات

الحصول على السجلات باستخدام نقاط نهاية الحاوية

الحصول على كافة السجلات

الحصول على سجلات لشهر معين

استكشاف الأخطاء وإصلاحها

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

الملاحظات

الملاحظات

الموارد الإضافية

تنزيل حاوية Docker باستخدام `docker pull`