نموذج البرنامج النصي Azure CLI - إنشاء تطبيق منطقي

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

ينشئ هذا البرنامج النصي نموذج تطبيق منطق من خلال ملحق Azure CLI Logic Apps، (az logic). للحصول على دليل مفصل لإنشاء تطبيقات المنطق وإدارتها من خلال Azure CLI، راجع التشغيل السريع ل Logic Apps ل Azure CLI.

Warning

ملحق Azure CLI Logic Apps تجريبي حاليا ولا يغطيه دعم العملاء. يرجى استخدام ملحق CLI بحذر لاسيما إذا اخترت استخدام الملحق في البيئات الإنتاجية.

Prerequisites

• حساب Azure مع اشتراك نشط. إذا لم يكن لديك اشتراك Azure، فأنشئ حسابًا مجانًا.
• Azure CLI المثبت على جهاز الكمبيوتر المحلي.
• ملحق Logic Apps Azure CLI المثبت على جهاز الكمبيوتر الخاص بك. بتثبيت هذا الملحق استخدم هذا الأمر: az extension add --name logic
• تعريف سير عمل لتطبيق المنطق الخاص بك. يجب أن يتبع ملف JSON هذا مخطط لغة تعريف سير العمل.
• اتصال API بحساب بريد إلكتروني من خلال موصل Azure Logic Apps مدعوم في نفس مجموعة الموارد مثل تطبيق المنطق الخاص بك. يستخدم هذا المثال موصل Office 365 Outlook ، ولكن يمكنك أيضا استخدام موصلات أخرى مثل Outlook.com.

التحقق من المتطلبات الأساسية

التحقق من بيئتك قبل أن تبدأ:

• سجّل الدخول إلى مدخل Azure وتحقق من أن اشتراكك نشط عن طريق تشغيل az login.

• تحقق من إصدار Azure CLI في المحطة الطرفية أو نافذة الأوامر عن طريق تشغيل az --version. للحصول على أحدث إصدار، راجع ملاحظات الإصدار الأخيرة .

  • في حال عدم امتلاك أحدث إصدار، فيمكن تحديث التثبيت باتباع دليل تثبيت نظام التشغيل أو النظام الأساسي لديك.

نموذج شرح سير العمل

ينشئ ملف تعريف سير العمل هذا المثال نفس المثال الأساسي لسير عمل تطبيق منطق الاستهلاك كما هو الحال في التشغيل السريع لمدخل Microsoft Azure.

نموذج سير العمل هذا:

1. يحدد مخططا، $schema، لتطبيق المنطق.

2. تعريف مشغل لتطبيق المنطق في قائمة المشغلات، triggers. يتكرر المشغل (recurrence) كل 3 ساعات. يتم تشغيل الإجراءات عند نشر عنصر موجز جديد (When_a_feed_item_is_published) لموجز RSS المحدد (feedUrl).

3. يحدد إجراء لتطبيق المنطق في قائمة الإجراءات، actions. يرسل الإجراء بريدا إلكترونيا (Send_an_email_(V2)) من خلال Microsoft 365 مع تفاصيل من عناصر موجز RSS كما هو محدد في قسم النص الأساسي (body) من مدخلات الإجراء (inputs).

نموذج تعريف سير العمل

قبل تشغيل نموذج البرنامج النصي، يجب أولا إنشاء نموذج تعريف سير العمل.

1. إنشاء ملف JSON، testDefinition.json على جهاز الكمبيوتر الخاص بك.

