مشاركة عبر

البرنامج التعليمي: استخدام واجهات برمجة التطبيقات REST لنسخ البيانات إلى تخزين Azure Data Box Blob

  • مقالة

تنبيه

تشير هذه المقالة إلى CentOS، وهو توزيع Linux هو حالة نهاية العمر الافتراضي (EOL). يرجى مراعاة استخدامك والتخطيط وفقا لذلك. لمزيد من المعلومات، راجع إرشادات نهاية العمر الافتراضي CentOS.

يُوضح البرنامج التعليمي إجراءات الاتصال بتخزين Azure Data Box Blob عبر واجهات برمجة التطبيقات REST عبر http أو https. بمجرد الاتصال، يجري أيضاً وصف الخطوات المطلوبة لنسخ البيانات إلى تخزينData Box Blob وإعداد مربع البيانات للشحن.

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

  • المتطلبات الأساسية
  • الاتصال لتخزين Data Box Blob عبر http أو https
  • نسخ البيانات إلى Data Box

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

قبل البدء، تأكد من:

  1. إكمال البرنامج التعليمي: إعداد Azure Data Box.
  2. تتلقى Data Box وحالة الطلب في المدخل هي Delivered.
  3. يمكنك مراجعة متطلبات النظام لتخزين Data Box Blob وتكون على دراية بالإصدارات المدعومة من واجهات برمجة التطبيقات وSDKs والأدوات.
  4. لديك حق الوصول إلى كمبيوتر مضيف يحتوي على البيانات التي تريد نسخها إلى Data Box. يجب أن يقوم الكمبيوتر المضيف الخاص بك ب:
    • تشغيل نظام تشغيل معتمد.
    • أن يكون متصلاً بشبكة عالية السرعة. نوصي بشدة أن يكون لديك اتصال واحد على الأقل بسرعة 10 جيجا بايت. يمكنك استخدام ارتباط بيانات بسرعة 1 جيجابت إيثرن إذا لم يتوفر اتصال بسرعة 10 جيجابت إيثرن، على الرغم من تأثر سرعات النسخ.
  5. قم بتنزيل AzCopy V10 على الكمبيوتر المضيف. يتم استخدام AzCopy لنسخ البيانات إلى تخزين Azure Data Box Blob من الكمبيوتر المضيف.

الاتصال عبر http أو https

الاتصال لتخزين Data Box Blob عبر http أو https.

  • يُعد Https هو الطريقة الآمنة والموصى بها للاتصال بتخزين Data Box Blob.
  • يُستخدم Http عند الاتصال عبر الشبكات الموثوق بها.

تختلف خطوات الاتصال عند الاتصال بتخزين Data Box Blob عبر http أو https.

الاتصال عبر http

يتطلب الاتصال بواجهات برمجة تطبيقات REST الخاصة بتخزينData Box Blob storage عبر http إجراء الخطوات التالية:

  • إضافة نقطة نهاية خدمة IP والكائن ثنائي الحجم للجهاز إلى المضيف البعيد
  • تكوين برنامج الشريك والتحقق من الاتصال

وُصفت كل خطوة من تلك الخطوات في الأقسام التالية.

أضف عنوان IP للجهاز ونقطة نهاية خدمة النقطة الكائن ثنائي الحجم

  1. قم بتسجيل الدخول إلى جهاز Data Box. تأكد من فتحه.

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

  2. انتقل إلى تعيين واجهات الشبكة. سجّل ملاحظة عن عنوان IP الخاص بالجهاز لواجهة الشبكة المستخدمة للاتصال بالعميل.

    لقطة شاشة تعرض إعدادات الشبكة حيث يمكنك رؤية عنوان I P.

  3. انتقل إلى الاتصال وانسخ وانقر فوق Rest.

    تُظهر لقطة الشاشة جزء الاتصال والنسخ حيث يمكنك تحديد REST كإعداد وصول.

  4. من حساب Access Storage ومربع حوار تحميل البيانات، انسخ نقطة نهاية خدمة Blob.

    لقطة شاشة تعرض حساب تخزين الوصول ومربع حوار تحميل البيانات حيث يمكنك نسخ نقطة نهاية خدمة Blob.

  5. قم بتشغيل Notepad كمسؤول، وافتح بعدها الملف المضيفين الموجود في C:\Windows\System32\Drivers\etc.

  6. أضف الإدخال التالي إلى ملف المضيفين : <device IP address> <Blob service endpoint>

  7. كمرجع، استخدم الصورة التالية. احفظ ملف المضيفين.

    لقطة شاشة تعرض مستند Notepad مع إضافة عنوان I P ونقطة نهاية خدمة blob.

