أنشئ معلمات عبر البيئة لإدخالات سير العمل في Azure Logic Apps

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

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

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

لمزيد من المعلومات حول Azure Logic Apps متعددة المستأجرين والمستأجر الواحد، راجع المستأجر الفردي مقابل متعدد المستأجرين في Azure Logic Apps.

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

• حساب واشتراك Azure. إذا لم يكن لديك اشتراك، فيجب التسجيل للحصول على حساب Azure مجاني.

• سير عمل تطبيق الاستهلاك أو المنطق القياسي

  إذا لم يكن لديك سير عمل تطبيق منطقي حتى الآن، فشاهد إنشاء مثال سير عمل تطبيق منطق الاستهلاك باستخدام مدخل Microsoft Azure أو إنشاء مثال لسير عمل تطبيق المنطق القياسي باستخدام مدخل Microsoft Azure.

  إشعار

  حاليًا، يمكن إنشاء معلمات لمهام سير عمل تطبيق منطق الاستهلاك فقط باستخدام مدخل Microsoft Azure. يمكنك إنشاء معلمات لعمليات سير العمل لتطبيق المنطق القياسي فقط باستخدام مدخل Microsoft Azure أو Visual Studio Code.

معلمات الاستهلاك مقابل مهام سير عمل تطبيق المنطق القياسي

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

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

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

هام

عندما يكون لديك معلومات حساسة، مثل سلسلة الاتصال التي تتضمن أسماء المستخدمين وكلمات المرور، تأكد من استخدام تدفق المصادقة الأكثر أمانا المتوفرة. على سبيل المثال، في مهام سير عمل تطبيق المنطق القياسي، أنواع البيانات الآمنة، مثل securestring و secureobject، غير مدعومة. توصي Microsoft بمصادقة الوصول إلى موارد Azure بهوية مدارة عندما يكون ذلك ممكنا، وتعيين دور له أقل امتياز ضروري.

إذا كانت هذه الإمكانية غير متوفرة، فتأكد من تأمين سلسلة الاتصال من خلال مقاييس أخرى، مثل Azure Key Vault، والتي يمكنك استخدامها مع إعدادات التطبيق. يمكنك بعد ذلكالعودة مباشرة إلى سلاسل آمنة، مثل سلاسل الاتصال والمفاتيح. على غرار قوالب ARM، حيث يمكنك تحديد متغيرات البيئة في وقت التوزيع، يمكنك تحديد إعدادات التطبيق ضمن تعريف سير عمل التطبيق المنطقي. يمكنك بعد ذلك تسجيل قيم البنية الأساسية التي تم إنشاؤها ديناميكياً، مثل نقاط نهاية الاتصال وسلاسل التخزين والمزيد. لمزيد من المعلومات، راجع أنواع التطبيقات النظام الأساسي للهويات في Microsoft.

مع ذلك، فإن إعدادات التطبيق لها حدود للحجم ولا يمكن الرجوع إليها من مناطق معينة في Azure Logic Apps. تقدم المعلمات نطاقًا أوسع من حالات الاستخدام مقارنة بإعدادات التطبيق، مثل دعم أحجام القيم الكبيرة والكائنات المعقدة.

على سبيل المثال، في حال كنت تستخدم Visual Studio Code كأداة تطوير محلية لتشغيل مهام سير العمل محلياً، في مشروع تطبيق المنطق الخاص بك، يمكنك تعريف المعلمات باستخدام ملفparameters.json. يمكنك بعد ذلك الرجوع إلى أي معلمة في ملف المعلمات هذا من أي سير عمل في ملف workflow.json الخاص بمشروعك أو من أي عنصر اتصال في ملف links.json الخاص بالمشروع. تصف القائمة التالية بعض حالات الاستخدام الشائعة:

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

• عاملات أجزاء مختلفة من ملف links.json. يمكنك بعد ذلك التحقق من ملف links.json الخاص بك في التحكم بالمصادر، ثم إدارة أي اتصالات من خلال ملف parameters.json.

• وضع المعلمات للعناصر المعقدة authentication، مثل عنصر JSON. على سبيل المثال، يمكنك استبدال authenticationقيمة العنصر بسلسلة تحتوي على تعبير معلمات واحد، مثل@parameters('api-auth').

• راجع إعدادات التطبيق وعدّلها في ملف local.settings.json الخاص بمشروعك. يمكنك بعد ذلك الرجوع إلى إعدادات التطبيق هذه في معلماتك.

