البدء السريع: إنشاء واستخدام مشاركة ملف Azure

ملفات Azure هو نظام ملفات سحابي سهل الاستخدام من Microsoft. يمكنك تحميل مشاركات ملفات Azure في أنظمة التشغيل Windows وLinux وmacOS. توضح هذه المقالة كيفية إنشاء مشاركة ملف SMB Azure باستخدام إما مدخل Azure أو Azure CLI أو Azure PowerShell.

ينطبق على

ينطبق هذا التشغيل السريع فقط على مشاركات ملفات SMB Azure. تدعم مشاركات ملفات SMB القياسية والمميزة التخزين الزائد محليا (LRS) والتخزين المتكرر في المنطقة (ZRS). تدعم مشاركات الملفات القياسية أيضا خيارات التخزين المتكرر جغرافيا (GRS) والتخزين المتكرر للمنطقة الجغرافية (GZRS). لمزيد من المعلومات، راجع تكرار ملفات Azure.

نوع مشاركة الملف	SMB	NFS
مشاركات الملفات القياسية (GPv2)، حسابات التخزين المكررة محليًا (LRS) وحسابات التخزين المكررة في المنطقة (ZRS)
مشاركات الملفات القياسية (GPv2)، حساب تخزين مكرر جغرافي (GRS) أو حساب تخزين مكرر للمنطقة الجغرافية (GZRS)
مشاركات الملفات المدفوعة (FileStorage)، حسابات التخزين المكررة محليًا (LRS) وحسابات التخزين المكررة في المنطقة (ZRS)

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

المدخل

في حال لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانيّاً قبل البدء.

بوويرشيل

في حال لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانيّاً قبل البدء.

Azure Cloud Shell

Azure يستضيف Azure Cloud Shell، بيئة تفاعلية يمكن استخدامها من خلال المستعرض. يمكنك استخدام Bash أو PowerShell مع Cloud Shell للعمل مع خدمات Azure. يمكنك استخدام أوامر Cloud Shell المثبتة مسبقًا لتشغيل التعليمات البرمجية في هذه المقالة دون الحاجة إلى تثبيت أي شيء على البيئة المحلية.

لبدء Azure Cloud Shell:

خيار	مثال/ رابط
انقر فوق ⁧⁩جربه⁧⁩ في الزاوية العلوية اليسرى من التعليمة البرمجية أو كتلة الأمر. تحديد ⁧⁩جربه⁧⁩ لا يقوم بنسخ التعليمة البرمجية أو الأمر تلقائيًا إلى Cloud Shell.
انتقل إلى ⁧⁩⁧ https://shell.azure.com⁩⁧⁩، أو حدد زر ⁩تشغيل Cloud Shell لفتح Cloud Shell في المتصفح لديك.
حدد زر Cloud Shell على شريط القوائم في أعلى اليمين في مدخل Microsoft Azure.

لاستخدام Azure Cloud Shell:

1. ابدأ تشغيل Cloud Shell.

2. حدد الزر نسخ على كتلة التعليمات البرمجية (أو كتلة الأوامر) لنسخ التعليمات البرمجية أو الأمر.

3. ألصق التعليمة البرمجية أو الأمر في جلسة Cloud Shell بتحديد Ctrl+Shift+Vعلى Windows وLunix، أو بتحديد Cmd+Shift+Vعلى macOS.

4. حدد Enter لتشغيل التعليمات البرمجية أو الأمر.

إذا كنت ترغب في تثبيت PowerShell واستخدامه محليا، فستحتاج إلى وحدة Azure PowerShell النمطية Az الإصدار 7.0.0 أو أحدث. نوصي بتثبيت أحدث إصدار متوفر. ولمعرفة إصدار وحدة Azure PowerShell الذي تقوم بتشغيله، قم بتنفيذ Get-InstalledModule Az. إذا كنت بحاجة إلى الترقية، فراجع تثبيت الوحدة النمطية Azure PowerShell. إذا كنت تقوم بتشغيل PowerShell محلياً، فستحتاج أيضاً إلى تشغيل Login-AzAccount لتسجيل الدخول إلى حساب Azure الخاص بك. لاستخدام المصادقة متعددة العوامل، ستحتاج إلى توفير معرف مستأجر Azure، مثل Login-AzAccount -TenantId <TenantId>.

Azure CLI

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

• استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع التشغيل السريع ل Bash في Azure Cloud Shell.

  

• إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.

  • إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.

  • عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات بشأن الامتدادات، راجع استخدام امتدادات مع Azure CLI.

  • يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.

• يتطلب هذا العنصر الإصدار 2.0.4 أو أحدث من Azure CLI. إذا كنت تستخدم Azure Cloud Shell، يتم تثبيت أحدث إصدار بالفعل.

