Argo CD GitOps Kubernetes: يقدّم مستودع argoproj/argo-cd نفسه على أنه «a declarative GitOps continuous delivery tool for Kubernetes»، أي أداة تسليم مستمر تصريحية بنهج GitOps لـ Kubernetes. يختصر ملف README مبدأه في جملتين: يجب أن تكون تعريفات التطبيقات والبيئات تصريحية وخاضعة لإدارة الإصدارات، ويجب أن يكون نشرها آليًا وقابلًا للتدقيق وسهل الفهم. يُنشر المشروع بترخيص Apache 2.0.
بالنسبة لمهندس SRE أو فريق المنصة، يجيب Argo CD عن سؤال بسيط: هل ما يعمل في العنقود (cluster) هو ما يصفه Git؟ تقارن وحدة التحكم باستمرار الحالة الفعلية بالحالة المطلوبة. كما تعرض مقاييس Prometheus ويمكنها تصدير تتبعات OpenTelemetry. سنرى ما يقوله المستودع، وكيف يُثبَّت، وكيف نراقب عملية النشر نفسها.
توضيح للأمانة: لم تثبّت span.observer أداة Argo CD ولم تشغّلها. الأوامر والإعدادات مأخوذة من README ومن مجلد docs/ في المستودع (الفرع الرئيسي) ومن الوثائق الرسمية، وقد قُرئت في 5 نوفمبر 2026. تعيد اللقطات إنتاج هذه النصوص. لم نستطع إعادة قراءة عدد النجوم من المصدر في ذلك اليوم، لذلك لا نذكره، ولا نذكر آخر إصدار منشور.
Argo CD GitOps Kubernetes: ما يقوله المستودع
- الترخيص: ملف LICENSE هو ملف Apache License 2.0، مع عبارة «Copyright 2017-2018 The Argo Authors».
- الغرض: أداة تسليم مستمر تصريحية لـ Kubernetes. يحيل README إلى الوثائق الكاملة على argo-cd.readthedocs.io وإلى عرض تجريبي على الإنترنت وإلى القائمة الرسمية للمستخدمين (
USERS.md). - الإصدار: يحمل ملف
VERSIONفي الفرع الرئيسي القيمة 3.7.0. هذا هو الإصدار قيد التطوير، وليس بالضرورة آخر إصدار منشور.
تصف صفحة «Architectural Overview» ثلاثة مكوّنات. يخدم خادم API الواجهة الرسومية وأداة CLI وأنظمة CI/CD. يخزّن repo server مستودع Git مؤقتًا ويولّد ملفات manifest. وتكتشف وحدة التحكم في التطبيقات الحالة OutOfSync ويمكنها تصحيحها.
المفاهيم التي يجب معرفتها قبل البدء
تحدّد صفحة «Core Concepts» المفردات المفيدة لما يلي:
- Target state: الحالة المطلوبة، ممثَّلة بملفات في Git.
- Live state: ما هو منشور فعليًا (pods وموارد أخرى).
- Sync status: هل الحالة الفعلية مطابقة لما في Git؟
- Sync operation status: هل نجحت آخر مزامنة؟
- Health: هل يعمل التطبيق بشكل سليم وهل يستطيع خدمة الطلبات؟
هذه الحالات الثلاث المنفصلة (المزامنة والعملية والصحة) هي أساس أي مراقبة. قد يكون النشر Synced ومع ذلك في حالة صحية سيئة.
التثبيت خطوة بخطوة
تجمع اللقطة التالية أوامر دليل «Getting Started» ومخرجات المثال لأمر argocd app get بعد اختصارها (حُذف السطران URL وTarget). وهي تُظهر الحالتين OutOfSync وMissing: التطبيق معرَّف لكن لم يُنشر شيء بعد.

