مشاركة عبر

المرجع: إعدادات تكوين Azure Arc للبوابة المستضافة ذاتيا

  • مقالة

ينطبق على: المطور | بريميوم

توفر هذه المقالة مرجعا للإعدادات المطلوبة والاختيارية المستخدمة لتكوين ملحق Azure Arc لحاوية البوابة المستضافة ذاتيا لإدارة واجهة برمجة التطبيقات.

هام

بوابة إدارة واجهة برمجة التطبيقات المستضافة ذاتيًا على Azure Arc حاليًا في المعاينة. أثناء المعاينة، يتوفر ملحق بوابة APIM في المناطق التالية:

  • آسيا (شرق وجنوب شرق)
  • أستراليا (وسط، وسط 2، شرق وجنوب شرق)
  • البرازيل (جنوب وجنوب شرق)
  • كندا (وسط وشرق)
  • أوروبا (الشمال والغرب)
  • فرنسا (وسط وجنوب)
  • ألمانيا (شمال وغرب وسط)
  • الهند (وسط وجنوب وغرب وجيو الوسطى وجيو الغربية)
  • اليابان (شرق وغرب)
  • كوريا (وسط وجنوب)
  • النرويج (شرق وغرب)
  • جنوب أفريقيا (الشمال والغرب)
  • السويد (وسط)
  • سويسرا (الشمال والغرب)
  • الإمارات العربية المتحدة (الإمارات العربية المتحدة - الوسط والشمال)
  • المملكة المتحدة (المملكة المتحدة - الجنوب)
  • الولايات المتحدة (الولايات المتحدة - وسط، وسط EUAP، شرق، شرق 2، شرق 2 EUAP، شمال وسط، جنوب وسط، وسط غرب، غرب، غرب 2، غرب 3)

تكامل واجهة برمجة تطبيقات التكوين

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

فيما يلي نظرة عامة على جميع خيارات التكوين:

Name ‏‏الوصف مطلوبة افتراضي
gateway.configuration.uri نقطة نهاية التكوين في APIM للبوابة المستضافة ذاتيًا. ابحث عن هذه القيمة في مدخل Microsoft Azure ضمن Gateways>Deployment. ‏‏نعم‬ غير متوفر
gateway.auth.token مفتاح المصادقة للمصادقة مع خدمة Azure API Management. يبدأ عادة ب GatewayKey. ‏‏نعم‬ غير متوفر
gateway.configuration.backup.enabled في حالة التمكين، سيتم تخزين نسخة احتياطية من أحدث تكوين تم تنزيله على وحدة تخزين false
gateway.configuration.backup.persistentVolumeClaim.accessMode وضع الوصول إلى جراب مطالبة وحدة التخزين الدائمة (PVC) ReadWriteMany
gateway.configuration.backup.persistentVolumeClaim.size حجم مطالبة وحدة التخزين الدائمة (PVC) التي سيتم إنشاؤها 50Mi
gateway.configuration.backup.persistentVolumeClaim.storageClassName اسم فئة التخزين الذي سيتم استخدامه لمطالبة وحدة التخزين الدائمة (PVC). عند عدم تعيين أي قيمة (null)، سيتم استخدام الإعداد الافتراضي للنظام الأساسي. يجب أن تدعم ReadWriteMany فئة التخزين المحددة وضع الوصول، وتعرف على المزيد حول موفري وحدة التخزين المدعومة وأوضاع الوصول المدعومة الخاصة بهم. null

اكتشاف ومزامنة عبر المثيلات

Name ‏‏الوصف مطلوبة افتراضي
service.instance.heartbeat.port منفذ UDP المستخدم لمثيلات نشر بوابة مستضافة ذاتيا لإرسال رسالة كشف أخطاء الاتصال إلى مثيلات أخرى. لا 4291
service.instance.synchronization.port منفذ UDP المستخدم لمثيلات البوابة المستضافة ذاتيا لمزامنة تحديد المعدل عبر مثيلات متعددة. لا 4290

المقاييس