• بشكل افتراضي، تقوم أوامر Azure CLI بإرجاع JavaScript Object Notation (JSON)، وهي الطريقة القياسية لإرسال الرسائل وتلقيها من واجهات برمجة تطبيقات REST. لتسهيل العمل مع استجابات لغة جسون، بعض الأمثلة في هذا العنصر تستخدم معلمة الاستعلام على أوامر Azure CLI. تستخدم هذه المعلمة لغة الاستعلام JMESPath لتحليل لغة جسون. لمعرفة المزيد حول كيفية استخدام نتائج أوامر Azure CLI باتباع لغة الاستعلام JMESPath، راجع البرنامج التعليمي JMESPath.

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

المدخل

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

لإنشاء حساب تخزين باستخدام مدخل Azure:

1. صمن Azure services، حدد Storage accounts.

2. حدد + Create لإنشاء حساب تخزين.

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

4. إذا كنت ترغب في إنشاء مجموعة موارد جديدة، فحدد Create new وأدخل اسما مثل myexamplegroup.

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

6. في المنطقة، حدد المنطقة التي تريد إنشاء حساب التخزين فيها.

7. في Performance، احتفظ بالقيمة الافتراضية لـ Standard.

8. في التكرار، حدد التخزين المحلي الزائد (LRS).

   

9. حدد مراجعة لمراجعة إعداداتك. سيقوم Azure بتشغيل التحقق النهائي.

10. عند اكتمال التحقق من الصحة، اختر إنشاء. من المفترض أن ترى إشعارًا بأن النشر قيد التقدم.

بوويرشيل

PowerShell - إنشاء مجموعة موارد

وتُعد مجموعة الموارد عبارة عن حاوية منطقية يتم فيها توزيع موارد Azure وإدارتها. وإذا لم يكن لديك مجموعة موارد Azure بالفعل، أنشئ مجموعة جديدة باستخدام الأمر New-AzResourceGroup cmdlet. تحتاج إلى مجموعة موارد لإنشاء حساب تخزين.

في المثال التالي سيتم إنشاء مجموعة موارد باسم myResourceGroup في منطقة غرب الولايات المتحدة 2:

$resourceGroupName = "myResourceGroup"
$region = "westus2"

New-AzResourceGroup `
    -Name $resourceGroupName `
    -Location $region | Out-Null

PowerShell - إنشاء حساب تخزين

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

في هذا المثال يتم إنشاء حساب تخزين باستخدام الأمر New-AzStorageAccount cmdlet. يُطلق على حساب التخزين اسم mystorageaccount<random number> ويتم تخزين مرجع لحساب التخزين هذا في المتغير $storageAcct. يجب أن تكون أسماء حسابات التخزين فريدة، لذا استخدم Get-Random لإلحاق رقم عشوائي بالاسم لجعله فريدًا.

$storageAccountName = "mystorageacct$(Get-Random)"

$storageAcct = New-AzStorageAccount `
    -ResourceGroupName $resourceGroupName `
    -Name $storageAccountName `
    -Location $region `
    -Kind StorageV2 `
    -SkuName Standard_LRS `
    -EnableLargeFileShare

Azure CLI

CLI - إنشاء مجموعة موارد

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

في المثال التالي، سيتم إنشاء مجموعة موارد تسمى myResourceGroup في منطقة غرب الولايات المتحدة 2:

export resourceGroupName="myResourceGroup"
region="westus2"

az group create \
    --name $resourceGroupName \
    --location $region \
    --output none

CLI - إنشاء حساب تخزين

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

ينشئ المثال التالي حساب تخزين باستخدام الأمر إنشاء حساب تخزين Azure. يجب أن تكون أسماء حسابات التخزين فريدة، لذا استخدم $RANDOM لإلحاق رقم عشوائي بالاسم لجعله فريدًا.

export storageAccountName="mystorageacct$RANDOM"

az storage account create \
    --resource-group $resourceGroupName \
    --name $storageAccountName \
    --location $region \
    --kind StorageV2 \
    --sku Standard_LRS \
    --enable-large-file-share \
    --output none

إنشاء مشاركة ملف Azure

المدخل

لإنشاء مشاركة ملف Azure:

1. حدد حساب التخزين من لوحة المعلومات.

2. في صفحة حساب التخزين، في قسم Data storage ، حدد File shares.

   

3. في القائمة الموجودة أعلى صفحة File shares ، حدد + File share. تظهر الصفحة New file share.

4. في الاسم، اكتب myshare. يجب أن تكون أسماء مشاركة الملفات كلها أحرف صغيرة وأرقام وواصلات مفردة، ويجب أن تبدأ وتنتهي بحرف أو رقم صغير. لا يمكن أن يحتوي الاسم على واصلتين متتاليتين. للحصول على تفاصيل حول تسمية مشاركات الملفات والملفات، راجع تسمية المشاركات والدلائل والملفات وبيانات التعريف والرجوع إليها.

