التشغيل السريع: نشر تطبيق مدار لكتالوج الخدمة

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

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

• تعريف تطبيق مدار تم إنشاؤه مع نشر تعريف تطبيق أو نشر تعريف مع إحضار التخزين الخاص بك.
• حساب Azure مع اشتراك نشط. إذا لم يكن لديك حساب، فأنشئ حسابا مجانيا قبل أن تبدأ.
• تعليمة Visual Studio البرمجية.
• تثبيت أحدث إصدار من Azure PowerShell أو Azure CLI.

إنشاء تطبيق مدار بواسطة كتالوج الخدمة

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

• نشر تعريف التطبيق: packageStorageGroup وappDefinitionGroup.
• نشر التعريف مع إحضار التخزين الخاص بك: packageStorageGroup و byosDefinitionStorageGroup و byosAppDefinitionGroup.

الحصول على تعريف التطبيق المدار

PowerShell

للحصول على تعريف التطبيق المدار باستخدام Azure PowerShell، قم بتشغيل الأوامر التالية.

في Visual Studio Code، افتح محطة PowerShell طرفية جديدة وسجل الدخول إلى اشتراك Azure الخاص بك.

Connect-AzAccount

يفتح الأمر المستعرض الافتراضي ويطالبك بتسجيل الدخول إلى Azure. لمزيد من المعلومات، انتقل إلى تسجيل الدخول باستخدام Azure PowerShell.

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

Get-AzManagedApplicationDefinition -ResourceGroupName appDefinitionGroup

Get-AzManagedApplicationDefinition يسرد جميع التعريفات المتوفرة في مجموعة الموارد المحددة، مثل sampleManagedApplication.

إنشاء متغير لمعرف مورد تعريف التطبيق المدار.

$definitionid = (Get-AzManagedApplicationDefinition -ResourceGroupName appDefinitionGroup -Name sampleManagedApplication).ManagedApplicationDefinitionId

يمكنك استخدام $definitionid قيمة المتغير عند نشر التطبيق المدار.

Azure CLI

للحصول على تعريف التطبيق المدار باستخدام Azure CLI، قم بتشغيل الأوامر التالية.

في Visual Studio Code، افتح جلسة Bash terminal جديدة وسجل الدخول إلى اشتراك Azure الخاص بك. إذا كان لديك Git مثبتا، فحدد Git Bash.

az login

يفتح الأمر المستعرض الافتراضي ويطالبك بتسجيل الدخول إلى Azure. لمزيد من المعلومات، انتقل إلى تسجيل الدخول باستخدام Azure CLI.

من Azure CLI، احصل على تعريف التطبيق المدار. في هذا المثال، استخدم اسم مجموعة الموارد appDefinitionGroup الذي تم إنشاؤه عند نشر تعريف التطبيق المدار.

az managedapp definition list --resource-group appDefinitionGroup

يسرد الأمر كافة التعريفات المتوفرة في مجموعة الموارد المحددة، مثل sampleManagedApplication.

إنشاء متغير لمعرف مورد تعريف التطبيق المدار.

definitionid=$(az managedapp definition show --resource-group appDefinitionGroup --name sampleManagedApplication --query id --output tsv)

يمكنك استخدام $definitionid قيمة المتغير عند نشر التطبيق المدار.

المدخل

للحصول على تعريف التطبيق المدار من مدخل Microsoft Azure، استخدم الخطوات التالية.

1. سجل الدخول إلى مدخل Azure.

2. حدد Create a resource.

   

3. ابحث عن التطبيق المُدار بواسطة كتالوج الخدمة وحدده من الخيارات المتوفرة.

4. يتم عرض التطبيق المدار بواسطة كتالوج الخدمة. حدد إنشاء.

   

5. حدد Sample managed application ثم حدد Create.

   يعرض المدخل تعريفات التطبيق المدارة التي قمت بنشرها مع مقالات التشغيل السريع.

   

إنشاء مجموعة الموارد والمعلمات

PowerShell

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

New-AzResourceGroup -Name applicationGroup -Location westus3

تحتاج أيضا إلى إنشاء اسم لمجموعة موارد التطبيق المدارة. يتم إنشاء مجموعة الموارد عند نشر التطبيق المدار.

قم بتشغيل الأوامر التالية لإنشاء اسم مجموعة الموارد المدارة.

