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

configuration as code SaaS: إصدار إعدادات Dynatrace وتحديد الأداة المناسبة بين Monaco وTerraform، مع manifest والمصادقة وتمرين واختبار.
Module 1 — Configuration as code SaaS : Monaco ou Terraform ?

تضع هذه الوحدة الأولى من دورة Monaco SaaS أسس configuration as code SaaS، أي وصف إعدادات بيئة Dynatrace SaaS في ملفات خاضعة لإدارة الإصدارات بدل إدخالها يدويًا في الواجهة، ثم فهم موضع كل أداة (Monaco أو provider الخاص بـ Terraform).

المسار: Monaco SaaS · الوحدة 1 · المدة: نحو 35 دقيقة · المستوى: مبتدئ

الأهداف:

  • شرح فائدة وصف الإعدادات في ملفات
  • تحديد موضع Monaco وprovider الخاص بـ Terraform ومعرفة أيهما يُختار
  • قراءة manifest وconfiguration في Monaco
  • التعرّف على طرق المصادقة في بيئة SaaS

المتطلبات المسبقة: بيئة Dynatrace SaaS (تكفي النسخة التجريبية المجانية) ومعرفة أولية بـ Git وYAML. يخص هذا المسار Dynatrace SaaS فقط.

لماذا configuration as code SaaS؟

تقدّم الوثائق الرسمية الإعداد ككود (configuration as code) على أنه نهج تصريحي: تُضبط Dynatrace «من دون الحاجة إلى ضبط كل شيء في الواجهة». يمكن إصدار الملفات وإعادة استخدامها ومشاركتها ومزامنتها بين البيئات.

ينتج عن ذلك ثلاث فوائد لفريق SRE:

  • قابلية إعادة الإنتاج: تتلقى بيئة الاختبار وبيئة الإنتاج التعريف نفسه، وبالتالي التنبيهات نفسها.
  • قابلية التتبع: يمر كل تغيير عبر commit ومراجعة. وتُعرف أي تنبيه عُدّل بالخطأ ويُلغى تعديله في دقائق، مما يقلل MTTR.
  • toil أقل: قاعدة تُكتب مرة واحدة تُنشر على عشر بيئات من دون نسخ الشاشات.

يبقى المبدأ بسيطًا: يصبح مستودع Git مصدر الحقيقة، وتطبّق الأداة هذا الوصف على البيئة.

أداتان: Monaco وprovider الخاص بـ Terraform

تذكر وثائق Dynatrace أداتين. Monaco أداة سطر أوامر مستقلة تنشرها Dynatrace وتعمل مع JSON الأصلي. أما provider الخاص بـ Terraform (dynatrace-oss/dynatrace) فيُستخدم مع Terraform، وهي أداة تصفها الصفحة بأنها المرجع في القطاع للإعداد ككود.

المعيار Monaco provider الخاص بـ Terraform
الطبيعة CLI مستقلة من Dynatrace provider لـ Terraform
الصيغة YAML (manifest وconfigurations) وقوالب JSON HCL
يُنصح به إذا تعذّر استخدام Terraform أو لم يكن مرغوبًا كان Terraform مستخدمًا أصلًا، أو عدة مزوّدين في مساحة واحدة، أو حالة (state) خارجية، أو تعابير HCL

بحسب الوثائق، يُنصح بـ Terraform عندما يعرفه الفريق أصلًا؛ وMonaco هو البديل في الحالة المعاكسة. تفصّل المقالة Monaco أو Terraform لإعداد Dynatrace هذا الاختيار. يعلّم هذا المسار Monaco (الوحدات من 1 إلى 5)؛ أما Terraform فيُعالَج في تدريب منفصل.

بنية configuration في Monaco

تصف الوثائق ثلاثة مكوّنات: manifest للنشر ومشاريع وconfigurations. يحدد الـ manifest أي المشاريع (مجلدات ملفات) تذهب إلى أي بيئات مستهدفة. وتجمع كل configuration ملف YAML (الاسم والمعاملات والتبعيات) وقالب JSON يحوي حمولة API مع أماكن محجوزة للمعاملات.