5. اترك المعاملات المحسنة محددة للطبقة.

6. حدد علامة التبويب النسخ الاحتياطي. بشكل افتراضي، يتم تمكين النسخ الاحتياطي عند إنشاء مشاركة ملف Azure باستخدام مدخل Microsoft Azure. إذا كنت تريد تعطيل النسخ الاحتياطي لمشاركة الملف، قم بإلغاء تحديد خانة الاختيار تمكين النسخ الاحتياطي . إذا كنت تريد تمكين النسخ الاحتياطي، يمكنك إما ترك الإعدادات الافتراضية أو إنشاء Recovery Services Vault جديد في نفس المنطقة والاشتراك مثل حساب التخزين. لإنشاء نهج نسخ احتياطي جديد، حدد إنشاء نهج جديد.

   

7. حدد Review + create ثم Create لإنشاء مشاركة ملف Azure.

بوويرشيل

والآن بعد أن أنشأت حساب تخزين، يمكنك إنشاء أول مشاركة لملف Azure باستخدام cmdlet New-AzRmStorageShare. يقوم هذا المثال بإنشاء مشاركة باسم myshare بحصة تبلغ 1024 جيجابايت. يمكن أن تكون الحصة بحد أقصى 5 تيرابايت، أو 100 تيرابايت مع تمكين مشاركات الملفات الكبيرة على حساب التخزين.

$shareName = "myshare"

New-AzRmStorageShare `
    -StorageAccount $storageAcct `
    -Name $shareName `
    -EnabledProtocol SMB `
    -QuotaGiB 1024 | Out-Null

Azure CLI

الآن بعد أن أنشأت حساب تخزين، يمكنك إنشاء أول مشاركة لملف Azure باستخدام أمر إنشاء مشاركة تخزين az. يقوم هذا المثال بإنشاء مشاركة باسم myshare بحصة تبلغ 1024 جيجابايت. يمكن أن تكون الحصة بحد أقصى 5 تيرابايت، أو 100 تيرابايت مع تمكين مشاركات الملفات الكبيرة على حساب التخزين.

shareName="myshare"

az storage share-rm create \
    --resource-group $resourceGroupName \
    --storage-account $storageAccountName \
    --name $shareName \
    --quota 1024 \
    --enabled-protocols SMB \
    --output none

إنشاء دليل

المدخل

لإنشاء دليل جديد باسم myDirectory في جذر مشاركة ملف Azure:

1. في صفحة إعدادات مشاركة الملفات، حدد مشاركة ملف myshare. تفتح صفحة مشاركة الملف، مما يشير إلى عدم العثور على ملفات.
2. في القائمة أعلى الصفحة، حدد "+ Add directory". تظهر الصفحة New directory.
3. اكتب myDirectory ثم حدد OK.

بوويرشيل

ولإنشاء دليل جديد باسم myDirectory في جذر مشاركة ملف Azure، استخدم الأمر New-AzStorageDirectory cmdlet.

New-AzStorageDirectory `
   -Context $storageAcct.Context `
   -ShareName $shareName `
   -Path "myDirectory"

Azure CLI

لإنشاء دليل جديد باسم myDirectory في جذر مشاركة ملفات Azure، استخدم الأمر az storage directory createالتالي:

إشعار

إذا لم توفر بيانات الاعتماد مع الأوامر الخاصة بك، فسيستعلم Azure CLI عن مفتاح حساب التخزين الخاص بك. يمكنك أيضا تزويد مفتاح حساب التخزين الخاص بك بالأمر باستخدام متغير مثل --account-key $storageAccountKey أو في نص عادي مثل --account-key "your-storage-account-key-here".

az storage directory create \
   --account-name $storageAccountName \
   --share-name $shareName \
   --name "myDirectory" \
   --output none

تحميل ملف

المدخل

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

1. حدد الدليل myDirectory. تفتح لوحة "myDirectory".

2. من القائمة في الأعلى، حدد "Upload". تفتح لوحة "Upload files".

   

3. حدد أيقونة المجلد لفتح نافذة لتصفح ملفاتك المحلية.

4. حدد ملفاً ثم حدد Open.

5. في صفحة تحميل الملفات ، تحقق من اسم الملف، ثم حدد تحميل.

6. عند الانتهاء، يجب أن يظهر الملف في القائمة على صفحة myDirectory.

بوويرشيل

لتوضيح كيفية تحميل ملف باستخدام الأمر Set-AzStorageFileContent cmdlet، نحتاج أولاً إلى إنشاء ملف داخل محرك أقراص التخزين المؤقت لـ PowerShell Cloud Shell لتحميله.

في هذا المثال يتم وضع التاريخ والوقت الحاليين في ملف جديد على محرك أقراص التخزين المؤقت، ثم يتم تحميل الملف إلى مشاركة الملف.

# this expression will put the current date and time into a new file on your scratch drive
cd "~/CloudDrive/"
Get-Date | Out-File -FilePath "SampleUpload.txt" -Force

# this expression will upload that newly created file to your Azure file share
Set-AzStorageFileContent `
   -Context $storageAcct.Context `
   -ShareName $shareName `
   -Source "SampleUpload.txt" `
   -Path "myDirectory\SampleUpload.txt"

إذا كنت تقوم بتشغيل PowerShell محلياً، فاستبدل ~/CloudDrive/ بمسار موجود على جهازك.

بعد تحميل الملف، يمكنك استخدام Get-AzStorageFile cmdlet للتحقق للتأكد من تحميل الملف إلى مشاركة ملف Azure.

Get-AzStorageFile `
    -Context $storageAcct.Context `
    -ShareName $shareName `
    -Path "myDirectory\" | Get-AzStorageFile

