مشاركة عبر

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

  • مقالة

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

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

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

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

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

مفتاح القيمة‬ تسمية نوع المحتوى
رسالة Hello اتركه فارغًا اتركه فارغًا
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" وإضافة التعليمة البرمجية التالية:

    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. قم بتعيين متغير بيئة يسمى AZURE_APPCONFIG_CONNECTION_STRING، وقم بتعيينه إلى سلسلة الاتصال لمتجر App Configuration. في سطر الأوامر، يوصى بتشغيل الأمر التالي:

    لتشغيل التطبيق محليا باستخدام موجه أوامر Windows، قم بتشغيل الأمر التالي واستبدل <app-configuration-store-connection-string> سلسلة الاتصال لمتجر تكوين التطبيق:

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

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

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

    echo %AZURE_APPCONFIG_CONNECTION_STRING%

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

    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(connection_string=os.environ.get("AZURE_APPCONFIG_CONNECTION_STRING"))

# 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")

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

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

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

هام

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

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

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

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

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

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

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