OpenChoreo منصة المطورين Kubernetes: يقدّم مستودع openchoreo/openchoreo نفسه على أنه «a complete, open-source developer platform for Kubernetes». يستهدف الفرق التي تبني منصتها الداخلية (IDP) بجمع بوابة وCI وGitOps وقابلية الملاحظة. ينشر المشروع بترخيص Apache 2.0، وبحسب README هو مشروع ضمن «CNCF Sandbox» التابع لمؤسسة CNCF.
يوضح README أن شركة WSO2 طوّرت OpenChoreo انطلاقًا من خبرتها مع منصة Choreo السحابية (SaaS)، وأنه إعادة كتابة كاملة وليس fork. وبالنسبة لمهندس SRE تتلخص الفائدة في فكرة واحدة: تُعرض السجلات والمقاييس والتتبعات «من خلال المفاهيم التي يفهمها مطوروك أصلًا» (المكوّن والمشروع والبيئة). ماذا يحتوي المستودع، وكيف تجربه، وما الذي يمكن مراقبته؟
توضيح للأمانة: لم تثبّت span.observer أداة OpenChoreo ولم تشغّلها. الأوامر والملفات المذكورة مأخوذة من README ومن مجلد samples/ في المستودع ومن الوثائق الرسمية على openchoreo.dev، وقد قُرئت في 5 نوفمبر 2026. اللقطات أدناه تعيد إنتاج هذه النصوص. لم نتمكن من إعادة قراءة عدد النجوم من المصدر في ذلك اليوم، لذلك لا نذكره.
OpenChoreo منصة المطورين Kubernetes: ماذا يقول المستودع
- الترخيص: ملف LICENSE هو نص Apache License 2.0، ويؤكد README عبارة «Apache 2.0».
- الإصدار: يشير ملف
VERSIONفي الفرع الرئيسي إلى1.4.0-m.2، وهو إصدار وسيط («milestone»). أدلة التثبيت في الوثائق تستهدف الإصدارv1.3.3، وهو ما نعتمده. - بنية الطبقات: يصف README طبقة التجربة (بوابة Backstage وواجهة CLI وGitOps ووكلاء الذكاء الاصطناعي)، وطبقة تحكم تترجم المفاهيم المجرّدة إلى موارد Kubernetes، وطبقة بيانات تعمل فيها الأحمال، وطبقة قابلية الملاحظة، وطبقة CI اختيارية قائمة على Buildpacks وArgo Workflows.
- المفاهيم المجرّدة: يتعامل المطورون مع المكوّنات (components) ونقاط النهاية (endpoints) والتبعيات؛ وتعرّف فرق المنصة أنواع المكوّنات و«السمات» (traits) وسير العمل (workflows) عبر موارد Kubernetes (CRD)، دون وحدة تحكم مخصصة.
نقطة مفيدة أخرى: تنظّم الوثائق المفاهيم في أربع صفحات: مفاهيم المطورين، ومفاهيم المنصة، ونموذج التنفيذ، والعلاقات بين الموارد.
التثبيت خطوة بخطوة (تجربة محلية)
تتبع هذه الخطوات دليل «on k3d locally» في الوثائق الرسمية. تنشئ عنقود Kubernetes محليًا داخل Docker: هذه تجربة وليست تثبيتًا للإنتاج.
الخطوة 1: التحقق من المتطلبات
تطلب الوثائق Docker بالإصدار v26 أو أحدث (مع 8 GB من الذاكرة و4 معالجات)، وk3d بالإصدار v5.8 أو أحدث، وkubectl بالإصدار v1.34 أو أحدث، وHelm بالإصدار v3.12 أو أحدث. وتقترح التحقق منها بالأوامر الأربعة الظاهرة في اللقطة أدناه.
الخطوة 2: تشغيل التثبيت بأمر واحد
ينشئ السكربت العنقود ويثبّت الطبقات الأربع. يضيف الخيار --with-build طبقة سير العمل (CI)، ويضيف --with-observability طبقة قابلية الملاحظة.