إشعار

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

تحديد واستخدام وتحرير المعلمات

استهلاك

مدخل Azure

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

2. من شريط أدوات المصمم، قم بتحديدالمعلمات.

   

3. في جزءParameters، قم بتحديدAdd parameter.

4. قدم المعلومات التالية حول المعلمة المراد إنشاؤها:

   الخاصية	المطلوب	‏‏الوصف‬
   الاسم	‏‏نعم‬	اسم المعلمة المراد إنشاؤها.
   النوع	‏‏نعم‬	نوع البيانات للمعلمة، مثلArrayوBoolوFloatوIntوObjectوSecure ObjectوSecure StringوString.
   القيمة الافتراضية	‏‏نعم‬	القيمة الافتراضية الخاصة بالمعلمة. يجب عليك أن تحدد قيمة المعلمة الافتراضية لأن منطق سير العمل ومعلومات الاتصال وقيم المعلمات غير موجودة في مكان واحد. يلزم أن يكون المصمم قادرًا على حل قيم المعلمات قبل التحميل. مهم: بالنسبة لأنواع بياناتالعنصر الآمنوالسلسلة الآمنة، تجنب تعيين قيمة افتراضية لأن القيمة مخزنة كنص عادي.
   قيمة فعلية	لا	القيمة الفعلية المتعلقة بالمعلمة.

   يوضح المثال التالي تعريفًا لمعلمة السلسلة:

   

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

6. للإشارة للمعلمة من مشغل أو إجراء موجود في نفس سير العمل، اتبع الخطوات الآتية:

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

   2. في الخاصية التي تريد استخدام المعلمة بها، قم بالنقر داخل مربع تحرير تلك الخاصية.

   3. من قائمة المحتوى الديناميكي التي تفتح، ضمنParameters، قم بتحديد المعلمةالتي تم إنشاؤها مسبقاً، على سبيل المثال:

      

7. لعرض أو تحرير المعلمات في سير عمل تطبيق منطقي، اتبع الخطوات التالية:

   1. افتح سير عمل تطبيق المنطق في المصمم. في شريط أدوات المصمم، قم بتحديد المعلمات.

      يتم فتح جزءParametersويعرض كافة المعلمات التي قمت بتعريفها لسير العمل هذا.

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

قياسي

مدخل Azure

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

2. من شريط أدوات المصمم، قم بتحديدالمعلمات.

   

3. في جزء Parameters، حدد Create parameter.

4. قدم المعلومات التالية حول المعلمة المراد إنشاؤها:

   الخاصية	المطلوب	‏‏الوصف‬
   الاسم	‏‏نعم‬	اسم المعلمة المراد إنشاؤها.
   النوع	‏‏نعم‬	نوع البيانات للمعلمة، مثلArrayوBoolوFloatوIntوObjectوString. ملاحظة: في مهام سير عمل لتطبيق المنطق القياسي، أنواع البيانات الآمنة، مثل securestringوsecureobject، غير مدعومة.
   القيمة	‏‏نعم‬	قيمة المعلمة. في مهام سير عمل تطبيق المنطق القياسي، يجب عليك تحديد قيمة المعلمة لأن منطق سير العمل ومعلومات الاتصال وقيم المعلمات غير موجودة في مكان واحد. يلزم أن يكون المصمم قادرًا على حل قيم المعلمات قبل التحميل.

   يوضح المثال التالي تعريفًا لمعلمة السلسلة:

   

5. عند الانتهاء، أغلق جزء Parameters، ولكن تأكد من حفظ سير عملك لحفظ تعريف المعلمة الجديد.

6. للإشارة إلى المعلمة من مشغل أو إجراء موجود في أي سير عمل داخل نفس تطبيق المنطق، اتبع الخطوات التالية:

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

   2. في الخاصية التي تريد استخدام المعلمة بها، قم بالنقر داخل مربع تحرير تلك الخاصية.

   3. من قائمة المحتوى الديناميكي التي تفتح، ضمنParameters، قم بتحديد المعلمةالتي تم إنشاؤها مسبقاً، على سبيل المثال:

      

7. لعرض أو تحرير المعلمات في نفس تطبيق المنطق، اتبع إحدى الخطوتين:

   • افتح أي سير عمل في التطبيق المنطقي هذا. في قائمة سير العمل، قم بتحديد Designer. في شريط أدوات المصمم، قم بتحديد المعلمات.

     تفتح جزء Parameters ويعرض كافة المعلمات التي قمت بتعريفها من سير العمل في تطبيق المنطق ذلك.

   • لعرض أو تحرير في JSON مجمع، في القائمة الرئيسية لتطبيق المنطق الخاص بك، قم بتحديد Parameters.

     يفتح جزء JSONParameters ويعرض كافة المعلمات التي قمت بتعريفها من سير العمل في تطبيق المنطق ذلك.