الخطوة 1: تثبيت Argo CD
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
يشرح الدليل أن الخيار --server-side ضروري لأن بعض تعريفات CRD (مثل ApplicationSet) تتجاوز حدّ 262 كيلوبايت للتعليقات التوضيحية (annotations) الذي يفرضه kubectl apply من جهة العميل. ويوصي أيضًا، في بيئة الإنتاج، بتثبيت إصدار محدد (يذكر v3.2.0 مثالًا) بدلًا من الفرع stable. تحتوي ملفات manifest على ClusterRoleBinding تشير إلى مساحة الأسماء argocd: عدّلها إذا غيّرت مساحة الأسماء.
الخطوة 2: الوصول إلى الواجهة وتسجيل الدخول
افتراضيًا، لا يُعرض Argo CD خارج العنقود. يقترح الدليل خدمة من النوع LoadBalancer أو Ingress أو port-forward بسيطًا:
kubectl port-forward svc/argocd-server -n argocd 8080:443
argocd admin initial-password -n argocd
argocd login <ARGOCD_SERVER>
تُخزَّن كلمة المرور الأولية للحساب admin كنص صريح في السر argocd-initial-admin-secret. تطلب الوثائق حذف هذا السر بعد تغيير كلمة المرور (argocd account update-password).
الخطوة 3: إنشاء تطبيق ومزامنته
argocd app create guestbook --repo https://github.com/argoproj/argocd-example-apps.git --path guestbook --dest-server https://kubernetes.default.svc --dest-namespace default
argocd app get guestbook
يكون التطبيق في البداية OutOfSync لأنه لا يوجد أي مورد بعد. تنشر المزامنة (argocd app sync guestbook في الدليل) الموارد وتنقل الحالة إلى Synced. ولاستهداف عنقود غير عنقود Argo CD، ينشئ الأمر argocd cluster add CONTEXTNAME حساب خدمة argocd-manager مرتبطًا، بحسب الوثائق، بدور ClusterRole بصلاحيات المسؤول.
مراقبة Argo CD والنشر
هنا يصبح المشروع مهمًا للموثوقية. تشير صفحة «Observability» إلى أن المكوّنات تعرض مقاييس Prometheus ويمكنها تصدير تتبعات OpenTelemetry.
مقاييس Prometheus
تسرد صفحة «Metrics» نقاط الوصول: argocd-metrics:8082/metrics لوحدة التحكم في التطبيقات، وargocd-server-metrics:8083/metrics لخادم API، وargocd-repo-server:8084/metrics لـ repo server. ومن مقاييس وحدة التحكم:
argocd_app_info: مقياس لحظي (gauge) تتضمن وسومهsync_statusوhealth_status؛argocd_app_sync_total: عدّاد لسجل المزامنات، مع الوسمphase(Error وFailed وRunning وSucceeded وTerminating)؛argocd_app_reconcile: مدرّج تكراري (histogram) لمدة المطابقة، بالثواني؛argocd_git_fetch_fail_total(في repo server): إخفاقات جلب البيانات من Git.
مع Prometheus Operator، توفّر الوثائق مورد ServiceMonitor يلزم تكييفه (مساحة الأسماء والوسم release):

فكرتان لتنبيهين تحتاجان إلى تكييف واختبار في بيئتك (لم تنفذهما span.observer):
argocd_app_info{sync_status!="Synced"}
increase(argocd_app_sync_total{phase!="Succeeded"}[1h]) > 0
يشير الأول إلى انحراف بين Git والعنقود. ويشير الثاني إلى مزامنات فاشلة. اربطهما بهدف مستوى خدمة (SLO) للتسليم، مثل نسبة الوقت التي تبقى فيها التطبيقات الحرجة Synced. ولربط هذه المقاييس بـ Dynatrace، راجع جمع مقاييس Prometheus على Kubernetes.
تتبعات OpenTelemetry
بحسب وثائق الفرع الرئيسي، يصدّر خادم API ووحدة التحكم في التطبيقات وrepo server والحاوية الجانبية (sidecar) للإضافات تتبعات عبر OTLP/gRPC. وقيم service.name لديها هي argocd-server وargocd-controller وargocd-repo-server وargocd-cmp-server. تحمل استدعاءات gRPC بين المكوّنات سياق W3C: فالمطابقة التي تطلقها وحدة التحكم وتوليد ملفات manifest في repo server يشكّلان تتبعًا واحدًا. يُضبط ذلك كله في ConfigMap باسم argocd-cmd-params-cm:

