إدارة الكيانات
الكيانات هي الشجرة التي تضم مواردك: الشركات والعملاء والبيئات والفرق. وكل ما تضبطه على كيان يرثه كل ما تحته. يوضح هذا الدليل كيفية بناء الشجرة وتغييرها ضمن Settings › Entities، وأين تضبط ما يمرره كل كيان إلى ما تحته، وكيفية وضع علامات على الموارد لتجميعها عبر الشجرة.
قبل البدء
- تحتاج إلى دور Entity admin على الكيان الذي تغيّره. ولإنشاء كيان تحتاج إليه على الكيان الأصل؛ ولنقل كيان تحتاج إليه على الكيان نفسه وعلى أصله الجديد.
- خطط للمستويات التي تحتاج إليها. أنواع الكيانات (tenant وclient وenvironment وgroup) مجرد تسميات ولا تغيّر أي سلوك. لمعرفة كيفية عمل الوراثة، راجع الكيانات والعلامات والوراثة.
في الأمثلة، ليوا للتقنية هي الجذر، وشركة خان الخليلي عميل تحتها، وProduction وUAT بيئتاها.
إنشاء كيان
- افتح Settings › Entities. تعرض الشجرة الكيان المختار في أداة الاختيار وكل ما تحته، مع عدد الموارد في كل فرع.
- على الكيان الأصل، مثل شركة خان الخليلي، افتح قائمة إجراءاته وحدد Add an entity below.
- أدخل Name، مثل
Production. - اختر Kind، مثل environment.
- يمكنك اختياريًا إدخال Short name، ويُستخدم في المسارات: أحرف لاتينية صغيرة وأرقام وواصلات، وهو فريد في التثبيت كله. وعند تركه فارغًا يُشتق من الاسم. ولا يمكن تغييره لاحقًا.
- حدد Create.
يوجد كيان جذر واحد فقط؛ ولكل كيان آخر كيان أصل.
إعادة تسمية كيان
- افتح قائمة إجراءات الكيان وحدد Rename.
- غيّر Name، وKind إذا لزم الأمر. ولا يمكن تغيير نوع الجذر.
- حدد Save.
يبقى الاسم المختصر كما كان، فتواصل الروابط والمسارات عملها.
نقل كيان
يؤدي نقل كيان إلى نقل كل ما تحته، ومن ذلك الحين يرث الجميع من موضعه الجديد: الحدود وقنوات Slack ونوافذ الصيانة والتسجيل والأدوار.
- افتح قائمة إجراءات الكيان وحدد Move.
- اختر New parent. لا تُعرض إلا الكيانات التي تديرها، ولا يُعرض الكيان نفسه ولا أي كيان تحته أبدًا.
- حدد Move.
لا يمكن نقل الجذر. ويسجّل سجل التدقيق كل عملية نقل.
حذف كيان
يمكنك حذف كيان بعد ألا يبقى تحته شيء.
- أزل ما يحتويه أو انقله: الكيانات الفرعية والموارد والمصادر. ويؤدي حذف مورد إلى حذف تنبيهاته أيضًا.
- افتح قائمة إجراءات الكيان وحدد Delete. يتوفر الخيار فقط عندما يكون الكيان فارغًا.
- حدد Delete للتأكيد. وتُحذف مع الكيان بيانات اعتماده وقنوات Slack وتعيينات الأدوار الخاصة به.
يرفض Excubius الحذف عندما يظل للكيان كيانات فرعية أو موارد أو مصادر أو تنبيهات، أو عندما تستخدم موارد في مكان آخر إحدى بيانات اعتماده. ولا يمكن حذف الجذر.
ضبط ما يمرره الكيان إلى ما تحته
لكل إعداد موروث شاشته الخاصة. اختر الكيان في أداة الاختيار، أو افتحه من Settings › Entities.
| الإعداد | المكان | الدليل |
|---|---|---|
| القيم الافتراضية لحدود كل فحص | Settings › Entities، قائمة الإجراءات، Threshold defaults | تغيير الحدود وإيقاف الفحوص |
| الأدوار ومن يحصل على حساب | Settings › Users and roles | إدارة المستخدمين والأدوار |
| بيانات الاعتماد للمُجمِّع | Settings › Credentials | تخزين بيانات اعتماد للمُجمِّع |
| قنوات Slack | Settings › Notifications | تكوين إشعارات Slack |
| نوافذ الصيانة | Settings › Maintenance windows | التخطيط لنافذة صيانة |
| السمة والشعار الافتراضيان | Settings › Branch appearance | إعداد صفحة الحالة العامة |
| صفحة الحالة العامة | Settings › Status page | إعداد صفحة الحالة العامة |
وضع علامات على الموارد
العلامات هي تسميات بصيغة key:value توضع على الموارد، مثل env:prod أو role:sql أو client:ciguapa. يوجد المورد في موضع واحد من الشجرة، لكن العلامات تتيح لك تجميعه مع موارد أخرى من أي موضع في الشجرة.
لوضع علامات على مورد:
- افتح المورد وحدد Edit. وعند إضافة مورد، يحتوي المعالج على خطوة Tags تعمل بالطريقة نفسها.
- في Tags، أدخل أزواج
key:valueمفصولة بمسافات، مثلenv:prod role:sql client:ciguapa. تستخدم المفاتيح حروفًا وأرقامًا ونقطة وشرطة وشرطة سفلية، ويظهر كل مفتاح مرة واحدة. - اضبط Criticality، من 1 (منخفضة) إلى 5 (حرجة). وهي حقل مستقل وليست علامة، وتُستخدم في التوجيه والمخاطر ودرجة الأمان.
- حدد 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 |