أوامر على الجهاز
مجموعتان منفصلتان من الأوامر تصلان إلى Customer Edge، ولا تحتوي إحداهما على الأخرى.
- على الجهاز، تمتلك Site CLI 6 أوامر على المستوى الأعلى و82 أمرًا فرعيًا لـ
execcli. - عبر الشبكة، تمتلك debug API كتالوجها الخاص المكوّن من 34 أمرًا.
معظم سطح الأوامر على الجهاز لا يعادله شيء في API: فمستوى التحكم Vega بالكامل، وغلافات Envoy، والتقاط الحزم، ومجموعة معاملات kubelet، وملفات edit-* وزوج الوصول إلى الجذر المساعد لا تكون متاحة إلا من الجهاز نفسه.
الوصول إليها يتطلب SSH أو وحدة التحكم التسلسلية، وهناك شيء واحد غير موثق في أي مكان:
كيف تم قياس هذا، وكيف تتداخل المجموعات
Section titled “كيف تم قياس هذا، وكيف تتداخل المجموعات”المجموعة أدناه لم تُنسَخ من وثيقة بائع. بل قُرئت من عُقد حية باستخدام scripts/sitecli_ssh_harvest.py وأُودعت في sitecli/exec-catalog.json مع مصدرها. ثلاث تشغيلات، في ثلاث حالات تسجيل:
| تم القياس عند | المستوى الأعلى | execcli |
|---|---|---|
site_state: PROVISIONING | 6 | 82 |
site_state: PROVISIONED | 6 | 82 |
site_state: ONLINE | 6 | 82 |
أعادت الثلاثة جميعها مجموعات متطابقة — نفس الأسماء، وليس مجرد نفس الإجماليات، وكان الأخير عملية نشر مختلفة بأسماء موقع وموارد مختلفة. لذا فإن سطح الأوامر لا يتغير مع حالة التسجيل، والأمر الغائب يكون غائبًا فعلًا لا لأنه لم يُعرَض بعد.
مقارنةً بالـ 34 لواجهة debug API، يعطي ذلك رقمين يستحق التمييز بينهما:
- 51 أمرًا فرعيًا من
execcliلا يعادله شيء في API. - 55 هو نفس الرقم محسوبًا عبر كامل سطح الجهاز، لأنه يشمل أيضًا أوامر
configure*الأربعة التي تعيش على المستوى الأعلى بدلًا من تحتexeccli.
كلاهما صحيح؛ والقارئ الذي يعيد حساب أحدهما ويجد الآخر لم يرتكب خطأ. كل رقم هنا مشتق من sitecli/catalog.json وsitecli/exec-catalog.json.
ما هو موثق وما هو مدرج فقط
Section titled “ما هو موثق وما هو مدرج فقط”يشغّل Customer Edge نظام Linux وعددًا من الخدمات الخارجية. توثيق أوامرها سيكرر مراجعها الخاصة ويوحي بأن F5 تمتلكها، لذا فالقاعدة هي: وثّق برمجيات F5، وبالنسبة لكل شيء آخر وثّق فقط ما هو خاص بـ CE.
ثلاث مستويات، لأن “ملكنا” و”ملكهم” ليست تفرقة واضحة. التفرقة مسجّلة في sitecli/command-classification.json.
| المستوى | المعالجة |
|---|---|
| برمجيات F5 | توثيق كامل — الغرض والصياخة والمعاملات والمخرجات الملتقطة وما يجب البحث عنه. Argo وVega وvpm وvifdump وconfigure* ومجموعة edit-* ومعاملات kubelet والوصول إلى الجذر. |
| تفسير خاص بـ CE | أداة خارجية تعني مخرجاتها شيئًا خاصًا على CE. يُوثَّق التفسير الخاص بـ CE وتُترك دلالات الأداة الخاصة بها للمصادر الأصلية. |
| مرور | نظام Linux أو خارجي بدون شيء خاص بـ CE لقوله. مدرج كمتاح مع إشارة للمصادر الأصلية. بدون نص. |
هذا التمييز يحدد ما إذا كانت الصفحة موجودة أصلًا، وهو ما يحول دون تحوّل هذا التوثيق إلى نسخة أسوأ من صفحات man.
برمجيات F5
Section titled “برمجيات F5”vegactl commands: configuration objects, introspection tables, trace buffers, and which node holds the primary role.vifdump commands. Documented, never run here: they write capture files onto the node.edit-* commands that open F5-owned files on the node.xuser root account. Support-directed, and it leaves the node modified.configure* commands at the Site CLI top level.متاح على الجهاز وغير موثق هنا — هذه هي نظام التشغيل والخدمات الخارجية، وليست برمجيات F5، ومراجعها الخاصة أفضل مما يمكن أن تعيد هذه الصفحة قوله.
| الأوامر | المصدر الأصلي |
|---|---|
ping, netstat, lsof, ip, ip-link-show, nmcli, tracepath | iproute2, NetworkManager |
top, check-mem, sysctl, load-sysctl-conf, journalctl, files, rpm-ostree, chronyc-sources | coreutils, procps, systemd, rpm-ostree, chrony |
edit-etc-hosts, edit-sysctl-conf | الملفات هي ملفات نظام التشغيل |
systemctl-status-crio, systemctl-status-docker, systemctl-status-kubelet, systemctl-status-iscsid, systemctl-status-multipathd | systemd |
systemctl-restart-crio, systemctl-restart-docker, systemctl-restart-kubelet, systemctl-restart-iscsid, systemctl-restart-multipathd | systemd — كل واحد من هذه الأوامر يعطّل أحمال العمل على العقدة |
اثنان من هذه يستحق معرفتهما حتى وإن لم تكن لهما صفحة خاصة. يُجري files عمليات على الملفات ولن يكتب إلا تحت /tmp. وكل systemctl-restart-* تعطيلي بطبيعته — إعادة تشغيل crio أو kubelet يعطّل أحمال العمل على تلك العقدة.