Quickstart: إنشاء وتوزيع سير عمل تطبيق منطق الاستهلاك في تطبيقات Azure Logic متعددة المستأجرين باستخدام قالب ARM

التطبيق على:Azure Logic Apps (Consumption)

تطبيقات Azure Logic هي خدمة سحابية تساعدك على إنشاء وتشغيل مهام سير العمل التلقائية التي تدمج البيانات والتطبيقات والخدمات المستندة إلى السحابة والأنظمة المحلية من خلال التحديد من بين مئات الموصلات. تركز البداية السريعة هذه على عملية توزيع قالب Azure Resource Manager (قالب ARM) لإنشاء سير عمل تطبيق منطق الاستهلاك الأساسي الذي يتحقق من حالة Azure وفقًا لجدول كل ساعة ويتم تشغيله في تطبيقات Azure Logic متعددة المستأجرين.

قالب Azure Resource Manager هو ملف JavaScript Object Notation (JSON) الذي يحدد البنية الأساسية والتكوين لمشروعك. يستخدم القالب عبارات توضيحية. يمكنك وصف النشر المقصود دون كتابة تسلسل أوامر البرمجة لإنشاء النشر.

إذا كانت بيئتك تلبي المتطلبات الأساسية وكنت معتادًا على استخدام قوالب ARM، فحدد زر التوزيع إلى Azure. سيتم فتح القالب في مدخل Azure.

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

إذا لم يكن لديك اشتراك في Azure، يمكنك إنشاء حساب مجاني قبل البدء.

مراجعة القالب

تستخدم هذه البداية السريعة قالب إنشاء تطبيق Logic والذي يمكنك العثور عليه في Azure Quickstart Templates Gallery ولكنه طويل جدًّا بحيث لا يمكن إظهاره هنا. بدلاً من ذلك، يمكنك مراجعة ملف azuredeploy.js الموجود في معرض القوالب.

ينشئ قالب البدء السريع سير عمل تطبيق منطق الاستهلاك الذي يستخدم مشغل التكرار المضمن، والذي يتم تعيينه للتشغيل كل ساعة، وإجراء HTTP مضمن، والذي يستدعي عنوان URL الذي يقوم بإرجاع حالة Azure. يتم تشغيل العمليات المضمنة محليًا على النظام الأساسي لتطبيقات Azure Logic.

يقوم القالب بإنشاء موارد Azure التالية:

• Microsoft.Logic/ سير العمل، الذي ينشئ سير العمل لمورد تطبيق منطق الاستهلاك.

للبحث عن قوالب بدء تشغيل أسرع لتطبيقات Azure Logic، راجع قوالب Microsoft.Logic في المعرض.

نشر القالب

اتبع الخيار الذي تريد استخدامه لنشر قالب التشغيل السريع:

خيار	‏‏الوصف
مدخل Microsoft Azure	إذا كانت بيئة Azure الخاصة بك تفي بالمتطلبات الأساسية وكنت معتادًا على استخدام قوالب ARM، فإن هذه الخطوات تساعدك على تسجيل الدخول مباشرةً إلى Azure وفتح قالب التشغيل السريع في مدخل Microsoft Azure. للمزيد من المعلومات، اطلع على نشر الموارد باستخدام قوالب ARM ومدخل Microsoft Azure.
Azure CLI	يوفر Azure CLI تجربة سطر الأوامر لإنشاء موارد Azure وإدارتها. لتشغيل هذه الأوامر، تحتاج إلى الإصدار 2.6 من Azure CLI أو إصدار أحدث. وللتحقق من إصدار واجهة مستوى الاستدعاء الخاصة بك، أدخل az --version. لمزيد من المعلومات، راجع الوثائق التالية: - ما هو Azure CLI؟ - البدء باستخدام ملفات Azure
Azure PowerShell	يوفر Azure PowerShell مجموعة من أوامر التي تستخدم نموذج Azure Resource Manager لإدارة موارد Azure. لمزيد من المعلومات، راجع الوثائق التالية: - نظرة عامة على Azure PowerShell - مقدمة إلى وحدة Azure PowerShell - البدء باستخدام Azure PowerShell
Azure Resource Management REST API	يوفر Azure واجهات برمجة التطبيقات لنقل الحالة التمثيلية (REST)، وهي نقاط نهاية خدمة تدعم عمليات (أساليب) HTTP التي تستخدمها لإنشاء موارد الخدمة، أو استردادها، أو تحديثها، أو حذفها. لمزيد من المعلومات، راجع البدء باستخدام Azure REST API.

