تكوين إعدادات التطبيق لـ Azure Static Web Apps

  • مقالة
  • قراءة خلال 2 دقائق

تحتفظ إعدادات التطبيق بقيم التكوين التي قد تتغير، مثل سلاسل اتصال قاعدة البيانات. تتيح لك إضافة إعدادات التطبيق تعديل إدخال التكوين إلى تطبيقك، دون الحاجة إلى تغيير رمز التطبيق.

إعدادات التطبيق:

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

هام

تنطبق إعدادات التطبيق الموضحة في هذه المقالة فقط على واجهة برمجة التطبيقات الخلفية لتطبيق ويب Azure Static App.

لتكوين متغيرات البيئة المطلوبة لإنشاء تطبيق ويب الواجهة الأمامية، راجع إنشاء تكوين.

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

  • تطبيق Azure Static Web Apps
  • Azure CLI — مطلوب إذا كنت تستخدم سطر الأوامر

تكوين إعدادات تطبيق واجهة برمجة التطبيقات للتنمية المحلية

يتم تشغيل واجهات برمجة التطبيقات في Azure Static Web Apps بواسطة وظائف Azure، مما يسمح لك بتحديد إعدادات التطبيق في الملف local.settings.json عند تشغيل التطبيق محليا. يحدد هذا الملف إعدادات التطبيق في Values خاصية التكوين.

ملاحظة

يتم استخدام الملف local.settings.json فقط للتنمية المحلية. استخدم مدخل Azure لتكوين إعدادات التطبيق للإنتاج.

يوضح النموذج التالي : local.settings.json كيفية إضافة قيمة ل DATABASE_CONNECTION_STRING.

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "",
    "FUNCTIONS_WORKER_RUNTIME": "node",
    "DATABASE_CONNECTION_STRING": "<YOUR_DATABASE_CONNECTION_STRING>"
  }
}

يمكن الرجوع إلى الإعدادات المعرفة في Values الخاصية من التعليمات البرمجية كمتغيرات بيئة. في Node.js الدالات، على سبيل المثال، تكون متوفرة في process.env الكائن.

const connectionString = process.env.DATABASE_CONNECTION_STRING;

لا يتم تعقب الملف بواسطة مستودع local.settings.json GitHub لأن المعلومات الحساسة، مثل سلاسل اتصال قاعدة البيانات، غالبا ما يتم تضمينها في الملف. نظرا لبقاء الإعدادات المحلية على جهازك، تحتاج إلى تكوين إعداداتك يدويا في Azure.

بشكل عام ، يتم تكوين إعداداتك بشكل غير متكرر ، وليس مطلوبا مع كل إصدار.

تكوين إعدادات تطبيق API في Azure

يمكنك تكوين إعدادات التطبيق عبر مدخل Azure أو باستخدام Azure CLI.

استخدام مدخل Microsoft Azure

توفر بوابة Azure الإلكترونية واجهة لإنشاء إعدادات التطبيق وتحديثها وحذفها.

  1. انتقل إلى مدخل Microsoft Azure.

  2. افتح تطبيق الويب الثابت.

  3. حدد التكوين في الشريط الجانبي.

  4. حدد البيئة التي تريد تطبيق إعدادات التطبيق عليها. يتم إنشاء بيئات التدريج تلقائيا عند إنشاء طلب سحب، ويتم ترقيتها إلى الإنتاج بمجرد دمج طلب السحب. يمكنك تعيين إعدادات التطبيق لكل بيئة.

  5. حدد + إضافة لإضافة إعداد تطبيق جديد.

    Azure Static Web Apps configuration view

  6. أدخل اسماوقيمة.

  7. حدد "OK".

  8. حدد ⁧⁩حفظ⁧⁩.

استخدام Azure CLI

يمكنك استخدام الأمر لتحديث az staticwebapp appsettings إعداداتك في Azure.

  • في محطة طرفية أو سطر أوامر، نفذ الأمر التالي لإضافة أو تحديث إعداد مسمى message بقيمة Hello world. تأكد من استبدال العنصر النائب <YOUR_APP_ID> بقيمتك.

    az staticwebapp appsettings set --name <YOUR_APP_ID> --setting-names "message=Hello world"

    تلميح

    يمكنك إضافة إعدادات متعددة أو تحديثها عن طريق تمرير أزواج متعددة من قيم الأسماء إلى --setting-names.

عرض إعدادات التطبيق باستخدام Azure CLI

تتوفر إعدادات التطبيق للعرض من خلال Azure CLI.

  • في محطة طرفية أو سطر أوامر، قم بتنفيذ الأمر التالي. تأكد من استبدال العنصر النائب <YOUR_APP_ID> بقيمتك.

    az staticwebapp appsettings list --name <YOUR_APP_ID>

حذف إعدادات التطبيق باستخدام Azure CLI

يمكن حذف إعدادات التطبيق من خلال Azure CLI.

  • في محطة طرفية أو سطر أوامر، نفذ الأمر التالي لحذف إعداد باسم message. تأكد من استبدال العنصر النائب <YOUR_APP_ID> بقيمتك.

    az staticwebapp appsettings delete --name <YOUR_APP_ID> --setting-names "message"

    تلميح

    يمكنك حذف إعدادات متعددة عن طريق تمرير أسماء إعدادات متعددة إلى --setting-names.

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

تكوين أطر عمل الواجهة الأمامية