الخطوة التعليمية 2: أتمتة تغيير حجم الصور التي تم تحميلها باستخدام شبكة الأحداث

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

Azure Event Grid هي خدمة أحداث للسحابة. تمكنك شبكة الحدث من إنشاء اشتراكات في الأحداث التي يتم رفعها بواسطة خدمات Azure أو موارد الجهات الخارجية.

يعمل هذا البرنامج التعليمي على توسيع Upload بيانات الصور في السحابة باستخدام البرنامج التعليمي Azure Storage لإضافة إنشاء صور مصغرة تلقائية بدون خادم باستخدام Azure Event Grid ووظائف Azure. تتيح شبكة الحدث لدوال Azure الاستجابة لتخزين أحداث فقاعة Azure وإنشاء صور مصغرة للصور التي تم تحميلها. يتم إنشاء اشتراك حدث مقابل حدث إنشاء تخزين فقاعة. عند إضافة فقاعة إلى حاوية تخزين فقاعة معينة، يتم استدعاء نقطة نهاية للدالة. يتم استخدام البيانات التي تم تمريرها إلى ربط الدالة من شبكة الحدث للوصول إلى الفقاعة وإنشاء صورة مصغرة.

يمكنك استخدام Azure CLI ومدخل Azure لإضافة وظيفة تغيير الحجم إلى تطبيق تحميل لصورة موجودة.

.NET v12 SDK

Node.js v10 SDK

في هذا البرنامج التعليمي، تتعلم كيفية:

• أنشئ حساب Azure Storage
• نشر كود بدون خادم باستخدام وظائف Azure
• إنشاء اشتراك حدث تخزين فقاعة في شبكة الحدث

المتطلبات الأساسية

ملاحظة

تستخدم هذه المقالة الوحدة النمطية Azure Az PowerShell، وهي الوحدة النمطية PowerShell الموصى بها للتفاعل مع Azure. لبدء استخدام الوحدة النمطية Az PowerShell، راجع تثبيت Azure PowerShell. لمعرفة كيفية الترحيل إلى الوحدة النمطية Az PowerShell، راجع ترحيل Azure PowerShell من AzureRM إلى Az.

لإكمال هذا البرنامج التعليمي:

• احصل على اشتراك Azure. هذا البرنامج التعليمي لا يعمل مع الاشتراك المجاني.
• يجب أن تكون قد أكملت البرنامج التعليمي السابق لتخزين الفقاعة: حمّل بيانات الصور في السحابة باستخدام تخزين Azure .

أنشئ حساب Azure Storage

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

تعيين متغيرات للاحتفاظ باسم مجموعة الموارد التي قمت بإنشائها في البرنامج التعليمي السابق، وموقع الموارد التي سيتم إنشاؤها، واسم حساب التخزين الجديد الذي تتطلبه دوال Azure. ثم قم بإنشاء حساب التخزين لدالة Azure.

PowerShell

استخدم الأمر جديد-AzStorageAccount.

1. حدد اسمًا لمجموعة الموارد.

   $resourceGroupName="myResourceGroup"
   

2. حدد موقعًا لحساب التخزين.

   $location="eastus"    
   

3. حدد اسم حساب التخزين الذي سيتم استخدامه من قبل الدالة.

   $functionstorage="<name of the storage account to be used by the function>"    
   

4. إنشاء حساب تخزين.

   New-AzStorageAccount -ResourceGroupName $resourceGroupName -AccountName $functionstorage -Location $location -SkuName Standard_LRS -Kind StorageV2        
   

Azure CLI

استخدم أمر إنشاء حساب تخزين az.

ملاحظة

استخدم الأوامر التالية في bash shell من Shell السحابة. استخدم القائمة المنسدلة في الزاوية العلوية اليسرى من سحابة Shell للتبديل إلى Bash shell إذا لزم الأمر.

1. حدد اسمًا لمجموعة الموارد.

   resourceGroupName="myResourceGroup"    
   

2. حدد موقعًا لحساب التخزين.

   location="eastus"
   