$mrgprefix = 'mrg-sampleManagedApplication-'
$mrgtimestamp = Get-Date -UFormat "%Y%m%d%H%M%S"
$mrgname = $mrgprefix + $mrgtimestamp
$mrgname

$mrgprefix يتم تسلسل المتغيرين و $mrgtimestamp وتخزينهما في $mrgname المتغير . قيمة المتغير بالتنسيق mrg-sampleManagedApplication-20230512103059. يمكنك استخدام $mrgname قيمة المتغير عند نشر التطبيق المدار.

تحتاج إلى توفير العديد من المعلمات لأمر النشر للتطبيق المدار. يمكنك استخدام سلسلة بتنسيق JSON أو إنشاء ملف JSON. في هذا المثال، نستخدم سلسلة بتنسيق JSON. حرف إلغاء PowerShell لعلامات الاقتباس هو الحرف الخلفي (`). يتم استخدام backtick أيضا لمتابعة السطر بحيث يمكن للأوامر استخدام أسطر متعددة.

بناء جملة السلسلة المنسقة JSON كما يلي:

"{ `"parameterName`": {`"value`":`"parameterValue`"}, `"parameterName`": {`"value`":`"parameterValue`"} }"

لسهولة القراءة، تستخدم سلسلة JSON المكتملة backtick لمتابعة السطر. يتم تخزين القيم في $params المتغير المستخدم في أمر النشر. المعلمات في سلسلة JSON مطلوبة لنشر الموارد المدارة.

$params="{ `"appServicePlanName`": {`"value`":`"demoAppServicePlan`"}, `
`"appServiceNamePrefix`": {`"value`":`"demoApp`"}, `
`"storageAccountNamePrefix`": {`"value`":`"demostg1234`"}, `
`"storageAccountType`": {`"value`":`"Standard_LRS`"} }"

المعلمات لإنشاء الموارد المدارة:

• appServicePlanName: إنشاء اسم خطة. بحد أقصى 40 حرفا أبجديا رقميا وواصلات. على سبيل المثال، demoAppServicePlan. يجب أن تكون أسماء خطة App Service فريدة ضمن مجموعة موارد في اشتراكك.
• appServiceNamePrefix: إنشاء بادئة لاسم الخطة. بحد أقصى 47 حرفا أبجديا رقميا أو واصلة. على سبيل المثال، demoApp. أثناء النشر، يتم ربط البادئة بسلسلة فريدة لإنشاء اسم فريد عالميا عبر Azure.
• storageAccountNamePrefix: استخدم الأحرف الصغيرة والأرقام فقط وبحد أقصى 11 حرفا. على سبيل المثال، demostg1234. أثناء النشر، يتم ربط البادئة بسلسلة فريدة لإنشاء اسم فريد عالميا عبر Azure. على الرغم من أنك تقوم بإنشاء بادئة، يتحقق عنصر التحكم من الأسماء الموجودة في Azure وقد يقوم بنشر رسالة تحقق من الصحة بأن الاسم موجود بالفعل. إذا كان الأمر كذلك، فاختر بادئة مختلفة.
• storageAccountType: الخيارات هي Premium_LRS Standard_LRS Standard_GRS.

Azure CLI

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

az group create --name applicationGroup --location westus3

تحتاج أيضا إلى إنشاء اسم ومسار لمجموعة موارد التطبيق المدارة. يتم إنشاء مجموعة الموارد عند نشر التطبيق المدار.

قم بتشغيل الأوامر التالية لإنشاء مسار مجموعة الموارد المدارة.

mrgprefix='mrg-sampleManagedApplication-'
mrgtimestamp=$(date +%Y%m%d%H%M%S)
mrgname="${mrgprefix}${mrgtimestamp}"
subid=$(az account list --query [].id --output tsv)
mrgpath="/subscriptions/$subid/resourceGroups/$mrgname"

$mrgprefix يتم تسلسل المتغيرين و $mrgtimestamp وتخزينهما في $mrgname المتغير . قيمة المتغير بالتنسيق mrg-sampleManagedApplication-20230512103059. mrgname يتم تسلسل المتغيرين و subid لإنشاء mrgpath قيمة المتغير التي تنشئ مجموعة الموارد المدارة أثناء النشر.

تحتاج إلى توفير العديد من المعلمات لأمر النشر للتطبيق المدار. يمكنك استخدام سلسلة بتنسيق JSON أو إنشاء ملف JSON. في هذا المثال، نستخدم سلسلة بتنسيق JSON. في Bash، حرف الإلغاء لعلامات الاقتباس هو الحرف المائل العكسي (\). يتم أيضا استخدام خط مائل عكسي لمتابعة السطر بحيث يمكن للأوامر استخدام أسطر متعددة.

بناء جملة السلسلة المنسقة JSON كما يلي:

"{ \"parameterName\": {\"value\":\"parameterValue\"}, \"parameterName\": {\"value\":\"parameterValue\"} }"

لقابلية القراءة، تستخدم سلسلة JSON المكتملة خط مائل عكسي لمتابعة السطر. يتم تخزين القيم في params المتغير المستخدم في أمر النشر. المعلمات في سلسلة JSON مطلوبة لنشر الموارد المدارة.

params="{ \"appServicePlanName\": {\"value\":\"demoAppServicePlan\"}, \
\"appServiceNamePrefix\": {\"value\":\"demoApp\"}, \
\"storageAccountNamePrefix\": {\"value\":\"demostg1234\"}, \
\"storageAccountType\": {\"value\":\"Standard_LRS\"} }"

المعلمات لإنشاء الموارد المدارة:

• appServicePlanName: إنشاء اسم خطة. بحد أقصى 40 حرفا أبجديا رقميا وواصلات. على سبيل المثال، demoAppServicePlan. يجب أن تكون أسماء خطة App Service فريدة ضمن مجموعة موارد في اشتراكك.
• appServiceNamePrefix: إنشاء بادئة لاسم الخطة. بحد أقصى 47 حرفا أبجديا رقميا أو واصلة. على سبيل المثال، demoApp. أثناء النشر، يتم ربط البادئة بسلسلة فريدة لإنشاء اسم فريد عالميا عبر Azure.
• storageAccountNamePrefix: استخدم الأحرف الصغيرة والأرقام فقط وبحد أقصى 11 حرفا. على سبيل المثال، demostg1234. أثناء النشر، يتم ربط البادئة بسلسلة فريدة لإنشاء اسم فريد عالميا عبر Azure. على الرغم من أنك تقوم بإنشاء بادئة، يتحقق عنصر التحكم من الأسماء الموجودة في Azure وقد يقوم بنشر رسالة تحقق من الصحة بأن الاسم موجود بالفعل. إذا كان الأمر كذلك، فاختر بادئة مختلفة.
• storageAccountType: الخيارات هي Premium_LRS Standard_LRS Standard_GRS.

المدخل

1. قم بتوفير قيم لعلامة التبويب Basics وحدد Next: Web App settings.

   

   • الاشتراك: حدد الاشتراك الذي تريد توزيع التطبيق المدار فيه.
   • مجموعة الموارد: حدد مجموعة الموارد. بالنسبة إلى هذا المثال، أنشئ مجموعة موارد تسمى applicationGroup.
   • المنطقة: حدد الموقع الذي تريد توزيع الموارد فيه.
   • اسم التطبيق: أدخل اسما للتطبيق المدار. استخدم على سبيل المثال demoManagedApplication.
   • مجموعة الموارد المدارة: اسم مجموعة الموارد المدارة التي تحتوي على الموارد التي تم نشرها للتطبيق المدار. الاسم الافتراضي بالتنسيق mrg-{definitionName}-{dateTime} ولكن يمكنك تغيير الاسم.

2. قم بتوفير قيم لعلامة التبويب إعدادات تطبيق الويب وحدد التالي: إعدادات التخزين.

   

   • اسم خطة App Service: إنشاء اسم خطة. بحد أقصى 40 حرفا أبجديا رقميا وواصلات. على سبيل المثال، demoAppServicePlan. يجب أن تكون أسماء خطة App Service فريدة ضمن مجموعة موارد في اشتراكك.
   • بادئة اسم App Service: إنشاء بادئة لاسم الخطة. بحد أقصى 47 حرفا أبجديا رقميا أو واصلة. على سبيل المثال، demoApp. أثناء النشر، يتم ربط البادئة بسلسلة فريدة لإنشاء اسم فريد عالميا عبر Azure.

3. أدخل بادئة لاسم حساب التخزين وحدد نوع حساب التخزين. حدّد Next: Review + create.

   

   • بادئة اسم حساب التخزين: استخدم الأحرف الصغيرة والأرقام فقط ويكون الحد الأقصى 11 حرفا. على سبيل المثال، demostg1234. أثناء النشر، يتم ربط البادئة بسلسلة فريدة لإنشاء اسم فريد عالميا عبر Azure. على الرغم من أنك تقوم بإنشاء بادئة، يتحقق عنصر التحكم من الأسماء الموجودة في Azure وقد يقوم بنشر رسالة تحقق من الصحة بأن الاسم موجود بالفعل. إذا كان الأمر كذلك، فاختر بادئة مختلفة.
   • نوع حساب التخزين: حدد تغيير النوع لاختيار نوع حساب تخزين. القيمة الافتراضية هي Standard LRS. الخيارات الأخرى هي Premium_LRS Standard_LRS Standard_GRS.

نشر التطبيق المدار

PowerShell

قم بتشغيل الأمر التالي لنشر التطبيق المدار.

New-AzManagedApplication `
  -Name "demoManagedApplication" `
  -ResourceGroupName applicationGroup `
  -Location westus3 `
  -ManagedResourceGroupName $mrgname `
  -ManagedApplicationDefinitionId $definitionid `
  -Kind ServiceCatalog `
  -Parameter $params

المعلمات المستخدمة في أمر النشر:

• Name: حدد اسما للتطبيق المدار. استخدم على سبيل المثال demoManagedApplication.
• ResourceGroupName: اسم مجموعة الموارد التي قمت بإنشائها للتطبيق المدار.
• Location: حدد المنطقة لنشر الموارد. على سبيل المثال، استخدم westus3.
• ManagedResourceGroupName: يستخدم $mrgname قيمة المتغير. يتم إنشاء مجموعة الموارد المدارة عند نشر التطبيق المدار.
• ManagedApplicationDefinitionId: يستخدم $definitionid قيمة المتغير لمعرف مورد تعريف التطبيق المدار.
• Kind: يحدد هذا النوع من التطبيقات المدارة. يستخدم هذا المثال ServiceCatalog.
• Parameter: يستخدم $params قيمة المتغير في سلسلة JSON المنسقة.

Azure CLI

قم بتشغيل الأمر التالي لنشر التطبيق المدار.

az managedapp create \
  --name demoManagedApplication \
  --resource-group applicationGroup \
  --location westus3 \
  --managed-rg-id $mrgpath \
  --managedapp-definition-id $definitionid \
  --kind ServiceCatalog \
  --parameters "$params"

المعلمات المستخدمة في أمر النشر:

• name: حدد اسما للتطبيق المدار. استخدم على سبيل المثال demoManagedApplication.
• resource-group: اسم مجموعة الموارد التي قمت بإنشائها للتطبيق المدار.
• location: حدد المنطقة لنشر الموارد. على سبيل المثال، استخدم westus3.
• managed-rg-id: يستخدم $mrgpath قيمة المتغير. يتم إنشاء مجموعة الموارد المدارة عند نشر التطبيق المدار.
• managedapp-definition-id: يستخدم $definitionid قيمة المتغير لمعرف مورد تعريف التطبيق المدار.
• kind: يحدد هذا النوع من التطبيقات المدارة. يستخدم هذا المثال ServiceCatalog.
• parameters: يستخدم $params قيمة المتغير في سلسلة JSON المنسقة.

المدخل

راجع ملخص القيم التي حددتها وتحقق من عرض تم اجتياز التحقق من الصحة. حدد Create لنشر التطبيق المدار.

عرض النتائج

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

التطبيق المدار

بعد الانتهاء من النشر، يمكنك التحقق من حالة التطبيق المدار.

PowerShell

قم بتشغيل الأمر التالي للتحقق من حالة التطبيق المدار.

Get-AzManagedApplication -Name demoManagedApplication -ResourceGroupName applicationGroup

قم بتوسيع الخصائص لتسهيل قراءة Properties المعلومات.

Get-AzManagedApplication -Name demoManagedApplication -ResourceGroupName applicationGroup | Select-Object -ExpandProperty Properties

Azure CLI

قم بتشغيل الأمر التالي للتحقق من حالة التطبيق المدار.

az managedapp list --resource-group applicationGroup

يقوم الأمر التالي بتحليل البيانات حول التطبيق المدار لإظهار اسم التطبيق وحالة التوفير فقط.

az managedapp list --resource-group applicationGroup --query "[].{Name:name, provisioningState:provisioningState}"

المدخل

انتقل إلى مجموعة الموارد المسماة applicationGroup وحدد Overview. تحتوي مجموعة الموارد على التطبيق المدار المسمى demoManagedApplication.

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

الموارد المُدارة

يمكنك عرض الموارد المنشورة إلى مجموعة الموارد المدارة.

PowerShell

لعرض موارد مجموعة الموارد المدارة، قم بتشغيل الأمر التالي. قمت بإنشاء $mrgname المتغير عند إنشاء المعلمات.

Get-AzResource -ResourceGroupName $mrgname

لعرض كافة تعيينات الأدوار لمجموعة الموارد المدارة.

Get-AzRoleAssignment -ResourceGroupName $mrgname

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

Get-AzRoleAssignment -ResourceGroupName $mrgname -RoleDefinitionName Owner

يمكنك أيضا سرد تعيينات الرفض لمجموعة الموارد المدارة.

Get-AzDenyAssignment -ResourceGroupName $mrgname

Azure CLI

لعرض موارد مجموعة الموارد المدارة، قم بتشغيل الأمر التالي. قمت بإنشاء $mrgname المتغير عند إنشاء المعلمات.

az resource list --resource-group $mrgname

قم بتشغيل الأمر التالي لسرد الاسم والنوع وحالة التوفير للموارد المدارة فقط.

az resource list --resource-group $mrgname --query "[].{Name:name, Type:type, provisioningState:provisioningState}"

قم بتشغيل الأمر التالي لسرد تعيين الدور للمجموعة التي تم استخدامها في تعريف التطبيق المدار.

az role assignment list --resource-group $mrgname

يقوم الأمر التالي بتحليل البيانات لتعيين دور المجموعة.

az role assignment list --resource-group $mrgname --role Owner --query "[].{ResourceGroup:resourceGroup, GroupName:principalName, RoleDefinition:roleDefinitionId, Role:roleDefinitionName}"

لمراجعة تعيينات رفض مجموعة الموارد المدارة، استخدم مدخل Microsoft Azure أو أوامر Azure PowerShell.

المدخل

انتقل إلى مجموعة الموارد المدارة مع بادئة الاسم mrg-sampleManagedApplication وحدد Overview لعرض الموارد التي تم نشرها. تحتوي مجموعة الموارد على App Service وخطة App Service وحساب تخزين.

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

لعرض تعيين الدور من مدخل Microsoft Azure:

1. انتقل إلى مجموعة موارد mrg-sampleManagedApplication .

2. حدد Access Control (IAM)>تعيينات الدور.

   يمكنك أيضا عرض تعيينات رفض المورد.

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

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

عند الانتهاء من التطبيق المدار، يمكنك حذف مجموعات الموارد وإزالة جميع الموارد التي قمت بإنشائها. على سبيل المثال، في هذا التشغيل السريع، قمت بإنشاء مجموعات الموارد applicationGroup ومجموعة موارد مدارة مع البادئة mrg-sampleManagedApplication.

PowerShell

يطالبك الأمر بتأكيد رغبتك في إزالة مجموعة الموارد.

Remove-AzResourceGroup -Name applicationGroup

Azure CLI

يطالب الأمر بالتأكيد، ثم يرجعك إلى موجه الأوامر أثناء حذف الموارد.

az group delete --resource-group applicationGroup --no-wait

المدخل

1. من مدخل Microsoft Azure Home في حقل البحث، أدخل مجموعات موارد.
2. حدد Resource groups.
3. حدد applicationGroup واحذف مجموعة الموارد.
4. لتأكيد الحذف، أدخل اسم مجموعة الموارد وحدد حذف.

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

• نشر تعريف التطبيق: packageStorageGroup وappDefinitionGroup.
• نشر التعريف مع إحضار التخزين الخاص بك: packageStorageGroup و byosDefinitionStorageGroup و byosAppDefinitionGroup.

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

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