Azure CLI

لتوضيح كيفية رفع ملف باستخدام الأمرaz storage file upload، قم أولا بإنشاء ملف لرفعه على محرك الأقراص Cloud Shell. في المثال التالي، يمكنك إنشاء ملف ثم رفعه:

cd ~/clouddrive/
date > SampleUpload.txt

az storage file upload \
    --account-name $storageAccountName \
    --share-name $shareName \
    --source "SampleUpload.txt" \
    --path "myDirectory/SampleUpload.txt"

إذا كنت تقوم بتشغيل Azure CLI محليًّا، فاستبدله ~/clouddrive بمسار موجود على جهازك.

بعد رفع الملف، يمكنك استخدام الأمر az storage file list للتأكد من رفع الملف إلى مشاركة ملفات Azure:

az storage file list \
    --account-name $storageAccountName \
    --share-name $shareName \
    --path "myDirectory" \
    --output table

تنزيل ملف

المدخل

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

بوويرشيل

يمكنك استخدام أمر cmdlet التالي Get-AzStorageFileContent لتنزيل نسخة من الملف الذي قمت بتحميله إلى محرك أقراص التخزين المؤقت في Cloud Shell.

# Delete an existing file by the same name as SampleDownload.txt, if it exists because you've run this example before.
Remove-Item `
    -Path "SampleDownload.txt" `
    -Force `
    -ErrorAction SilentlyContinue

Get-AzStorageFileContent `
    -Context $storageAcct.Context `
    -ShareName $shareName `
    -Path "myDirectory\SampleUpload.txt" `
    -Destination "SampleDownload.txt"

بعد تنزيل الملف، يمكنك استخدام Get-ChildItem cmdlet للتأكد من أنه تم تنزيل الملف إلى محرك الأقراص الصفري ل PowerShell Cloud Shell.

Get-ChildItem | Where-Object { $_.Name -eq "SampleDownload.txt" }

Azure CLI

يمكنك استخدام الأمر az storage file download لتنزيل نسخة من الملف الذي قمت برفعه إلى محرك الأقراص Cloud Shell:

# Delete an existing file by the same name as SampleDownload.txt, if it exists, because you've run this example before
rm -f SampleDownload.txt

az storage file download \
    --account-name $storageAccountName \
    --share-name $shareName \
    --path "myDirectory/SampleUpload.txt" \
    --dest "./SampleDownload.txt" \
    --output none

تنظيف الموارد

المدخل

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

إذا كانت هناك أقفال على حساب التخزين، فستحتاج إلى إزالتها أولا. انتقل إلى حساب التخزين وحدد الإعدادات> Locks. إذا تم إدراج أي أقفال، فاحذفها.

قد تحتاج أيضا إلى حذف مخزن Azure Backup Recovery Services قبل السماح لك بحذف مجموعة الموارد.

1. حدد الصفحة الرئيسية ثم مجموعات الموارد.
2. حدد مجموعة الموارد التي تريد حذفها.
3. حدد Delete resource group. تفتح نافذة وتعرض تحذيرًا حول الموارد التي سيتم حذفها مع مجموعة الموارد.
4. أدخل اسم مجموعة الموارد وحدد Delete.

بوويرشيل

عند الانتهاء، يمكنك استخدام Remove-AzResourceGroup cmdlet لحذف مجموعة الموارد وجميع الموارد الموجودة في مجموعة الموارد.

Remove-AzResourceGroup -Name myResourceGroup

Azure CLI

عند الانتهاء، يمكنك استخدام az group delete الأمر لحذف مجموعة الموارد وجميع الموارد الموجودة في مجموعة الموارد:

az group delete --name $resourceGroupName

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

ما هي ملفات Azure؟