المدخل

1. لتسجيل الدخول باستخدام حساب Azure الخاص بك وفتح قالب البدء السريع في مدخل Microsoft Azure، حدد الصورة التالية:

   

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

   الخاصية	القيمة‬	‏‏الوصف
   الاشتراك	<"Azure-subscription-name">	اسم اشتراك Azure الذي ستستخدمه
   مجموعة الموارد	<اسم مجموعة الموارد>	اسم مجموعة موارد Azure جديدة أو موجودة. يستخدم هذا المثال Check-Azure-Status-RG.
   المنطقة	<تحديد منطقة Azure>	منطقة مركز بيانات Azure لاستخدام تطبيق Logic. يستخدم هذا المثال غرب الولايات المتحدة.
   اسم تطبيق Logic	<"logic-app-name">	الاسم الذي ستستخدمه لتطبيق Logic الخاص بك. يستخدم هذا المثال Check-Azure-Status-LA.
   اختبار URI	<اختبار URI>	رابط URI للخدمة للاتصال به استنادًا إلى جدول زمني محدد. يستخدم هذا المثال https://azure.status.microsoft/en-us/status/، وهي صفحة حالة Azure.
   Location	<منطقة Azure لجميع الموارد>	منطقة Azure التي سيتم استخدامها لكافة الموارد، إذا كانت مختلفة عن القيمة الافتراضية. يستخدم هذا المثال القيمة الافتراضية، [ResourceGroup (). location]، وهي موقع مجموعة الموارد.

   يوضح المثال التالي كيف تبدو الصفحة بقيم نموذجية:

   

3. عندما تنتهي، حدد "Review + create".

4. تابع الخطوات في مراجعة الموارد المنشورة.

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

read -p "Enter a project name to use for generating resource names:" projectName &&
read -p "Enter the location, such as 'westus':" location &&
templateUri="https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.json" &&
resourceGroupName="${projectName}rg" &&
az group create --name $resourceGroupName --location "$location" &&
az deployment group create --resource-group $resourceGroupName --template-uri  $templateUri &&
echo "Press [ENTER] to continue ..." &&
read

لمزيد من المعلومات، راجع الوثائق التالية:

• Azure CLI: مجموعة نشر Azure
• نشر الموارد باستخدام قوالب ARM وAzure CLI

بوويرشيل

$projectName = Read-Host -Prompt "Enter a project name to use for generating resource names"
$location = Read-Host -Prompt "Enter the location, such as 'westus'"
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.json"

$resourceGroupName = "${projectName}rg"

New-AzResourceGroup -Name $resourceGroupName -Location "$location"
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri

Read-Host -Prompt "Press [ENTER] to continue ..."

لمزيد من المعلومات، راجع الوثائق التالية:

• Azure PowerShell: New-AzResourceGroup
• Azure PowerShell: New-AzResourceGroupDeployment
• نشر الموارد باستخدام قوالب ARM وAzure PowerShell

واجهة برمجة التطبيقات REST

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

   PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}?api-version=2019-10-01
   

   قيمة	‏‏الوصف
   <subscriptionId>	دليل اشتراك Azure الذي تريد استخدامه
   <resourceGroupName>	اسم مجموعة موارد Azure التي تريد إنشاءَها. يستخدم هذا المثال Check-Azure-Status-RG.

   على سبيل المثال:

   PUT https://management.azure.com/subscriptions/xxxxXXXXxxxxXXXXX/resourcegroups/Check-Azure-Status-RG?api-version=2019-10-01
   

   لمزيد من المعلومات، راجع الوثائق التالية:

   • مرجع Azure REST API - كيفية استدعاء Azure REST APIs
   • Resource Management REST API: مجموعات الموارد - إنشاء أو تحديث.