التحقق من صحة الاتصال وتكوين البرامج الشريكة

تكوين إعدادات برنامج partner software للاتصال بالعميل. للاتصال ببرامج الشريك، تحتاج عادة إلى المعلومات التالية (قد تختلف) التي جمعتها من صفحة الاتصال والنسخ لواجهة مستخدم الويب المحلية في الخطوة السابقة:

  • Storage account name
  • مفتاح الوصول
  • نقطة نهاية Blob service

للتحقق من أن إتمام الاتصال بنجاح، استخدم Storage مستكشف التخزين لإرفاقه بحساب تخزين خارجي. إذا لم يكن لديك Storage Explorer، فستحتاج إلى تنزيله وتثبيته.

في المرة الأولى التي تستخدم فيها Storage Explorer، تحتاج إلى تنفيذ الخطوات التالية:

  1. من شريط الأوامر العلوي، انتقل إلى Edit > Target Azure Stack.

    يظهر أمامك على الشاشة

  2. أعد تشغيل مستكشف التخزين لتصبح التغييرات نافذة المفعول.

    يظهر أمامك على الشاشة

اتبع هذه الخطوات للاتصال بحساب التخزين والتحقق من الاتصال.

  1. في Storage Explorer، افتح مربع الحوار الاتصال بـAzure Storage. في جزء الاتصال بـ Azure Storage، حدد استخدام اسم حساب ومفتاح التخزين.

    تظهر لقطة الشاشة مربع الحوار الاتصال إلى Azure Storage باستخدام اسم حساب تخزين والمفتاح المحدد.

  2. لصق اسم الحساب ومفتاح الحساب (قيمة المفتاح 1 من الاتصال ونسخ الصفحة في واجهة المستخدم المحلية على الويب). حدد مجال نقاط نهاية التخزين لتكون مجالات أخرى (أدخل أدناه) ثم قم بتوفير نقطة نهاية خدمة النقطة النقطية كما هو موضح أدناه. حدد خيار استخدام HTTP فقط إذا نقل عبر http. إذا كنت تستخدم https، اترك الخيار دون تحديد. حدد التالي.

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

  3. في المربع الحواري ملخص الاتصال، راجع المعلومات المتوفرة. حدد اتصال.

    تظهر لقطة الشاشة مربع الحوار ملخص الاتصال مع الاتصال المحدد.

  4. يتم عرض الحساب الذي قمت بإضافته بنجاح في الجزء الأيمن من "مستكشف التخزين" باستخدام (خارجي، آخر) ملحق باسمه. انقر فوق حاويات Blob لعرض الحاوية.

    تظهر لقطة الشاشة قائمة Explorer مع تحديد Blob Containers.

الاتصال عبر https

يتطلب الاتصال بتخزين Azure Blob الخاصة بواجهة برمجة التطبيقات REST عبر https اتخاذ الخطوات التالية:

  • قم بتنزيل الشهادة من مدخل Microsoft Azure. يتم استخدام هذه الشهادة للاتصال بواجهة مستخدم الويب وواجهات برمجة تطبيقات REST لتخزين Azure Blob.
  • استيراد الشهادة على العميل أو المضيف البعيد.
  • أضف نقطة نهاية خدمة IP وblob للجهاز إلى العميل أو المضيف البعيد.
  • تكوين برنامج الشريك والتحقق من الاتصال.

وُصفت كل خطوة من تلك الخطوات في الأقسام التالية.

تنزيل الشهادة

استخدم البوابة الإلكترونية الخاصة بــ Azure لتنزيل الشهادة.

  1. قم بتسجيل الدخول إلى مدخل Azure.

  2. انتقل إلى طلب Data Box وانتقل إلى تفاصيل الجهاز العام>.

  3. ضمن بيانات اعتماد الجهاز، انتقل إلى واجهة برمجة التطبيقات للوصول إلى الجهاز. حدد تنزيل. يقوم هذا الإجراء بتنزيل <اسم> طلبك.cer ملف الشهادة. احفظ هذا الملف وقم بتثبيته على الكمبيوتر العميل أو المضيف الذي تستخدمه للاتصال بالجهاز.

    تنزيل الشهادة من على البوابة الإلكترونية الخاصة بــ Azure

استيراد الشهادة