3. حدد اسم حساب التخزين الذي سيتم استخدامه من قبل الدالة.

   functionstorage="<name of the storage account to be used by the function>"
   

4. إنشاء حساب تخزين.

   az storage account create --name $functionstorage --location $location --resource-group $resourceGroupName --sku Standard_LRS --kind StorageV2
   

إنشاء تطبيق وظائف

يجب أن يكون لديك تطبيق دالة لاستضافة تنفيذ الدالة الخاصة بك. يوفر تطبيق الدالة بيئة لتنفيذ كود للدالة بدون خادم.

في الأمر التالي، قم بتوفير اسم تطبيق الدالة الفريد الخاص بك. يتم استخدام اسم تطبيق الدالة كمجال DNS افتراضي لتطبيق الدالة، وبالتالي يجب أن يكون الاسم فريدًا عبر جميع التطبيقات في Azure.

حدد اسمًا لتطبيق الدالة الذي سيتم إنشاؤه، ثم قم بإنشاء الدالة Azure.

PowerShell

إنشاء تطبيق دالة باستخدام الأمر جديد-AzFunctionApp.

1. حدد اسمًا لتطبيق الوظائف.

   $functionapp="<name of the function app>"    
   

2. إنشاء تطبيق الدالة

   New-AzFunctionApp -Location $location -Name $functionapp -ResourceGroupName $resourceGroupName -Runtime PowerShell -StorageAccountName $functionstorage    
   

Azure CLI

إنشاء تطبيق دالة باستخدام الأمر إنشاء functionapp az.

1. حدد اسمًا لتطبيق الوظائف.

   functionapp="<name of the function app>"
   

2. إنشاء تطبيق الدالة

   az functionapp create --name $functionapp --storage-account $functionstorage --resource-group $resourceGroupName --consumption-plan-location $location --functions-version 3    
   

الآن قم بتكوين تطبيق الدالة للاتصال بحساب تخزين الفقاعة الذي قمت بإنشائه في البرنامج التعليمي السابق.

تكوين تطبيق الوظائف

تحتاج الدالة إلى بيانات اعتماد لحساب تخزين الفقاعة، والتي تتم إضافتها إلى إعدادات التطبيق لتطبيق الدالة باستخدام إما تعيين إعدادات التكوين az functionapp أو الأمر Update-AzFunctionAppSetting.

.NET v12 SDK

storageConnectionString=$(az storage account show-connection-string --resource-group $resourceGroupName --name $blobStorageAccount --query connectionString --output tsv)

az functionapp config appsettings set --name $functionapp --resource-group $resourceGroupName --settings AzureWebJobsStorage=$storageConnectionString THUMBNAIL_CONTAINER_NAME=thumbnails THUMBNAIL_WIDTH=100 FUNCTIONS_EXTENSION_VERSION=~2 FUNCTIONS_WORKER_RUNTIME=dotnet

$storageConnectionString=$(az storage account show-connection-string --resource-group $resourceGroupName --name $blobStorageAccount --query connectionString --output tsv)

Update-AzFunctionAppSetting -Name $functionapp -ResourceGroupName $resourceGroupName -AppSetting @{AzureWebJobsStorage=$storageConnectionString; THUMBNAIL_CONTAINER_NAME=thumbnails; THUMBNAIL_WIDTH=100 FUNCTIONS_EXTENSION_VERSION=~2; 'FUNCTIONS_WORKER_RUNTIME'='dotnet'}

Node.js v10 SDK

blobStorageAccountKey=$(az storage account keys list -g $resourceGroupName -n $blobStorageAccount --query [0].value --output tsv)

storageConnectionString=$(az storage account show-connection-string --resource-group $resourceGroupName --name $blobStorageAccount --query connectionString --output tsv)

az functionapp config appsettings set --name $functionapp --resource-group $resourceGroupName --settings FUNCTIONS_EXTENSION_VERSION=~2 BLOB_CONTAINER_NAME=thumbnails AZURE_STORAGE_ACCOUNT_NAME=$blobStorageAccount AZURE_STORAGE_ACCOUNT_ACCESS_KEY=$blobStorageAccountKey AZURE_STORAGE_CONNECTION_STRING=$storageConnectionString FUNCTIONS_WORKER_RUNTIME=node WEBSITE_NODE_DEFAULT_VERSION=~10

