الوحدة 1 — التكوين ككود في Managed: Settings 2.0 وMonaco

التكوين ككود في Managed: الأسباب، وSettings 2.0 مقابل واجهات API الكلاسيكية، وMonaco مقابل Terraform، مع تمرين واختبار لـ Dynatrace Managed.
Module 1 — Configuration as code Managed : Settings 2.0 et Monaco

الوحدة 1 من مسار Monaco Managed: شرح التكوين ككود في Managed قبل تثبيت أي أداة، لتختار أداتك عن دراية (Monaco أو مزوّد Terraform).

المسار: Monaco Managed · الوحدة 1/5 · المدة: نحو 35 دقيقة · المستوى: متوسط

الأهداف:

  • شرح سبب إدارة تكوين Dynatrace في ملفات خاضعة لإدارة الإصدارات
  • التمييز بين Settings 2.0 وواجهات API التكوين الكلاسيكية
  • مقارنة Monaco ومزوّد Terraform بمعايير ملموسة

المتطلبات: أساسيات Dynatrace Managed (يُنصح بـمسار Dynatrace Managed)، ومعرفة بـ Git وYAML.

يُكوَّن عنقود Managed بسرعة يدويًا: ملفات تعريف التنبيه، وقواعد الوسوم، ومناطق الإدارة، والإشعارات. ثم تتكاثر البيئات وتتكاثر الفرق، ولا يعود أحد يعرف من غيّر ماذا. والتكوين ككود في Managed يعالج هذه المشكلة: يعيش التكوين في ملفات داخل Git، وتطبّقه أداة على البيئة. تضع هذه الوحدة الإطار العام. أما التثبيت والأوامر فتأتي في الوحدات التالية.

هذا المسار خاص بـ Dynatrace Managed فقط. مسارات API والرموز المميّزة الموصوفة هنا هي الخاصة ببيئات Managed؛ ولمنصة SaaS مسارها الخاص.

لماذا التكوين ككود في Managed؟

تقدّم الوثائق الرسمية لـ Managed مفهوم Configuration as Code بوصفه وسيلة لأتمتة تكوين Dynatrace انطلاقًا من ملفات بدل الواجهة. وتذكر استخدامات مثل الإعداد الذاتي للفرق، والاتساق بين البيئات، والمراجعة عبر Git. ومن وجهة نظر مهندس SRE، المكاسب ملموسة:

  • إمكانية التتبع: كل تغيير هو commit يُراجَع قبل الدمج؛
  • قابلية إعادة الإنتاج: تتلقى بيئة الاختبار التكوين نفسه الذي تتلقاه بيئة الإنتاج؛
  • تقليل toil: لا مزيد من النقرات المتكررة في وحدة التحكم مع كل فريق جديد؛
  • التراجع: العودة إلى حالة معروفة تعني إعادة تطبيق commit سابق.

العقد بسيط: يصبح مستودع Git مصدر الحقيقة. وأي تعديل يدوي في الواجهة يبتعد عن هذا المصدر، مما يطرح مسألة الانحراف (drift) التي يعالجها تدريب Terraform المنفصل.

Settings 2.0 وواجهات API التكوين الكلاسيكية

قبل اختيار أداة، يجب أن تعرف ماذا تكوّن. يوفّر Dynatrace Managed عائلتين من التكوين، وتسمّيهما وثائق Monaco صراحةً: «Settings 2.0» و«Configuration APIs».

Settings 2.0

بحسب وثائق Managed، إطار Settings 2.0 أداة موحّدة للتحكم في التكوينات. كل تكوين هو كائن إعدادات يصفه مخطط (schema). المخططات تنشئها Dynatrace وتصونها: لا يمكنك إنشاء مخطط. أما الكائنات فهي تحت تحكمك. ويستهدف كل كائن نطاقًا (scope) واحدًا بالضبط، مثل البيئة بأكملها. وتوضح الوثيقة أيضًا أن الواجهة الرسومية وواجهة Settings API تضبطان التكوينات نفسها وبالأثر نفسه.

واجهات API التكوين الكلاسيكية

واجهات API التكوين (المسارات /api/config/v1/…) هي الجيل السابق: نقطة وصول لكل نوع تكوين. وتشير صفحة «Configuration types and access permissions» في وثائق Monaco إلى أن معظم هذه الواجهات مهجورة (deprecated) لصالح Settings 2.0. ويحدد جدول التغطية في مستودع Monaco التقابل بينها: فمثلًا حُلّت محل ملفات تعريف التنبيه الكلاسيكية (/api/config/v1/alertingProfiles) المخططُ builtin:alerting.profile. ويقدّم هذا الجدول نفسه على أنه وثيقة عمل قد تكون قديمة: الصفحة الرسمية هي المرجع.

