ऑन-बॉक्स कमांड
दो अलग कमांड सेट एक Customer Edge तक पहुँचते हैं, और कोई भी दूसरे को पूरी तरह समाहित नहीं करता।
- बॉक्स पर, Site CLI में 6 शीर्ष-स्तरीय कमांड और 82
execcliसबकमांड हैं। - नेटवर्क के माध्यम से, debug API का अपना 34 कमांड का कैटलॉग है।
ऑन-बॉक्स सतह का अधिकांश भाग किसी API के समकक्ष के बिना है: संपूर्ण Vega कंट्रोल प्लेन, Envoy रैपर, पैकेट कैप्चर, kubelet पैरामीटर सेट, edit-* फाइलें और सहायक root-access जोड़ी केवल बॉक्स से ही पहुँच योग्य हैं।
इन तक पहुँचने के लिए 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 |
तीनों ने समान सेट लौटाए — केवल समान कुल नहीं, बल्कि समान नाम, और अंतिम एक अलग डिप्लॉयमेंट था जिसमें अलग साइट और संसाधन नाम थे। तो कमांड सतह पंजीकरण अवस्था के साथ नहीं बदलती, और जो कमांड अनुपस्थित है वह वास्तव में अनुपस्थित है न कि अभी तक प्रदान नहीं किया गया।
debug API के 34 कमांड के विरुद्ध, इससे दो आँकड़े मिलते हैं जिन्हें सही रखना उचित है:
- 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 पैरामीटर, root एक्सेस। |
| CE-विशिष्ट व्याख्या | एक थर्ड-पार्टी उपकरण जिसका आउटपुट CE पर कुछ विशेष अर्थ रखता है। CE-विशिष्ट पठन प्रलेखित है और उपकरण के अपने शब्दार्थ अपस्ट्रीम पर छोड़े गए हैं। |
| पासथ्रू | सादा Linux या थर्ड-पार्टी जिसके बारे में CE-विशिष्ट कुछ नहीं कहना है। उपलब्ध के रूप में सूचीबद्ध, अपस्ट्रीम की ओर संकेत के साथ। कोई गद्य नहीं। |
वह विभाजन तय करता है कि कोई पृष्ठ मौजूद है या नहीं, और यही इस दस्तावेज़ीकरण को man pages की बदतर प्रति बनने से बचाता है।
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.पासथ्रू
Section titled “पासथ्रू”बॉक्स पर उपलब्ध और यहाँ प्रलेखित नहीं — ये ऑपरेटिंग सिस्टम और थर्ड-पार्टी डेमॉन हैं, 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 को पुनरारंभ करने से उस नोड के वर्कलोड बाधित होते हैं।