يقدّم الدليل أيضًا تثبيتًا خطوة بخطوة عبر Helm لفهم كل مكوّن. وهناك بديل أقصر: يشغّل دليل البدء السريع حاوية تطوير (ghcr.io/openchoreo/quick-start:v1.3.3) ثم ينفّذ داخلها ./install.sh --version v1.3.3؛ ويمكن إضافة --with-build --with-observability بالطريقة نفسها.
الخطوة 3: فتح البوابة
تُقدَّم بوابة Backstage على http://openchoreo.localhost:8080؛ ويستجيب Observer على http://observer.openchoreo.localhost:11080، وحركة التطبيقات المنشورة على المنفذ 19080. بيانات الاعتماد الافتراضية للتجربة مذكورة في الوثائق: لا تعد استخدامها أبدًا خارج جهاز محلي.
قابلية ملاحظة الخدمات: ماذا تصف الوثائق
يثبّت دليل التثبيت طبقة قابلية الملاحظة عبر عدة charts من Helm: وحدة للسجلات ووحدة للتتبعات تعتمدان على OpenSearch، ووحدة للمقاييس تعتمد على Prometheus، وFluent Bit لجمع السجلات، وجامع OpenTelemetry لأحداث Kubernetes. وتُصدَّر هذه الأخيرة إلى فهرس OpenSearch باسم k8s-events.
الطبقة معيارية. تشرح صفحة «tracing adapter API» أن Observer يستعلم من محوّل (adapter) لقراءة التتبعات والـ spans وتفاصيل كل span؛ والواجهة الخلفية هي التي توفرها الوحدة. لا تذكر الوثائق في هذه الصفحة واجهة خلفية أخرى غير تلك المثبّتة، فلا تفترض وجود غيرها.
تنبيهات معرّفة ككود
بحسب الوثائق، يربط المطورون قاعدة تنبيه بمكوّن على شكل سمة (observability-alert-rule). يعتمد الشرط على نافذة زمنية وفاصل وعامل مقارنة (gt وlt وgte وlte وeq) وعتبة. والمصدر نمط في السجلات أو مقياس موارد؛ ويذكر مثال المستودع cpu_usage وmemory_usage.

يطلق هذا المثال تنبيهًا حرجًا إذا ظهر الخطأ أكثر من خمس مرات خلال خمس دقائق، مع تقييم كل دقيقة. وهذا هو منطق مؤشر SLI قائم على معدل الأخطاء؛ ولتأطيره راجع مسار SLO وSLA.
قنوات الإشعار
تخرج التنبيهات عبر قناة لكل بيئة، من نوع بريد إلكتروني (SMTP) أو webhook. أول قناة تُنشأ في بيئة ما تصبح القناة الافتراضية، بحسب الوثائق. المقطع التالي مأخوذ من ملف المثال؛ وعنوان webhook مثال يجب استبداله.

