إنتقل إلى المحتوى الرئيسي
الإصدار: 0.4 · الحالي

إدارة الكيانات

دليل إرشاديتمت المراجعة في 11 أكتوبر 2026
ينطبق على:Excubius 0.4الأدوار: مسؤول الكيان
الخططFree · Core · Pro · Enterpriseالنشراستضافة ذاتية

الكيانات هي الشجرة التي تضم مواردك: الشركات والعملاء والبيئات والفرق. وكل ما تضبطه على كيان يرثه كل ما تحته. يوضح هذا الدليل كيفية بناء الشجرة وتغييرها ضمن Settings › Entities، وأين تضبط ما يمرره كل كيان إلى ما تحته، وكيفية وضع علامات على الموارد لتجميعها عبر الشجرة.

قبل البدء​

  • تحتاج إلى دور Entity admin على الكيان الذي تغيّره. ولإنشاء كيان تحتاج إليه على الكيان الأصل؛ ولنقل كيان تحتاج إليه على الكيان نفسه وعلى أصله الجديد.
  • خطط للمستويات التي تحتاج إليها. أنواع الكيانات (tenant وclient وenvironment وgroup) مجرد تسميات ولا تغيّر أي سلوك. لمعرفة كيفية عمل الوراثة، راجع الكيانات والعلامات والوراثة.

في الأمثلة، ليوا للتقنية هي الجذر، وشركة خان الخليلي عميل تحتها، وProduction وUAT بيئتاها.

إنشاء كيان​

  1. افتح Settings › Entities. تعرض الشجرة الكيان المختار في أداة الاختيار وكل ما تحته، مع عدد الموارد في كل فرع.
  2. على الكيان الأصل، مثل شركة خان الخليلي، افتح قائمة إجراءاته وحدد Add an entity below.
  3. أدخل Name، مثل Production.
  4. اختر Kind، مثل environment.
  5. يمكنك اختياريًا إدخال Short name، ويُستخدم في المسارات: أحرف لاتينية صغيرة وأرقام وواصلات، وهو فريد في التثبيت كله. وعند تركه فارغًا يُشتق من الاسم. ولا يمكن تغييره لاحقًا.
  6. حدد Create.

يوجد كيان جذر واحد فقط؛ ولكل كيان آخر كيان أصل.

إعادة تسمية كيان​

  1. افتح قائمة إجراءات الكيان وحدد Rename.
  2. غيّر Name، وKind إذا لزم الأمر. ولا يمكن تغيير نوع الجذر.
  3. حدد Save.

يبقى الاسم المختصر كما كان، فتواصل الروابط والمسارات عملها.

نقل كيان​

يؤدي نقل كيان إلى نقل كل ما تحته، ومن ذلك الحين يرث الجميع من موضعه الجديد: الحدود وقنوات Slack ونوافذ الصيانة والتسجيل والأدوار.

  1. افتح قائمة إجراءات الكيان وحدد Move.
  2. اختر New parent. لا تُعرض إلا الكيانات التي تديرها، ولا يُعرض الكيان نفسه ولا أي كيان تحته أبدًا.
  3. حدد Move.

لا يمكن نقل الجذر. ويسجّل سجل التدقيق كل عملية نقل.

حذف كيان​

يمكنك حذف كيان بعد ألا يبقى تحته شيء.

  1. أزل ما يحتويه أو انقله: الكيانات الفرعية والموارد والمصادر. ويؤدي حذف مورد إلى حذف تنبيهاته أيضًا.
  2. افتح قائمة إجراءات الكيان وحدد Delete. يتوفر الخيار فقط عندما يكون الكيان فارغًا.
  3. حدد Delete للتأكيد. وتُحذف مع الكيان بيانات اعتماده وقنوات Slack وتعيينات الأدوار الخاصة به.

يرفض Excubius الحذف عندما يظل للكيان كيانات فرعية أو موارد أو مصادر أو تنبيهات، أو عندما تستخدم موارد في مكان آخر إحدى بيانات اعتماده. ولا يمكن حذف الجذر.

ضبط ما يمرره الكيان إلى ما تحته​

لكل إعداد موروث شاشته الخاصة. اختر الكيان في أداة الاختيار، أو افتحه من Settings › Entities.

الإعدادالمكانالدليل
القيم الافتراضية لحدود كل فحصSettings › Entities، قائمة الإجراءات، Threshold defaultsتغيير الحدود وإيقاف الفحوص
الأدوار ومن يحصل على حسابSettings › Users and rolesإدارة المستخدمين والأدوار
بيانات الاعتماد للمُجمِّعSettings › Credentialsتخزين بيانات اعتماد للمُجمِّع
قنوات SlackSettings › Notificationsتكوين إشعارات Slack
نوافذ الصيانةSettings › Maintenance windowsالتخطيط لنافذة صيانة
السمة والشعار الافتراضيانSettings › Branch appearanceإعداد صفحة الحالة العامة
صفحة الحالة العامةSettings › Status pageإعداد صفحة الحالة العامة

وضع علامات على الموارد​

العلامات هي تسميات بصيغة key:value توضع على الموارد، مثل env:prod أو role:sql أو client:ciguapa. يوجد المورد في موضع واحد من الشجرة، لكن العلامات تتيح لك تجميعه مع موارد أخرى من أي موضع في الشجرة.

لوضع علامات على مورد:

  1. افتح المورد وحدد Edit. وعند إضافة مورد، يحتوي المعالج على خطوة Tags تعمل بالطريقة نفسها.
  2. في Tags، أدخل أزواج key:value مفصولة بمسافات، مثل env:prod role:sql client:ciguapa. تستخدم المفاتيح حروفًا وأرقامًا ونقطة وشرطة وشرطة سفلية، ويظهر كل مفتاح مرة واحدة.
  3. اضبط Criticality، من 1 (منخفضة) إلى 5 (حرجة). وهي حقل مستقل وليست علامة، وتُستخدم في التوجيه والمخاطر ودرجة الأمان.
  4. حدد Save.

استخدم على الأقل env وrole وclient على كل مورد، واضبط مستوى الحرجية.

لاستخدام العلامات:

  • في Resources، أدخل Tag rule. يعرض role:sql env:prod الموارد التي تحمل العلامتين معًا؛ ويعرض المفتاح وحده، مثل client، كل مورد يحمل هذا المفتاح.
  • في Overview، اختر طريقة العرض Hex وGroup by لمفتاح علامة لرؤية مجموعة واحدة من السداسيات لكل قيمة.

التنفيذ عبر API​

المهمةالطلب
الإنشاءPOST /api/v1/entities مع parent_id وname، وkind وslug (اختياريان)
إعادة التسمية أو تغيير النوعPATCH /api/v1/entities/{id} مع name أو kind
النقلPATCH /api/v1/entities/{id} مع parent_id
الحذفDELETE /api/v1/entities/{id}؛ ويرد بالرمز 409 مع السبب ما دام الكيان غير فارغ
وضع علامات على موردPATCH /api/v1/resources/{id} مع tags، وهو كائن مثل {"env": "prod", "role": "sql"}، وcriticality