التشغيل السريع: إنشاء مهام سير العمل وإدارتها باستخدام Azure CLI في Azure Logic Apps

مقالة
01/04/2024

وينطبق ذلك على: Azure Logic Apps (الاستهلاك)

يوضح التشغيل السريع كيفية إنشاء وإدارة مهام سير العمل التلقائية التي تعمل في Azure Logic Apps باستخدام ملحق Azure CLI Logic Apps (az logic). من PowerShell، يمكنك إنشاء تطبيق استهلاك منطقي في Azure Logic Apps متعدد المستأجرين باستخدام ملف JSON لتعريف سير العمل للتطبيق المنطقي. يمكنك إذن إدارة تطبيقك المنطقي بتشغيل العمليات مثل list، show، (get)، update وdelete من سطر الأوامر.

تحذير

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

ينطبق التشغيل السريع حاليًا فقط على مهام سير عمل تطبيق Consumption logic التي تعمل في Azure Logic Apps متعددة المستأجرين. Azure CLI غير متوفر حاليًا لسير العمل لتطبيق المنطق القياسي الذي يعمل في Azure Logic Apps أحادي المستأجر. لمزيد من المعلومات، راجع نوع المورد واختلافات المضيف في Azure Logic Apps.

إذا كنت مستخدماً جديدا لـ Azure Logic Apps، تعرف على كيفية إنشاء سير عمل تطبيق استهلاك المنطق الأول من خلال مدخل Microsoft Azure وفي Visual Studio وفي Visual Studio Code.

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

حساب Azure باشتراك نشط. عند عدم وجود اشتراك في Azure، ⁦قم بإنشاء حساب مجاني⁦⁩.
Azure CLI، مثبت على جهاز الكمبيوتر الشخصي.
ملحق Logic Apps Azure CLI يثبت على جهاز الكمبيوتر. بتثبيت هذا الملحق استخدم هذا الأمر: az extension add --name logic
مجموعة موارد Azure يتم من خلالها إنشاء تطبيقك المنطقي.

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

قبل البدء، تحقق من صحة بيئتك:

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

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

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

إذا لم يكن لديك بالفعل مجموعة موارد لتطبيقك المنطقي، فيرجى إنشاؤها باستخدام الأمر az group create. في المثال التالي سيتم إنشاء مجموعة موارد تسمى testResourceGroup في موقع westus.

az group create --name testResourceGroup --location westus

يظهر الناتج provisioningState كـ Succeeded عند إنشاء مجموعة مواردك بنجاح:

<...>
  "name": "testResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
<...>

تعريف سير العمل

قبل البدء بإنشاء تطبيق منطقي جديد أو تحديث تطبيقك المنطقي الحالي باستخدام Azure CLI، ستحتاج إلى تعريف سير عمل لتطبيقك المنطقي. في مدخل Microsoft Azure، يمكنك عرض تعريف سير العمل الأساسي لتطبيقك المنطقي بتنسيق JSON بالتبديل من عرض المصمم إلى عرض التعليمات البرمجية.

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

إنشاء التطبيقات المنطقية- من CLI

يمكنك إنشاء سير عمل للتطبيق الخاص بك المنطقي من Azure CLI باستخدام أمر az logic workflow create مع ملف JSON للتعريف.

az logic workflow create --definition
                         --location
                         --name
                         --resource-group
                         [--access-control]
                         [--endpoints-configuration]
                         [--integration-account]
                         [--integration-service-environment]
                         [--state {Completed, Deleted, Disabled, Enabled, NotSpecified, Suspended}]
                         [--tags]

يجب أن يتضمن أمرك المعلمات اللازمة التالية:

المعلمة	القيمة	الوصف
تعريف سير العمل	`--definition`	ملف JSON مع تعريف سير العمل لتطبيقك المنطقي.
‏‏الموقع	`--location -l`	موقع Azure الذي يوجد به تطبيقك المنطقي.
الاسم	`--name -n`	اسم تطبيقك المنطقي. يمكن أن يحتوي الاسم فقط على أحرف وأرقام وواصلات (`-`) وشرطات سفلية (`_`) وأقواس (`()`) ونقاط (`.`). يجب أن يكون الاسم أيضاً فريداً عبر المناطق.
اسم مجموعة الموارد	`--resource-group -g`	مجموعة موارد Azure التي ترغب من خلالها في إنشاء تطبيقك المنطقي. إنشاء مجموعة موارد قبل أن تبدأ إذا لم يكن لديك بالفعل واحد لتطبيقك المنطقي.