هذا manifest يعتمد على المفاتيح الموثقة، بقيم توضيحية:

ملف manifest.yaml لـ configuration as code SaaS: manifestVersion ومشروع alerting وبيئة dev ورموز تُقرأ من متغيرات البيئة

ثلاث نقاط تستحق الانتباه:

  • قيمة manifestVersion هي 1.0، وهو إصدار manifest الذي يدعمه مستودع المشروع؛
  • لا يظهر الـ URL ولا الرموز (tokens) بنص صريح أبدًا: يشير name إلى اسم متغير البيئة الذي يحوي السر، لا إلى السر نفسه؛
  • إذا كان متغير مُشار إليه غائبًا أو فارغًا، يرفض Monaco تحميل الـ manifest (الشيفرة المصدرية للمستودع، manifest_loader.go).

أما configuration فتوجد في ملف config.yaml. هذا المقتطف من مجموعات الاختبار في المستودع الرسمي (ترخيص Apache 2.0):

ملف config.yaml من مستودع Monaco: كائنا Settings هما builtin:alerting.profile وbuiltin:management-zones يربط بينهما مرجع

ينشئ المرجع [ builtin:management-zones, zone, id ] تبعية: ينشر Monaco المنطقة أولًا، ثم الملف التعريفي الذي يستخدم معرّفها. تعود الوحدة 4 إلى ذلك.

المصادقة على بيئة SaaS

يتوقف اختيار المصادقة على الـ API المستهدفة. بحسب وثائق Monaco:

  • token: رمز API كلاسيكي لواجهات الإعداد؛
  • platformToken أو oAuth: لواجهات المنصة (workflows والمستندات وbuckets في Grail)؛
  • يمكن دمج token مع platformToken أو مع عميل OAuth، لكن لا يُعرَّف platformToken وoAuth معًا لبيئة واحدة؛
  • بحسب الوثائق، تُدعم صيغة platformToken ابتداءً من Monaco 2.24.0.

تتوقف النطاقات (scopes) المطلوبة على أنواع الموارد المُدارة. في المثال الرسمي الخاص بـ SLO يطلب رمز المنصة slo:slos:read وslo:slos:write وslo:objective-templates:read. تعالج الوحدة 2 إنشاء الرمز وقائمة النطاقات.

