استضافة موقع ويب ثابت في Azure Storage

مقالة
05/11/2023

يمكنك عرض المحتوى الثابت (HTML و CSS و JavaScript وملفات الصور) مباشرة من حاوية في حساب للأغراض العامة V2 أو BlockBlobStorage. لمعرفة المزيد، راجع استضافة مواقع الويب الثابتة في Azure Storage.

توضح لك هذه المقالة كيفية تمكين استضافة مواقع ويب ثابتة باستخدام مدخل Microsoft Azure أو Azure CLI أو PowerShell.

تمكين استضافة المواقع الثابتة

استضافة مواقع الويب الثابتة هي ميزة يجب عليك تمكينها على حساب التخزين.

وللبدء، يتعين تسجيل الدخول أولاً إلى ⁧⁩مدخل Microsoft Azure⁧⁩.
حدد موقع حساب التخزين الخاص بك وحدده لعرض جزء نظرة عامة في الحساب.
في جزء نظرة عامة، حدد علامة التبويب القدرات. بعد ذلك، حدد موقع ويب ثابت لعرض صفحة التكوين لموقع ويب الثابت.
حدد ⁧⁩تمكين⁧⁩ لتمكين استضافة موقع ويب ثابتة لحساب التخزين.
في حقل اسم مستند الفهرس، حدد صفحة فهرس افتراضية (على سبيل المثال: index.html).

يتم عرض صفحة الفهرس الافتراضية عندما ينتقل مستخدم إلى جذر موقع الويب الثابت.
في الحقل مسار مستند خطأ، حدد صفحة خطأ افتراضية (على سبيل المثال: 404.html).

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

يمكنك تمكين استضافة مواقع الويب الثابتة باستخدام Azure CLI.

أولا، افتح Azure Cloud Shell، أو إذا قمت بتثبيت Azure CLI محليًا، افتح تطبيق وحدة تحكم أوامر مثل Windows PowerShell.
إذا كانت هويتك مرتبطة بأكثر من اشتراك واحد، فقم بتعيين اشتراكك النشط على اشتراك حساب التخزين الذي سيستضيف موقعك الثابت على الويب.
```
az account set --subscription <subscription-id>
```
استبدل قيمة <subscription-id>العنصر النائب بمعرف اشتراكك.
تمكين استضافة المواقع الثابتة.
```
az storage blob service-properties update --account-name <storage-account-name> --static-website --404-document <error-document-name> --index-document <index-document-name>
```
- استبدل <storage-account-name> قيمة العنصر النائب باسم حساب التخزين الخاص بك.
- استبدل العنصر النائب <error-document-name> باسم مستند الخطأ الذي سيظهر للمستخدمين عندما يطلب المستعرض صفحة غير موجودة على موقعك.
- استبدل العنصر النائب <index-document-name> باسم مستند الفهرس. عادة ما تكون هذه الوثيقة "index.html".

يمكنك تمكين استضافة مواقع الويب الثابتة باستخدام وحدة Azure PowerShell.

افتح إطار أمر Windows PowerShell.
تحقق من أن لديك الوحدة النمطية Azure PowerShell Az الإصدار 0.7 أو أحدث.
```
Get-InstalledModule -Name Az -AllVersions | select Name,Version
```
إذا كنت بحاجة إلى التثبيت أو الترقية، فراجع تثبيت وحدة Azure PowerShell.
سجل الدخول إلى اشتراكك في Azure باستخدام الأمر Connect-AzAccount واتبع الإرشادات التي تظهر على الشاشة.
```
Connect-AzAccount
```
إذا كانت هويتك مرتبطة بأكثر من اشتراك واحد، فقم بتعيين اشتراكك النشط على اشتراك حساب التخزين الذي سيستضيف موقعك الثابت على الويب.
```
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
```
استبدل قيمة <subscription-id>العنصر النائب بمعرف اشتراكك.
احصل على سياق حساب التخزين الذي يحدد حساب التخزين الذي تريد استخدامه.
```
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
```
- استبدل قيمة العنصر النائب ⁧<resource-group-name>⁩ باسم مجموعة الموارد خاصتك.
- استبدل <storage-account-name> قيمة العنصر النائب باسم حساب التخزين الخاص بك.
تمكين استضافة المواقع الثابتة.
```
Enable-AzStorageStaticWebsite -Context $ctx -IndexDocument <index-document-name> -ErrorDocument404Path <error-document-name>
```
- استبدل العنصر النائب <error-document-name> باسم مستند الخطأ الذي سيظهر للمستخدمين عندما يطلب المستعرض صفحة غير موجودة على موقعك.
- استبدل العنصر النائب <index-document-name> باسم مستند الفهرس. عادة ما تكون هذه الوثيقة "index.html".

تحميل الملفات

توضح لك الإرشادات التالية كيفية تحميل الملفات باستخدام مدخل Microsoft Azure. يمكنك أيضًا استخدام AzCopy أو PowerShell أو CLI أو أي تطبيق مخصص يمكنه تحميل الملفات إلى حاوية $web في حسابك. للحصول على برنامج تعليمي خطوة بخطوة يقوم بتحميل الملفات باستخدام التعليمات البرمجية Visual Studio، راجع البرنامج التعليمي: استضافة موقع ويب ثابت على Blob Storage.