يتطلب الوصول إلى مخزن البيانات الثنائية الكبيرة مربع البيانات عبر HTTPS شهادة TLS/SSL للجهاز. تختلف طريقة إتاحة هذه الشهادة لتطبيق العميل من تطبيق إلى تطبيق وعبر أنظمة التشغيل والتوزيعات. يمكن لبعض التطبيقات الوصول إلى الشهادة بعد استيرادها إلى مخزن شهادات النظام، بينما لا تستخدم التطبيقات الأخرى هذه الآلية.

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

اتبع هذه الخطوات لاستيراد .cer الملف إلى متجر مصدر Windows أو Linux الخاص بالعميل. وفقًا لنظام Windows، يُمكنك استخدام Windows PowerShell أو واجهة مستخدم خادم Windows لاستيراد الشهادة، وتثبيتها على نظامك.

استخدام Windows PowerShell

  1. البدء في جلسة Windows PowerShell كمسؤول.

  2. في نافذة موجه الأوامر، يُرجى كتابة:

    Import-Certificate -FilePath C:\temp\localuihttps.cer -CertStoreLocation Cert:\LocalMachine\Root

استخدام Windows Server UI

  1. انقر بزر الماوس الأيمن فوق الملف .cer وحدد "Install certificate". يبدأ هذا الإجراء معالج استيراد الشهادة.

  2. بالنسبة إلى موقع المتجر، حدد الجهاز المحلي، ثم حدد التالي.

    معالج استيراد الشهادة، خادم Windows

  3. حدد وضع جميع الشهادات في المتجر التالي، ثم حدد استعراض. انتقل إلى المخزن الجذر للمضيف البعيد، ثم حدد التالي.

    معالج استيراد الشهادة، متجر الشهادات

  4. حدد إنهاء. تظهر رسالة تخبرك بأن عملية الاستيراد تمت بنجاح.

    معالج استيراد الشهادة، إنهاء الاستيراد

استخدام نظام Linux

يختلف الأسلوب لاستيراد الشهادة حسب التوزيع.

يستخدم العديد، مثل أوبونتو وديبيان update-ca-certificates الأمر.

  • إعادة تسمية ملف الشهادة بترميز Base64 ليكون .crt له ملحق ونسخه إلى /usr/local/share/ca-certificates directory ملف.
  • تشغيل الأمر update-ca-certificates.

تُستخدم الإصدارات الأخيرة من RHEL وFedora وCentOS update-ca-trust الأمر.

  • نسخ ملف الشهادة إلى /etc/pki/ca-trust/source/anchors الدليل.
  • شغّل update-ca-trust.

راجع الوثائق الخاصة بتوزيعك للحصول على التفاصيل.

أضف عنوان IP للجهاز ونقطة نهاية خدمة النقطة الكائن ثنائي الحجم

اتبع نفس الخطوات لإضافة عنوان IP للجهاز ونقطة نهاية خدمة blob عند الاتصال عبر http.

تكوين برنامج شريك والتحقق من الاتصال

اتبع الخطوات لتكوين البرامج الشريكة التي اُستخدمت أثناء الاتصال عبر http. يتمثل الفرق الوحيد في أنه يجب ترك خيار استخدام http دون ضوابط.

نسخ البيانات إلى Data Box

بعد توصيل مشاركة واحدة أو أكثر من مشاركات Data Box، تتمثل الخطوة التالية في نسخ البيانات. قبل بدء عمليات نسخ البيانات، ضع في اعتبارك القيود التالية:

  • أثناء نسخ البيانات، تأكد من توافق حجم البيانات مع حدود الحجم الموضحة في حدود تخزين Azure ومربع البيانات.
  • قد تؤدي عمليات التحميل المتزامنة بواسطة Data Box وتطبيق آخر غير Data Box إلى فشل مهمة التحميل وفساد البيانات.

هام

تأكد من الاحتفاظ بنسخة من البيانات المصدر حتى تتمكن من التأكد من نسخ بياناتك في Azure Storage.

وفقًا للبرنامج التعليمي، تُستخدم AzCopy لنسخ البيانات إلى تخزين Data Box Blob. إذا كنت تفضل أداة تستند إلى واجهة المستخدم الرسومية، يمكنك أيضا استخدام Azure Storage Explorer أو برنامج شريك آخر لنسخ البيانات.

تتضمن إجراءات النسخ الخطوات التالية:

  • إنشاء حاوية
  • تحميل محتويات مجلد لتخزين Data Box Blob
  • تحميل الملفات المُعدلة إلى تخزين Data Box Blob

يجري وصف كل من هذه الخطوات بالتفصيل في المقاطع التالية.

