Manage Azure Functions in Azure Container Apps

يمكنك إدارة الوظائف المنتشرة داخل Azure Container Apps باستخدام Azure CLI. تساعدك الأوامر التالية في سرد وفحص والتفاعل مع الوظائف التي تعمل في بيئة الحاويات الخاصة بك.

‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫ملاحظة

عند التعامل مع سيناريوهات التعديلات المتعددة، أضف المعلمة --revision <REVISION_NAME> إلى أمرك لاستهداف نسخة محددة.

دالات القائمة

عرض جميع الوظائف المنشورة في تطبيق الحاوية الخاص بك:

# List all functions
az containerapp function list \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME

تفاصيل وظيفة العرض

احصل على معلومات مفصلة عن وظيفة معينة:

az containerapp function show \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME \
  --function-name <FUNCTIONS_APP_NAME>

مراقبة استدعاءات الدوال

مراقبة تطبيق الوظائف الخاص بك أمر ضروري لفهم أدائه وتشخيص المشاكل. الأوامر التالية توضح لك كيفية استرجاع عناوين URLs للوظائف، وتفعيل الاستدعاءات، وعرض ملخصات تفصيلية للبيانات والاستدعاء باستخدام واجهة الأزرق (Azure CLI). قبل استدعاء التتبعات، استدعي الدالة عدة مرات باستخدام curl -X POST "fqdn/api/HttpExample".

1. لعرض مسارات الاستدعاء، احصل على مسارات تفصيلية لاستدعاءات الدال:

   az containerapp function invocations traces \
     --name $CONTAINERAPP_NAME \
     --resource-group $RESOURCE_GROUP \
     --function-name <FUNCTIONS_APP_NAME> \
     --timespan 5h \
     --limit 3
   

2. شاهد ملخص الاستدعاء لمراجعة الدعوات الناجحة والفاشلة.

   az containerapp function invocations summary \
     --name $CONTAINERAPP_NAME \
     --resource-group $RESOURCE_GROUP \
     --function-name <FUNCTIONS_APP_NAME> \
     --timespan 5h
   

إدارة مفاتيح الوظائف

يستخدم Azure Functions المفاتيح للمصادقة والتفويض. يمكنك إدارة أنواع المفاتيح المختلفة التالية:

• مفاتيح المضيف: الوصول إلى أي وظيفة في التطبيق
• المفاتيح الرئيسية: توفير وصول إداري
• مفاتيح النظام: تستخدمها خدمات Azure
• مفاتيح الوظائف: الوصول إلى وظائف محددة

الأوامر التالية توضح لك كيفية إدارة المفاتيح للمضيف. لتشغيل نفس الأمر لتطبيق وظائف معين، أضف المعامل --function-name <FUNCTIONS_APP_NAME> إلى أمرك.

سرد المفاتيح

استخدم الأوامر التالية لإدراج المفاتيح على مستوى المضيف والوظيفة الخاصة بوظائف Azure التي تعمل في تطبيقات الحاويات.

‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫ملاحظة

احتفظ بتشغيل نسخة واحدة على الأقل حتى تعمل أوامر إدارة المفاتيح التالية.

az containerapp function keys list \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME \
  --key-type hostKey

أظهر مفتاحا محددا

اعرض قيمة مفتاح معين على مستوى المضيف لتطبيق الوظائف باستخدام الأمر التالي:

az containerapp function keys show \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME \
  --key-name <KEY_NAME> \
  --key-type hostKey

اضبط مفتاحا

قم بتعيين مفتاح مستوى المضيف الخاص بتطبيق الوظائف باستخدام الأمر التالي:

az containerapp function keys set \
  --resource-group $RESOURCE_GROUP \
  --name $CONTAINERAPP_NAME \
  --key-name <KEY_NAME> \
  --key-value <KEY_VALUE> \
  --key-type hostKey

إدارة المفاتيح مع Azure Key Vault

عندما تستخدم Azure Key Vault لتخزين الأسرار الخاصة بوظائف Azure على تطبيقات الحاويات، يعمل توليد المفاتيح بشكل مختلف عن استضافة الوظائف التقليدية.

بشكل افتراضي:

• مضيف الوظائف لا يقوم تلقائيا بإنشاء المفاتيح في Key Vault عند التشغيل.

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

• يبدأ مضيف الوظائف بنجاح حتى بدون مفاتيح، وتكتمل مزامنة المفاتيح بشكل طبيعي.

نتيجة لذلك، يعمل تطبيقك بشكل صحيح، لكن مفاتيح مستوى المضيف لا تظهر في Key Vault إلا إذا أنشأتها يدويا.

توليد المفاتيح يدويا

لتفعيل إنشاء المفتاح في Azure Key Vault، استدعي نقطة نهاية إدارة الوظائف باستخدام أمر CLI التالي.

az containerapp function keys list \
 -n <CONTAINER_APP_NAME> \
 -g <RESOURCE_GROUP> \
 --key-type hostKey

المحتوى ذو الصلة

• نظرة عامة على Azure Functions على Azure Container Apps