2. لنشر قالب التشغيل السريع إلى مجموعة الموارد، اتبع التعليمات للطلب الذي ترسله إلى Resource Management REST API:

   PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2019-10-01
   

   قيمة	‏‏الوصف
   <subscriptionId>	دليل اشتراك Azure الذي تريد استخدامه
   <resourceGroupName>	اسم مجموعة موارد Azure التي سيتم استخدامها. يستخدم هذا المثال Check-Azure-Status-RG.
   <deploymentName>	الاسم الذي ستستخدمه للنشر. يستخدم هذا المثال Check-Azure-Status-LA.

   على سبيل المثال:

   PUT https://management.azure.com/subscriptions/xxxxXXXXxxxxXXXXX/resourcegroups/Check-Azure-Status-RG/providers/Microsoft.Resources/deployments/Check-Azure-Status-LA?api-version=2019-10-01
   

   لمزيد من المعلومات، راجع Resource Management REST API: عمليات النشر - إنشاء أو تحديث.

3. لتوفير القيم لاستخدامها للنشر، مثل منطقة Azure وارتباطات إلى ملفالمعلمة وقالب التشغيل السريع، الذي يحتوي على قيم قالب التشغيل السريع لاستخدامه في النشر، اتبع بناء التعليمات هذه لنسخ الطلب الذي ترسله إلىResource Management REST A PI:

   {
      "location": "{Azure-region}",
      "properties": {
         "templateLink": {
            "uri": "{quickstart-template-URL}",
            "contentVersion": "1.0.0.0"
         },
         "parametersLink": {
            "uri": "{quickstart-template-parameter-file-URL}",
            "contentVersion": "1.0.0.0"
         },
         "mode": "Incremental"
      }
   }
   

   الخاصية	القيمة‬	‏‏الوصف
   موقع	<تحديد منطقة Azure>	منطقة Azure التي سيتم استخدامها للنشر. يستخدم هذا المثال غرب الولايات المتحدة.
   templateLink : uri	< رابط URL لقالب التشغيل السريع >	موقع URL لقالب التشغيل السريع لاستخدامه للنشر: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.json
   parametersLink : uri	<رابط URL لملف معلمة قالب التشغيل السريع>	موقع URL لملف معلمة قالب التشغيل السريع لاستخدامه للنشر: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.parameters.json لمزيد من المعلومات حول ملف معلمة Resource Manager، راجع الوثائق التالية: - إنشاء ملف معلمة إدارة الموارد - البرنامج التعليمي: استخدام ملفات المعلمات لنشر قالب إدارة موارد Azure
   الوضع	<وضع النشر>	شغّل إما تحديثًا تزايديًا أو تحديثًا كاملاً. يستخدم هذا المثال التزايدي، وهي القيمة الافتراضية. لمزيد من المعلومات، راجع أوضاع توزيع إدارة موارد Azure.

   على سبيل المثال:

   {
      "location": "West US",
      "properties": {
         "templateLink": {
            "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.json",
            "contentVersion": "1.0.0.0"
         },
         "parametersLink": {
            "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.parameters.json",
            "contentVersion": "1.0.0.0"
         },
         "mode": "Incremental"
      }
   }
   

لمزيد من المعلومات، راجع المواضيع التالية:

• Azure Resource Management REST API
• نشر الموارد باستخدام قوالب ARM وAzure Resource Manager REST API

مراجعة الموارد الموزعة

لعرض سير عمل التطبيق المنطقي، يمكنك استخدام مدخل Microsoft Azure أو تشغيل برنامج نصي تقوم بإنشائه باستخدام Azure CLI أو Azure PowerShell أو استخدام Logic App REST API.

المدخل

1. في مربع بحث مدخل Microsoft Azure، أدخل اسم تطبيق المنطق الخاص بك، وهو Check-Azure-Status-LA في هذا المثال. من قائمة النتائج، حدد تطبيق المنطق.

2. في مدخل Microsoft Azure، ابحث عن تطبيق المنطق وحدده، وهو Check-Azure-Status-RG في هذا المثال.

