Monaco من Managed إلى SaaS: تصدير الإعدادات وإعادة نشرها

Monaco من Managed إلى SaaS: صدّر إعدادات عنقود Managed، وراجعها في Git، ثم أعد نشرها على SaaS بعد تجربة جافة (dry-run) للتحقق.
Monaco Managed vers SaaS : exporter et rejouer la configuration

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

يركز هذا الدليل على خطوة واحدة: تصدير إعدادات بيئة Dynatrace Managed ونشرها على Dynatrace SaaS. وللاطلاع على الخطة الشاملة (الوكلاء وOperator والموجات) راجع دليل الانتقال من Managed إلى SaaS. وللاطلاع على أساسيات الأداة راجع Dynatrace Monaco: الإعدادات كشيفرة.

بالنسبة لفريق SRE تكمن الفائدة في قابلية التكرار: التصدير المُصدَّر بإصدارات يمكن مقارنته ومراجعته وإعادة تشغيله مرات عدة، مما يقلل العمل اليدوي المتكرر (toil) ومخاطر الانتقال اليدوي.

Monaco من Managed إلى SaaS: ما الذي يغطيه

توضح صفحة «Migrate configuration» في وثائق Managed النطاق بجلاء: لا يدعم معالج الانتقال إلى SaaS ولا Monaco سوى جزء من إعدادات Managed، ويُعاد الباقي يدويًا. العائلات التي تذكرها الصفحة:

  • بيانات الاعتماد: credentials الخاصة بالإضافات ومزودي السحابة، وخزنة بيانات الاعتماد، ورموز الوصول؛
  • التكاملات: إشعارات المشكلات إلى أدوات خارجية (Jira وPagerDuty وxMatters) والإشعارات على الهاتف؛
  • الخدمات: ترتيب قواعد تسمية الطلبات، والخدمات المدمجة، وkey requests؛
  • التحليل: العروض المحفوظة في Multidimensional analysis، والاستعلامات المحفوظة في Data Explorer، وبلاطات (tiles) لوحات المعلومات من البيئات البعيدة؛
  • الحسابات: المستخدمون والمجموعات والأذونات وسياسات IAM؛
  • الكيانات: custom devices، والوسوم المطبقة يدويًا، وأسماء الكيانات وأوصافها المخصصة.

نقطة أخرى في الصفحة نفسها: إذا كنت تستخدم قواعد كشف مجموعات العمليات (البسيطة أو المتقدمة أو التصريحية) في Managed، فانقلها إلى Process Grouping Rules قبل الانتقال إلى SaaS. وأخيرًا توصي الصفحة بتحديث Managed إلى أحدث إصدار، ويفضل أن يتوافق مع إصدار بيئة SaaS.

المتطلبات

  • تثبيت Monaco على جهاز يصل عبر الشبكة إلى عنقود Managed (تذكر الوثائق عقدة من العنقود)؛ والإصدار والملف التنفيذي في releases مستودع Dynatrace/dynatrace-configuration-as-code بترخيص Apache 2.0.
  • رمز واحد لكل بيئة Managed مصدر بصلاحية القراءة فقط، ورمز SaaS بصلاحيتي القراءة والكتابة. النطاقات (scopes) التي تسردها الوثائق في الصورة أدناه.
  • مستودع Git لحفظ إصدارات التصدير.
قائمة نطاقات الرموز في صفحة Migrate configuration: القراءة فقط في Managed، والقراءة والكتابة في SaaS

تُنشأ الرموز في كل بيئة ضمن Access tokens مع تاريخ انتهاء. احفظها في خزنة أسرار. رمز Managed لا يعمل على SaaS: الرمزان منفصلان، كما يشرح استكشاف أخطاء رمز API في Dynatrace.

الخطوة 1: تعريف البيئات في ملف manifest

يسرد ملف manifest المشاريع والبيئات. تعطي الصفحة الرسمية هذا المثال لبيئتين من Managed.

مثال manifest.yaml من الوثائق: مشروعان ومجموعة بيئات managed مع عنوان URL واسم متغير الرمز

يشير الحقل token.name إلى متغير بيئة، وليس إلى الرمز نفسه. صدّر المتغيرات دون مسافات حول علامة المساواة:

export MIGRATION_TOKEN_PROD_FIN="dt0c01.XXXX"
export ENV_TOKEN_SAAS="dt0c01.YYYY"

انتبه إلى شكل الملف. في شيفرة Monaco الحالية يُعرَّف رمز البيئة تحت auth (auth.token.name)، بينما تعرض وثائق Managed بنية أقدم. أضف مجموعة ثانية لهدف SaaS في الملف نفسه:

  - name: saas
    environments:
      - name: saas
        url:
          value: https://<env-id>.live.dynatrace.com
        auth:
          token:
            name: ENV_TOKEN_SAAS

إذا رفض Monaco الملف، فقارنه بناتج monaco download (الخطوة التالية): فالأداة تكتب بنفسها ملف manifest صالحًا للإصدار المثبت.

الخطوة 2: تنزيل إعدادات Managed

يقرأ التنزيل البيئة المصدر ويكتب مشروعًا من الملفات (ملف config.yaml وقوالب JSON). الخيارات المفيدة بحسب الشيفرة ومرجع الأوامر:

الخيار التأثير
--manifest, -m مسار ملف manifest (الافتراضي manifest.yaml)
--environment, -e البيئة المراد قراءتها من ملف manifest
--only-apis واجهات الإعدادات الكلاسيكية فقط
--only-settings كائنات Settings 2.0 فقط
--output-folder, -o مجلد المخرجات
--project, -p اسم المشروع المنشأ
--force, -f يستبدل ملف manifest.yaml الموجود بدل إنشاء ملف ثانٍ
monaco download --manifest manifest.yaml --environment production-fin \
  --project production-fin --output-folder export-managed

تكتب صفحة Managed الأمر monaco download manifest manifest.yaml، بينما يصف مرجع الأوامر الحالي الخيارات أعلاه. عند الشك نفّذ monaco download --help على إصدارك.

نفّذ commit للمجلد كما هو. هذا الـ commit الأول هو المرجع، وأي تنظيف لاحق يظهر في الفرق (diff).

الخطوة 3: المراجعة واستبعاد ما لا يجب إرساله

قبل النشر راجع التصدير. احذف ملفات تعريف التنبيه اليتيمة، ودمج المكرر منها (راجع Management zones والوسم التلقائي)، وحدد الكائنات التي تشير إلى معرّفات كيانات: فهي غير موجودة في SaaS.

للإبقاء على كائن في التصدير دون نشره يعرف Monaco المعامل skip في config.yaml، كما يوضح مستودع المشروع.

مقطع من config.yaml في مستودع Monaco: إعدادان للوسم التلقائي، أحدهما بقيمة skip false والآخر skip true

تذكر صفحة Managed القيمة skipDeployment: "true" للإعدادات غير المدعومة أو المكررة؛ ولم أجد في المستودع سوى المفتاح skip. تحقق من المفتاح الذي يقبله إصدارك باستخدام --dry-run.

الخطوة 4: التحقق ثم الإعادة على SaaS

monaco deploy manifest.yaml --environment saas --dry-run
monaco deploy manifest.yaml --environment saas --continue-on-error

يتحقق --dry-run من البنية ويحل المعاملات ويولّد قوالب JSON، لكنه لا يستطيع التحقق من محتوى ملفات JSON: قد يفشل النشر مع خطأ من واجهة Dynatrace API. ومع --continue-on-error يواصل Monaco رغم الفشل، لكن الإعدادات التي تعتمد على إعداد فاشل قد تفشل بدورها. اقرأ السجل كاملًا: تطلب الوثائق معالجة كل تعارض يُبلَّغ عنه.

كيف تتحقق من أن كل شيء يعمل

  • أعد تشغيل النشر: يجب ألا يظهر أي خطأ ولا إنشاء مكرر.
  • قارن كائنًا بكائن ملفات تعريف التنبيه وقواعد الوسوم بين Managed وSaaS.
  • أطلق تنبيهًا تجريبيًا وتأكد من وصوله إلى القناة الصحيحة (الإشعارات إلى الأدوات الخارجية من الكائنات التي تُعاد يدويًا).
  • اشطب من قائمتك العائلات الواردة في قسم «ما الذي يغطيه»: لكل عائلة مسؤول وتاريخ.

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

  • أداة واحدة كمصدر وحيد للحقيقة: إذا كنت تستخدم Terraform فراجع Terraform وDynatrace ولا تخلط بينهما.
  • رموز محدودة المدة، تُحذف بعد الانتقال.
  • منطق blameless: وثّق ما فشل في النشر كما توثّق حادثًا، للموجة التالية.
  • OpenTelemetry: تشير مصدّرات OTLP إلى البيئة؛ ويتغير عنوانها ورمزها عند الانتقال، لا إعدادات Monaco.

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

هل ينقل Monaco المستخدمين والرموز أيضًا؟

لا. بحسب وثائق Managed، فإن المستخدمين والمجموعات والأذونات وسياسات IAM ورموز الوصول مما يُعاد يدويًا.

هل يمكن إعادة تشغيل التصدير عدة مرات؟

هذا هو الاستخدام المقصود: ينشئ النشر الكائنات أو يحدّثها. أجرِ مع ذلك تجربة جافة، ثم فحصًا على بيئة اختبار قبل الإنتاج.

هل نحتاج إلى الواجهات الكلاسيكية أم Settings 2.0؟

افتراضيًا يغطي التنزيل الاثنين معًا. يتيح الخياران --only-apis و--only-settings معالجتهما كلًا على حدة، وهذا مفيد لحصر المراجعة.

الخلاصة

يوفر Monaco من Managed إلى SaaS مسارًا قابلًا للتكرار: ملف manifest، ثم التنزيل، فالمراجعة، فالتجربة الجافة، فالنشر. ضع في اعتبارك الحدود الموثقة وأعد يدويًا ما لا يُدعم.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. Dynatrace علامة تجارية لشركة Dynatrace LLC. خيارات Monaco تتطور: تحقق منها في الوثائق الرسمية ومستودع المشروع.

Total
0
Shares
Leave a Reply

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

Previous Post
Ollama vLLM llama.cpp : quel moteur local choisir pour vos LLM ?

Ollama vLLM llama.cpp: أي محرك محلي تختار لنماذج LLM؟

Next Post
eBPF Kubernetes : observer les flux réseau avec Cilium et Hubble

eBPF Kubernetes: مراقبة تدفقات الشبكة باستخدام Cilium وHubble

Related Posts