يقرأ provider الخاص بـ Terraform إعداداته من متغيرات البيئة. تذكر وثائقه DYNATRACE_ENV_URL (لبيئة SaaS: https://########.live.dynatrace.com)، وDYNATRACE_PLATFORM_TOKEN لرمز المنصة، وDT_CLIENT_ID وDT_CLIENT_SECRET وDT_ACCOUNT_ID لـ OAuth:

كتلة required_providers لـ provider الخاص بـ Terraform dynatrace-oss/dynatrace ومتغيرات البيئة DYNATRACE_ENV_URL وDYNATRACE_PLATFORM_TOKEN وDYNATRACE_HTTP_OAUTH_PREFERENCE

تذكر هذه الوثائق حدّين: لا تدعم كل الموارد OAuth، ولا يصلح رمز المنصة لواجهة إدارة الحساب (IAM) ولا للموارد الكلاسيكية.

الأوامر التي ينبغي معرفتها

يوفّر Monaco أربعة أوامر بوجه خاص (المرجع الرسمي للأوامر):

  • monaco deploy يطبّق manifest؛ الخيارات --dry-run و--environment و--group و--project؛
  • monaco download يصدّر configuration موجودة (الوحدة 3)؛
  • monaco delete يحذف configurations المدرجة في ملف حذف (الوحدة 5)؛
  • monaco generate يُنتج ملفات مساعدة: ملف الحذف والرسم البياني والمخطط (schema).

يتحقق --dry-run من بنية الـ manifest والمشاريع والـ configurations من دون الاتصال بـ Dynatrace. ولا يتحقق من محتوى ملفات JSON: يبقى خطأ HTTP 400 واردًا عند النشر الفعلي.

تمرين عملي

يُنفَّذ هذا التمرين على بيئة SaaS تجريبية. لم تُنفَّذ الأوامر أدناه من أجل هذه المقالة: تصف النتيجة المتوقعة السلوك الموثق، لا مخرجات منسوخة.

الخطوة 1 — إنشاء المستودع

أنشئ مستودع Git فارغًا يحوي مجلد alerting/ وملف manifest.yaml مستوحى من الصورة 1 (الـ URL والرموز في متغيرات البيئة). النتيجة المتوقعة: لا أسرار في المستودع.

الخطوة 2 — كتابة أول configuration

أضف في alerting/ ملف config.yaml وقالب JSON، مسترشدًا ببنية الصورة 2 وبوثائق مخطط Settings المختار. النتيجة المتوقعة: معرّف (id) ونوع وقالب لكل configuration.

الخطوة 3 — تعريف المتغيرات والتحقق

صدّر DT_ENV_URL وDT_API_TOKEN وPLATFORM_TOKEN بقيم بيئتك، ثم شغّل monaco deploy manifest.yaml --dry-run. النتيجة المتوقعة: تحقق من البنية من دون أي استدعاء لـ Dynatrace؛ ويؤدي غياب متغير إلى فشل تحميل الـ manifest.

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

دوّن في ثلاثة أسطر سبب اختيار فريقك Monaco أو Terraform، استنادًا إلى الجدول أعلاه. النتيجة المتوقعة: معيار قرار مكتوب تعود إليه في الوحدة 8.

اختبار

  1. في manifest الخاص بـ Monaco، ماذا يحوي name تحت token؟ أ) الرمز ب) اسم متغير بيئة ج) الـ URL الخاص بالبيئة د) اسم المشروع
  2. هل يمكن تعريف platformToken وoAuth لبيئة واحدة؟ أ) نعم، دائمًا ب) لا ج) فقط مع --dry-run د) فقط مع Terraform
  3. الخيار --dry-run في Monaco: أ) ينشر في وضع الاختبار ب) يتحقق من البنية من دون الاتصال بـ Dynatrace ج) يتحقق من محتوى JSON لدى الـ API د) يحذف configurations
  4. توصي الوثائق بـ Terraform عندما: أ) يستخدمه الفريق أصلًا ب) لا يُعرف Git ج) يراد تجنب YAML د) أبدًا

الإجابات

  1. ب) يبقى السر خارج المستودع: لا يظهر فيه إلا اسم المتغير.
  2. ب) يُدمج token مع أحدهما، لكن ليس مع الاثنين معًا.
  3. ب) يبقى خطأ HTTP 400 واردًا عند النشر الفعلي.
  4. أ) يناسب Terraform خصوصًا الفرق التي تستخدمه أصلًا لبنيتها التحتية.

للمزيد

→ فهرس المسار · الوحدة 2: تثبيت Monaco لـ Dynatrace SaaS ←

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

هل يلزم تعلّم Terraform أيضًا؟

لا. تكفي أداة واحدة لإدارة نطاق إعداد واحد. يغطي هذا المسار Monaco؛ وإذا فضّل فريقك Terraform فهناك مسار Terraform منفصل.

أين تُحفظ الأسرار؟

ليس في المستودع أبدًا. يقرأ Monaco الأسرار من متغيرات البيئة، ويوصي provider الخاص بـ Terraform بمتغيرات البيئة أيضًا. وفي الـ pipeline تأتي من مخزن أسرار أداة CI.

هل يصلح هذا المسار لـ Dynatrace Managed؟

لا. رموز المنصة وOAuth ومنصة الجيل الثالث تخص Dynatrace SaaS. يوجد مسار منفصل لـ Managed.

أصبحت تعرف ما الذي تغطيه configuration as code SaaS، وكيف يتكوّن manifest وconfiguration، وما أنواع المصادقة المتاحة. تثبّت الوحدة التالية Monaco وتُعدّ manifest بيئتك.

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

Total
0
Shares
Leave a Reply

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

Previous Post
Module 1 — Configuration as code Managed : Settings 2.0 et Monaco

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

Next Post
Module 2 — Installation Monaco Managed : binaire, manifeste et jeton

الوحدة 2 — تثبيت Monaco Managed: الملف التنفيذي والبيان والرمز

Related Posts