2. انسخ المحتوى التالي في ملف JSON:

   
   {
       "definition": {
           "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
           "actions": {
               "Send_an_email_(V2)": {
                   "inputs": {
                       "body": {
                           "Body": "<p>@{triggerBody()?['publishDate']}<br>\n@{triggerBody()?['title']}<br>\n@{triggerBody()?['primaryLink']}</p>",
                           "Subject": "@triggerBody()?['title']",
                           "To": "test@example.com"
                       },
                       "host": {
                           "connection": {
                               "name": "@parameters('$connections')['office365']['connectionId']"
                           }
                       },
                       "method": "post",
                       "path": "/v2/Mail"
                   },
                   "runAfter": {},
                   "type": "ApiConnection"
               }
           },
           "contentVersion": "1.0.0.0",
           "outputs": {},
           "parameters": {
               "$connections": {
                   "defaultValue": {},
                   "type": "Object"
               }
           },
           "triggers": {
               "When_a_feed_item_is_published": {
                   "inputs": {
                       "host": {
                           "connection": {
                               "name": "@parameters('$connections')['rss']['connectionId']"
                           }
                       },
                       "method": "get",
                       "path": "/OnNewFeed",
                       "queries": {
                           "feedUrl": "https://www.pbs.org/now/rss.xml"
                       }
                   },
                   "recurrence": {
                       "frequency": "Hour",
                       "interval": 3
                   },
                   "splitOn": "@triggerBody()?['value']",
                   "type": "ApiConnection"
               }
           }
       },
       "parameters": {
           "$connections": {
               "value": {
                   "office365": {
                       "connectionId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/office365",
                       "connectionName": "office365",
                       "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Web/locations/westus/managedApis/office365"
                   },
                   "rss": {
                       "connectionId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/rss",
                       "connectionName": "rss",
                       "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Web/locations/westus/managedApis/rss"
                   }
               }
           }
       }
   }
   
   

3. تحديث قيم العنصر النائب بالمعلومات الخاصة بك:

   1. استبدل عنوان البريد الإلكتروني للعنوان النائب ("To": "test@example.com"). تحتاج إلى استخدام عنوان بريد إلكتروني متوافق مع موصلات Logic Apps. لمزيد من المعلومات، راجع المتطلبات الأساسية.

   2. استبدل تفاصيل الموصل الإضافية إذا كنت تستخدم موصل بريد إلكتروني آخر غير موصل Office 365 Outlook.

   3. استبدل قيم اشتراك العنصر النائب (00000000-0000-0000-0000-000000000000) لمعرفات الاتصال الخاصة بك (connectionId و id) ضمن معلمة الاتصالات ($connections) بقيم الاشتراك الخاصة بك.

4. احفظ تغييراتك.

نموذج البرنامج النصي

Note

تتم كتابة هذه العينة ل shell bash . إذا كنت تريد تشغيل هذه العينة في shell أخرى، مثل Windows PowerShell أو موجه الأوامر، فقد تحتاج إلى إجراء تعديلات على البرنامج النصي الخاص بك.

قبل تشغيل نموذج البرنامج النصي هذا، قم بتشغيل هذا الأمر للاتصال ب Azure:

az login

بعد ذلك، انتقل إلى الدليل الذي قمت بإنشاء تعريف سير العمل فيه. على سبيل المثال، إذا قمت بإنشاء ملف JSON لتعريف سير العمل على سطح المكتب الخاص بك:

cd ~/Desktop

ثم قم بتشغيل هذا البرنامج النصي لإنشاء تطبيق منطقي.

#!/bin/bash

# Create a resource group

az group create --name testResourceGroup --location westus

# Create your logic app

az logic workflow create --resource-group "testResourceGroup" --location "westus" --name "testLogicApp" --definition "testDefinition.json"

تنظيف النشر

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

az group delete --name testResourceGroup --yes

شرح السيناريو

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

Command	Notes
az group create	إنشاء مجموعة موارد يتم فيها تخزين موارد تطبيق المنطق الخاص بك.
az logic workflow create	إنشاء تطبيق منطقي استنادا إلى سير العمل المحدد في المعلمة --definition.
az group delete	حذف مجموعة موارد وكافة مواردها المتداخلة.

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

لمزيد من المعلومات حول Azure CLI، راجع وثائق Azure CLI.

يمكنك العثور على نماذج البرنامج النصي ل Logic Apps CLI إضافية في مستعرض نماذج التعليمات البرمجية من Microsoft.