Name ‏‏الوصف مطلوبة افتراضي
telemetry.metrics.cloud الإشارة إلى ما إذا كان يجب تمكين مقاييس الإرسال إلى Azure Monitor أم لا. لا true
telemetry.metrics.local تمكين جمع المقاييس المحلية من خلال StatsD. القيمة هي أحد الخيارات التالية: none، . statsd لا ‏‫غير متاح
telemetry.metrics.localStatsd.endpoint نقطة نهاية StatsD. نعم، إذا telemetry.metrics.local تمت المجموعة إلى statsd؛ وإلا لا. ‏‫غير متوفر‬
telemetry.metrics.localStatsd.sampling يحدد مقاييس معدل أخذ العينات. يجب أن تكون القيمة بين 0 و1، على سبيل المثال، 0.5. لا ‏‫غير متاح
telemetry.metrics.localStatsd.tagFormat تنسيق وضع العلامات على مصدر StatsD. القيمة هي أحد الخيارات التالية: ibrato، ، dogStatsD. influxDB لا ‏‫غير متاح
telemetry.metrics.opentelemetry.enabled الإشارة إلى ما إذا كان يجب تمكين تنبيهات المقاييس إلى مجمع OpenTelemetry على Kubernetes أم لا. لا false
telemetry.metrics.opentelemetry.collector.uri URI لجامع OpenTelemetry لإرسال المقاييس إليه. نعم، إذا observability.opentelemetry.enabled تمت المجموعة إلى true؛ وإلا لا. ‏‫غير متوفر‬

السجلات

Name ‏‏الوصف مطلوبة افتراضي
telemetry.logs.std تمكين التسجيل إلى دفق قياسي. القيمة هي أحد الخيارات التالية: none، ، text. json لا text
telemetry.logs.local تمكين التسجيل المحلي. القيمة هي أحد الخيارات التالية: none، auto، localsyslog، ، rfc5424، journaljson لا auto
telemetry.logs.localConfig.localsyslog.endpoint نقطة النهاية لسجلات النظام المحلية نعم إذا telemetry.logs.local تمت المجموعة إلى localsyslog؛ وإلا لا. ‏‫غير متوفر‬
telemetry.logs.localConfig.localsyslog.facility يحدد رمز مرفق syslog المحلي، على سبيل المثال، 7. لا ‏‫غير متاح
telemetry.logs.localConfig.rfc5424.endpoint نقطة نهاية rfc5424. نعم إذا telemetry.logs.local تمت المجموعة إلى rfc5424؛ وإلا لا. ‏‫غير متوفر‬
telemetry.logs.localConfig.rfc5424.facility رمز المرفق لكل rfc5424، على سبيل المثال، 7 لا ‏‫غير متاح
telemetry.logs.localConfig.journal.endpoint نقطة نهاية دفتر اليومية. نعم إذا telemetry.logs.local تمت المجموعة إلى journal؛ وإلا لا. ‏‫غير متوفر‬

توجيه حركة المرور

Name ‏‏الوصف مطلوبة افتراضي
service.type نوع خدمة Kubernetes لاستخدامها في الكشف عن البوابة. (مستندات) لا ClusterIP
service.http.port المنفذ المراد استخدامه لكشف حركة مرور HTTP. لا 8080
service.http.nodePort منفذ على العقدة لاستخدامها في الكشف عن حركة مرور HTTP. يتطلب NodePort ذلك كنوع خدمة. لا ‏‫غير متاح
service.https.port المنفذ المراد استخدامه لكشف حركة مرور HTTPS. لا 8081
service.https.nodePort منفذ على العقدة لاستخدامها في الكشف عن حركة مرور HTTPS. يتطلب NodePort ذلك كنوع خدمة. لا ‏‫غير متاح
service.annotations التعليقات التوضيحية لإضافتها إلى خدمة Kubernetes للبوابة. لا ‏‫غير متاح
ingress.annotations التعليقات التوضيحية لإضافتها إلى دخول Kubernetes للبوابة. (تجريبي) لا ‏‫غير متاح
ingress.enabled الإشارة إلى ما إذا كان يجب استخدام دخول Kubernetes أم لا. (تجريبي) لا false
ingress.tls تكوين TLS ل Kubernetes Ingress. (تجريبي) لا ‏‫غير متاح
ingress.hosts تكوين المضيفين لاستخدامها في دخول Kubernetes. (تجريبي) لا ‏‫غير متاح