تعليمة Visual Studio برمجية

1. في ملف JSON على مستوى جذر المشروع المسمى parameters.json، حدد all المعلمات وقيمها. يحتوي هذا الملف على كائن يشمل أزواج قيم المفاتيح. كل مفتاحهو اسم لكل معلمة، بينما كل قيمةهي بنية لكل معلمة. يجب أن تشمل كل بنية إعلان بالربط type وvalue.

   هام

   يجب أن يحدد ملف parameters.json كافة المعلمات وقيمها التي تشير إليها أو تستخدمها في مكان آخر في مشروعك، على سبيل المثال، في تعريفات سير العمل أو الاتصالات.

   يوضح المثال التالي ملف معلمات أساسي:

   {
       "responseString": { 
           "type": "string", 
           "value": "hello" 
       },
       "functionAuth": { 
           "type": "object", 
           "value": { 
               "type": "QueryString", 
               "name": "Code", 
               "value": "@appsetting('<AzureFunctionsOperation-FunctionAppKey>')" 
           }
       }
    }
   

   إشعار

   في ملف parameters.json، @appsetting هو نوع التعبير الوحيد الصالح.

2. للإشارة إلى المعلمات في المشغل أو مدخلات الإجراء، استخدم التعبير @parameters('<parameter-name>').

معلمة ملف الاتصالات

لوضع معلمات لملف links.json، استبدل القيم الحرفية، مثل ConnectionRuntimeUrl، بتعبير parameters() واحد، على سبيل المثال، @parameters('api-runtimeUrl'). في ملف connections.json، أنواع التعبير الصالحة الوحيدة هي @parameters@appsetting.

هام

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

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

{
   "serviceProviderConnections": {
      "serviceBus": {
         "parameterValues": {
            "connectionString": "@appsetting('serviceBus_connectionString')"
        },
        "serviceProvider": {
           "id": "/serviceProviders/serviceBus"
        },
        "displayName": "servicebus"
     }
   },
   "managedApiConnections": {
      "azureblob": {
         "api": {
            "id": "/subscriptions/@{appsetting('WORKFLOWS_SUBSCRIPTION_ID')}/providers/Microsoft.Web/locations/@{appsetting('WORKFLOWS_LOCATION_NAME')}/managedApis/azureblob"
         },
         "connection": {
            "id": "/subscriptions/@{appsetting('WORKFLOWS_SUBSCRIPTION_ID')}/resourceGroups/@{appsetting('WORKFLOWS_RESOURCE_GROUP_NAME')}/providers/Microsoft.Web/connections/azureblob"
         },
         "connectionRuntimeUrl": "@appsetting('BLOB_CONNECTION_RUNTIMEURL')",
         "authentication": "@parameters('blob_auth')"
      }
   }
}

إشعار

عندما يكون لديك تعبير سطري مع نص عادي، تأكد من استخدام التنسيق المقحم لهذا التعبير من خلال إحاطة هذا التعبير بأقواس معقوفة ({}). يساعد هذا التنسيق في تجنب مشاكل التحليل.

على سبيل المثال، إذا كنت تمتلك "<text>/@<function-name>('<parameter-name>')/<text>"، فاستخدم الإصدار التالي بدلا من ذلك:"<text>/@{<function-name>('<parameter-name>')}/<text>".

لمزيد من المعلومات، راجع اعتبارات استخدام الوظائف.

إدارة ملفات المعلمات

عادة، تحتاج إلى إدارة إصدارات متعددة من ملفات المعلمات. قد يكون لديك قيم مستهدفة لبيئات التوزيع المختلفة، مثل التطوير والاختبار والإنتاج. غالباً ما تعمل إدارة ملفات المعلمات هذه مثل إدارة ملفات معلمات قالب ARM. عندما تقوم بالتوزيع في بيئة معينة، فإنك تقوم بترقية ملف المعلمات المطابقة، بشكل عام من خلال تدفق لـ DevOps.

لاستبدال ملفات المعلمات ديناميكيًا باستخدام Azure CLI، قم بتشغيل الأمر الأتي:

