Dynatrace Operator Kubernetes وOpenShift: الاتصال بعنقود Managed

Dynatrace Operator Kubernetes مرتبط بعنقود Managed: DynaKube والشهادات الداخلية والسجلات الخاصة وقيود OpenShift، خطوة بخطوة.
Kubernetes et OpenShift : connecter Dynatrace Operator à un cluster Managed

جعلت عناقيد Kubernetes وOpenShift تثبيت الوكلاء «يدويًا» على كل مضيف أمرًا قديمًا. فالعقد تولد وتموت مع التوسع التلقائي، وتنتقل الـ pods، وتريد فرق المنصة أن يكون كل شيء تصريحيًا وخاضعًا للإصدارات ومتوافقًا تلقائيًا. وفي مجال قابلية الملاحظة (observability) يعني ذلك أن دورة حياة OneAgent وActiveGate يجب أن يديرها Kubernetes نفسه. وهذه هي مهمة Dynatrace Operator Kubernetes: يتولى Kubernetes نشر الوكلاء وتحديثهم بنفسه.

هذا هو دور Dynatrace Operator ومورده المخصص DynaKube. غير أن معظم الأمثلة المتاحة تفترض بيئة SaaS يمكن بلوغها عبر الإنترنت. أما في سياق Dynatrace Managed فالأسئلة مختلفة: عنوان API يشير إلى نطاقك الخاص، وشهادة العنقود تصدر غالبًا عن PKI داخلية، وسجلات الصور العامة ليست متاحة دائمًا، وتعبر التدفقات الشبكية بين عنقود Kubernetes وعنقود Managed جدرانًا نارية تديرها أنت.

يشرح هذا المقال كيفية ربط Dynatrace Operator ببيئة Managed، على Kubernetes القياسي وعلى OpenShift، بإعداد DynaKube يلائم هذه القيود.

البنية: ما الذي ينشره Operator

  • Operator نفسه، الذي يراقب موارد DynaKube ويوفّق الحالة المطلوبة.
  • الـ webhook، الذي يحقن وحدات الشيفرة في pods التطبيقات (وضع cloud-native) ويتحقق من موارد DynaKube.
  • مشغّل CSI (بحسب الوضع)، الذي يخزّن ثنائيات OneAgent مؤقتًا على كل عقدة لتفادي التنزيلات المتكررة.
  • OneAgent على شكل DaemonSet، أي pod واحد لكل عقدة، لرؤية المضيف والحقن.
  • ActiveGate على شكل StatefulSet، يتولى مراقبة API الخاص بـ Kubernetes ويمكنه توجيه حركة الوكلاء إلى عنقود Managed.

تتواصل كل هذه المكونات مع API البيئة، المعروض في Managed على العنوان https://{votre-domaine}/e/{id-environnement}/api.

اختيار وضع النشر

وضع DynaKube المبدأ متى يُستخدم
cloudNativeFullStack OneAgent على المضيف مع الحقن في الـ pods عبر webhook الخيار الافتراضي الموصى به لمعظم العناقيد
applicationMonitoring الحقن في الـ pods فقط، دون وكيل على المضيف المنصات التي تمنع DaemonSets ذات الامتيازات
hostMonitoring وكيل على المضيف دون حقن في التطبيقات مراقبة البنية التحتية للعقد
classicFullStack الأسلوب التاريخي، حقن على مستوى المضيف التوافق مع عمليات النشر القديمة

تتطور الأوضاع المتاحة وسلوكها مع إصدارات Operator وAPI الخاص بـ DynaKube: راجع مصفوفة التوافق بين إصدار Managed لديك وإصدار Operator قبل الاختيار.

