الوحدة 2 من مسار Terraform Dynatrace Managed: يتيح استيراد Terraform إلى Dynatrace Managed استعادة السيطرة على إعدادات أُنشئت يدويًا، وحفظها في حالة (state) مشتركة، واكتشاف التعديلات التي تُجرى خارج الشيفرة.
المسار: Terraform Dynatrace Managed · الوحدة 2/3 · المدة: ~45 دقيقة · المستوى: متوسط
الأهداف:
- شرح دور حالة Terraform واختيار واجهة خلفية (backend) بعيدة
- تصدير إعدادات موجودة بأداة مزوّد Dynatrace
- استيراد الكائنات إلى الحالة بالخيار
-import-stateأو بكتلةimport - اكتشاف الانجراف (drift) وتنظيم الشيفرة في وحدات (modules)
المتطلبات المسبقة: الوحدة 1 (المزوّد مثبّت، وعنوان بيئة Managed، ورمز API) وبيئة اختبار، وليس الإنتاج أبدًا في المحاولة الأولى.
كانت الوحدات السابقة تنطلق من بيئة فارغة. لكن العنقود يحتوي أصلًا على سنوات من الإعدادات المنشأة في الواجهة. وبدون استيراد، يتجاهل Terraform هذه الكائنات، وسينشئ الأمر apply نسخًا مكررة منها.
استيراد Terraform إلى Dynatrace Managed: الحالة وأين تُحفظ
يقارن Terraform بين ثلاثة أشياء: الشيفرة والحالة والبيئة الفعلية. الحالة هي السجل الذي يربط كل كتلة resource بالكائن المقابل في Dynatrace. افتراضيًا تُحفظ في ملف محلي اسمه terraform.tfstate. يكفي هذا للتجربة، لا للفريق: فيجب أن تتوفر لكل شخص آخر نسخة.
تحل الواجهة الخلفية البعيدة المشكلتين معًا. بحسب وثائق HashiCorp، تُكتب الحالة حينئذ في تخزين مشترك، وتوفّر الواجهات الخلفية الكاملة قفلًا يمنع التنفيذ المتزامن. واختيار الواجهة (S3 وAzure Blob Storage وGoogle Cloud Storage وHCP Terraform…) يرجع إلى بنيتك التحتية.

نقطتان تستدعيان الانتباه:
- الحالة حساسة. توضح HashiCorp أنها قد تحتوي على قيم سرية (رموز وكلمات مرور) وأن الحالة المحلية ملف نصي صريح. استبعدها من Git وشفّرها أثناء التخزين إذا سمحت الواجهة الخلفية بذلك.
- القفل يعتمد على الواجهة الخلفية. في S3 يُفعَّل بالوسيط
use_lockfileوهو معطّل افتراضيًا. تحقق من الخيار المكافئ في واجهتك الخلفية.
تصدير الموجود بأداة المزوّد
يعمل مزوّد Dynatrace أيضًا كملف تنفيذي مستقل لتصدير إعدادات موجودة. تقدّمه الوثائق بديلًا عن الكتابة اليدوية ووسيلة لإنشاء قوالب. هذه الأداة ليست الملف الثنائي terraform، بل الملف الثنائي للمزوّد، وتضعه الوثائق عادةً في المجلد .terraform/providers/registry.terraform.io/dynatrace-oss/dynatrace/ تحت مجلد الإصدار والنظام.
في Managed، تُحدَّد البيئة بالمتغير DYNATRACE_ENV_URL على الشكل https://<dynatrace-host>/e/<identifiant>، ورمز API بالمتغير DYNATRACE_API_TOKEN (ملف README الخاص بالمزوّد). ويُضبط مجلد المخرجات بالمتغير DYNATRACE_TARGET_FOLDER.
export DYNATRACE_ENV_URL="https://cluster.example.com/e/EXEMPLE"
export DYNATRACE_API_TOKEN="<jeton, jamais dans le dépôt>"
export DYNATRACE_TARGET_FOLDER="./export"
./terraform-provider-dynatrace -export -list-exclusions
./terraform-provider-dynatrace -export dynatrace_alerting
يسرد الأمر الأول الموارد المستبعدة افتراضيًا، ومنها dynatrace_json_dashboard: فلا تُصدَّر لوحة المعلومات إلا بطلب صريح. ويصدّر الأمر الثاني ملفات تعريف التنبيهات. الخيارات المفيدة هي:
| الخيار | الأثر (الوثائق الرسمية) |
|---|---|
-ref |
يضمّ الموارد مع مصادر بياناتها وتبعياتها |
-migrate |
يضمّ التبعيات دون مصادر البيانات |
-import-state |
يهيّئ وحدات Terraform ويستورد الموارد إلى الحالة |
-id |
يعرض المعرّف تعليقًا في الملفات |
-flat |
يضع كل شيء في المجلد الهدف دون بنية وحدات |
-exclude |
يستبعد الموارد المحددة |