المعيار Settings 2.0 واجهات API التكوين الكلاسيكية
النموذج مخططات وكائنات ونطاقات نقطة وصول لكل نوع
صلاحية الرمز (Monaco) Read settings (settings.read) وWrite settings (settings.write) في الغالب Read configuration وWrite configuration؛ وبعض الأنواع تتطلب صلاحيات أخرى
الحالة الهدف الحالي مهجورة في معظمها

القاعدة العملية: فضّل Settings 2.0 متى وُجد مخطط لما تكوّنه، واحتفظ بالواجهات الكلاسيكية لما لا مقابل له.

Monaco أم مزوّد Terraform؟

أداتان تغطيان هذه الحاجة. كلتاهما تستهدف Settings 2.0 والواجهات الكلاسيكية؛ وتختلفان في فلسفتهما. يلخّص الجدول ما تقوله الوثائق الرسمية والمستودعات. ويفصّل المقال Monaco أم Terraform لتكوين Dynatrace هذه المقارنة.

يعلّم هذا المسار Monaco (الوحدات 1 إلى 5)؛ أما Terraform فله تدريب منفصل: مسار Terraform في Dynatrace Managed.

المعيار Monaco مزوّد Terraform
الطبيعة أداة سطر أوامر من Dynatrace، مستقلة المزوّد dynatrace-oss/dynatrace لـ Terraform
الوصف YAML للتكوينات، وJSON أصلي للقوالب HCL
الحالة (state) لم يُتحقق منه هنا حالة Terraform، وقد تكون عن بُعد
يُوصى به عندما لا يمكن استخدام Terraform في الفريق Terraform مستخدم أصلًا، أو عدة مزوّدين في مساحة عمل واحدة، أو حالة خارجية، أو تكوينات ديناميكية بـ HCL

الصفان الأخيران يعيدان معايير الصفحة الرسمية لـ Managed. مستودع Monaco منشور برخصة Apache 2.0؛ ومزوّد Terraform كذلك، ومستودعه ضمن المنظمة dynatrace-oss.

كيف يبدو Monaco

يصف Monaco كل تكوين في ملف config.yaml. تبيّن الكتلة type هل هو كائن Settings 2.0 (المفتاح settings مع schema وscope) أم واجهة كلاسيكية (المفتاح api). اللقطتان التاليتان مقتطفان حقيقيان من مجموعات اختبار مستودع Monaco.

مقتطف من ملف config.yaml في Monaco: تكوينان من النوع settings بمخطط builtin:alerting.profile وbuiltin:management-zones والنطاق environment

الفكرة نفسها مع الواجهات الكلاسيكية: يحل المفتاح api محل settings، ويُسمّى النوع بمعرّف مثل alerting-profile.

مقتطف من ملف config.yaml في Monaco: تكوينات من النوع api هي alerting-profile وmanagement-zone، مع معامل إحالة بين التكوينات

كيف يبدو مزوّد Terraform

يعلن المزوّد كل مورد مع واجهة API التي يقوم عليها. ويبيّن ذلك الملف supported-resources.md في مستودعه لكل مورد: فالمورد dynatrace_alerting يعتمد على Settings 2.0، بينما يعتمد dynatrace_application_detection_rule على واجهة كلاسيكية. وقد يوجد الموضوع نفسه بإصدارين، مثل dynatrace_application_detection_rule_v2.

مقتطف من supported-resources.md لمزوّد Terraform: ثلاثة موارد مع واجهة API وصلاحيات الرمز الخاصة بكل منها، settings.read وsettings.write أو ReadConfig وWriteConfig

أما الاتصال بـ Managed، فيذكر الملف docs/index.md للمزوّد أن عنوان البيئة يأخذ الشكل https://<dynatrace-host>/e/<identifier>، وأن رمز API يُمرَّر عبر المتغير DYNATRACE_API_TOKEN والعنوان عبر DYNATRACE_ENV_URL. ويشرح تدريب Terraform المنفصل الإجراء كاملًا.

أفضل الممارسات

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

تمرين عملي

لا يتطلب هذا التمرين سوى صلاحية قراءة على بيئة Managed للاختبار ومتصفح. لا يُنفَّذ أي أمر، ولا يوجد مخرج لإعادة إنتاجه.

