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

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

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

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

هام

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

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

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

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

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

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

إشعار

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

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

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

Settings defined in the Values property can be referenced from code as environment variables. In Node.js functions, for example, they're available in the process.env object.

const connectionString = process.env.DATABASE_CONNECTION_STRING;

The local.settings.json file isn't tracked by the GitHub repository because sensitive information, like database connection strings, are often included in the file. Since the local settings remain on your machine, you need to manually configure your settings in Azure.

Generally, configuring your settings is done infrequently, and isn't required with every build.

تكوين إعدادات التطبيق

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

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

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

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

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

  3. حدد متغيرات البيئة في الشريط الجانبي.

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

  5. حدد + إضافة لإضافة متغير بيئة جديد. لقطة شاشة لعرض متغيرات بيئة Azure Static Web Apps

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

  7. حدد موافق.

  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"

Tip

You can add or update multiple settings by passing multiple name-value pairs to --setting-names.

View application settings with the Azure CLI

In a terminal or command line, execute the following command. Make sure to replace the placeholder <YOUR_APP_ID> with your value.

az staticwebapp appsettings list --name <YOUR_APP_ID>

Delete application settings with the Azure CLI

In a terminal or command line, execute the following command to delete a setting named message. Make sure to replace the placeholder <YOUR_APP_ID> with your value.

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

Tip

Delete multiple settings by passing multiple setting names to --setting-names.