بدون -flat ينتج التصدير ملف main.tf يستدعي وحدة لكل نوع من الموارد. يكتب كود المزوّد هذه الكتل بالشكل module "alerting" { source = "./modules/alerting" }. وتُنقل الملفات التي لا يمكن معالجتها إلى .flawed (قديمة أو تحتاج تصحيحًا) أو .required_attention (معلومات ناقصة، مثل سلاسل سرية لا يعيدها أي API). راجع هذين المجلدين قبل أي apply.
مساران للاستيراد
المسار 1: الخيار -import-state
يهيّئ التصدير بالخيار -import-state الوحدات ويستورد الموارد المصدَّرة إلى الحالة في مرور واحد. ويؤكد كود المزوّد ذلك: إذا غابت واجهة سطر أوامر Terraform، يُتجاوز الاستيراد مع رسالة. اضبط الواجهة الخلفية قبل ذلك لتكون الحالة مشتركة منذ البداية.
المسار 2: كتلة import، مورد بمورد
بحسب وثائق Terraform، تعلن كتلة import العنوان الهدف (to) ومعرّف الكائن (id). ويجب أن توجد كتلة resource بالعنوان نفسه. يعتمد المعرّف على نوع المورد: تحيل وثائق Terraform إلى وثائق المزوّد. ولا تذكر صفحات موارد المزوّد صيغة عامة؛ استخدم الخيار -id في التصدير لقراءة المعرّف الفعلي لكل كائن.