FUNCTIONS_EXTENSION_VERSION=~2يجعل الإعداد تطبيق الدالة يعمل على الإصدار 2.x من وقت تشغيل دوال Azure.

يمكنك الآن نشر مشروع كود دالة إلى تطبيق الدالة هذه.

نشر كود الدالة

.NET v12 SDK

نموذج C# تغيير حجم الدالة متوفر على GitHub. نشر مشروع الكود هذا إلى تطبيق الدالة باستخدام أمر تكوين مصدر نشر functionapp az.

az functionapp deployment source config --name $functionapp --resource-group $resourceGroupName --branch master --manual-integration --repo-url https://github.com/Azure-Samples/function-image-upload-resize

Node.js v10 SDK

نموذج Node.js تغيير حجم الدالة متوفر على GitHub. نشر هذا المشروع لكود الدوال إلى تطبيق الدالة باستخدام الأمر تكوين مصدر نشر functionapp az.

az functionapp deployment source config --name $functionapp \
  --resource-group $resourceGroupName --branch master --manual-integration \
  --repo-url https://github.com/Azure-Samples/storage-blob-resize-function-node

يتم تشغيل دالة تغيير حجم الصورة بواسطة طلبات HTTP المرسلة إليها من خدمة شبكة الحدث. تخبر شبكة الحدث أنك تريد الحصول على هذه الإشعارات في عنوان URL الخاص بدالتك عن طريق إنشاء اشتراك حدث. بالنسبة لهذا البرنامج التعليمي ، يمكنك الاشتراك في الأحداث التي تم إنشاؤها بواسطة blob.

تتضمن البيانات التي تم تمريرها إلى الدالة من إعلام شبكة الحدث عنوان URL للفقاعة. يتم تمرير URL هذا بدوره إلى ربط الإدخال للحصول على الصورة التي تم تحميلها من تخزين الفقاعة. الدالة تقوم بإنشاء صورة مصغرة ويكتب الدفق الناتج إلى حاوية منفصلة في تخزين فقاعة.

يستخدم هذا المشروع EventGridTrigger لنوع المشغل. يوصى باستخدام مشغل شبكة الحدث عبر مشغلات HTTP العامة. تقوم شبكة الحدث تلقائيًّا بالتحقق من صحة مشغلات دالة شبكة الحدث. مع مشغلات HTTP عامة، يجب عليك تنفيذ استجابة التحقق من الصحة.

.NET v12 SDK

لمعرفة المزيد حول هذه الدالة، راجع ملفات function.js و run.csx.

Node.js v10 SDK

لمعرفة المزيد حول هذه الدالة، راجع ملفات function.js و index.js.

يتم نشر كود مشروع الدالة مباشرة من مستودع النموذج العام. لمعرفة المزيد حول خيارات النشر لدوال Azure، راجع النشر المستمر لدوال Azure.

إنشاء اشتراك حدث

يشير اشتراك الحدث إلى الأحداث التي أنشأها الموفر والتي تريد إرسالها إلى نقطة نهاية معينة. في هذه الحالة، يتم كشف نقطة النهاية بواسطة الدالة الخاصة بك. استخدم الخطوات التالية لإنشاء اشتراك حدث يرسل إعلامات إلى الدالة في مدخل Azure:

1. في مدخل Azure، في أعلى الصفحة، ابحث عن تطبيق الوظيفة الذي قمت بإنشائه وحدده Function App واختره. حدد دوال واختار دالة الصورة المصغرة.

   

2. حدد التكامل ثم اختر مشغل شبكة الحدث وحدد إنشاء اشتراك شبكة الحدث.

   