3. عندما يفتح مصمم سير العمل، راجع سير عمل التطبيق المنطقي الذي تم إنشاؤه بواسطة قالب البدء السريع.

4. لبدء تطبيق Logic يدويًّا، في شريط أدوات المصمم، حدد تشغيل.

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

echo "Enter your logic app name:" &&
read logicAppName &&
az logic workflow show --resource-group $resourceGroupName --name $logicAppName &&
echo "Press [ENTER] to continue ..."

لمزيد من المعلومات، راجع Azure CLI: عرض سير العمل تطبيق Logic في Azure.

بوويرشيل

$logicAppName = Read-Host -Prompt "Enter your logic app name"
Get-AzLogicApp -ResourceGroupName $resourceGroupName -Name $logicAppName 
Write-Host "Press [ENTER] to continue..."

لمزيد من المعلومات، راجع Azure PowerShell: الحصول على تطبيق AzLogic.

واجهة برمجة التطبيقات REST

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}?api-version=2016-06-01

قيمة	‏‏الوصف
subscriptionId	المعرف الفريد العمومي لاشتراك Azure في المكان الذي قمت فيه بنشر قالب التشغيل السريع.
resourceGroupName	اسم مجموعة موارد Azure في المكان الذي قمت فيه بنشر قالب التشغيل السريع. يستخدم هذا المثال Check-Azure-Status-RG.
workflowName	اسم تطبيق Logic الذي قمت بنشره. يستخدم هذا المثال Check-Azure-Status-LA.

على سبيل المثال:

GET https://management.azure.com/subscriptions/xxxxXXXXxxxxXXXXX/resourceGroups/Check-Azure-Status-RG/providers/Microsoft.Logic/workflows/Check-Azure-Status-LA?api-version=2016-06-01

لمزيد من المعلومات، انظر إلى Logic Apps REST API: Workflows - Get.

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

إذا كنت تخطط لمواصلة العمل مع الخطوات السريعة اللاحقة والبرامج التعليمية، فقد ترغب في الاحتفاظ بهذه الموارد. إذا لم تعد بحاجة إلى تطبيق Logic، فقم بحذف مجموعة الموارد باستخدام إما مدخل Microsoft Azure، أو Azure CLI، أو Azure PowerShell، أو Resource Management REST API.

المدخل

1. في مدخل Microsoft Azure، ابحث عن مجموعة الموارد التي تريد حذفها وحددها، وهي Check-Azure-Status-RG في هذا المثال.

2. في قائمة مجموعة الموارد، حدد نظرة عامة إذا لم تكن محددة مسبقًا. في جزء نظرة عامة، حدد حذف مجموعة الموارد.

3. للتأكيد، أدخل اسم مجموعة الموارد.

لمزيد من المعلومات، راجع حذف مجموعة الموارد.

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

echo "Enter your resource group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

لمزيد من المعلومات، راجع Azure CLI: حذف مجموعة Azure.

بوويرشيل

$resourceGroupName = Read-Host -Prompt "Enter the resource group name"
Remove-AzResourceGroup -Name $resourceGroupName
Write-Host "Press [ENTER] to continue..."

لمزيد من المعلومات، راجع Azure PowerShell: إزالة مجموعة موارد Azure.

واجهة برمجة التطبيقات REST

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}?api-version=2019-10-01

قيمة	‏‏الوصف
subscriptionId	المعرف الفريد العمومي لاشتراك Azure في المكان الذي قمت فيه بنشر قالب التشغيل السريع.
resourceGroupName	اسم مجموعة موارد Azure في المكان الذي قمت فيه بنشر قالب التشغيل السريع. يستخدم هذا المثال Check-Azure-Status-RG.

على سبيل المثال:

GET https://management.azure.com/subscriptions/xxxxXXXXxxxxXXXXX/resourceGroups/Check-Azure-Status-RG?api-version=2019-10-01

لمزيد من المعلومات، راجع Resource Management REST API : موارد المجموعة - حذف.

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

برنامج تعليمي: إنشاء ونشر أول قالب ARM خاص بك