التشغيل السريع: استخدام تكوين تطبيق Azure في Azure Container Apps

في هذا التشغيل السريع، ستستخدم Azure App Configuration في تطبيق يعمل في Azure Container Apps. بهذه الطريقة، يمكنك مركزية تخزين وإدارة تكوين تطبيقاتك في Container Apps. يستفيد هذا التشغيل السريع من تطبيق ASP.NET Core الذي تم إنشاؤه في التشغيل السريع: إنشاء تطبيق ASP.NET Core باستخدام App Configuration. ستقوم بتعبئة التطبيق في حاويات ونشره في Azure Container Apps. أكمل التشغيل السريع قبل المتابعة.

تلميح

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

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

• تطبيق يستخدم متجر App Configuration. إذا لم يكن لديك مثيل، فبادر بإنشاء مثيل باستخدام التشغيل السريع: إنشاء تطبيق ASP.NET Core باستخدام App Configuration.
• مثيل Azure Container Apps. إذا لم يكن لديك مثيل، قم بإنشاء مثيل باستخدام مدخل Microsoft Azure أو CLI.
• Docker Desktop
• واجهة Azure CLI

---

الاتصال Azure App Configuration إلى تطبيق الحاوية

في مدخل Microsoft Azure، انتقل إلى مثيل تطبيق الحاوية. اتبع التشغيل السريع Service الاتصال or لتطبيقات حاوية Azure لإنشاء اتصال خدمة مع متجر App Configuration باستخدام الإعدادات أدناه.

• في علامة التبويب Basics:

  • حدد تكوين التطبيق لنوع الخدمة

  • اختر متجر App Configuration الخاص بك ل "App Configuration"

    

• في علامة التبويب Authentication :

  • اختر نوع مصادقة سلسلة الاتصال ion والقراءة فقط ل "أذونات سلسلة الاتصال
  • توسيع القائمة خيارات متقدمة . في معلومات التكوين، يجب أن يكون هناك متغير بيئة تم إنشاؤه بالفعل يسمى "AZURE_APPCONFIGURATION_CONNECTIONSTRING". قم بتحرير متغير البيئة عن طريق تحديد الأيقونة على اليمين وتغيير الاسم إلى الاتصالionStrings__AppConfig. نحن بحاجة إلى إجراء هذا التغيير لأن الاتصالionStrings__AppConfig هو اسم متغير البيئة الذي سيبحث عنه التطبيق المضمن في التشغيل السريع ASP.NET Core. هذا هو متغير البيئة الذي يحتوي على سلسلة الاتصال لتكوين التطبيق. إذا كنت قد استخدمت تطبيقا آخر لمتابعة هذا التشغيل السريع، فالرجاء استخدام اسم متغير البيئة المقابل. ثم حدد تم.

• استخدم القيم الافتراضية لكل شيء آخر.

بمجرد الانتهاء، ستتم إضافة متغير بيئة يسمى الاتصالionStrings__AppConfig إلى حاوية تطبيق الحاوية. قيمته هي مرجع للبيانات السرية لتطبيق الحاوية، سلسلة الاتصال لمتجر App Configuration.

إنشاء حاوية

1. قم بتشغيل الأمر dotnet publish لإنشاء التطبيق في وضع الإصدار وإنشاء الأصول في المجلد المنشور.

   dotnet publish -c Release -o published
   

2. أنشئ ملفا باسم Dockerfile في الدليل الذي يحتوي على ملف .csproj، وافتحه في محرر نص، وأدخل المحتوى التالي. Dockerfile هو ملف نصي لا يحتوي على ملحق ويستخدم لإنشاء صورة حاوية.

   FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS runtime
   WORKDIR /app
   COPY published/ ./
   ENTRYPOINT ["dotnet", "TestAppConfig.dll"]
   

3. إنشاء الحاوية عن طريق تشغيل الأمر التالي.

   docker build --tag aspnetapp .
   

إنشاء مثيل Azure Container Registry

أنشئ سجل حاوية Azure (ACR). تمكنك ACR من إنشاء صور الحاوية وتخزينها وإدارتها.

المدخل

1. لإنشاء سجل الحاوية، اتبع التشغيل السريع ل Azure Container Registry.
2. بمجرد اكتمال النشر، افتح مثيل ACR ومن القائمة اليسرى، حدد الإعدادات > مفاتيح الوصول.
3. دون قيمة خادم تسجيل الدخول المدرجة في هذه الصفحة. ستستخدم هذه المعلومات في خطوة لاحقة.
4. قم بتبديل مسؤول المستخدم إلى ممكن. يتيح لك هذا الخيار توصيل ACR ب Azure Container Apps باستخدام بيانات اعتماد المستخدم المسؤول. بدلا من ذلك، يمكنك تركه معطلا وتكوين تطبيق الحاوية لسحب الصور من السجل بهوية مدارة.

Azure CLI