إنشاء حاوية

تتمثل الخطوة الأولى في إنشاء حاوية؛ لأنه يتم تحميل النقاط دائما في حاوية. تُنظم الحاويات مجموعات من النقط مثل تنظيم الملفات في مجلدات على حاسوبك. اتبع هذه الخطوات لإنشاء حاوية blob.

  1. افتح Storage Explorer.

  2. في الجزء الأيمن، توسيع حساب التخزين الذي يُراد إنشاء حاوية blob.

  3. حدد بزر الماوس الأيمن "Blob Containers"، ومن قائمة السياق، حدد "Create Blob Container".

    قائمة سياق Blob Containers، إنشاء Blob Container

  4. يظهر مربع النص أسفل مجلد Blob Container. أدخل اسم Blob Container. الاطلاع على إنشاء الحاوية وتعيين أذونات للحصول على معلومات حول القواعد والقيود المتعلقة بتسمية Blob Container.

  5. اضغط إدخال عند القيام به لإنشاء blob container أو خروج لإلغاء الأمر. بعد الإنشاء الناجح، يتم عرض حاوية blob ضمن مجلد Blob Containers لحساب التخزين المحدد.

    تم إنشاء Blob Containers

تحميل محتويات مجلد إلى تخزين Data Box Blob

استخدم AzCopy لتحميل جميع الملفات داخل مجلد إلى تخزين Blob على Windows أو Linux. لتحميل كافة blobs في مجلد، أدخل الأمر AzCopy التالي:

Linux

azcopy \
    --source /mnt/myfolder \
    --destination https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/ \
    --dest-key <key> \
    --recursive

Windows

AzCopy /Source:C:\myfolder /Dest:https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/ /DestKey:<key> /S

استبدل <key> بمفتاح حسابك. يمكنك استرداد مفتاح حسابك داخل مدخل Microsoft Azure عن طريق الانتقال إلى حساب التخزين الخاص بك. حدد Settings > Access keys، واختر مفتاحا، ثم انسخ القيمة والصقها في الأمر AzCopy.

إذا لم تكن حاوية الوجهة المحددة موجودة، يقوم AzCopy بإنشائها وتحميل الملف إليها. تحديث مسار المصدر إلى دليل بياناتك، واستبدال data-box-storage-account-name عنوان URL الوجهة باسم حساب التخزين المتصلة بمربع بياتناتك.

لتحميل محتويات الدليل المحدد إلى تخزين Blob بشكل متكرر، حدد --recursive خيار Linux أو /S خيار Windows. عند تشغيل AzCopy مع أحد هذه الخيارات، يتم تحميل جميع المجلدات الفرعية وملفاتها أيضاً.

تحميل الملفات المُعدلة إلى تخزين Data Box Blob

يمكنك أيضا استخدام AzCopy لتحميل الملفات استنادا إلى آخر وقت تم تعديله. لتحميل الملفات المحدثة أو الجديدة فقط، أضف معلمة --exclude-older Linux أو المعلمة لمعلمة /XO Windows إلى الأمر AzCopy.

إذا كنت تريد فقط نسخ الموارد داخل المصدر المحلي غير الموجودة داخل الوجهة، فحدد كل من --exclude-older المعلمتين و --exclude-newer ل Linux، أو /XO المعلمات و /XN ل Windows في الأمر AzCopy. يقوم AzCopy بتحميل البيانات المحدثة فقط، كما هو محدد بواسطة طابعها الزمني.

Linux

azcopy \
--source /mnt/myfolder \
--destination https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/ \
--dest-key <key> \
--recursive \
--exclude-older

Windows

AzCopy /Source:C:\myfolder /Dest:https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/ /DestKey:<key> /S /XO

إذا كانت هناك أي أخطاء أثناء عملية الاتصال أو النسخ، يُرجى الاطلاع على استكشاف المشكلات المتعلقةData Box Blob storage.

الخطوة التالية هي إعداد جهازك للشحن.

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

في هذا البرنامج التعليمي، تعرّفت على موضوعات Azure Data Box مثل:

  • المتطلبات الأساسية لنسخ البيانات إلى تخزين Azure Data Box Blob باستخدام واجهات برمجة تطبيقات REST
  • الاتصال بتخزين Data Box Blob عبر http أو https
  • نسخ البيانات إلى Data Box

تقديم البرنامج التعليمي التالي لمعرفة كيفية شحن مربع بياناتك مرة أخرى إلى Microsoft.

إرسال Azure Data Box إلى Microsoft