3. استخدم إعدادات الاشتراك في الحدث كما هو محدد في الجدول.

   

   الإعداد	القيمة المقترحة	الوصف
   الاسم	imageresizersub	الاسم الذي يحدد اشتراك الحدث الجديد الخاص بك.
   نوع الموضوع	حسابات التخزين⁧	اختر موفر حدث لحساب التخزين.
   الاشتراك	اشتراكك في Azure	افتراضيًّا، يتم تحديد اشتراك Azure الحالي الخاص بك.
   مجموعة الموارد	myResourceGroup	حدد استخدام الموجود واختر مجموعة الموارد التي كنت تستخدمها في هذا البرنامج التعليمي.
   المورد	حساب تخزين الفقاعة الخاص بك	اختر حساب تخزين الفقاعة الذي أنشأته.
   اسم موضوع النظام	imagestoragesystopic	حدد اسمًا لموضوع النظام. للتعرف على موضوعات النظام، راجع نظرة عامة على موضوعات النظام.
   أنواع الحدث	الفقاعة التي تم إنشاؤها	قم بإلغاء تحديد كافة الأنواع الأخرى غير الفقاعة التي تم إنشاؤها. يتم تمرير أنواع الحدث فقط Microsoft.Storage.BlobCreated إلى الدالة.
   نوع نقطة النهاية	تم تجديدها تلقائيًّا	المعرفة مسبقًا كدالة Azure.
   نقطة النهاية	تم تجديدها تلقائيًّا	اسم الدالة. في هذه الحالة، إنها صورة مصغرة.

4. قم بالتبديل إلى علامة تبويب عوامل التصفية، ثم قم بالإجراءات التالية:

   1. حدد تمكين خيار تصفية الموضوع.

   2. بالنسبة إلى الموضوع الذي يبدأ به، أدخل القيمة التالية: / blobServices/default/containers/images/.

      

5. حدد إنشاء لإضافة اشتراك الحدث لإنشاء اشتراك حدث يقوم بتشغيل Thumbnail الوظيفة عند إضافة نقطة إلى الحاوية images . تقوم الدالة بإعادة تغيير حجم الصور وإضافتها إلى thumbnails الحاوية.

الآن بعد أن تم تكوين الخدمات الخلفية، يمكنك اختبار وظيفة تغيير حجم الصورة في نموذج التطبيق على شبكة الإنترنت.

اختبر نموذج التطبيق

لاختبار تغيير حجم الصورة في تطبيق الويب، استعرض للوصول إلى عنوان URL للتطبيق المنشور. عنوان URL الافتراضي لتطبيق الويب هو https://<web_app>.azurewebsites.net .

NET v12 SDK.

انقر فوق منطقة تحميل الصور لتحديد ملف وتحميله. يمكنك أيضًا سحب صورة إلى هذه المنطقة.

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

Node.js v10 SDK

انقر فوق اختيار ملف لتحديد ملف، ثم انقر فوق تحميلصورة. عندما يكون التحميل ناجحًا، ينتقل المستعرض إلى صفحة نجاح. انقر فوق الرابط للعودة إلى الصفحة الرئيسية. يتم عرض نسخة من الصورة التي تم تحميلها في منطقة الصور المصغرة التي تم إنشاؤها. (إذا لم تظهر الصورة في البداية، فجرب إعادة تحميل الصفحة.) تم إعادة حجم هذه الصورة بواسطة الدالة، وإضافتها إلى حاوية الصور المصغرة، وتنزيلها من قبل عميل الويب.

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

في هذا البرنامج التعليمي، تعلمت كيفية:

• إنشاء حساب تخزين Azure عام
• نشر كود بدون خادم باستخدام وظائف Azure
• إنشاء اشتراك حدث تخزين فقاعة في شبكة الحدث

تقدم إلى الجزء الثالث من سلاسل البرامج التعليمية للتخزين لمعرفة كيفية تأمين الوصول إلى حساب التخزين.

الوصول الآمن إلى بيانات التطبيقات في السحابة

• لمعرفة المزيد حول شبكة الحدث، راجع مقدمة لشبكة حدث Azure.
• لتجربة برنامج تعليمي آخر يتميز بدوال Azure، راجع إنشاء دالة تتكامل مع تطبيقات Azure المنطقية.