مشاركة عبر


Quickstart: إنشاء تطبيق بايثون باستخدام Azure Managed Redis

في هذا المقال، تتعلم كيفية استخدام ذاكرة تخزين مؤقت Azure Managed Redis مع لغة بايثون والاتصال باستخدام Microsoft Entra ID.

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

  • اشتراك Azure - إنشاء اشتراك مجاني
  • قم بتثبيت بيئة لغة Python 3.7+
  • أضف هذه الواردات من إلى مشروعك وإلى بيئة التطوير الخاصة بك
    • redis - عميل Redis Python
    • redis-entraid - ملحق مصادقة معرف Redis Microsoft Entra
    • azure-identity - مكتبة مصادقة Azure

إنشاء مثيل Azure Managed Redis

أولا، قم بإنشاء ذاكرة تخزين مؤقت. يمكنك إنشاء ذاكرة تخزين مؤقت باستخدام Azure Managed Redis أو Azure Cache for Redis باستخدام مدخل Microsoft Azure. في هذا التشغيل السريع، نستخدم Azure Managed Redis.

عند إنشاء ذاكرة التخزين المؤقت، يتم تمكين معرف Microsoft Entra افتراضيا مما يجعله آمنا من البداية. يجب أن تستخدم ذاكرة التخزين المؤقت أيضا نقطة نهاية عامة لهذا التشغيل السريع.

لإنشاء ذاكرة تخزين مؤقت باستخدام المدخل، اتبع أحد الإجراءات التالية:

اختياريا، يمكنك إنشاء ذاكرة تخزين مؤقت باستخدام Azure CLI وPowerShell، أيهما تفضل.

التعليمات البرمجية للاتصال بذاكرة التخزين المؤقت Redis

في الجزء الأول من نموذج التعليمات البرمجية، قم بتعيين اتصالك بذاكرة التخزين المؤقت.

  • منافذ Azure Managed Redis وذاكرة التخزين المؤقت للمؤسسة: 10000
  • منافذ Azure Cache لمثيلات Redis: 6380
import redis
from azure.identity import DefaultAzureCredential
from redis_entraid.cred_provider import create_from_default_azure_credential

redis_host = "<host-url>"
redis_port = 10000  # Managed Redis default port

credential_provider = create_from_default_azure_credential(
    ("https://redis.azure.com/.default",),
)

r = redis.Redis(
    host=redis_host,
    port=redis_port,
    ssl=True,
    decode_responses=True,
    credential_provider=credential_provider
)

قبل أن تتمكن من تشغيل هذا الرمز ، يجب عليك إضافة نفسك كمستخدم Redis إلى ذاكرة التخزين المؤقت.

يجب عليك أيضا تخويل الاتصال ب Azure من سطر الأوامر باستخدام سطر أوامر Azure أو سطر أوامر مطور Azure (azd).

يجب أيضا إضافة مستخدمين أو أساس نظام إلى ذاكرة التخزين المؤقت. أضف أي شخص قد يقوم بتشغيل البرنامج كمستخدم على ذاكرة التخزين المؤقت Redis.

والنتيجة تبدو كما يلي:

PING: True
GET: Hello from Azure Managed Redis!

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

import redis
from azure.identity import DefaultAzureCredential
from redis_entraid.cred_provider import create_from_default_azure_credential

redis_host = "<host-url>"
redis_port = 10000  # Managed Redis default port

credential_provider = create_from_default_azure_credential(
    ("https://redis.azure.com/.default",),
)

try:
    r = redis.Redis(
        host=redis_host,
        port=redis_port,
        ssl=True,
        decode_responses=True,
        credential_provider=credential_provider,
        socket_timeout=10,
        socket_connect_timeout=10
    )

    print("PING:", r.ping())
    r.set("Message", "Hello from Azure Managed Redis!")
    print("GET:", r.get("Message"))

except Exception as e:
    print(f"Error: {e}")
finally:
    if 'r' in locals():
        r.close()

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

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

وإلا، إذا انتهيت من الموارد، يمكنك حذف مجموعة موارد Azure التي قمت بإنشائها لتجنب الرسوم.

هام

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

لحذف مجموعة موارد

  1. سجل الدخول إلى مدخل Azure، وحدد "Resource groups".

  2. حدد مجموعة الموارد التي تريد حذفها.

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

    لقطة شاشة تعرض قائمة بمجموعات الموارد المراد حذفها في جزء العمل.

  3. حدد Delete resource group.

  4. يُطلب منك تأكيد حذف مجموعة الموارد. اكتب اسم مجموعة الموارد لتأكيده، واختر "Delete".

    لقطة شاشة تعرض نموذجا يتطلب اسم المورد لتأكيد الحذف.

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