تثبيت الوكيل على Linux

تنزيل حزمة التسجيل

أنشئوا تسجيلاً لخادم Linux في مساحة العمل المطلوبة من لوحة الإدارة. تُنزّل الحزمة في ملف enrollment.json يتضمن رمز تسجيل يُستخدم مرة واحدة. يظهر في قائمة الخوادم الجهاز الذي يستخدم هذا الرمز لإتمام التسجيل.

يُضاف الخادم إلى مجموعة الأجهزة المسجّلة بأمر تثبيت واحد ورمز تسجيل، وإلغاء تسجيله يفصله عن المنظومة.

التثبيت

شغّلوا الوكيل أولاً في الطرفية للتأكد من نجاح التسجيل:

dsh-host-agent run --enrollment-file enrollment.json

بعد نجاح الاتصال، ثبّتوه كخدمة تعمل في الخلفية. يسجّل نص التثبيت المرفق بالحزمة خدمة systemd، وينشئ حساب dsh-agent مخصصاً لتشغيلها دون صلاحيات المستخدم الجذر:

sudo ./install.sh --enrollment-file enrollment.json

مسارات الملفات

• مجلد التثبيت: /opt/dsh-host-agent، يملكه المستخدم الجذر، وتستطيع مجموعة dsh-agent قراءته.
• مجلد الحالة: /var/lib/dsh-host-agent، بصلاحيات 700، ويملكه حساب dsh-agent. يمكن تغيير موقعه باستخدام DSH_AGENT_STATE_DIR.
• ملف تعريف الخدمة: /etc/systemd/system/dsh-host-agent.service.

سياسة التنفيذ

سياسة التنفيذ للقراءة فقط هي الافتراضية على كل خادم مسجّل، والسياسة الكاملة خيار صريح لكل خادم.

ينتمي حساب dsh-agent إلى مجموعات التشخيص التي تتيح قراءة السجلات، مثل adm وsystemd-journal، بدلاً من التشغيل بحساب المستخدم الجذر. تحدد سياسة التنفيذ الأوامر التي يمكن تشغيلها، وتحدد صلاحيات الحساب الملفات والموارد التي تستطيع هذه الأوامر الوصول إليها.

فحص الخدمة

بعد التثبيت، يرسل الوكيل إشارة حالة كل 30 ثانية، ويزامن دليل المهارات الموقّع كل خمس دقائق. استخدموا الأوامر التالية للتحقق من حالته دون تغيير الخدمة:

dsh-host-agent status
dsh-host-agent status --local
dsh-host-agent diagnose

إلغاء التثبيت

يزيل الأمر التالي خدمة الخلفية، ويُبقي ملفات الحالة المحلية:

dsh-host-agent uninstall