F5 XC संदर्भ

xcsh संदर्भों (contexts) के माध्यम से F5 Distributed Cloud से जुड़ता है — ये नामित क्रेडेंशियल सेट हैं जो एक टेनेंट URL, API टोकन और नेमस्पेस को बाइंड करते हैं। यदि आपने kubectl config use-context या kubectx का उपयोग किया है, तो कार्यप्रवाह समान है: एक संदर्भ बनाएं, नाम से उनके बीच स्विच करें, और वापस पलटने के लिए - का उपयोग करें।

शुरुआत करना

1. अपना पहला संदर्भ बनाएं

आपको अपने F5 XC कंसोल से तीन चीज़ों की आवश्यकता है: टेनेंट URL, एक API टोकन, और वैकल्पिक रूप से एक नेमस्पेस।

/context create production https://acme.console.ves.volterra.io p12k3-your-api-token

Context 'production' created. Use /context activate production to switch to it.

या यदि आप चरण-दर-चरण प्रॉम्प्ट पसंद करते हैं तो गाइडेड विज़ार्ड का उपयोग करें:

/context wizard

2. इसे सक्रिय करें

/context production

╭─ production ─────────────────────────────────────────────────╮
│ XCSH_TENANT     acme                                         │
│ XCSH_API_URL    https://acme.console.ves.volterra.io         │
│ XCSH_API_TOKEN  ...oken                                      │
│ Status          Connected (312ms)                            │
├─ Environment ────────────────────────────────────────────────┤
│ XCSH_NAMESPACE  default                                      │
╰──────────────────────────────────────────────────────────────╯

सक्रिय होने पर, xcsh आपके सत्र में टेनेंट क्रेडेंशियल्स इंजेक्ट करता है। एजेंट अब F5 XC API कॉल कर सकता है, और स्टेटस लाइन सक्रिय संदर्भ दिखाती है।

3. और संदर्भ जोड़ें और उनके बीच स्विच करें

/context create staging https://staging.console.ves.volterra.io p12k3-staging-token

नाम से स्विच करें — किसी सबकमांड क्रिया की आवश्यकता नहीं:

/context staging

पिछले संदर्भ पर वापस जाएं (cd - शैली):

/context -

/context - को दो बार कॉल करने से आप वापस वहीं पहुंच जाते हैं जहां से आपने शुरू किया था।

4. देखें आपके पास क्या है

/context

  production           https://acme.console.ves.volterra.io
* staging              https://staging.console.ves.volterra.io

* सक्रिय संदर्भ को चिह्नित करता है।

दैनिक कमांड

कमांड	यह क्या करता है
/context	सभी संदर्भों की सूची दिखाएं
/context <name>	किसी संदर्भ पर स्विच करें
/context -	पिछले संदर्भ पर स्विच करें
/context show	सक्रिय संदर्भ का विवरण दिखाएं (टोकन छिपे हुए)
/context status	वर्तमान प्रमाणीकरण स्थिति दिखाएं

संदर्भ जीवनचक्र

कमांड	यह क्या करता है
/context create <name> <url> <token> [namespace]	एक संदर्भ बनाएं
/context delete <name> --confirm	एक संदर्भ हटाएं (--confirm आवश्यक)
/context rename <old> <new>	एक संदर्भ का नाम बदलें
/context validate <name>	स्विच किए बिना क्रेडेंशियल्स का परीक्षण करें
/context export [name] [--include-token]	JSON के रूप में निर्यात करें (टोकन डिफ़ॉल्ट रूप से छिपे हुए)
/context import <path-or-json> [--overwrite]	फ़ाइल या इनलाइन JSON से आयात करें
/context wizard	गाइडेड इंटरैक्टिव सेटअप

नेमस्पेस स्विच करना

प्रत्येक संदर्भ में एक डिफ़ॉल्ट नेमस्पेस होता है। संदर्भ बदले बिना इसे स्विच करें:

/context namespace system

टैब कंप्लीशन सक्रिय टेनेंट से नेमस्पेस नाम प्रदान करता है।

