الوحدة 3 من مسار Monaco Managed: تصدير Monaco Managed بالأمر monaco download يحوّل الإعدادات الموجودة في بيئتك إلى ملفات قابلة لإدارة الإصدارات.
المسار: Monaco Managed · الوحدة 3/5 · المدة: نحو 40 دقيقة · المستوى: متوسط
الأهداف:
- تشغيل
monaco downloadباستخدام ملف manifest أو باستخدام عنوان URL - حصر التصدير في Settings 2.0 أو في واجهات API الكلاسيكية للإعدادات
- قراءة البنية الناتجة: ملف manifest والمشروع و
config.yamlوقوالب JSON - معرفة ما لا يشمله التصدير
المتطلبات: إنهاء الوحدة 2 (تثبيت Monaco وملف manifest ورمز API المميّز)؛ وبيئة Dynatrace Managed للاختبار أو للتجربة قبل الإنتاج.
تحتوي بيئة Managed لديك أصلًا على عشرات الإعدادات المُدخلة يدويًا: ملفات تعريف التنبيه وmanagement zones والوسوم التلقائية. إعادة كتابتها بصيغة YAML تستغرق وقتًا وتكثر فيها الأخطاء. تقترح Monaco العكس: تقرأ البيئة وتكتب الملفات نيابةً عنك. يصلح هذا التصدير نسخةً احتياطية، ونقطة انطلاق للوحدة التالية، وأساسًا للمقارنة بين بيئتين. تقتصر هذه الوحدة على Dynatrace Managed.
ما الذي يفعله الأمر monaco download
تصف الوثائق الرسمية الأمر download بأنه وسيلة لتنزيل إعدادات بيئة Dynatrace على هيئة ملفات Monaco. وتبرز ثلاثة استخدامات: النسخ الاحتياطي، والمشاركة بين البيئات، وإنشاء قوالب انطلاقًا مما ضُبط في الواجهة.
يوجد نمطان، وهما يستبعد أحدهما الآخر:
| النمط | الأمر | ملاحظة |
|---|---|---|
| مع manifest | monaco download --manifest manifest.yaml --environment dev |
الخيار --environment إلزامي؛ وبدون --manifest تبحث Monaco عن manifest.yaml في المجلد الحالي |
| بدون manifest | monaco download --url URL --token NOM_VARIABLE |
لا يتوافق مع --manifest ولا مع --environment؛ ويُنشأ ملف manifest |
نقطة أمان أساسية: الخيار --token لا يستلم الرمز المميّز نفسه أبدًا، بل اسم متغير البيئة الذي يحتويه. وتصيغ الوثائق ذلك هكذا: تُقرأ أسرار المصادقة دائمًا من متغيرات البيئة. لذلك لا يحتوي سجل الأوامر في الصدفة (shell) على الرمز.

الخيارات المهمة عند تصدير Monaco Managed
ترد الخيارات التالية في الوثائق الرسمية وفي مساعدة الأمر، كما قُرئت في الشيفرة المصدرية لمستودع Monaco.
--output-folder(-o): مجلد الإخراج. افتراضيًا تنشئ Monaco مجلدًا اسمهdownloadيليه ختم زمني.--project(-p): اسم المشروع الناتج، والقيمة الافتراضيةproject.--only-settings: كائنات Settings 2.0 فقط. ويستهدف--settings-schema(-s) مخططًا واحدًا أو أكثر بعينه.--only-apis: واجهات API الكلاسيكية للإعدادات فقط، دون واجهات API المهجورة. ويستهدف--api(-a) واجهة API واحدة أو أكثر، بما فيها المهجورة.--force(-f): يستبدل ملفmanifest.yamlالموجود بدلًا من إنشاءmanifest_{timestamp}.yaml.
أما خيارات التصدير الخاصة بموارد المنصة من الجيل الجديد (الأتمتة وbuckets والمستندات) فلا تخص Managed ولا تُعالج هنا. والخياران --api و--only-apis متنافيان، وكذلك --settings-schema و--only-settings.
الرمز المميّز والنطاقات
تسرد صفحة إعداد Monaco في وثائق Managed النطاقات (scopes) المطلوبة «في معظم الحالات»: DataExport وReadConfig وWriteConfig وsettings.read وsettings.write. ولا توضح أيّها يلزم للتصدير وحده. أما أي مجموعة جزئية تكفي لتنزيل للقراءة فقط فهو غير متحقَّق منه هنا: في بيئة اختبار، استخدم رمز الوحدة 2 ثم قيّده لاحقًا بحذر.
قراءة البنية الناتجة
بعد التصدير يحتوي مجلد الإخراج على ملف manifest ومجلد مشروع. ومع وجود manifest يُضاف اسم البيئة إلى اسم المشروع (مثل project_dev)، إلا مع --force. وداخل المشروع يكون لكل نوع من الإعدادات مجلد فرعي: اسم واجهة API كلاسيكية أو معرّف مخطط Settings. وتُحذف من اسم المجلد الأحرف التي ليست حروفًا أو أرقامًا أو شرطة أو شرطة سفلية أو نقطة: فيصبح builtin:management-zones هو builtinmanagement-zones.