في مدخل Microsoft Azure، انتقل إلى حساب التخزين الذي يحتوي على موقعك الثابت على الويب. حدد الحاويات في جزء التنقل الأيمن لعرض قائمة الحاويات.
في جزء الحاويات، حدد حاوية $web لفتح جزء نظرة عامة في الحاوية.
في جزء نظرة عامة، حدد أيقونة رفع لفتح جزء رفع كائن ثنائي كبير الحجم. بعد ذلك، حدد الحقل ملفات داخل جزء رفع كائن ثنائي كبير الحجم لفتح مستعرض الملفات. انتقل إلى الملف الذي تريد تحميله، وحدده، ثم حدد فتح لملء حقل الملفات. اختياريًا، حدد خانة الاختيار الكتابة فوق إذا كانت الملفات موجودة بالفعل.
إذا كنت تنوي أن يعرض المستعرض محتويات الملف، فتأكد من تعيين نوع محتوى هذا الملف إلى text/html. للتحقق من ذلك، حدد اسم النقطة التي قمت بتحميلها في الخطوة السابقة لفتح جزء نظرة عامة. تأكد من تعيين القيمة داخل حقل الخاصية CONTENT-TYPE.

ملاحظة

يتم تعيين هذه الخاصية تلقائيا إلى text/html الإضافات المعروفة بشكل شائع مثل .html. ومع ذلك، في بعض الحالات، سيكون عليك تعيين هذا بنفسك. إذا لم تقم بتعيين هذه الخاصية إلى text/html، فسيطالب المتصفح المستخدمين بتنزيل الملف بدلًا من عرض المحتويات. يمكن تعيين هذه الخاصية في الخطوة السابقة.

ارفع العناصل إلى حاوية $web من دليل مصدر.

يفترض هذا المثال أنك تقوم بتشغيل أوامر من جلسة عمل Azure Cloud Shell.

az storage blob upload-batch -s <source-path> -d '$web' --account-name <storage-account-name>

ملاحظة

إذا طالب المستعرض المستخدمين بتنزيل الملف بدلًا من عرض المحتويات، فيمكنك إلحاقه بالأمر --content-type 'text/html; charset=utf-8'.

استبدل <storage-account-name> قيمة العنصر النائب باسم حساب التخزين الخاص بك.
استبدل العنصر النائب <source-path> بمسار إلى موقع الملفات التي تريد تحميلها.

ملاحظة

إذا كنت تستخدم تثبيت موقع Azure CLI، فيمكنك استخدام المسار إلى أي موقع على الكمبيوتر المحلي (على سبيل المثال: C:\myFolder.

إذا كنت تستخدم Azure Cloud Shell، فسيتعين عليك الرجوع إلى مشاركة ملف مرئية لـCloud Shell. قد يكون هذا الموقع هو مشاركة الملف الخاصة بمشاركة Cloud نفسها أو مشاركة ملف موجودة تقوم بتحميلها من Cloud Shell. لمعرفة كيفية القيام بذلك، راجع استمرار الملفات في Azure Cloud Shell.

ارفع العناصل إلى حاوية $web من دليل مصدر.

# upload a file
set-AzStorageblobcontent -File "<path-to-file>" `
-Container `$web `
-Blob "<blob-name>" `
-Context $ctx

ملاحظة

إذا طالب المستعرض المستخدمين بتنزيل الملف بدلًا من عرض المحتويات، فيمكنك إلحاقه بالأمر -Properties @{ ContentType = "text/html; charset=utf-8";}.

استبدل قيمة العنصر النائب <path-to-file> بالمسار المؤهل بالكامل إلى الملف الذي تريد تحميله (على سبيل المثال: C:\temp\index.html).
استبدل قيمة العنصر النائب <blob-name> بالاسم الذي تريد إعطاءه الكائن الثنائي كبير الحجم الناتج (على سبيل المثال: index.html).

العثور على عنوان URL لموقع الويب

يمكنك عرض صفحات موقعك من متصفح باستخدام عنوان URL العام لموقع الويب.

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

قياسات مواقع الويب الثابتة في Azure Storage

ابحث عن عنوان URL العام لموقعك الثابت على ويب باستخدام الأمر التالي:

az storage account show -n <storage-account-name> -g <resource-group-name> --query "primaryEndpoints.web" --output tsv

استبدل <storage-account-name> قيمة العنصر النائب باسم حساب التخزين الخاص بك.
استبدل <resource-group-name> قيمة العنصر النائب باسم مجموعة الموارد.

ابحث عن عنوان URL العام لموقعك الثابت على ويب باستخدام الأمر التالي:

 $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -Name "<storage-account-name>"
Write-Output $storageAccount.PrimaryEndpoints.Web

استبدل <resource-group-name> قيمة العنصر النائب باسم مجموعة الموارد.
استبدل <storage-account-name> قيمة العنصر النائب باسم حساب التخزين الخاص بك.

تمكين المقاييس على صفحات موقع الويب الثابتة

بعد تمكين المقاييس، يتم الإبلاغ عن إحصاءات الزيارات على الملفات الموجودة في حاوية $web في لوحة معلومات المقاييس.

انقر على المقاييس ضمن قسم المراقبة في قائمة حساب التخزين.

ملاحظة

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

ملاحظة

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