‏‫عمليات تكامل‬

تتكامل البوابة المستضافة ذاتيا مع تقنيات أخرى مختلفة. يوفر هذا القسم نظرة عامة على خيارات التكوين المتوفرة التي يمكنك استخدامها.

Dapr

Name ‏‏الوصف مطلوبة افتراضي
dapr.enabled الإشارة إلى ما إذا كان يجب استخدام تكامل Dapr أم لا. لا false
dapr.app.id معرف التطبيق المراد استخدامه لتكامل Dapr بلا
dapr.config تحديد التكوين الذي يجب أن يستخدمه CRD Dapr tracing
dapr.logging.level مستوى إسهاب السجل ل Dapr sidecar info
dapr.logging.useJsonOutput الإشارة إلى ما إذا كان يجب أن يكون التسجيل بتنسيق JSON أم لا true

Azure Monitor

Name ‏‏الوصف مطلوبة افتراضي
monitoring.customResourceId معرف المورد لمساحة عمل Azure Log Analytics لإرسال السجلات إليها. لا ‏‫غير متاح
monitoring.ingestionKey مفتاح الاستيعاب للمصادقة مع مساحة عمل Azure Log Analytics لإرسال السجلات إليها. لا ‏‫غير متاح
monitoring.workspaceId معرف مساحة العمل لمساحة عمل Azure Log Analytics لإرسال السجلات إليها. لا ‏‫غير متاح

صورة وجدولة حمل العمل

Kubernetes هو منصة تزامن قوية تمنح الكثير من المرونة في ما يجب نشره وكيفية جدولته.

يوفر هذا القسم نظرة عامة على خيارات التكوين المتوفرة التي يمكنك استخدامها للتأثير على الصورة المستخدمة، وكيفية جدولتها وتكوينها للشفاء الذاتي.

Name ‏‏الوصف مطلوبة افتراضي
replicaCount عدد مثيلات البوابة المستضافة ذاتيا للتشغيل. لا 3
image.repository صورة للتشغيل. لا mcr.microsoft.com/azure-api-management/gateway
image.pullPolicy النهج الذي يجب استخدامه لسحب صور الحاوية. لا IfNotPresent
image.tag علامة صورة الحاوية لاستخدامها. لا يتم استخدام إصدار التطبيق من الملحق
imagePullSecrets سر Kubernetes لاستخدامه للمصادقة مع سجل الحاوية عند سحب صورة الحاوية. لا ‏‫غير متاح
probes.readiness.httpGet.path مسار URI لاستخدامه لفحوصات الجاهزية للحاوية لا /status-0123456789abcdef
probes.readiness.httpGet.port منفذ لاستخدامه في تحقيقات فعالية الحاوية لا http
probes.liveness.httpGet.path مسار URI لاستخدامه في تحقيقات فعالية الحاوية لا /status-0123456789abcdef
probes.liveness.httpGet.port منفذ لاستخدامه في تحقيقات فعالية الحاوية لا http
highAvailability.enabled الإشارة إلى ما إذا كان يجب جدولة البوابة عالية التوفر في نظام المجموعة أم لا. لا false
highAvailability.disruption.maximumUnavailable مقدار الحجيرات المسموح لها بأن تكون غير متوفرة بسبب الاضطرابات الطوعية. لا 25%
highAvailability.podTopologySpread.whenUnsatisfiable الإشارة إلى كيفية نشر الحجيرات عبر العقد في حالة تعذر استيفاء المتطلبات. تعرف على المزيد في مستندات Kubernetes لا ScheduleAnyway
resources القدرة على تعريف موارد وحدة المعالجة المركزية/الذاكرة لتعيينها إلى البوابة لا ‏‫غير متاح
nodeSelector القدرة على استخدام المحددات لتحديد العقدة التي يجب تشغيل البوابة عليها. لا ‏‫غير متاح
affinity ترابط جدولة الجراب (مستندات) لا ‏‫غير متاح
tolerations التفاوتات لجدولة الجراب (مستندات) لا ‏‫غير متاح

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