المتطلبات في جهة Managed

  • بيئة مخصصة أو مشتركة، ومعرّفها الظاهر في العنوان /e/{id-environnement}.
  • رمز Operator (رمز API) أُنشئ بالقالب Kubernetes: Dynatrace Operator: InstallerDownload وDataExport وsettings.read وsettings.write وactiveGateTokenManagement.create (لم يعد entities.read مطلوبًا منذ Operator 1.7.0).
  • رمز استيعاب البيانات (ingestion token) بالقالب Kubernetes: Data Ingest: metrics.ingest وlogs.ingest وopenTelemetryTrace.ingest.
  • تدفق HTTPS مفتوح من عقد Kubernetes إلى عقد Managed أو إلى ActiveGate.
  • شهادة سلطة الجذر في PKI لديك بصيغة PEM (انظر شهادات SSL ونطاق العنقود) إذا كان عنقود Managed لا يستخدم شهادة عامة.
  • إصدار حديث بما يكفي من عنقود Managed لإصدار Operator المستهدف.

دليل تطبيقي خطوة بخطوة: Dynatrace Operator Kubernetes

الخطوة 1: التحقق من الوصول إلى API من داخل العنقود

شغّل pod مؤقتًا لاختبار المسار الشبكي من داخل العنقود:

kubectl run nettest --rm -it --restart=Never --image=curlimages/curl -- \
  curl -sS -o /dev/null -w "%{http_code}\n" \
  -H "Authorization: Api-Token {token}" \
  https://{votre-domaine}/e/{id-environnement}/api/v1/time

يتضمن رمز Operator النطاق DataExport الذي يتطلبه هذا الاستدعاء: فالرمز 200 يؤكد الشبكة والرمز معًا. أما خطأ الشهادة فيعني أنه يجب تزويد DynaKube بسلطة الجذر (الخطوة 4).

الخطوة 2: تثبيت Operator

أنشئ مساحة الأسماء (namespace) ثم ثبّت Operator بمخطط Helm الرسمي أو بالملفات (manifests) المنشورة لإصدارك:

kubectl create namespace dynatrace

helm install dynatrace-operator oci://public.ecr.aws/dynatrace/dynatrace-operator \
  --namespace dynatrace --version {version-operator} --atomic

kubectl -n dynatrace get pods

على OpenShift ينطبق أمر Helm نفسه: تُكتشف المنصة تلقائيًا عند التثبيت (ويبقى OperatorHub بديلًا). تلزم قيود سياق الأمان (Security Context Constraints) في الوضعين cloudNativeFullStack وapplicationMonitoring مع مشغّل CSI. وفي البيئة المنفصلة عن الإنترنت انسخ الصور مسبقًا إلى سجلك الداخلي وعدّل مراجع الصور في قيم Helm.

الخطوة 3: إنشاء سر الرموز

kubectl -n dynatrace create secret generic {nom-dynakube} \
  --from-literal="apiToken={token-operator}" \
  --from-literal="dataIngestToken={token-ingestion}"

يجب أن يحمل السر اسم مورد DynaKube نفسه، ما لم تشر إليه صراحةً في المواصفات (spec).

الخطوة 4: تزويد شهادة PKI الخاصة بك

kubectl -n dynatrace create configmap dynatrace-trusted-ca \
  --from-file=certs=/chemin/vers/ca-interne.pem

المفتاح certs هو ما ينتظره Operator. ويُشار إلى هذا الـ ConfigMap في الحقل trustedCAs.

الخطوة 5: تعريف مورد DynaKube

apiVersion: dynatrace.com/{version-api-dynakube}
kind: DynaKube
metadata:
  name: {nom-dynakube}
  namespace: dynatrace
spec:
  apiUrl: https://{votre-domaine}/e/{id-environnement}/api
  trustedCAs: dynatrace-trusted-ca
  networkZone: {zone-reseau}
  oneAgent:
    hostGroup: {cluster-k8s}_{environnement}
    cloudNativeFullStack: {}
  activeGate:
    capabilities:
      - kubernetes-monitoring
      - routing
    resources:
      requests:
        cpu: 500m
        memory: 1Gi
      limits:
        cpu: 1000m
        memory: 2Gi