संदर्भों पर एनवायरनमेंट वेरिएबल

संदर्भ अतिरिक्त एनवायरनमेंट वेरिएबल ले जा सकते हैं जो सक्रियण पर आपके सत्र में इंजेक्ट किए जाते हैं। प्रति-टेनेंट कॉन्फ़िगरेशन के लिए उपयोगी जो क्रेडेंशियल सेट का हिस्सा नहीं है।

/context set CUSTOM_HEADER=x-acme-trace
/context set LOG_LEVEL=debug
/context env list
/context unset LOG_LEVEL

उपनाम: add = set, remove/clear = unset।

टैब कंप्लीशन

/context टाइप करें और Tab दबाएं। ड्रॉपडाउन दिखाता है:

1. संदर्भ नाम — टेनेंट URL संकेतों के साथ, ताकि आप टेनेंट्स को अलग-अलग पहचान सकें
2. - — तब दिखाई देता है जब आपने पहले स्विच किया हो, दिखाता है कि आप किस संदर्भ पर पलटेंगे
3. सबकमांड — list, create, delete, आदि।

संदर्भ नाम पहले दिखाई देते हैं क्योंकि स्विच करना सबसे आम क्रिया है।

सबकमांड-स्तरीय कंप्लीशन भी काम करते हैं: /context activate <Tab> संदर्भ नाम पूर्ण करता है, /context namespace <Tab> नेमस्पेस पूर्ण करता है, /context unset <Tab> ज्ञात env var कुंजियों को पूर्ण करता है।

नामकरण नियम

संदर्भ नाम 1-64 अक्षरों के होने चाहिए: अक्षर, अंक, हाइफ़न, अंडरस्कोर।

सबकमांड से टकराने वाले नाम अस्वीकार कर दिए जाते हैं:

/context create list https://example.com tok

Error: Context name 'list' conflicts with a /context subcommand. Choose a different name.

पूर्ण आरक्षित सेट: list, show, status, create, delete, rename, namespace, env, set, unset, add, remove, clear, activate, validate, export, import, wizard, help। तुलना केस-असंवेदनशील है।

एनवायरनमेंट वेरिएबल ओवरराइड

यदि xcsh लॉन्च करने से पहले आपके शेल एनवायरनमेंट में XCSH_API_URL और XCSH_API_TOKEN सेट हैं, तो वे किसी भी संदर्भ पर प्राथमिकता लेते हैं। यह CI/CD पाइपलाइनों या एकबारगी सत्रों के लिए उपयोगी है जहां आप स्थायी संदर्भ बनाना नहीं चाहते।

इस मोड में चलते समय, /context एनवायरनमेंट-स्रोत क्रेडेंशियल्स को (via env vars) लेबल के साथ दिखाता है।

पिछले संदर्भ का व्यवहार

• सत्र-स्कोप्ड: जब आप xcsh पुनः आरंभ करते हैं तो पिछला संदर्भ रीसेट हो जाता है। यह डिस्क पर स्थायी नहीं होता।
• पिंग-पोंग: /context - दो बार करने से आप वापस वहीं पहुंच जाते हैं जहां से शुरू किया था।
• म्यूटेशन के प्रति सुरक्षित: यदि आप पिछले संदर्भ को हटाते हैं, तो पॉइंटर साफ़ हो जाता है। यदि आप इसका नाम बदलते हैं, तो पॉइंटर नए नाम का अनुसरण करता है।
• पुनः-सक्रियण एक नो-ऑप है: जब आप पहले से production पर हैं तो /context production पिछले पॉइंटर को रीसेट नहीं करता।

डिज़ाइन सम्मेलन

/context UX इनका अनुसरण करता है:

• kubectx: स्विच करने के लिए kubectx <name>, पिछले के लिए kubectx -, सूचीबद्ध करने के लिए बिना तर्क kubectx
• kubectl: स्पष्ट रूप के लिए kubectl config use-context
• शेल: पिछली-निर्देशिका ट्रैकिंग के लिए cd - / OLDPWD