دع الخدمات الصغيرة لا "تضيع" بعد الآن: مقتطفات التعليمات البرمجية الفعلية وقصص التطبيقات لبوابات API

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

لهذا السبب علينا أن نتحدث عن بوابات API.

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

كيف يبدو في الكود؟

مثال بسيط لتكوين توجيه البوابة

بافتراض أنك تستخدم Spring Cloud Gateway (وهو أمر شائع جدًا في نظام Java البيئي)، فقد يبدو تكوين التوجيه الأساسي كما يلي:

@Bean public RouteLocator customRouteLocator(RouteLocatorBuilder builder) { return builder.routes() .route("product_service", r -> r .path("/api/products/**") .filters(f -> f .addRequestHeader("X-Request-Source", "gateway") .circuitBreaker(config -> config .setName("productCB") .setFallbackUri("forward:/fallback/product"))) .uri("lb://PRODUCT-SERVICE")) .route("order_service"، r -> r .path("/api/orders/**") .uri("lb://ORDER-SERVICE")) .build(); }

ماذا يفعل هذا الرمز؟ يخبر البوابة: يتم إعادة توجيه جميع الطلبات التي تبدأ بـ /api/products/ إلى الخدمة المسماة PRODUCT-SERVICE. بالمناسبة، تتم إضافة رأس الطلب، ويتم تكوين قواطع الدائرة والتخفيضات - في حالة عدم قدرة خدمة المنتج على الاستجابة مؤقتًا، سيتم نقلها إلى الخطة الاحتياطية. يعد توجيه خدمة الطلب أبسط ويتم إعادة توجيهه مباشرة.

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

الفوائد حقيقية

قد يتساءل أحدهم: هل إضافة طبقة إضافية سيجعل النظام أبطأ؟ في الواقع، هناك دائمًا بعض الحمل مع رابط آخر. ولكن بالمقارنة مع الفوائد التي تجلبها، فإن التكلفة تستحق العناء في كثير من الأحيان.

على سبيل المثال، السلامة. بدلاً من تنفيذ التحقق من JWT بشكل متكرر في كل خدمة، اسمح للبوابة بالتعامل معها بشكل موحد:

# مثال تكوين لمرشحات مرشح البوابة: - الاسم: JwtAuthFilter args: SecretKey: "your-secret-key-here" ExceptPaths: - "/api/public/login" - "/health"

الآن، باستثناء الواجهتين العامتين لتسجيل الدخول والتحقق من الصحة، يجب على جميع الطلبات الأخرى اجتياز التحقق من الرمز المميز أولاً. عندما تريد تعديل قواعد التحقق، ما عليك سوى تغيير هذا المكان.

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

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

ما الذي يجب الانتباه إليه عند الاختيار؟

هناك العديد من الخيارات لبوابات API في السوق. كيف تختار؟ لا أعتقد أنك بحاجة لمتابعة الوظائف الأكثر اكتمالا. المفتاح هو ما إذا كانت هذه الأشياء مريحة:

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

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

بعض الاعتبارات أثناء النشر الفعلي

الحديث على الورق هو في النهاية سطحي. لاستخدامه فعليًا، عليك التفكير في بعض التفاصيل مقدمًا.

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

يحتاج التسجيل أيضًا إلى التصميم بعناية. ما هي السجلات التي يجب أن تحتفظ بها البوابة؟ سيؤثر الكثير على الأداء، والقليل جدًا سيضر باستكشاف الأخطاء وإصلاحها. عادة ما تكون البيانات التعريفية للطلب والاستجابة (الوقت، المسار، رمز الحالة، عنوان IP للعميل) ضرورية، ولكن بالنسبة للمحتوى الكبير المحتمل مثل نص الطلب، عليك الاختيار بعناية، ربما فقط تسجيل نص الطلب لمسار معين، أو عينة السجل فقط.

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

كن صادقا

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

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

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

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