يناسب هذا المسار استيرادًا تدريجيًا، كائنًا بعد كائن، في بيئة تحتوي أصلًا على شيفرة. ويستطيع Terraform أيضًا توليد شيفرة الموارد المستوردة بالأمر terraform plan -generate-config-out=PATH، لكن الوثائق تصفه بأنه تجريبي: راجع الناتج كما تراجع تصديرًا.
الانجراف: اكتشاف ما يتغير خارج الشيفرة
يعدّل مسؤول ملف تعريف تنبيهات في الواجهة أثناء حادثة: هذا هو الانجراف (drift). يحدّث الأمر terraform plan الحالة من البيئة ثم يُظهر الفرق مع الشيفرة. أداتان تخدمان مهندس SRE:
- يعيد
terraform plan -detailed-exitcodeالقيمة 0 عند عدم وجود تغييرات، و1 عند الخطأ، و2 إذا وُجدت تغييرات. فيمكن لمهمة مجدولة أن تنبّه عند الرمز 2. - يحدّث
terraform plan -refresh-onlyالحالة لتعكس التغييرات التي جرت خارج Terraform، مثلًا أثناء حادثة. استخدمه عندما يكون التعديل اليدوي مشروعًا، ثم انقله بعد ذلك إلى الشيفرة.
يُقاس الفائدة بزمن المعالجة المتوسط (MTTR) وبالعمل اليدوي المتكرر (toil): يمكن تحديد التعديل اليدوي الذي يفسّر سلوكًا غير متوقع بسرعة. وتبقى الروح «بلا لوم»: الانجراف يشير إلى نقص في العملية لا إلى خطأ شخص.
الوحدات: توحيد الإعدادات
تذكر وثائق Dynatrace من مزايا المزوّد تجميع المكوّنات في وحدات قابلة لإعادة الاستخدام. وينتج التصدير وحدة لكل نوع مورد أصلًا. وفي حال وجود عدة بيئات Managed، اكتب وحدة للفريق (ملف تعريف تنبيهات، management zone، إشعار) تُستدعى بمتغيرات: تُنشر الشيفرة نفسها في بيئة الاختبار ثم في الإنتاج. وتربط الوحدة 3 هذه الفكرة بـ GitOps.
للمقارنة بين الأداتين، اقرأ Monaco أم Terraform والإعدادات كشيفرة مع Monaco.
تمرين عملي
في بيئة اختبار Managed فقط. لم تُنفَّذ الأوامر التالية من أجل هذا المقال: لا يُعرض أي ناتج، والسلوك الدقيق على عنقود Managed عليك أن تتحقق منه عندك.
الخطوة 1 — ضبط الواجهة الخلفية
في مجلد عمل، أنشئ providers.tf وbackend.tf كما في اللقطة الأولى، بواجهة خلفية من بنيتك التحتية. شغّل terraform init. النتيجة المتوقعة: يشير Terraform إلى تهيئة الواجهة الخلفية والمزوّد.
الخطوة 2 — تصدير نوع من الموارد
عرّف DYNATRACE_ENV_URL وDYNATRACE_API_TOKEN وDYNATRACE_TARGET_FOLDER، ثم شغّل تصدير dynatrace_alerting مع -id. النتيجة المتوقعة: مجلد يحتوي على main.tf ومجلد فرعي modules. تحقق من .flawed و.required_attention.
الخطوة 3 — الاستيراد والتحقق
أعد التصدير مع -import-state، ثم شغّل terraform plan في المجلد المصدَّر. النتيجة المتوقعة: لا تغييرات في الحالة المثالية؛ وإلا فحلّل كل فرق قبل تطبيق أي شيء.
الخطوة 4 — إحداث انجراف
عدّل ملف تعريف تنبيهات في الواجهة، ثم شغّل terraform plan -detailed-exitcode ودوّن رمز الخروج. النتيجة المتوقعة: الرمز 2 وفرق موصوف. صحّح الشيفرة أو البيئة.
اختبار
- لماذا نفضّل واجهة خلفية بعيدة على ملف حالة محلي في الفريق؟ أ) تجعل Terraform أسرع ب) تشارك الحالة وتقفل التنفيذ المتزامن بحسب الواجهة ج) تلغي الحاجة إلى رمز API د) تشفّر شيفرة HCL
- أي خيار في التصدير يستورد الموارد إلى الحالة؟ أ)
-refب)-flatج)-import-stateد)-id - ماذا يعني رمز الخروج 2 للأمر
terraform plan -detailed-exitcode؟ أ) خطأ ب) لا تغييرات ج) نجاح مع وجود تغييرات د) خطة ملغاة - ماذا يحتوي المجلد
.required_attention؟ أ) سجلات التصدير ب) ملفات تنقصها معلومات أساسية، مثل بيانات حساسة ج) نسخ الحالة الاحتياطية د) الوحدات القابلة لإعادة الاستخدام
الإجابات
- ب. تُشارَك الحالة، ومع واجهة خلفية كاملة تُقفل أثناء التنفيذ.
- ج. يهيّئ
-import-stateالوحدات ويستورد الموارد إلى الحالة. - ج. 0 تعني لا تغييرات، و1 خطأ، و2 وجود تغييرات.
- ب. تنقص هذه الملفات معلومات، مثل الأسرار التي لا يعيدها API.
للمزيد
- مزوّد Terraform لـ Dynatrace: التنبيهات وmanagement zones ولوحات المعلومات
- SLO في Dynatrace مع Terraform
- Monaco من Managed إلى SaaS: تصدير الإعدادات وإعادة تطبيقها
- وثائق Dynatrace Managed: Configuration as Code عبر Terraform
- مستودع مزوّد Terraform لـ Dynatrace
→ الوحدة 1: مزوّد Terraform · فهرس المسار · الوحدة 3: GitOps ←
الأسئلة الشائعة
هل نستورد أم نبدأ من الصفر؟
استورد إذا كانت البيئة تحمل إعدادات مفيدة: فالبدء من الصفر قد ينشئ نسخًا مكررة أو يستبدل إعدادات قائمة. ابدأ من الصفر فقط في بيئة فارغة.
هل تُصدَّر لوحات المعلومات؟
ليس افتراضيًا. تذكر الوثائق أن dynatrace_json_dashboard وموارد أخرى مستبعدة ما لم يُطلب تصديرها صراحةً. ويعطي الخيار -list-exclusions القائمة الكاملة.
هل ينطبق OAuth أو رمز المنصة على Managed؟
تتحدث صفحات التصدير في الوثائق عن رمز المنصة وOAuth، وهما من مفاهيم منصة SaaS. أما في Managed فتعتمد هذه الوحدة على DYNATRACE_ENV_URL وDYNATRACE_API_TOKEN. وصفحة التصدير غير موجودة في وثائق Managed: لم يُختبر استخدام التصدير على عنقود Managed هنا.
تحوّل الحالة والاستيراد ومراقبة الانجراف عنقودًا مُعدًّا يدويًا إلى إعدادات قابلة للتكرار. وتجمع الوحدة 3 هذه العناصر في مسار GitOps مع مراجعات وترقية بين البيئات.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. لا يحل هذا المسار محل دورات Dynatrace University وشهاداتها الرسمية. تحقق من الميزات في الوثائق الرسمية الخاصة بإصدارك.