1. إنشاء مثيل ACR باستخدام الأمر التالي. يقوم بإنشاء سجل الطبقة الأساسية المسمى myregistry مع تمكين المستخدم المسؤول الذي يسمح لتطبيق الحاوية بالاتصال بالسجل باستخدام بيانات اعتماد المستخدم المسؤول. لمزيد من المعلومات، راجع التشغيل السريع ل Azure Container Registry.

   az acr create 
   --resource-group AppConfigTestResources \
   --name myregistry \
   --admin-enabled true \
   --sku Basic
   

2. في إخراج الأمر، لاحظ قيمة خادم تسجيل الدخول ACR المدرجة بعد loginServer.

3. استرداد اسم المستخدم وكلمة المرور ACR عن طريق تشغيل az acr credential show --name myregistry. ستحتاج هذه القيم لاحقًا.

ادفع الصورة لـ Azure Container Registry

ادفع صورة Docker إلى ACR الذي تم إنشاؤه مسبقا.

1. قم بتشغيل الأمر az acr login لتسجيل الدخول إلى السجل.

   az acr login --name myregistry
   

   يرجع Login Succeeded الأمر بمجرد نجاح تسجيل الدخول.

2. استخدم علامة docker لوضع علامة على التفاصيل المناسبة للصورة.

   docker tag aspnetapp myregistry.azurecr.io/aspnetapp:v1
   

   تلميح

   لمراجعة قائمة صور وعلامات docker الموجودة، قم بتشغيل docker image ls. في هذا السيناريو، يجب أن تشاهد صورتين على الأقل: aspnetapp و myregistry.azurecr.io/aspnetapp.

3. استخدم دفع docker لدفع الصورة إلى سجل الحاوية. ينشئ هذا المثال مستودع aspnetapp في ACR الذي يحتوي على aspnetapp الصورة. في المثال أدناه، استبدل العناصر النائبة <login-server، <image-name> وقيمة <tag> خادم تسجيل الدخول إلى ACR واسم الصورة وعلامة الصورة.

   الأسلوب

   docker push <login-server>/<image-name>:<tag>
   

   مثال:

   docker push myregistry.azurecr.io/aspnetapp:v1
   

4. افتح Azure Container Registry في مدخل Microsoft Azure وتأكد من أنه ضمن Repositories، يمكنك مشاهدة المستودع الجديد.

   

إضافة صورة الحاوية إلى Azure Container Apps

تحديث تطبيق الحاوية لتحميل صورة الحاوية من ACR الخاص بك.

1. في مدخل Microsoft Azure، افتح مثيل Azure Container Apps.

2. في القائمة اليسرى، ضمن Application، حدد Containers.

3. حدد تحرير ونشر.

4. ضمن صورة الحاوية، انقر فوق اسم صورة الحاوية الموجودة.

5. تحديث الإعدادات التالية:

   الإعدادات	القيمة المقترحة	‏‏الوصف
   مصدر الصورة	Azure Container Registry	حدد Azure Container Registry كمصدر صورتك.
   المصادقة	بيانات اعتماد مسؤول	استخدم خيار بيانات اعتماد المستخدم المسؤول الذي تم تمكينه مسبقا في سجل الحاوية. إذا لم تقم بتمكين المستخدم المسؤول ولكن تم تكوينه لاستخدام هوية مدارة، فستحتاج إلى إدخال الصورة والعلامة يدويا في النموذج.
   السجل	myregistry.azurecr.io	حدد Azure Container Registry الذي أنشأته سابقا.
   Image	aspnetapp	حدد صورة docker التي أنشأتها ودفعتها إلى ACR سابقا.
   علامة الصورة	v1	حدد علامة الصورة من القائمة.

6. حدد Save ثم Create لنشر التحديث إلى Azure Container App.

استعرض للوصول إلى عنوان URL لتطبيق حاوية Azure

في مدخل Microsoft Azure، في مثيل Azure Container Apps، انتقل إلى علامة التبويب Overview وافتح عنوان Url للتطبيق.

تبدو صفحة الويب كما يلي:

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

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

هام

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

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

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

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

في هذه البداية السريعة، قمت بـ:

• الاتصال Azure App Configuration إلى Azure Container Apps
• استخدم Docker لإنشاء صورة حاوية من تطبيق ASP.NET Core مع إعدادات App Configuration
• إنشاء مثيل Azure Container Registry
• دفع الصورة إلى مثيل Azure Container Registry
• تمت إضافة صورة الحاوية إلى Azure Container Apps
• تم استعراضه إلى عنوان URL لمثيل Azure Container Apps المحدث بالإعدادات التي قمت بتكوينها في متجر App Configuration.

تمكن الهوية المدارة مورد Azure من الوصول إلى مورد آخر دون الاحتفاظ بأسرار. يمكنك تبسيط الوصول من Container Apps إلى موارد Azure الأخرى. لمزيد من المعلومات، راجع كيفية الوصول إلى تكوين التطبيق باستخدام الهوية المدارة وكيفية [الوصول إلى سجل الحاوية باستخدام الهوية المدارة].

لمعرفة كيفية تكوين تطبيق الويب ASP.NET Core لتحديث إعدادات التكوين ديناميكيا، تابع البرنامج التعليمي التالي.

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