تخصيص تكوين الدخول في Azure Spring Apps

تنطبق هذه المقالة على: ✔️ Basic/Standard ✔️ Enterprise

توضح هذه المقالة كيفية تعيين إعدادات دخول التطبيق وتحديثها في Azure Spring Apps باستخدام مدخل Microsoft Azure وAzure CLI.

تستخدم خدمة Azure Spring Apps وحدة تحكم دخول أساسية للتعامل مع إدارة نسبة استخدام الشبكة للتطبيق. يتم دعم إعدادات الدخول التالية للتخصيص.

الاسم	إعداد الدخول	القيمة الافتراضية	نطاق صالح	‏‏الوصف
ingress-read-timeout	proxy-read-timeout	300	[1,1800]	المهلة بالثوان لقراءة استجابة من خادم مقتصد.
ingress-send-timeout	proxy-send-timeout	60	[1,1800]	المهلة بالثوان لإرسال طلب إلى الخادم proxied.
session-affinity	affinity	بلا	جلسة العمل، بلا	نوع الترابط الذي سيجعل الطلب يأتي إلى نفس النسخة المتماثلة للحجيرة التي كانت تستجيب للطلب السابق. قم بتعيين session-affinity إلى ملف تعريف الارتباط لتمكين ترابط الجلسة. في المدخل فقط، يجب عليك اختيار مربع تمكين ترابط الجلسة.
session-max-age	session-cookie-max-age	0	[0, 604800]	الوقت بالثوان حتى انتهاء صلاحية ملف تعريف الارتباط، المطابق Max-Age لتوجيه ملف تعريف الارتباط. إذا قمت بتعيين session-max-age إلى 0، تكون فترة انتهاء الصلاحية مساوية لفترة جلسة عمل المستعرض.
backend-protocol	backend-protocol	الإعداد الافتراضي	افتراضي، GRPC	تعيين بروتوكول الواجهة الخلفية للإشارة إلى كيفية اتصال NGINX بخدمة الواجهة الخلفية. الافتراضي يعني HTTP/HTTPS/WebSocket. backend-protocol ينطبق الإعداد فقط على نسبة استخدام الشبكة من عميل إلى تطبيق. بالنسبة لنسبة استخدام الشبكة من تطبيق إلى تطبيق داخل نفس مثيل الخدمة، اختر أي بروتوكول لنسبة استخدام الشبكة من تطبيق إلى تطبيق دون تعديل backend-protocol الإعداد. لا يقيد البروتوكول اختيارك للبروتوكول لنسبة استخدام الشبكة من تطبيق إلى تطبيق داخل نفس مثيل الخدمة.

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

• اشتراك Azure. في حال لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانيّاً قبل البدء.

• Azure CLI مع ملحق Azure Spring Apps. استخدم الأمر التالي لإزالة الإصدارات السابقة وتثبيت أحدث ملحق. إذا قمت مسبقا بتثبيت ملحق spring-cloud، قم بإلغاء تثبيته لتجنب عدم تطابق التكوين والإصدار.

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

تعيين تكوين الدخول

استخدم أمر Azure CLI التالي لتعيين تكوين الدخول عند الإنشاء.

az spring app create \
    --resource-group <resource-group-name> \
    --service <service-name> \
    --name <service-name> \
    --ingress-read-timeout 300 \
    --ingress-send-timeout 60 \
    --session-affinity Cookie \
    --session-max-age 1800 \
    --backend-protocol Default \

ينشئ هذا الأمر تطبيقا بالإعدادات التالية:

• مهلة قراءة الدخول: 300 ثانية
• مهلة إرسال الدخول: 60 ثانية
• ترابط الجلسة: ملف تعريف الارتباط
• الحد الأقصى لعمر ملف تعريف الارتباط للجلسة: 1800 ثانية
• بروتوكول الواجهة الخلفية: افتراضي

تحديث إعدادات الدخول لتطبيق موجود

مدخل Microsoft Azure

استخدم الخطوات التالية لتحديث إعدادات الدخول لتطبيق مستضاف بواسطة مثيل خدمة موجود.

1. سجّل الدخول إلى المدخل باستخدام حساب مرتبط باشتراك Azure الذي يحتوي على مثيل تطبيقات Azure Spring.

2. انتقل إلى جزء التطبيقات ، ثم حدد التطبيق الذي تريد تكوينه.

3. انتقل إلى جزء التكوين ، ثم حدد علامة التبويب إعدادات الدخول.

4. قم بتحديث إعدادات الدخول، ثم حدد حفظ.

   

Azure CLI

استخدم الأمر التالي لتحديث إعدادات الدخول لتطبيق موجود.

az spring app update \
    --resource-group <resource-group-name> \
    --service <service-name> \
    --name <service-name> \
    --ingress-read-timeout 600 \
    --ingress-send-timeout 600 \
    --session-affinity None \
    --session-max-age 0 \
    --backend-protocol GRPC \

يقوم هذا الأمر بتحديث التطبيق بالإعدادات التالية:

• مهلة قراءة الدخول: 600 ثانية
• مهلة إرسال الدخول: 600 ثانية
• ترابط الجلسة: لا شيء
• الحد الأقصى لعمر ملف تعريف الارتباط لجلسة العمل: 0
• بروتوكول الواجهة الخلفية: GRPC

الأسئلة المتداولة

• كيف يمكنك تمكين gRPC؟

  تعيين بروتوكول الخلفية إلى GRPC.

• كيف يمكنك تمكين WebSocket؟

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

  يمكنك أيضا استخدام RSocket استنادا إلى WebSocket.

• ما الفرق بين تكوين الدخول وإعدادات الدخول؟

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

• عند استخدام إعدادات الدخول مع App Gateway/APIM، ماذا يحدث عند تعيين المهلة في كل من دخول Azure Spring Apps وبوابة التطبيق/APIM؟

  يتم استخدام المهلة الأقصر.

• هل تحتاج إلى تكوين إضافي في App Gateway/APIM إذا كنت بحاجة إلى دعم شامل ل gRPC أو WebSocket؟

  لا تحتاج إلى تكوين إضافي طالما أن App Gateway تدعم gRPC.

• هل المنفذ القابل للتكوين مدعوم؟

  المنفذ القابل للتكوين غير مدعوم حاليا (80/443).

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

• وحدات تحكم الدخول
• وحدة تحكم دخول NGINX