يحتوي كل مجلد فرعي على config.yaml وقالب JSON لكل إعداد. ويصرّح config.yaml بالمعرّف والقالب والحقل skip والنوع: api لواجهة API كلاسيكية، وsettings مع schema وschemaVersion وscope لكائن Settings 2.0. والمقتطفان التاليان مأخوذان من ملفات الاختبار في مستودع Monaco (ترخيص Apache 2.0)، وليسا من تصدير فعلي لبيئتك.

المراجع والمعرّفات والقوالب
أثناء التصدير تحلل Monaco قوالب JSON لرصد المراجع بين الإعدادات (كقاعدة تشير إلى management zone مثلًا) وتستبدل بها مراجع YAML، كي تتم إعادة النشر بالترتيب الصحيح. وتستخرج كذلك بعض المعرّفات إلى معاملات YAML. وبالنسبة إلى كائنات Settings تُهرّب الأقواس المزدوجة في المحتوى حتى لا تُفسَّر كمتغيرات قالب؛ وإذا فشلت العملية يُظهر تحذير أن القالب يحتاج إلى تعديل يدوي. وفي نهاية التصدير يبحث الأمر عن التبعيات الدائرية ويبلّغ عنها. والقوالب موضوع الوحدة 4.
حدود التصدير
- الأنواع المستبعدة افتراضيًا:
aws-credentialsوazure-credentialsوkubernetes-credentialsوcredential-vaultوextension. فواجهة API لا تعيد محتواها كاملًا، ولا تُصدَّر أسرارها بعد الإنشاء. - الكائنات للقراءة فقط: تُصفّى الإعدادات غير القابلة للتعديل.
- مرشحات يمكن تعطيلها (من Monaco 2.2.0 فصاعدًا):
MONACO_FEAT_DOWNLOAD_FILTER=falseيعطّل كل المرشحات؛ أماMONACO_FEAT_DOWNLOAD_FILTER_SETTINGSوMONACO_FEAT_DOWNLOAD_FILTER_SETTINGS_UNMODIFIABLEوMONACO_FEAT_DOWNLOAD_FILTER_CLASSIC_CONFIGSفتعمل لكل عائلة على حدة. والتصدير بلا مرشحات لا يُنشر كما هو: يحتاج إلى تعديل يدوي. - الأداء: يحدد
MONACO_CONCURRENT_REQUESTSعدد الاستدعاءات المتزامنة (5 افتراضيًا). وتستهلك معالجة التبعيات المعالج وقد تكون بطيئة على جهاز متواضع.
بالنسبة إلى مهندس SRE لهذه الحدود نتيجة عملية: التصدير ليس نسخة احتياطية كاملة. دوّن ما يبقى خارج المستودع (بيانات الاعتماد والإضافات) وعالجه على حدة.
تمرين عملي
نفّذه على بيئة Managed للاختبار أو للتجربة قبل الإنتاج، وليس على الإنتاج أولًا أبدًا. الأوامر التالية لا تُنفَّذ في هذه المقالة: فالمخرجات الدقيقة تتوقف على بيئتك وعلى إصدار Monaco لديك، ولذلك لا يُختلق أي مخرج.
الخطوة 1 — تجهيز الرمز المميّز
ضع رمز الوحدة 2 في متغير بيئة، مثل DT_TOKEN_DEV. وتحقق من أن ملف manifest الخاص بالوحدة 2 يشير إلى هذا المتغير في auth.token.name. النتيجة المتوقعة: لا أسرار بنص صريح في ملف manifest.
الخطوة 2 — تصدير كائنات Settings وحدها
شغّل monaco download -m manifest.yaml -e dev --only-settings -o export-settings. النتيجة المتوقعة: تُظهر السجلات التنزيل ثم معالجة التبعيات ثم البحث عن التبعيات الدائرية ثم الكتابة في مجلد الإخراج.
الخطوة 3 — تصدير واجهات API الكلاسيكية
شغّل الأمر نفسه مع --only-apis ومجلد إخراج آخر. النتيجة المتوقعة: مجلدات فرعية تحمل أسماء واجهات API الكلاسيكية (ملفات تعريف التنبيه وmanagement zones…).
الخطوة 4 — القراءة والمقارنة
افتح ملف config.yaml وقالب JSON الخاص به، ثم دوّن النوع والمعرّف والحقل skip. وسجّل الأنواع المتوقعة لكنها غائبة. النتيجة المتوقعة: قائمة فيها نوع مستبعد واحد على الأقل، تقابلها مع قسم الحدود.
الخطوة 5 — وضعه تحت Git
أنشئ مستودعًا واعتمد المجلد المصدَّر دون أي رمز مميّز. النتيجة المتوقعة: أول commit بعنوان «الحالة الأولية للبيئة dev».
اختبار قصير
- ماذا يستلم الخيار
--tokenفيmonaco download؟ أ) رمز API ب) اسم متغير بيئة ج) مسار ملف د) عنوان URL للبيئة - مع وجود manifest، أي خيار إلزامي؟ أ)
--environmentب)--urlج)--forceد)--project - أي نوع إعدادات يُستبعد افتراضيًا من التصدير؟ أ)
alerting-profileب)management-zoneج)credential-vaultد)builtin:management-zones - ماذا يفعل
--only-settings؟ أ) يصدّر واجهات API الكلاسيكية ب) يصدّر كائنات Settings 2.0 فقط ج) يستبدل ملف manifest د) ينشر الكائنات
الإجابات
- ب) يبقى السر في بيئة الصدفة؛ ولا يُمرَّر إلى الأمر سوى اسمه.
- أ) بعد اختيار ملف manifest يجب تسمية البيئة المراد قراءتها.
- ج) تحتوي خزائن بيانات الاعتماد على أسرار لا تُصدَّر بعد الإنشاء.
- ب) وبذلك تُترك واجهات API الكلاسيكية جانبًا.
للمزيد
- Monaco: إعدادات Dynatrace ككود
- Monaco أم Terraform: أي أداة لإعداد Dynatrace؟
- إعادة استخدام إعدادات Monaco من Managed إلى SaaS
- Terraform وDynatrace: التنبيهات ولوحات المعلومات
- مرجع أوامر Monaco (وثائق Managed)
- مستودع Dynatrace Configuration as Code على GitHub
→ الوحدة 2: تثبيت Monaco Managed · فهرس المسار · الوحدة 4: نشر Monaco Managed ←
الأسئلة الشائعة
هل يمكن التصدير بدون ملف manifest؟
نعم، بالخيارين --url و--token. عندها تنشئ Monaco ملف manifest بحيث يمكن إعادة نشر التصدير. ولا يُجمع هذا الخيار مع --manifest ولا مع --environment.
لماذا تغيب بعض الإعدادات عن التصدير؟
افتراضيًا تصفّي Monaco الأنواع التي لا تعيد واجهة API محتواها كاملًا (بيانات الاعتماد والإضافات) والكائنات للقراءة فقط. وتعطّل المتغيرات MONACO_FEAT_DOWNLOAD_FILTER* هذه المرشحات، على حساب تصدير يلزم تعديله قبل النشر.
ماذا يحدث إذا كان المجلد يحتوي أصلًا على ملف manifest؟
بدون --force تنشئ Monaco الملف manifest_{timestamp}.yaml بجانب الملف الموجود. ومع --force تستبدل manifest.yaml.
صارت لديك الآن حالة أولية للبيئة على هيئة ملفات. وتعلّمك الوحدة التالية كيف تعدّل هذه المشاريع وتضبط معاملاتها بالقوالب وتنشرها بتشغيل تجريبي (dry-run).
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. لا يغني هذا المسار عن التدريبات والشهادات الرسمية في Dynatrace University. تحقق دائمًا من الميزات في الوثائق الرسمية الخاصة بإصدارك.