الأسطر الحاسمة: otlp.address يفعّل التصدير (إذا كان فارغًا يُعطَّل التتبع)، وotlp.insecure قيمته الافتراضية "true" (نص غير مشفّر)، وotlp.sample.ratio يحدّد نسبة التتبعات المسجَّلة. يتبع أخذ العينات التتبع الأصل: التتبع الذي تبدأه وحدة التحكم يُسجَّل كاملًا أو لا يُسجَّل إطلاقًا. أعد تشغيل المكوّنات بعد التعديل.
تصف الصفحة نفسها إرسال المقاييس عبر OTLP (otlp.metrics.enabled، والفاصل الافتراضي 30 ثانية). انتبه: يظهر هذا الخيار في وثائق الفرع الرئيسي، ولم تذكره صفحة «stable» التي قُرئت في ذلك اليوم. تحقق من وجوده في إصدارك. وإذا كان Collector يجمع /metrics أصلًا، فإن تفعيله يضاعف كل سلسلة.
وماذا عن Dynatrace؟
لا يوثّق Argo CD أي تكامل خاص مع Dynatrace، ولا نخترع واحدًا. يمكن أن تمر تتبعات OTLP عبر Collector، وهو معروض في دليل Collector الخاص بـ OpenTelemetry على Kubernetes نحو Dynatrace. أما السلوك في Dynatrace SaaS أو Managed فتحدده وثائق Dynatrace. وللمقارنة بمشروع آخر من السجل نفسه، اقرأ KEDA والتحجيم التلقائي المبني على الأحداث.
الحدود والنقاط المفتوحة
- صلاحيات واسعة: يُنشئ تسجيل عنقود حساب خدمة بدور ClusterRole بصلاحيات المسؤول. تشير الوثائق إلى إمكان تقييد صلاحيات الكتابة، لكن الصلاحيات
getوlistوwatchتظل لازمة على مستوى العنقود. - عدد القيم الفريدة للوسوم (cardinality): يؤدي عرض وسوم Application عبر
controller.metrics.application.labelsإلى إنشاء سلسلة لكل قيمة مختلفة. توصي الوثائق بوسوم قليلة القيم الفريدة. - الفرع الرئيسي: بعض الصفحات المقروءة تصف وظائف حديثة. قارنها دائمًا بوثائق إصدارك.
- التوافر العالي: مع عدة نسخ من وحدة التحكم، تنصح الوثائق باستخدام
ServiceMonitorأو اكتشاف لكل pod، لأن ClusterIP يعيد نسخة واحدة فقط في كل طلب. - غير متحقَّق منه: النجوم وآخر إصدار والوضع الدقيق تجاه CNCF ليست ضمن ما استطعنا إعادة قراءته.
ممارسات جيدة
- ثبّت الإصدار في عنوان URL لملف manifest التثبيت، واختبر كل تحديث خارج الإنتاج.
- احذف
argocd-initial-admin-secretبعد أول تغيير لكلمة المرور. - أطلق تنبيهات على الانحراف (
sync_status) وعلى إخفاقات المزامنة، وليس على صحة pods فقط. - اختر وضعًا واحدًا لكل مكوّن، جمع المقاييس أو إرسالها عبر OTLP، لتفادي التكرار.
- احتفظ بإعدادات المراقبة أيضًا في Git، كما في وحدة GitOps في Dynatrace SaaS.
الأسئلة الشائعة
ما الذي يضيفه Argo CD مقارنة بمسار CI تقليدي؟
بحسب README، يستهدف نشرًا آليًا وقابلًا للتدقيق وتصريحيًا. تقارن وحدة التحكم باستمرار بين Git والعنقود، بدلًا من الدفع مرة واحدة من CI. ويمكن أن يبقى CI في المراحل السابقة لبناء الصور.
كيف أعرف أن نشرًا ما فاشل؟
تتكامل ثلاث إشارات: sync_status وhealth_status في argocd_app_info، والعدّاد argocd_app_sync_total حسب phase، وتتبعات المطابقة إذا فُعّل تصدير OTLP.
هل يمكن إرسال تتبعات Argo CD إلى Dynatrace؟
يصدّر Argo CD عبر OTLP/gRPC إلى العنوان المحدد في otlp.address. ضع Collector بين الطرفين، ثم اتبع وثائق Dynatrace لجانب الاستقبال. لم تختبر span.observer هذا التركيب.
الخلاصة
يجعل Argo CD من Git مصدر الحقيقة لعملية النشر على Kubernetes، وتجعل مقاييسه وتتبعاته هذا التسليم قابلًا للملاحظة. ويبقى المدخل الأكثر جدوى هو الانحراف وفشل المزامنة. أعد قراءة وثائق إصدارك قبل تفعيل تصدير OTLP.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا لمشروع Argo CD. العلامات المذكورة ملك لأصحابها. الأدوات تتطور بسرعة: تحقق من الأوامر والخيارات في وثائقها الرسمية.