التشغيل السريع: إنشاء تطبيق .NET باستخدام App Configuration

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

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

• حساب Azure مع اشتراك نشط. أنشئ حسابًا مجانًا.
• متجر App Configuration، كما هو موضح في البرنامج التعليمي لإنشاء متجر.
• .NET SDK 6.0 أو أحدث - متوفر أيضا في Azure Cloud Shell.

إضافة قيمة مفتاح

أضف قيمة المفتاح التالية إلى متجر App Configuration واترك Label و Content Type بقيمهما الافتراضية. لمزيد من المعلومات حول كيفية إضافة قيم المفاتيح إلى مخزن باستخدام مدخل Microsoft Azure أو CLI، انتقل إلى إنشاء قيمة مفتاح.

مفتاح	القيمة
TestApp:الإعدادات:رسالة	البيانات من Azure App Configuration

إنشاء تطبيق NET console

يمكنك استخدام واجهة سطر الأوامر .NET (CLI) لإنشاء مشروع تطبيق وحدة تحكم .NET جديد. تتمثل ميزة استخدام .NET CLI على Visual Studio في أنه متاح عبر الأنظمة الأساسية Windows وmacOS وLinux. بدلا من ذلك، استخدم الأدوات المثبتة مسبقا المتوفرة في Azure Cloud Shell.

1. أنشئ مجلدًا جديدًا لمشروعك.

2. في المجلد الجديد، قم بتشغيل الأمر التالي لإنشاء مشروع تطبيق وحدة تحكم .NET جديد:

   dotnet new console
   

الاتصال بمخزن تكوين التطبيق

يمكنك الاتصال بمخزن App Configuration باستخدام معرف Microsoft Entra (مستحسن) أو سلسلة الاتصال.

1. أضف مراجع حزمة NuGet عن طريق تشغيل الأمر التالي:

   معرف Microsoft Entra (مستحسن)

   dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
   dotnet add package Azure.Identity
   

   سلسلة الاتصال

   dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
   

2. تشغيل الأمر التالي لاستعادة الحزم لمشروعك:

   dotnet restore
   

3. افتح ملف Program.cs ، وأضف مساحات الأسماء التالية:

   معرف Microsoft Entra (مستحسن)

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.Configuration.AzureAppConfiguration;
   using Azure.Identity;
   

   سلسلة الاتصال

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.Configuration.AzureAppConfiguration;
   

4. اتصل بمخزن App Configuration الخاص بك عن طريق استدعاء AddAzureAppConfiguration الأسلوب في Program.cs الملف.

   معرف Microsoft Entra (مستحسن)

   يمكنك استخدام DefaultAzureCredential للمصادقة على متجر App Configuration. اتبع الإرشادات لتعيين بيانات الاعتماد الخاصة بك دور قارئ بيانات تكوين التطبيق. تأكد من السماح بوقت كاف للإذن للنشر قبل تشغيل التطبيق الخاص بك.

   var builder = new ConfigurationBuilder();
   builder.AddAzureAppConfiguration(options =>
   {
       string endpoint = Environment.GetEnvironmentVariable("Endpoint");
       options.Connect(new Uri(endpoint), new DefaultAzureCredential());
   });
   
   var config = builder.Build();
   Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");
   

   سلسلة الاتصال

   var builder = new ConfigurationBuilder();
   builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));
   
   var config = builder.Build();
   Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");
   

يوصى بإنشاء التطبيق وتشغيله محليًا

1. تعيين متغير بيئة.

   معرف Microsoft Entra (مستحسن)

   قم بتعيين متغير البيئة المسمى Endpoint إلى نقطة النهاية لمتجر App Configuration الموجود ضمن نظرة عامة على متجرك في مدخل Microsoft Azure.

   إذا كنت تستخدم موجه الأوامر Windows، فشغل الأمر التالي، ثم أعد تشغيل موجه الأوامر للسماح للتغيير بتنفيذ الأمر:

   setx Endpoint "<endpoint-of-your-app-configuration-store>"
   

   إذا كنت تستخدم PowerShell، فقم بتشغيل الأمر التالي:

   $Env:Endpoint = "<endpoint-of-your-app-configuration-store>"
   

   إذا كنت تستخدم macOS أو Linux، فقم بإجراء الأمر التالي:

   export Endpoint='<endpoint-of-your-app-configuration-store>'
   

   سلسلة الاتصال

   قم بتعيين متغير البيئة المسمى ConnectionString إلى سلسلة الاتصال للقراءة فقط لمتجر App Configuration الموجود ضمن مفاتيح الوصول لمتجرك في مدخل Microsoft Azure.

   إذا كنت تستخدم موجه الأوامر Windows، فشغل الأمر التالي، ثم أعد تشغيل موجه الأوامر للسماح للتغيير بتنفيذ الأمر:

   setx ConnectionString "<connection-string-of-your-app-configuration-store>"
   

   إذا كنت تستخدم PowerShell، فقم بتشغيل الأمر التالي:

   $Env:ConnectionString = "<connection-string-of-your-app-configuration-store>"
   

   إذا كنت تستخدم macOS أو Linux، فقم بإجراء الأمر التالي:

   export ConnectionString='<connection-string-of-your-app-configuration-store>'
   

2. يوصى بتشغيل الأمر التالي لإنشاء تطبيق وحدة التحكم:

   dotnet build
   

3. بعد إنجاز الإنشاء بنجاح، يُرجى تشغيل الأمر التالي لتشغيل التطبيق محليًا:

   dotnet run
   

   

تنظيف الموارد

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

هام

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

1. سجل الدخول إلى مدخل Microsoft Azure، وحدد Resource groups.
2. في المربع تصفية حسب الاسم ، أدخل اسم مجموعة الموارد الخاصة بك.
3. في قائمة النتائج، حدد اسم مجموعة الموارد لاستعراض نظرة عامة.
4. حدد Delete resource group.
5. يُطلب منك تأكيد حذف مجموعة الموارد. أدخل اسم مجموعة الموارد للتأكيد وحدد "Delete".

بعد بضع لحظات، يتم حذف مجموعة الموارد وكافة مواردها.

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

في هذا التشغيل السريع، قمت بإنشاء متجر App Configuration جديد واستخدامه مع تطبيق وحدة تحكم .NET عبر موفر App Configuration. لمعرفة كيفية تكوين تطبيق .NET لتحديث إعدادات التكوين ديناميكيا، تابع إلى البرنامج التعليمي التالي.

تمكين التكوين الديناميكي