يمكنك أيضاً تضمين معلمات اختيارية إضافية لتهيئة عناصر التحكم في الوصول لتطبيقك المنطقي ونقاط النهاية وحساب التكامل وبيئة خدمة التكامل والحالة وعلامات الموارد.

مثال - إنشاء تطبيق منطقي

في هذا المثال، يتم إنشاء سير عمل باسم testLogicApp في مجموعة الموارد testResourceGroup في الموقع westus. يحتوي ملف JSON testDefinition.json على تعريف سير العمل.

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

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

تحديث التطبيقات المنطقية- من CLI

يمكنك أيضا تحديث سير عمل التطبيق المنطقي من Azure CLI باستخدام الأمر az logic workflow create.

يجب أن يشتمل الأمر على نفس المعلمات المطلوبة كما هو الحال عند إنشاء تطبيق logic app. يمكنك أيضاً إضافة نفس المعلمات الاختيارية كما هو الحال عند إنشاء تطبيق منطقي.

az logic workflow create --definition
                         --location
                         --name
                         --resource-group
                         [--access-control]
                         [--endpoints-configuration]
                         [--integration-account]
                         [--integration-service-environment]
                         [--state {Completed, Deleted, Disabled, Enabled, NotSpecified, Suspended}]
                         [--tags]

مثال - تحديث التطبيق المنطقي

في هذا المثال، يتم تحديث نموذج سير العمل الذي تم إنشاؤه في القسم السابق لاستخدام ملف تعريف JSON مختلف، newTestDefinition.json وإضافة علامتين من الموارد، testTag1 وtestTag2 مع قيم للوصف.

az logic workflow create --resource-group "testResourceGroup" --location "westus" --name "testLogicApp" --definition "newTestDefinition.json" --tags "testTag1=testTagValue1" "testTag2=testTagValue"

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

حذف التطبيق المنطقي - من CLI

يمكنك أيضا حذف سير عمل التطبيق المنطقي من Azure CLI باستخدام الأمر az logic workflow delete.

يجب أن يتضمن أمرك المعلمات اللازمة التالية:

المعلمة	القيمة	الوصف
الاسم	`--name -n`	اسم تطبيقك المنطقي.
اسم مجموعة الموارد	`-resource-group -g`	مجموعة الموارد التي يتواجد بها تطبيقك المنطقي.

يمكنك أيضاً تضمين معلمة اختيارية لتخطي مطالبات التأكيد، --yes -y.

az logic workflow delete --name
                         --resource-group
                         [--yes]

تطالب بعد ذلك CLI بتأكيد حذف تطبيقك المنطقي. يمكنك تخطي مطالبة التأكيد باستخدام المعلمة الاختيارية --yes -y مع الأمر المرتبط بك.

Are you sure you want to perform this operation? (y/n):

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

مثال - حذف التطبيق المنطقي

في هذا المثال، يتم حذف نموذج سير العمل الذي تم إنشاؤه في قسم سابق.

az logic workflow delete --resource-group "testResourceGroup" --name "testLogicApp"

بعد الاستجابة لمطالبة التأكيد باستخدامy، يتم حذف التطبيق المنطقي.

اعتبارات - حذف التطبيق المنطقي

يؤثر حذف تطبيق منطق على مثيلات سير العمل بالطرق التالية:

تبذل Azure Logic Apps قصارى جهدها لإلغاء عمليات تشغيل قيد التقدم ومعلقة.