وكيل لتحليل السبب الجذري
يحتوي المستودع أيضًا على وكيل RCA. بحسب README، يتلقى تنبيهًا عبر REST API، ويحقق بحلقة ReAct عبر خادمي MCP (قابلية الملاحظة وموارد OpenChoreo)، ويُنتج تقريرًا منظمًا. ولا تُتاح له إلا مجموعة أدوات للقراءة فقط. ولتقييم هذا النوع من الوكلاء في الإنتاج، اقرأ ضوابط أمان وكلاء الذكاء الاصطناعي وتأمين خادم MCP.
الحدود والنقاط المفتوحة
- ثِقل الحزمة: يجمع التثبيت الكامل Gateway API وcert-manager وExternal Secrets وخزنة OpenBao ومزوّد هوية وOpenSearch وPrometheus. احسب وقت التشغيل لا وقت التثبيت فقط.
- تجربة محلية: تستخدم أمثلة الوثائق بيانات اعتماد افتراضية، وقد ضُبط جامع الأحداث على
insecure_skip_verify: trueباتجاه OpenSearch. هذه الإعدادات لا تصلح للإنتاج. - وتيرة التغيير: الفرع الرئيسي على إصدار وسيط 1.4.0؛ ويذكر سجل التغييرات مثلًا خطوط الإصدار («release lines») وإدارة أسرار طبقة قابلية الملاحظة. أعد قراءة ملاحظات الإصدار قبل كل ترقية.
- قياس التطبيقات (instrumentation): لم نقرأ صفحة تصف كيف يرسل تطبيق تتبعاته إلى طبقة قابلية الملاحظة. هذه النقطة غير مؤكدة؛ راجع الوثائق قبل أن تَعِد بها فريقًا.
- Dynatrace: لا يوثّق المشروع أي تكامل مع Dynatrace، ونحن لا نختلقه.
مراقبة المنصة نفسها
المنصة الداخلية خدمة كغيرها: إذا سقطت طبقة التحكم لم يعد أحد قادرًا على النشر. تصف وثائق OpenChoreo قابلية ملاحظة الأحمال المنشورة؛ أما المنصة نفسها فيبقى عليك مراقبة مكوّنات Kubernetes التي تحملها. إليك اقتراحات عامة وليست خاصة بالمشروع:
- التوافر: راقب عمليات النشر في فضاءات الأسماء
openchoreo-control-planeوopenchoreo-data-planeوopenchoreo-observability-planeالتي ينشئها التثبيت، عبر تنبيهات على الـ pods والحصص. - المقاييس: إذا كان في عنقودك Prometheus أصلًا، فاطلع على كيفية ربط Prometheus بـ Dynatrace؛ والمبدأ يصلح لأي واجهة خلفية لقابلية الملاحظة.
- إشارات OpenTelemetry: جامع الأحداث في التثبيت هو جامع OpenTelemetry؛ وملاحظاتنا حول مكوّنات Collector contrib تساعد على قراءة هذا النوع من الإعدادات.
مقال مجاور في السلسلة: Jan، البديل المفتوح المصدر لـ ChatGPT، وهو مشروع آخر قُرئ بالطريقة نفسها.
أفضل الممارسات
- جرّب أولًا على k3d مع طبقة قابلية الملاحظة، ثم قارن بحزمتك الحالية قبل أي ترحيل.
- احتفظ بقواعد التنبيه في Git مثل بقية الموارد، واربط كل عتبة بـ SLO.
- استبدل جميع بيانات الاعتماد والأسرار التجريبية؛ واستخدم خزنة الأسرار المقررة بدل القيم الصريحة.
- ثبّت إصدارات الـ charts، كما تفعل الوثائق بالخيار
--version. - اقصر أدوات MCP الخاصة بالوكلاء على القراءة فقط، كما يفعل وكيل RCA في المستودع.
الأسئلة الشائعة
هل يحل OpenChoreo محل Backstage؟
لا: يصف README بوابة «Backstage-powered». يقدّم OpenChoreo المفاهيم المجرّدة وطبقة التحكم وCI وGitOps وقابلية الملاحظة حول هذه البوابة.
هل يجب تثبيت طبقة قابلية الملاحظة؟
هي اختيارية بحسب الوثائق: يضيفها الخيار --with-observability. لذلك يجب تفعيلها للحصول على السجلات والمقاييس والتتبعات الموصوفة أعلاه.
ما الترخيص ومن يتولى صيانة المشروع؟
الكود بترخيص Apache 2.0. يشير README إلى تطوير أولي من WSO2 وإلى وضع مشروع CNCF Sandbox؛ أعد قراءة صفحة الحوكمة في المستودع (GOVERNANCE.md) قبل أي قرار في المؤسسة.
الخلاصة
يقترح OpenChoreo منصة تطوير متكاملة لـ Kubernetes، مع قابلية ملاحظة مدمجة وتنبيهات معرّفة بصيغة YAML. يبدو المشروع نشطًا، لكن التثبيت ثقيل وتبقى نقاط عدة تحتاج إلى التحقق في الوثائق: قياس التطبيقات والتشغيل على المدى الطويل. جرّبه محليًا، وقِس ما يحل محله في سلسلتك، ثم قرّر.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لـ OpenChoreo ولا لشركة WSO2 ولا لشركة Dynatrace LLC. العلامات المذكورة تعود إلى مالكيها. الأدوات تتطور بسرعة: تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.