قيمة apiVersion (مثل v1beta2 أو v1beta3…) وبعض الحقول تتغير بين الإصدارات: يوضع hostGroup تحت spec.oneAgent، وتستبدل إصدارات Operator الحديثة القدرة kubernetes-monitoring بالقسم spec.kubernetesMonitoring (وهما يستبعد أحدهما الآخر). انطلق دائمًا من المثال المرفق بإصدار Operator المثبّت. أما موارد ActiveGate فهي أرقام تقريبية تُضبط بحسب حجم العنقود.

kubectl apply -f dynakube.yaml
kubectl -n dynatrace get dynakube
kubectl -n dynatrace get pods -o wide

الخطوة 6: التحقق من الاتصال

kubectl -n dynatrace describe dynakube {nom-dynakube}
kubectl -n dynatrace logs deploy/dynatrace-operator --tail=100

يجب أن يبلغ المورد المرحلة Running. وفي البيئة يظهر عنقود Kubernetes في عرض Kubernetes، وتظهر العقد في قائمة المضيفين مع المجموعة المحددة.

الخطوة 7: مراقبة الحقن

أعد تشغيل تطبيق تجريبي ثم تحقق من وجود الملاحظات (annotations) أو وحدات التخزين (volumes) التي أضافها الـ webhook:

kubectl -n {namespace-app} rollout restart deployment/{application}
kubectl -n {namespace-app} get pod -l app={application} -o yaml | grep -i dynatrace

لحصر الحقن في بعض مساحات الأسماء، استخدم namespaceSelector في DynaKube بدل قياس العنقود كله منذ البداية.

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

  • ضع DynaKube وقيم Helm تحت إدارة الإصدارات في Git وطبّقهما عبر أداة GitOps لديك.
  • طابق إصدار Operator مع مصفوفة التوافق لإصدار Managed قبل كل ترقية.
  • استخدم سجلًا داخليًا للصور في البيئات المقيّدة، واختبر جلب الصورة على عقدة.
  • استبعد مساحات أسماء النظام (kube-system وopenshift-*) من الحقن.
  • حدّد حجم ActiveGate بحسب عدد كائنات Kubernetes المراقَبة، وراقب استهلاكه للذاكرة.
  • جدّد الرموز بانتظام بمجرد تحديث السر.

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

أي وضع DynaKube أختار مع عنقود Managed؟

الوضع cloudNativeFullStack هو الخيار الافتراضي لمعظم العناقيد. وإذا كانت DaemonSets ذات الامتيازات ممنوعة، فيقتصر applicationMonitoring على الحقن في الـ pods. وتحقق في جميع الحالات من مصفوفة التوافق بين إصدار Managed وإصدار Operator.

ماذا أفعل إذا أعاد اختبار API خطأ في الشهادة؟

هذه علامة على أن عنقود Managed يستخدم شهادة صادرة عن PKI داخلية. أنشئ ConfigMap يحتوي سلطة الجذر بصيغة PEM تحت المفتاح certs، ثم أشر إليه في الحقل trustedCAs من DynaKube.

كيف أتجنب قياس العنقود كله دفعة واحدة؟

استخدم namespaceSelector في DynaKube لحصر الحقن في مساحات الأسماء المطلوبة، واستبعد مساحات النظام مثل kube-system وopenshift-*.

الخلاصة

لا يتطلب ربط Dynatrace Operator بعنقود Managed آلية خاصة، لكنه يستلزم معالجة صريحة لما يخفيه SaaS: عنوان API على نطاقك، والشهادات الداخلية، والسجلات الخاصة، والتدفقات الشبكية. وبمورد DynaKube تصريحي وخاضع للإصدارات ومتلائم مع PKI لديك، يصبح Kubernetes وOpenShift مكونين من الدرجة الأولى في منصة قابلية الملاحظة داخل المؤسسة (on-premise).

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

Total
0
Shares
Leave a Reply

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

Previous Post
Installer OneAgent sur Windows Server en mode silencieux

تثبيت OneAgent Windows بصمت على Windows Server باستخدام PowerShell

Next Post
Gérer des environnements multi-tenant et des quotas de licence dans la CMC

البيئات متعددة المستأجرين وحصص الترخيص في Dynatrace Managed

Related Posts