الخطوة 1 — جرد التكوين

اذكر عشرة عناصر تكوين يعدّلها فريقك بانتظام (ملفات تعريف التنبيه، والوسوم التلقائية، والإشعارات، ومناطق الإدارة…). النتيجة المتوقعة: جدول من عشرة أسطر على الأقل.

الخطوة 2 — التصنيف بحسب النموذج

افتح جدول التغطية في مستودع Monaco (الملف api_coverage.md) وابحث عن كل عنصر. دوّن هل يقابل مخططًا builtin:… (Settings 2.0) أم واجهة /api/config/v1/… فقط. النتيجة المتوقعة: عمود «العائلة» مكتمل، مع عبارة «غير موجود» للعناصر الغائبة عن الجدول.

الخطوة 3 — تدوين صلاحيات الرمز

في صفحة «Configuration types and access permissions» من وثائق Managed، دوّن الصلاحيات اللازمة لكل عنصر. النتيجة المتوقعة: قائمة الصلاحيات التي يجب أن يحملها الرمز.

الخطوة 4 — اختيار أداة

طبّق معايير جدول المقارنة على سياقك وبرّر اختيارك في ثلاث جمل. النتيجة المتوقعة: قرار مكتوب يراجعه زميل.

اختبار

  1. من ينشئ مخططات Settings 2.0؟ أ) كل مستخدم ب) Dynatrace ج) Monaco د) Terraform
  2. في ملف config.yaml لـ Monaco، أي مفتاح يدل على كائن Settings 2.0؟ أ) api ب) settings ج) schema وحده د) classic
  3. ما صلاحيات الرمز التي تربطها وثائق Monaco بـ Settings 2.0؟ أ) ReadConfig وWriteConfig ب) settings.read وsettings.write ج) apiTokens.read د) لا شيء
  4. في أي حالة توصي الوثائق بـ Terraform بدلًا من Monaco؟ أ) عندما يتعذر استخدام Terraform ب) عندما يعرفه الفريق أصلًا أو يريد حالة خارجية ج) أبدًا د) في SaaS فقط

الإجابات

  1. ب) المخططات تنشئها Dynatrace وتديرها؛ والكائنات وحدها من شأن المستخدم.
  2. ب) المفتاح settings مع schema وscope، في مقابل api للواجهات الكلاسيكية.
  3. ب) Read settings (settings.read) وWrite settings (settings.write).
  4. ب) فريق مطّلع أصلًا، أو عدة مزوّدين، أو حالة خارجية، أو تكوينات ديناميكية بـ HCL.

للمزيد

فهرس المسار · الوحدة 2: تثبيت Monaco وبيئة Managed ←

الأسئلة الشائعة

هل يحل Settings 2.0 محل كل واجهات API التكوين؟

لا. تذكر الوثائق أن معظم واجهات API التكوين مهجورة لصالح Settings 2.0، وليس كلها. بعض الأنواع لا مقابل لها: تحقق من الصفحة الرسمية لإصدارك.

هل يجب أن أتعلم Terraform أيضًا؟

ليس لمتابعة هذا المسار الذي يركّز على Monaco. أما Terraform فله تدريب منفصل هو مسار Terraform في Dynatrace Managed، تتبعه أو لا بحسب الأداة التي يعتمدها فريقك.

هل يمكن استخدام أداتين معًا؟

من الناحية التقنية نعم، لكن على نطاقات منفصلة. أداتان تديران الكائن نفسه تتعارضان.

هل يلزم رمز مختلف لكل أداة؟

هذه ممارسة جيدة بمبدأ أقل الصلاحيات: رمز لكل أداة ولكل بيئة، مقتصر على صلاحيات القائمة الواردة في الوحدة 2.

صرت تعرف ما يقدّمه التكوين ككود، وما تغطيه Settings 2.0 والواجهات الكلاسيكية، وبأي معايير تختار أداتك. وتثبّت الوحدة التالية Monaco وتربطه ببيئة Managed.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. لا يحل هذا المسار محل التدريبات والشهادات الرسمية من Dynatrace University. تحقق دائمًا من الميزات في الوثائق الرسمية الخاصة بإصدارك.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Parcours Monaco SaaS : la formation en 5 modules

مسار Monaco SaaS: التدريب في 5 وحدات

Next Post
Module 1 — Configuration as code SaaS : Monaco ou Terraform ?

الوحدة 1 — configuration as code SaaS: هل نختار Monaco أم Terraform؟

Related Posts