az functionapp deploy --resource-group MyResourceGroup --name MyLogicApp --src-path C:\parameters.json --type static --target-path parameters.json

إذا كنت تمتلك مشروع تطبيق منطق يستند إلى NuGet، فيجب عليك تحديث ملف المشروع (<logic-app-name>.csproj) لتضمين ملف المعلمات في إخراج البنية، على سبيل المثال:

<ItemGroup>
  <None Update="parameters.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>

إشعار

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

لمزيد من المعلومات حول إعداد تطبيقاتك المنطقية لعمليات توزيع DevOps، راجع الوثائق التالية:

• نظرة عامة على توزيع DevOps للتطبيقات المنطقية المستندة إلى المستأجر الفردي
• إعداد توزيع DevOps للتطبيقات المنطقية المستندة إلى المستأجر الفردي

إدارة إعدادات التطبيق

في Azure Logic Apps للمستأجر الفردي، تحتوي إعدادات التطبيق على خيارات التكوين العامة لجميع مهام سير العمل في نفس التطبيق المنطقي. عند تشغيل مهام سير العمل محلياً في Visual Studio Code، يمكنك الوصول إلى إعدادات التطبيق هذه كمتغيرات البيئة المحلية في ملف local.settings.json. يمكنك بعد ذلك الرجوع إلى إعدادات التطبيق هذه في معلماتك.

لإضافة إعدادات التطبيق أو تحديثها أو حذفها، حدد ومراجعة الأقسام التالية لقالب Visual Studio Code أو مدخل Microsoft Azure أو واجهة مستوى الاستدعاء (Azure CLI) أو ARM (Bicep).

مدخل Azure

لمراجعة إعدادات التطبيق لمورد تطبيق المنطق في مدخل Microsoft Azure، اتبع الخطوات الآتية:

1. في مدخل Microsoft Azure، افتح مورد التطبيق المنطقي.

2. في قائمة تطبيق المنطق، ضمن Settings، حدد Configuration.

3. في صفحة التكوين، في علامة التبويبالإعدادات المتعلقة بالتطبيق، راجع إعدادات التطبيق لتطبيق المنطق الخاص بك.

4. لعرض جميع القيم، حدد Show Values. أو، لعرض قيمة واحدة، حدد تلك القيمة.

لإضافة إعداد جديد، اتبع الخطوات الآتية:

1. في علامة التبويب Application settings، ضمن Application settings، حدد New application setting.

2. بالنسبة إلى الاسم، أدخل المفتاح أو اسم الإعداد الجديد.

3. بالنسبة إلى القيمة، أدخل قيمة الإعداد الجديد.

4. عندما تكون مستعداً لإنشاء زوج جديد من key-value، حدد OK.

   

5. عند الانتهاء، في شريط أدواتCORS، قم بتحديد حفظ.

Azure CLI

لمراجعة إعدادات التطبيق الجارية باستخدام Azure CLI، قم بتشغيل الأمر az logicapp config appsettings list. تأكد من أن الأمر الخاص بك يتضمن المعلمات --name -n و--resource-group -g، على سبيل المثال:

az logicapp config appsettings list --name MyLogicApp --resource-group MyResourceGroup

لإضافة أو تحديث إعداد تطبيق باستخدام واجهة مستوى الاستدعاء (Azure CLI)، قم بتشغيل الأمر az logicapp config appsettings set. تأكد من أن الأمر يشمل المعلمتين --name nو--resource-group -g. على سبيل المثال، يقوم الأمر التالي بإنشاء إعداد بمفتاح يسمى CUSTOM_LOGIC_APP_SETTING بقيمة 12345:

az logicapp config appsettings set --name MyLogicApp --resource-group MyResourceGroup --settings CUSTOM_LOGIC_APP_SETTING=12345 

Resource Manager أو قالب العضلة ذات الرأسين

لمراجعة وتحديد إعدادات التطبيق في قالب ARM أو قالب Bicep، ابحث عن تعريف مورد تطبيق المنطق، وقم بتحديث عنصر JSON appSettings. للحصول على تعريف المورد الكامل، راجع مرجع قالب ARM.

يوضح هذا المثال إعدادات الملف إما لقوالب ARM أو قوالب Bicep:

"appSettings": [
    {
        "name": "string",
        "value": "string"
    },
    {
        "name": "string",
        "value": "string"
    },
    <...>
], 

المحتوى ذو الصلة

• مستأجر واحد مقابل متعدد المستأجرين في Azure Logic Apps