التشغيل السريع: إنشاء تطبيق Python باستخدام تكوين تطبيق Azure

في هذا التشغيل السريع، ستستخدم موفر Python لتكوين تطبيق Azure لمركزية التخزين وإدارة إعدادات التطبيق باستخدام مكتبة عميل موفر Python لتكوين تطبيق Azure.

موفر Python App Configuration هو مكتبة تعمل أعلى Azure SDK ل Python، مما يساعد مطوري Python على استهلاك خدمة App Configuration بسهولة. يتيح استخدام إعدادات التكوين مثل القاموس.

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

• حساب Azure مع اشتراك نشط. أنشئ حسابًا مجانًا.
• متجر App Configuration، كما هو موضح في البرنامج التعليمي لإنشاء متجر.
• Python 3.8 أو إصدار أحدث - للحصول على معلومات حول إعداد Python على Windows، راجع Python على وثائق Windows

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

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

مفتاح	القيمة‬	تسمية	نوع المحتوى
رسالة	مرحبا	اتركه فارغًا	اتركه فارغًا
test.message	اختبار Hello	اتركه فارغًا	اتركه فارغًا
my_json	{"key":"value"}	اتركه فارغًا	application/json

تطبيقات وحدة التحكم

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

الاتصال ب App Configuration

1. إنشاء دليل جديد للمشروع المسمى app-configuration-quickstart.

   mkdir app-configuration-quickstart
   

2. التبديل إلى دليل "app-configuration-quickstart" الذي تم إنشاؤه حديثًا.

   cd app-configuration-quickstart
   

3. قم بتثبيت موفر Azure App Configuration باستخدام pip install الأمر .

   pip install azure-appconfiguration-provider
   

4. إنشاء ملف جديد يسمى app-configuration-quickstart.py في "app-configuration-quickstart" وإضافة التعليمة البرمجية التالية:

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

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

   from azure.appconfiguration.provider import (
       load,
       SettingSelector
   )
   from azure.identity import DefaultAzureCredential
   import os
   
   endpoint = os.environ.get("AZURE_APPCONFIG_ENDPOINT")
   
   # Connect to Azure App Configuration using Microsoft Entra ID.
   config = load(endpoint=endpoint, credential=credential)
   credential = DefaultAzureCredential()
   
   # Find the key "message" and print its value.
   print(config["message"])
   # Find the key "my_json" and print the value for "key" from the dictionary.
   print(config["my_json"]["key"])
   
   # Connect to Azure App Configuration using Entra ID and trimmed key prefixes.
   trimmed = {"test."}
   config = load(endpoint=endpoint, credential=credential, trim_prefixes=trimmed)
   # From the keys with trimmed prefixes, find a key with "message" and print its value.
   print(config["message"])
   
   # Connect to Azure App Configuration using SettingSelector.
   selects = {SettingSelector(key_filter="message*", label_filter="\0")}
   config = load(endpoint=endpoint, credential=credential, selects=selects)
   
   # Print True or False to indicate if "message" is found in Azure App Configuration.
   print("message found: " + str("message" in config))
   print("test.message found: " + str("test.message" in config))
   

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

   from azure.appconfiguration.provider import (
       load,
       SettingSelector
   )
   import os
   
   connection_string = os.environ.get("AZURE_APPCONFIG_CONNECTION_STRING")
   
   # Connect to Azure App Configuration using a connection string.
   config = load(connection_string=connection_string)
   
   # Find the key "message" and print its value.
   print(config["message"])
   # Find the key "my_json" and print the value for "key" from the dictionary.
   print(config["my_json"]["key"])
   
   # Connect to Azure App Configuration using a connection string and trimmed key prefixes.
   trimmed = {"test."}
   config = load(connection_string=connection_string, trim_prefixes=trimmed)
   # From the keys with trimmed prefixes, find a key with "message" and print its value.
   print(config["message"])
   
   # Connect to Azure App Configuration using SettingSelector.
   selects = {SettingSelector(key_filter="message*", label_filter="\0")}
   config = load(connection_string=connection_string, selects=selects)
   
   # Print True or False to indicate if "message" is found in Azure App Configuration.
   print("message found: " + str("message" in config))
   print("test.message found: " + str("test.message" in config))
   

شغّل التطبيق

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

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

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

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

   setx AZURE_APPCONFIG_ENDPOINT "endpoint-of-your-app-configuration-store"
   

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

   $Env:AZURE_APPCONFIG_ENDPOINT = "endpoint-of-your-app-configuration-store"
   

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

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

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

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

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

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

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

   $Env:AZURE_APPCONFIG_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
   

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

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

2. بعد تعيين متغير البيئة بشكل صحيح، قم بتشغيل الأمر التالي لتشغيل التطبيق محليا:

   python app-configuration-quickstart.py
   

   ينبغي أن تشاهد المخرج التالي:

   Hello
   value
   Hello test
   message found: True
   test.message found: False
   

تطبيقات الويب

يقوم موفر App Configuration بتحميل البيانات في كائن Mapping ، يمكن الوصول إليه كقاموس، والذي يمكن استخدامه بالاشتراك مع التكوين الحالي لإطارات عمل Python المختلفة. يوضح هذا القسم كيفية استخدام موفر App Configuration في أطر عمل الويب الشائعة مثل Flask و Django.

قارورة

يمكنك استخدام Azure App Configuration في تطبيقات الويب Flask الموجودة عن طريق تحديث التكوين المضمن. يمكنك القيام بذلك عن طريق تمرير كائن موفر App Configuration إلى update وظيفة مثيل تطبيق Flask في app.py:

azure_app_config = load(endpoint=os.environ.get("AZURE_APPCONFIG_ENDPOINT"), credential=credential)

# NOTE: This will override all existing configuration settings with the same key name.
app.config.update(azure_app_config)

# Access a configuration setting directly from within Flask configuration
message = app.config.get("message")

Django

يمكنك استخدام Azure App Configuration في تطبيقات ويب Django الموجودة عن طريق إضافة الأسطر التالية من التعليمات البرمجية إلى ملفك settings.py

AZURE_APPCONFIGURATION = load(endpoint=os.environ.get("AZURE_APPCONFIG_ENDPOINT"), credential=credential)

للوصول إلى إعدادات التكوين الفردية في طرق عرض Django، يمكنك الرجوع إليها من كائن الموفر الذي تم إنشاؤه في إعدادات Django. على سبيل المثال، في views.py:

# Import Django settings
from django.conf import settings

# Access a configuration setting from Django settings instance.
MESSAGE = settings.AZURE_APPCONFIGURATION.get("message")

يمكن العثور على نماذج التعليمات البرمجية الكاملة حول كيفية استخدام تكوين تطبيق Azure في تطبيقات ويب Python في مستودع GitHub لتكوين تطبيق Azure.

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

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

هام

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

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

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

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

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

للحصول على عينات تعليمات برمجية إضافية، قم بزيارة:

نموذج DjangoFlask نموذجموفر Python لتكوين تطبيق Azure