حتى مع الحجم الكبير أو التراكم يتم إلغاء معظم التشغيلات قبل الانتهاء أو البدء. ومع ذلك، قد تستغرق عملية الإلغاء بعض الوقت لإكمالها. وفي الوقت نفسه، قد تُستأنف بعض عمليات التشغيل للتنفيذ أثناء عمل وقت التشغيل خلال عملية الإلغاء.
لا تنشئ Azure Logic Apps مثيلات سير عمل جديدة أو تقوم بتشغيلها.
إذا قمت بحذف سير عمل ثم أعدت إنشاء نفس سير العمل، فلن يكون لسير العمل المعاد إنشاؤه نفس بيانات التعريف مثل سير العمل المحذوف. يجب إعادة حفظ أي سير عمل يسمى سير العمل المحذوف. بهذه الطريقة، يحصل المتصل على المعلومات الصحيحة لسير العمل المعاد إنشاؤه. وإلا، تتعذر الاستدعاءات لسير العمل المعاد إنشاؤه مع وجود خطأ Unauthorized. ينطبق هذا السلوك أيضاً على مهام سير العمل التي تستخدم النتائج الواردة في حسابات التكامل وسير العمل التي تستدعي وظائف Azure.

إظهار تطبيقات منطقية في CLI

للحصول على سير عمل محدد للتطبيق المنطقي باستخدام الأمر az logic workflow show.

az logic workflow show --name
                       --resource-group

يجب أن يتضمن الأمر المعلمات اللازمة التالية

المعلمة	القيمة	الوصف
الاسم	`--name -n`	اسم تطبيقك المنطقي.
اسم مجموعة الموارد	`--resource-group -g`	اسم مجموعة الموارد التي يتواجد بها تطبيقك المنطقي.

مثال - الحصول على تطبيق منطقي

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

az logic workflow show --resource-group "testResourceGroup" --name "testLogicApp" --debug

إدراج تطبيقات منطقية في CLI

يمكنك سرد التطبيقات الخاصة بك المنطقية عن طريق الاشتراك باستخدام الأمر az logic workflow list. يقوم الأمر بإرجاع التعليمات البرمجية JSON لسير عمل التطبيقات الخاصة بك المنطقية.

يمكنك تصفية النتائج حسب المعلمات الاختيارية التالية:

المعلمة	القيمة	الوصف
اسم مجموعة الموارد	`--resource-group -g`	اسم مجموعة الموارد التي تريد من خلالها تصفية النتائج.
عدد العناصر	`--top`	عدد العناصر المدرجة في النتائج.
عامل التصفية	`--filter`	نوع الفلتر الذي تستخدمه في قائمتك. يمكنك التصفية حسب الحالة (`State`)، التشغيل (`Trigger`)، ومعرف الموارد المشار إليه (`ReferencedResourceId`).

az logic workflow list [--filter]
                       [--resource-group]
                       [--top]

مثال - إدراج التطبيقات المنطقية الخاصة بك

في هذا المثال، يتم إرجاع كافة مهام سير العمل الممكنة في مجموعة الموارد testResourceGroup بتنسيق جدول ASCII.

az logic workflow list --resource-group "testResourceGroup" --filter "(State eq 'Enabled')" --output "table"

أخطاء

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

az: 'logic' is not in the 'az' command group. See 'az --help'. If the command is from an extension, please make sure the corresponding extension is installed. To learn more about extensions, please visit https://learn.microsoft.com/cli/azure/azure-cli-extensions-overview

قد يشير الخطأ التالي إلى أن مسار الملف لتحميل تعريف سير العمل غير صحيح.

Expecting value: line 1 column 1 (char 0)

معلمات عمومية

يمكنك استخدام معلمات Azure CLI العمومية الاختيارية التالية مع az logic الأوامر:

المعلمة	القيمة	الوصف
نموذج الإخراج	`--output -o`	تغيير تنسيق الإخراج من JSON الافتراضي.
إظهار الأخطاء فقط	`--only-show-errors`	إلغاء التحذيرات وإظهار الأخطاء فقط.
رسالة مطولة	`--verbose`	إظهار رسالة مطولة.
تصحيح	`--debug`	إظهار كافة سجلات التصحيح.
رسالة تعليمات	`--help -h`	إظهار مربع حوار التعليمات.
الاستعلام	`--query`	تعيين سلسلة استعلام JMESPath لإخراج JSON.

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

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

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

بعد ذلك، يمكنك إنشاء نموذج لتطبيق app logic من خلال CLI Azure باستخدام نموذج البرنامج النصي وتعريف سير العمل.

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